pskmod

Modulate signal using M-PSK method

Syntax

Y = pskmod(X,M)

Y = pskmod(X,M,phaseoffset)

Y = pskmod(X,M,phaseoffset,symorder)

Y = pskmod(X,M,Name=Value)

Description

Y = pskmod(X,M) modulates the input signal X using the M-Ary phase shift keying (M-PSK) method. M specifies the modulation order.

Y = pskmod(X,M,phaseoffset) specifies the phase offset of the M-PSK constellation.

example

Y = pskmod(X,M,phaseoffset,symorder) specifies the symbol order of the M-PSK constellation.

Y = pskmod(X,M,Name=Value) specifies optional name-value arguments using any of the previous syntaxes. For example, pskmod(Y,M,PlotConstellation=true) modulates using modulation order M and plots the constellation. Specify name-value arguments after all other input arguments.

Examples

collapse all

Modulate PSK Signal

Open Live Script

Modulate and plot the constellations of QPSK and 16-PSK signals.

QPSK

Set the modulation order to 4.

M = 4;

Generate random data symbols.

data = randi([0 M-1],1000,1);

Modulate the data symbols.

txSig = pskmod(data,M,pi/M);

Pass the signal through white noise and plot its constellation.

rxSig = awgn(txSig,20);
scatterplot(rxSig)

Figure Scatter Plot contains an axes object. The axes object with title Scatter plot, xlabel In-Phase, ylabel Quadrature contains a line object which displays its values using only markers. This object represents Channel 1.

16-PSK

Change the modulation order from 4 to 16.

M = 16;

Generate random data symbols.

data = randi([0 M-1],1000,1);

Modulate the data symbols.

txSig = pskmod(data,M,pi/M);

Pass the signal through white noise and plot its constellation.

rxSig = awgn(txSig,20);
scatterplot(rxSig)

Modulate and Demodulate QPSK Signal in AWGN

Open Live Script

Generate random symbols.

dataIn = randi([0 3],1000,1);

QPSK modulate the data.

txSig = pskmod(dataIn,4,pi/4);

Pass the signal through an AWGN channel.

rxSig = awgn(txSig,10);

Demodulate the received signal and compute the number of symbol errors.

dataOut = pskdemod(rxSig,4,pi/4);
numErrs = symerr(dataIn,dataOut)

numErrs = 
3

PSK Symbol Mapping

Open Live Script

Set the modulation order, then create a data sequence containing a complete set of constellation points.

M = 8;
data = (0:M-1);
phaseoffset = 0;

Visualize the plot constellations of 8-PSK symbol mapping for modulated and demodulated gray-coded and binary-coded data.

symgray = pskmod(data,M,phaseoffset,'gray',PlotConstellation=true, ...
          InputType='integer');

Figure contains an axes object. The axes object with title 8-PSK, Gray Mapping, xlabel In-phase Amplitude, ylabel Quadrature Amplitude contains 11 objects of type line, text. One or more of the lines displays its values using only markers

mapgray = pskdemod(symgray,M,phaseoffset,'gray',OutputType='integer');
symbin = pskmod(data,M,phaseoffset,'bin');
mapbin = pskdemod(symbin,M,phaseoffset,'bin',PlotConstellation=true, ...
         OutputType='bit');

Figure contains an axes object. The axes object with title 8-PSK, Binary Mapping, xlabel In-phase Amplitude, ylabel Quadrature Amplitude contains 11 objects of type line, text. One or more of the lines displays its values using only markers

Input Arguments

collapse all

`X` — Input signal
scalar | vector | matrix

Input signal, specified as a scalar, vector, or matrix of positive integers. The elements of X must have binary or integer values in the range [0, M – 1], where M is the modulation order.

Note

To process an input signal as binary elements, set the InputType name-value argument to 'bit'. For binary inputs, the number of rows must be an integer multiple of log₂(M). The function maps groups of log₂(M) bits onto a symbol, with the first bit representing the MSB and the last bit representing the LSB.

Dependencies

For input signals of datatype logical, you must set InputType to 'bit'.

`M` — Modulation order
positive integer

Modulation order, specified as an integer value greater than 1.

Data Types: double

`phaseoffset` — Phase offset
`0` (default) | scalar

Phase offset of the PSK constellation in radians, specified as a scalar.

Data Types: double

`symorder` — Symbol order
`'gray'` (default) | `'bin'` | vector

Symbol order, specified as 'gray', 'bin', or a vector. This argument specifies how the function assigns binary vectors to corresponding integers.

'gray' — Use a Gray-coded ordering.
'bin' — Use a binary-coded ordering.
vector –– Use custom symbol ordering. The vector is of length M containing unique values in the range [0, M – 1]. The first element correlates to the constellation point corresponding to angle phaseoffset, with subsequent elements running counter-clockwise.

Name-Value Arguments

Specify optional pairs of arguments as Name1=Value1,...,NameN=ValueN, where Name is the argument name and Value is the corresponding value. Name-value arguments must appear after other arguments, but the order of the pairs does not matter.

Example: Y = pskmod(X,M,phaseoffset,symorder,InputType='bit')

`InputType` — Input type
`'integer'` (default) | `'bit'`

Input type, specified as either 'integer' or 'bit'.

'integer' –– Input signal consists of integers in the range [0, M – 1].
'bit' –– Input signal consists of binary values and the number of rows must be an integer multiple of log₂(M).

`OutputDataType` — Data type of output
`'double'` (default) | `'single'`

