Maps an incoming bit stream to complex-valued PAM symbols.

##### Programming Patterns
Use this node in conjunction with MT Matched Filter, MT Align to Ideal Symbols, MT Decimate Oversampled Waveform, and MT Calculate BER to perform waveform analysis on the modulated waveform.
Note

The mapping of symbols to bits depends on the number of bits per symbol, which equals ${\mathrm{log}}_{2}\left(M\right)$ with M representing the size of the modulation scheme. For example, in a 256-QAM system, 500 QAM symbols are mapped to $\left(500\right)×{\mathrm{log}}_{2}\left(256\right)=4000\text{\hspace{0.17em}}\text{\hspace{0.17em}}message\text{\hspace{0.17em}}\text{\hspace{0.17em}}\text{\hspace{0.17em}}bits$.

## input bit stream

The incoming bit stream to be mapped to symbols.

## symbol map

An ordered array that maps each symbol value to its desired coordinates in the complex plane.

The number of PAM states in the array must be 2 N , where N is the number of bits per symbol. The length of the vector for the symbols farthest from the origin must be 1. To specify a prebuilt map, unbundle the symbol map element from the PAM system parameters cluster generated byMT Generate PAM System Parameters (M) or MT Generate PAM System Parameters (map).

## error in

Error conditions that occur before this node runs. The node responds to this input according to standard error behavior.

Default: no error

## reset?

A Boolean that determines whether stored state information is cleared on each call to this node.

When the input bit stream is not comprised of an integer number of symbols, the carryover bits are buffered.

 TRUE Clears the buffered data, checks the input parameters on a first call, and reflects any change in the input parameter values during subsequent iterations. FALSE Adds the buffered data to the beginning of data from next iteration, in continuous operations.

Default: TRUE

## symbols

An array of complex-valued symbols with a one-to-one mapping to the input bit stream based on the specified symbol map.

Note

Wire this parameter to MT Apply Pulse Shaping Filter to generate the oversampled baseband complex waveform.

## error out

Error information. The node produces this output according to standard error behavior.