EngeeComms.Repeat
Re-samples the input signal at a higher rate by repeating values.
Library |
|
Block |
Description
The system object EngeeComms.Repeat increases the sampling rate of each input signal channel (sized by ) to a frequency that is times the sampling rate of the input signal. To do this, the object repeats at the output each consecutive input sample times. The integer L
is specified in the property RepetitionCount or through the input argument L.
To increase the sampling rate of each channel of the input signal, perform the following steps:
-
Create an object EngeeComms.Repeat 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
-
repeat = EngeeComms.Repeat()
creates a system object to increase the sample rate of each input signal channelrepeat
with by default properties.Example:
repeat = EngeeComms.Repeat()
-
repeat = EngeeComms.Repeat(Name=Value)
creates arepeat
system object with the specifiedName
property set to the specifiedValue
value. You can specify additional arguments as a name-value pair in any order (Name1
=Value1
,…,NameN
=ValueN
).Example:
repeat = EngeeComms.Repeat(RepetitionCountSource=10)
Arguments
Input arguments
In -
input signal
scalar
| vector
| matrix
Details
Input signal as a real scalar, vector or matrix.
This argument has no name until you set the * property to Input port
.RepetitionCountSource* property to Input port
.
Типы данных |
|
Support for complex numbers |
Yes |
L -
number of repetitions
` positive integer ≤ Lmax`
Details
Repetition count input signal as a positive integer.
Dependencies
To use this argument, set the property RepetitionCountSource property to Input port
.
Типы данных |
|
Support for complex numbers |
No |
Output arguments
Out -
output signal
scalar
| vector
| matrix
Details
An output signal with a sampling rate that is times the input sampling rate. The system object EngeeComms.Repeat shows an output signal having the same data type and dimensionality as the input signal. The size of the output signal depends on the value of the number of repetitions and the setting of the property RateOptions.
If the property RepetitionCount* property is set to L
and the property is set to.RateOptions* * * is set to:
-
Enforce single-rate processing
- the object maintains the input sampling rate while increasing the output frame size by a factor of . -
Allow multirate processing
- the object will resample the signal so that the output sample rate is times the input sample rate. The output signal has the same frame size as the input one.
When the number of repetitions is input through the input port L, the property RateOptions is automatically set to Enforce single-rate processing
. In this case, the object maintains the sampling rate of the input signal at the output, increasing the output frame size by a factor of .
The output signal is a variable size signal if one or both conditions are met:
-
A variable-size signal is applied to the input.
-
The number of repetitions is supplied through the L port.
Типы данных |
|
Support for complex numbers |
None |
Properties
#
InputProcessing —
input signal processing method
String
Details
Specify how the object should process the input. You can set this property to one of the following options:
-
Columns as channels (frame based)
-if you select this option, the object processes each column of input as a separate channel. In this mode, the object can perform single-speed or multirate processing. -
Elements as channels (sample based)
-if you select this option, the object processes each input element as a separate channel. In this mode, the object always performs multirate processing.
Типы данных |
|
#
RateOptions —
a method by which the facility increases the sampling frequency of the input
String
Details
Specify the method by which the object increases the sampling rate of the input. You can select one of the following options:
-
Enforce single-rate processing
- If you select this option, the object maintains the input sample rate by increasing the output frame size by a factor of L. To select this option, you must set the property InputProcessing toColumns as channels (frame based)
. -
Allow multirate processing
- if you select this option, the object will resample the signal so that the output sample rate is times faster than the input.
Типы данных |
|
#
RepetitionCountSource —
repetition source
String
Details
The source of the number of repetitions:
-
Dialog parameter
- the number of repetitions is set in the * property.RepetitionCount*. -
Input port
- the number of repetitions will be obtained through the input argument L.
Типы данных |
|
#
RepetitionCount —
number of repetitions
Real number
Details
Number of repetitions as a positive integer. This value represents the number of times the object repeats the input value. It is the factor by which the object increases the output frame size or sampling rate.
Dependencies
To use this property, set the property RepetitionCountSource property to Dialog parameter
.
#
InitialConditions —
initial value
Scalar / vector of Int64
Details
Specify the value with which the object is initialised for non-zero wait time cases as a scalar or matrix.
Типы данных |
|