Description
Rate-limit one actuator-command step with asymmetric rise/fall bounds.
Control boundaries and stability terms depend on state history, sign conventions and the full system dynamics. A finite scalar factor, one pole or one frequency sample is not sufficient to establish safe closed-loop behavior.
Rate-limit one actuator-command step with asymmetric rise/fall bounds.
When to use this tool
Use Actuator Rate Limit One Step Gap when checking a supplied saturation, hysteresis or local stability condition.
How to use the tool and how it works
- Enter current, requested, riseRate, fallRate, step. Use the units and conventions below.
- Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
- Read next, unmet. Use the output convention below.
Rate-limit one actuator-command step with asymmetric rise/fall bounds. Require nonnegative rates/step; clamp requested between current-fallRate*step and current+riseRate*step, returning next and unmet = requested-next.1
| Input field | Meaning and units | Accepted input |
|---|---|---|
| current | Supplied current state or value under the stated update convention. | Required. Finite number. |
| requested | Requested | Required. Finite number. |
| riseRate | Rise Rate | Required. Finite number; minimum 0. |
| fallRate | Fall Rate | Required. Finite number; minimum 0. |
| step | Step duration in the same time unit used by rates and time constants. | Required. Finite number; minimum 0. |
| Output field | Interpretation | Returned shape |
|---|---|---|
| next | Next | Required. Finite number. |
| unmet | Unmet | Required. Finite number. |
{
"input": {
"current": 10,
"requested": 20,
"riseRate": 2,
"fallRate": 3,
"step": 2
},
"output": {
"next": 14,
"unmet": 6
}
}Limitations and assumptions
- This limits rate rather than absolute amplitude; physical actuator response and safety are not verified.
- Inputs must satisfy both the field types and the cross-field conditions above. Invalid input causes an error; a successful false flag or documented placeholder is a different result.
- Numeric calculations use binary floating point unless exact decimal-integer arithmetic is explicitly stated. No hidden measurement tolerance or decimal rounding is added; nonfinite or out-of-contract results are rejected. Numeric signed-zero results are exported as zero.
Alternative or Complementary methods
Analyze the complete dynamic system and practical constraints before interpreting a local result as robust or safe operation.
References
Similar or alternative tools
- Actuator Dead Zone Edge Token
Classify an actuator input against a supplied deadzone interval.
- Control Saturation Duty Fraction Term
Return a saturated command and its range fraction.