Engee documentation

First-Order Filter

A first-order filter.

blockType: SubSystem

Path in the library:

/Physical Modeling/Electrical/Control/General Control/First-Order Filter

Description

Block First-Order Filter implements one of the following transfer functions depending on the parameter value Filter type:

  • Low-pass filter:

  • High-pass filter:

Where

  • — Laplace operator;

  • — time constant.

Features

The main characteristics of the block First-Order Filter are:

  • The input port accepts a vector from signals and implements filters. This feature is especially useful for designing controllers in three-phase systems ( );

  • It is possible to initialize the filter states for the DC and AC Inputs specified.

Ports

Input

# IN_1 — filter input
scalar | vector

Details

The input signal of the first-order filter, specified as a scalar or vector.

Data types

Float64

Complex numbers support

I don’t

Output

# OUT_1 — filter output signal
scalar | vector

Details

The output signal of the first-order filter, returned as a scalar or vector.

Data types

Float64

Complex numbers support

I don’t

Parameters

Main

# Filter type — selecting the filter type
Lowpass | Highpass

Details

Determine the type of first-order filter. Set the value Lowpass to implement a low-pass filter, or set the value Highpass to implement a high-pass filter.

Values

Lowpass | Highpass

Default value

Lowpass

Program usage name

type

Evaluatable

Yes

# Time constant, s — filter time constant

Details

The time constant of the first-order filter, set in seconds.

Default value

10e-3

Program usage name

T

Evaluatable

Yes

# Sample Time — sampling period

Details

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

Default value

0

Program usage name

sample_time

Evaluatable

Yes

# Initialize filter states: — the initial value of alternating and direct current

Details

Select this option to initialize the filter states according to the parameters. AC initial input [ Mag, Phase (degrees), Freq (Hz) ] and DC initial input.

Default value

true (switched on)

Program usage name

enable_initialization

Evaluatable

Yes

# AC initial input [Magnitude, Phase (deg), Frequency (Hz)] — the initial value of the variable component

Details

Specify the initial value of the variable component of the input signal: amplitude, phase in degrees, and frequency in Hz. If the input signal is a vector ( signals), specify the matrix on , where each row of the matrix corresponds to a specific input. The phase can have any value. The amplitude and frequency should have a positive value.

Dependencies

To use this option, check the box Initialize filter states:.

Default value

[0 0 50]

Program usage name

V_AC_start

Evaluatable

Yes

# DC initial input — the initial value of the constant component

Details

Specify the initial value of the constant component of the input signal. If the input signal is a vector, specify the vector on , where each value corresponds to a specific input.

Dependencies

To use this option, check the box Initialize filter states:.

Default value

0

Program usage name

V_DC_start

Evaluatable

Yes