Engee documentation

EngeeComms.RaisedCosineReceiveFilter

Shapes the pulse by decimating the signal using a FIR filter with raised cosine.

Library

EngeeComms.

Block

Raised Cosine Receive Filter

Description

To generate a pulse by decimating the signal using a FIR filter with raised cosine, follow the steps below:

  1. Create an object EngeeComms.RaisedCosineReceiveFilter and set its properties.

  2. Call the object with arguments as if it were a function.

To learn more about how to work with system objects, see Engee system objects.

Syntax

Creation

  • rxfilter = EngeeComms.RaisedCosineReceiveFilter() - Returns a system object of a Raised Cosine FIR receive FIR filter that decimates the input signal using a Raised Cosine FIR filter. The filter utilises the effective polyphase decimation structure of the FIR filter and has unit energy.

    Example:

    rxfilter = EngeeComms.RaisedCosineReceiveFilter()
  • rxfilter = EngeeComms.RaisedCosineReceiveFilter(Name=Value) - creates a system object EngeeComms.RaisedCosineReceiveFilter with the specified property Name set to the specified value Value. You can specify additional arguments as a name-value pair in any order (Name1=Value1,…​,NameN=ValueN). For example, comm.RaisedCosineReceiveFilter(RolloffFactor=0.3) configures the Raised Cosine Receive Filter system object with the smoothing factor set to 0.3.

    Example:

    rxfilter = EngeeComms.RaisedCosineReceiveFilter(RolloffFactor=0.3)

Usage

  • Y = rxfilter(X) - applies pulse shaping by decimating the input signal with a raised cosine FIR filter. The decimated signal values are obtained at the output.

Y = rxfilter(X)

Arguments

Input arguments

X - input signal
vector-column | matrix

Details

An input signal specified as a column vector or matrix to , where i is the number of input samples per signal channel and is the number of signal channels.

For an input signal in the form of a matrix i by , the object treats the columns of the input matrix as independent channels.

This system object accepts variable-sized input data. After locking the system object, you can change the size of each input channel, but you cannot change the number of channels.

Типы данных

Float64, Float32

Support for complex numbers

Yes

Output arguments

Y - output signal
vector-column | matrix

Details

The output signal returned as a column vector or matrix to . is equal to / DecimationFactor, where is the number of input samples per signal channel and is the number of signal channels.

The system object filters each channel in time and generates a matrix to at the output. The output signal has the same data type as the input signal.

Properties

# InputSamplesSymbol — input counts per character
Real number

Details

Input counts per character, specified as a positive integer.

# DecimationOffset — decimation bias
Real number

Details

The decimation offset, specified as an integer in the range [0, (DecimationFactor - 1)]. This property defines the number of filtered samples that the object discards before downsampling.

# RolloffFactor — smoothing factor
Real number

Details

A smoothing factor specified as a scalar in the range [0, 1].

# DecimationFactor — decimation factor
Real number

Details

The decimation factor specified as an integer in the range [1, InputSamplesPerSymbol]. This value must be evenly divisible by InputSamplesPerSymbol. The sampling rate of the output signal is reduced by the decimation factor so that length(Y)/length(X) is equal to DecimationFactor. For a matrix input signal, the number of input rows must be a multiple of the decimation factor.

# LinearAmplitudeFilterGain — linear filter gain
Real number

Details

The linear filter gain factor of a filter, specified as a positive scalar. The system object designs the raised cosine of the filter having unit energy, and then applies the linear filter gain to obtain the final tap ratio values.

# FilterSpanSymbols — filter range in characters
Real number

Details

The range of the filter in symbols, specified as a positive integer. The system object truncates the infinite impulse response (IIR) of an ideal raised cosine filter to an impulse response that spans the number of symbols specified by this property.

Methods

Common for all system objects

step!

Start the system object’s operating algorithm