Limiter

Signal limiter that constrains input values between specified boundaries.

Implements a hard saturation that restricts the output signal to remain within the bounds specified by y_min and y_max. When the input signal is within these limits, it passes through unchanged; otherwise, the output is clamped to the nearest limit value. This is commonly used in control systems to prevent signals from exceeding safe operating ranges.

This component extends from SISO

Usage

Limiter(y_max, y_min=-y_max)

Parameters:

Name	Description	Units	Default value
y_max	Maximum allowed output value	–
y_min	Minimum allowed output value, defaults to negative of y_max	–	-y_max

Connectors

• u - This connector represents a real signal as an input to a component (RealInput)

• y - This connector represents a real signal as an output from a component (RealOutput)

Behavior

$$\begin{array}{rl}y\left(t\right)& =clamp(u\left(t\right),\mathtt{y}\mathtt{\_}\mathtt{min},\mathtt{y}\mathtt{\_}\mathtt{max})\end{array}$$

Source

# Signal limiter that constrains input values between specified boundaries.
#
# Implements a hard saturation that restricts the output signal to remain within the bounds
# specified by y_min and y_max. When the input signal is within these limits, it passes through
# unchanged; otherwise, the output is clamped to the nearest limit value. This is commonly used
# in control systems to prevent signals from exceeding safe operating ranges.
component Limiter
  extends SISO
  # Maximum allowed output value
  parameter y_max::Real
  # Minimum allowed output value, defaults to negative of y_max
  parameter y_min::Real = -y_max
relations
  y = clamp(u, y_min, y_max)
end

Flattened Source

# Signal limiter that constrains input values between specified boundaries.
#
# Implements a hard saturation that restricts the output signal to remain within the bounds
# specified by y_min and y_max. When the input signal is within these limits, it passes through
# unchanged; otherwise, the output is clamped to the nearest limit value. This is commonly used
# in control systems to prevent signals from exceeding safe operating ranges.
component Limiter
  # Input signal port
  u = RealInput() [{
    "Dyad": {
      "placement": {"icon": {"iconName": "input", "x1": -50, "y1": 450, "x2": 50, "y2": 550}}
    }
  }]
  # Output signal port
  y = RealOutput() [{
    "Dyad": {
      "placement": {"icon": {"iconName": "output", "x1": 950, "y1": 450, "x2": 1050, "y2": 550}}
    }
  }]
  # Maximum allowed output value
  parameter y_max::Real
  # Minimum allowed output value, defaults to negative of y_max
  parameter y_min::Real = -y_max
relations
  y = clamp(u, y_min, y_max)
metadata {}
end

Test Cases

This is setup code, that must be run before each test case.

using BlockComponents
using ModelingToolkit, OrdinaryDiffEqDefault
using Plots
using CSV, DataFrames

snapshotsdir = joinpath(dirname(dirname(pathof(BlockComponents))), "test", "snapshots")

"/home/actions-runner-10/.julia/packages/BlockComponents/77kIK/test/snapshots"

Related

• Examples

• Experiments

• Analyses

• Tests

  • LimiterTest