Data type of output, specified as either 'double' or 'single'.

`PlotConstellation` — Option to plot constellation
`false` or `0` (default) | `true` or `1`

Option to plot constellation, specified as logical 0 (false) or 1 (true). To plot the PSK constellation, set 'PlotConstellation' to true.

Data Types: logical

Output Arguments

collapse all

`Y` — M-PSK modulated baseband signal
scalar | vector | matrix

M-PSK modulated baseband signal, returned as a scalar, vector or matrix of complex values. The columns of Y represent independent channels. For integer inputs, the output Y has the same dimensions as the input signal X. For bit inputs, the number of rows in Y is the number of rows in X divided by log₂(M).

Algorithms

For higher-order PSK constellations, the complex baseband form for an M-ary PSK signal using binary-ordered symbol mapping is

$s_{m} (t) = \exp (j (\frac{2 π m}{M} + ϕ)); m \in {0, 1, \dots, M - 1} .$

When the input is configured for bits, groups of log₂(M) bits represent the complex symbols for the configured symbol mapping. The mapping can be binary encoded, Gray encoded, or custom encoded.

Gray coding has the advantage that only one bit changes between adjacent constellation points, which results in better bit error rate performance.

This 8-PSK constellation uses Gray-coded symbol mapping.

For modulation orders beyond 4, the bit error rate performance of PSK in AWGN worsens. In this bit error rate plot for Gray-coded mapping, the QPSK and BPSK curves overlap one another.

References

[1] Proakis, John G. Digital Communications. 4th ed. New York: McGraw Hill, 2001.

Extended Capabilities

C/C++ Code Generation
Generate C and C++ code using MATLAB® Coder™.

GPU Arrays
Accelerate code by running on a graphics processing unit (GPU) using Parallel Computing Toolbox™.

This function supports GPU array inputs. For more information, see Run MATLAB Functions on a GPU (Parallel Computing Toolbox).

Version History

Introduced before R2006a

expand all

R2024b: Add GPU array support

The pskmod function adds support for gpuArray (Parallel Computing Toolbox) object processing to run code on a graphics processing unit (GPU).

R2022a: New enhancements to the function

You can now:

Specify a binary input using the InputType argument.
Specify custom symbol mapping using the symorder argument. The default now is 'gray' symbol mapping.
Perform soft-decision demodulation by using the bit-wise log-likelihood or approximate log-likelihood algorithm
Specify all built-in numeric data types using the OutputDataType argument.
Visualize the reference constellation using the PlotConstellation argument.

pskmod

Syntax

Description

Examples

Modulate PSK Signal

Modulate and Demodulate QPSK Signal in AWGN

PSK Symbol Mapping

Input Arguments

`X` — Input signal
scalar | vector | matrix

Dependencies

`M` — Modulation order
positive integer

`phaseoffset` — Phase offset
`0` (default) | scalar

`symorder` — Symbol order
`'gray'` (default) | `'bin'` | vector

Name-Value Arguments

`InputType` — Input type
`'integer'` (default) | `'bit'`

`OutputDataType` — Data type of output
`'double'` (default) | `'single'`

`PlotConstellation` — Option to plot constellation
`false` or `0` (default) | `true` or `1`

Output Arguments

`Y` — M-PSK modulated baseband signal
scalar | vector | matrix

Algorithms

References

Extended Capabilities

C/C++ Code Generation
Generate C and C++ code using MATLAB® Coder™.

GPU Arrays
Accelerate code by running on a graphics processing unit (GPU) using Parallel Computing Toolbox™.

Version History

R2024b: Add GPU array support

R2022a: New enhancements to the function

See Also

Functions

Blocks

Topics

pskmod

Syntax

Description

Examples

Modulate PSK Signal

Modulate and Demodulate QPSK Signal in AWGN

PSK Symbol Mapping

Input Arguments

X — Input signal scalar | vector | matrix

Dependencies

M — Modulation order positive integer

phaseoffset — Phase offset 0 (default) | scalar

symorder — Symbol order 'gray' (default) | 'bin' | vector

Name-Value Arguments

InputType — Input type 'integer' (default) | 'bit'

OutputDataType — Data type of output 'double' (default) | 'single'

PlotConstellation — Option to plot constellation false or 0 (default) | true or 1

Output Arguments

Y — M-PSK modulated baseband signal scalar | vector | matrix

Algorithms

References

Extended Capabilities

C/C++ Code Generation Generate C and C++ code using MATLAB® Coder™.

GPU Arrays Accelerate code by running on a graphics processing unit (GPU) using Parallel Computing Toolbox™.

Version History

R2024b: Add GPU array support

R2022a: New enhancements to the function

See Also

Functions

Blocks

Topics

`X` — Input signal
scalar | vector | matrix

`M` — Modulation order
positive integer

`phaseoffset` — Phase offset
`0` (default) | scalar

`symorder` — Symbol order
`'gray'` (default) | `'bin'` | vector

`InputType` — Input type
`'integer'` (default) | `'bit'`

`OutputDataType` — Data type of output
`'double'` (default) | `'single'`

`PlotConstellation` — Option to plot constellation
`false` or `0` (default) | `true` or `1`

`Y` — M-PSK modulated baseband signal
scalar | vector | matrix

C/C++ Code Generation
Generate C and C++ code using MATLAB® Coder™.

GPU Arrays
Accelerate code by running on a graphics processing unit (GPU) using Parallel Computing Toolbox™.