EngeeComms.RaisedCosineTransmitFilter

Page in progress.

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

Library	`EngeeComms`.
Block	Raised Cosine Transmit Filter

Description

To apply pulse shaping by interpolating the input signal using a FIR filter with raised cosine, follow the steps below:

Create an object EngeeComms.RaisedCosineTransmitFilter and set its properties.
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

txfilter = EngeeComms.RaisedCosineTransmitFilter() - Returns a system object that interpolates the input signal using an FIR filter with an elevated cosine transmission, with by default properties. The filter uses the effective polyphase structure of the FIR filter and has unit energy.

Example:
```
txfilter = EngeeComms.RaisedCosineTransmitFilter(RolloffFactor = 1.0,FilterSpanSymbols = 2,OutputSamplesSymbol = 3,LinearAmplitudeFilterGain = 1.0)
```
txfilter = EngeeComms.RaisedCosineTransmitFilter(Name=Value) - creates a system object 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, EngeeComms.RaisedCosineTransmitFilter(FilterSpanSymbols =15) configures a raised cosine filter FIR system object with the filter range set to 15 characters.

Example:
```
txfilter = EngeeComms.RaisedCosineTransmitFilter(FilterSpanSymbols =15)
```

Usage

y = txfilter(X) - applies pulse shaping by interpolating the input signal with a raised cosine FIR filter. The output is the interpolated values of the signal.

Example:
```
y = step!(txfilter, 0.0, [3.14, 2.0])
```

Arguments

Input arguments

X - input signal
vector-column | matrix

Details

An input signal specified as a column vector or matrix to , where 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 to , the object treats the columns of the input matrix as independent channels.

This system object accepts variable-sized input data. After locking the 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 , where is equal to × OutputSamplesPerSymbol. - is the number of input samples per signal channel, and is the number of signal channels.

The object interpolates and filters each channel along the first dimension, and then generates an output matrix to . The output signal has the same data type as the input signal.

Properties

# RolloffFactor — smoothing factor
Real number

Details

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

# LinearAmplitudeFilterGain — linear filter gain
Real number

Details

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

# FilterSpanSymbols — filter range in characters
Real number

Details

The range of the filter in symbols, specified as a positive integer. This 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.

# OutputSamplesSymbol — output counts per character
Real number

Details

The number of output counts per character specified as a positive integer.

Methods

Common for all system objects

step!

Start the system object’s operating algorithm