📄 support.html
字号:
<HTML><HEAD><TITLE> Support Programs </TITLE></HEAD><BODY><H1> Support Programs </H1>The following programs provide support for testing and performanceassessment.<P><A NAME="rand-src"><HR><B>rand-src</B>: Generate random message bits.<BLOCKQUOTE><PRE>rand-src <I>source-file seed n-bits</I></PRE></BLOCKQUOTE><P>Creates a file of random messages bits called<TT><I>source-file</I></TT>, which is suitable for testing thecorrectness and performance of other programs. The bits in the fileare independent, and are equally likely to be 0 or 1. They aregenerated pseudo-randomly based on <TT><I>seed</I></TT>. The actualrandom number seed used will be <TT><I>seed</I></TT> times 10 plus 2,so that the stream of pseudo-random numbers will not be the same asany that might have been used by another program.<P>The <TT><I>n-bits</I></TT> argument specifies the number of bits toproduce. It can be a single number, or it can consist of a block sizeand a number of blocks, written with <TT>x</TT> separating thesenumbers, with no spaces. Each block is written as a single line, withthe bits in the block represented by the characters '0' and '1', withno intervening spaces. If the bit count is given by a single number,the block size is assumed to be one.<P><B>Example:</B> The following command produces a file containing 3 blocks, each consisting of 15 random bits, produced using the pseudo-randomnumber stream identified by the <TT><I>seed</I></TT> of 17:<UL><PRE><LI>rand-src rsrc 17 15x3</PRE></UL>The contents of the file <TT>rsrc</TT> after this command might be somethinglike the following:<BLOCKQUOTE><PRE>111011000110000010010110010111100000000000111</BLOCKQUOTE></PRE><P><A NAME="verify"><HR><B>verify</B>: Verify that decoded blocks are codewords, and that they match the source.<BLOCKQUOTE><PRE>verify [ -t ] <I>pchk-file decoded-file</I> [ <I>gen-file</I> [ <I>source-file</I> ] ]</PRE></BLOCKQUOTE><P>Checks whether or not the blocks in <TT><I>decoded-file</I></TT>are codewords, according to the parity check matrix in<TT><I>pchk-file</I></TT>. If <TT><I>gen-file</I></TT> is specified,the message bits of the blocks are also checked against thecorresponding blocks of <TT><I>source-file</I></TT>, or against zeroif <TT><I>source-file</I></TT> is not given. (Normally, one wouldleave out <TT><I>source-file</I></TT> only if the <AHREF="channel.html#transmit"><TT>transmit</TT></A> command was usedwith an argument specifying that zeros are to be transmitted, ratherthan a file of encoded data.)<P>A summary of the results is displayed on standard error, giving thetotal numbers of blocks, the number with parity check errors, and, if<TT><I>gen-file</I></TT> was specified, the number of blocks withsource errors and the number with errors of both kinds. If <TT><I>gen-file</I></TT> was specified, a secondsummary line displays the bit error rate fromcomparing the decoded message bits with the true message bits (zerosif no <TT><I>source file</I></TT> was given).<P>If the <B>-t</B> option is given, block-by-block results areprinted on standard output in two or three columns, giving the blocknumber (from zero), the number of parity check errors for that block,and the number of errors in source bits. The last column is omittedif <TT><I>gen-file</I></TT> is not specified. The columns arepreceded by a line of headers, so the file is suitable for readinginto the S-Plus or R statistics packages, with a command such as<BLOCKQUOTE><PRE>data <- read.table(<I>file</I>,header=T)</PRE></BLOCKQUOTE><P>Warning messages are displayed on standard error if the number ofbits in <TT><I>decoded-file</I></TT> is not a multiple of the blocklength, or if <TT><I>source-file</I></TT> is too short. Newlinesin these files are ignored, even though they would normally occurat the ends of blocks.<HR><A HREF="index.html">Back to index for LDPC software</A></BODY></HTML>⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -