Engee documentation

Inport

Converts the input signal into an RF signal.

blockType: SubSystem

Path in the library:

/RF/Circuit Envelope/Utilities/Inport

Description

Block Inport imports incoming signals for use in the simulation environment on the library envelope RF Blockset. You can also modulate the input signal to a square carrier wave in a simulation environment on the envelope of the library RF Blockset.

Complex input signals they represent modulation at frequencies specified in the parameter Carrier frequencies the block. The input port converts complex input signals into an RF signal suitable for multiband simulation:

Parameter Source type Defines the input signal as current, voltage, or power supply. Block icon Inport varies depending on the type of source. This table shows how the icons of this block change depending on the type of source that was set in the parameter Source type this block.

Source type: Ideal voltage Source type: Ideal current Source type: Power

inport

inport 1

inport 2

Ports

Input

# SL — Input signal
scalar | vector

Details

The input signal.

The Source type parameter defines the input signal as current, voltage, or power supply.

Data types

Float64

Complex numbers support

Yes

Conserving

# RF+ — Output signal
electricity

Details

The electrical port corresponding to the positive terminal of the RF circuit.

Program usage name

AcausalPort_626140f5-061d-41a1-8dde-aaeb286bfa08

# RF- — Output signal
electricity

Details

The electrical port corresponding to the negative terminal of the RF circuit.

Program usage name

AcausalPort_72faa9dc-5a72-48f0-ac11-8fc32443aa23

Parameters

Parameters

# Source type — interpretation of the input signal
Ideal voltage | Ideal current | Power

Details

Determine the input signal:

  • Ideal voltage — the unit outputs input signals in the form of voltage signals in the environment RF Blockset. If this option is selected, it is necessary to manually add the serial internal resistance of the source in order to match the blocks connected to the input port. The following figure shows the internal configuration of the unit.

    inport 4

  • Ideal current — the block outputs input signals in the form of current signals in the environment RF Blockset. If this option is selected, the parallel internal resistance of the source must be manually added to match the blocks connected to the input port. The following figure shows the internal configuration of the unit.

    inport 5

  • Power — the block interprets the signals. as available power, and internally uses a voltage source and a series resistance. If this option is selected, the input port automatically adds the source resistance to the circuit, as shown in the figure.

    inport 6

    Voltage is the scaling of the input signal :

    where – parameter value Source impedance (Ohm).

    The generator provides active power to the load :

    when This generator provides the available power .

Values

Ideal voltage | Ideal current | Power

Default value

Ideal voltage

Program usage name

source_type

Tunable

No

Evaluatable

Yes

# Source impedance (Ohm) — source resistance for power matching

Details

The resistance of the power matching source, specified as a vector of positive integers, in ohms.

Dependencies

To use this parameter, set for the parameter Source type the Power value.

Default value

50

Program usage name

source_impedance

Tunable

No

Evaluatable

Yes

# Carrier frequencies — carrier frequencies

Details

Carrier frequencies specified as a vector or scalar in Hz, kHz, MHz, or GHz. If the check box is selected Use Square Wave, the value of the parameter Carrier frequencies must be set as a positive scalar. The carrier frequencies are a combination of the fundamental tones and the corresponding harmonics in the block Configuration.

Default value

0

Program usage name

carrier_freq

Tunable

No

Evaluatable

Yes

# Use Square Wave — the option of using a square carrier wave

Details

Select this option to modulate the input signal to a square carrier wave.

Default value

false (switched off)

Program usage name

square_wave

Tunable

No

Evaluatable

Yes

# Number of Fourier Coefficients — number of Fourier coefficients

Details

The number of Fourier coefficients required to modulate the input signal to a square carrier wave is set as an integer greater than or equal to `1'.

Dependencies

To use this option, check the box Use Square Wave.

Default value

20

Program usage name

num_fourier_coeff

Tunable

No

Evaluatable

Yes

# DC Bias — direct current displacement

Details

The DC offset, specified as a real number.

Dependencies

To use this option, check the box Use Square Wave.

Default value

0

Program usage name

dc_bias

Tunable

No

Evaluatable

Yes

# Duty Cycle (%) — borehole of a square carrier wave

Details

The borehole of a square carrier wave, specified as a positive integer between 0 and `100', in %.

Dependencies

To use this option, check the box Use Square Wave.

Default value

50

Program usage name

duty_cycle

Tunable

No

Evaluatable

Yes

# Ground and hide negative terminal — ground the terminals of the RF circuit

Details

Check this box to ground and hide the negative terminals. Uncheck this option to open the negative terminals for connection to other components of the model.

Default value

false (switched off)

Program usage name

ground_negative_terminal

Tunable

No

Evaluatable

Yes

Learn more

Modeling of a multiband envelope

Details

Using the block Inport You can specify complex envelopes of input signals and import them as RF signals to simulate multiband signals.

Block Configuration Automatically detects the basic tones specified in the input ports and suggests the appropriate harmonic order to reflect the nonlinearity of the system. You can also manually specify the harmonic order for each pitch when modeling.

You can specify any number of carrier frequencies. It is recommended to choose between the simulation bandwidth (inversely proportional to the simulation time step) and the total number of simulation frequencies.

The illustration shows the modeling of an envelope with several carriers. In this illustration, the complex envelope of the modulated input signals consists of carriers, the envelope of the circuit consists of harmonic tones, and the complex envelope around the selected carrier consists of the envelope of the signal.

inport 3 en