Engee documentation

Fundamental (PLL-Driven)

Calculates the amplitude and phase of the fundamental harmonic of the signal.

blockType: SubSystem

Path in the library:

/Physical Modeling/Electrical/Control/Measurements/Fundamental (PLL-Driven)

Description

Block Fundamental (PLL-Driven) calculates the amplitude and phase of the fundamental harmonic of the input signal In during a sliding window equal to one cycle of the fundamental frequency set by the input signal Freq. The coordinate system required for calculations is set by the input signal of the angle of the reference frame wt.

Based on the Fourier analysis of a periodic signal, the magnitude of the fundamental harmonic of the signal can be expressed as

,

,

,

, where — main frequency,

.

The amplitude and phase of the fundamental harmonic are calculated as follows:

,

.

To solve these equations, the block uses the value on the input port Freq for and the value on the input port wt for . These two input signals are usually connected to the outputs of the PLL unit.

Since this block uses a moving average window, one simulation cycle must be completed before the output values match the correct amplitude and phase values. For the first simulation cycle, the output values correspond to the parameter in which the initial values are set.

Ports

Output

# |u| — amplitude of the fundamental harmonic
scalar

Details

The amplitude of the fundamental harmonic is in the same units as the input signal.

Data types

Float64

Complex numbers support

I don’t

# ∠u — the phase of the fundamental harmonic
scalar

Details

The phase of the fundamental harmonic in degrees.

Data types

Float64

Complex numbers support

I don’t

Input

# Freq — main frequency, Hz
scalar

Details

The fundamental frequency (Hz) required for calculations.

Data types

Float64

Complex numbers support

I don’t

# wt — the angle of the coordinate system, rad
scalar

Details

The angle of the coordinate system (rad) required for calculations.

Data types

Float64

Complex numbers support

I don’t

# In — Input signal
scalar | vector

Details

Input signal for analysis. The input signals can be voltage or current signals.

Data types

Float64

Complex numbers support

I don’t

Parameters

Parameters

# Initial frequency, Hz: — initial frequency, Hz

Details

The frequency of the first simulation cycle in Hz.

Default value

50.0

Program usage name

f_start

Evaluatable

Yes

# Minimum frequency, Hz: — minimum frequency, Hz

Details

The minimum frequency value determines the block buffer size. Variable Time Delay, used inside the block to calculate the average value.

Default value

45.0

Program usage name

f_min

Evaluatable

Yes

# Initial input [ Mag, Phase-relative-to-PLL (deg) ]: — initial input values of amplitude and phase

Details

The initial values of the amplitude and phase of the output signal.

The phase is set in degrees.

Default value

[1, 0]

Program usage name

mag_and_phase_PLL_start

Evaluatable

Yes

# Sample time: — sampling period

Details

The sampling period of the block in seconds. Set the value 0 to implement a continuous block.

Default value

0.01

Program usage name

sample_time

Evaluatable

Yes