minreal — Cancel matching poles and zeros in a transfer function.
minreal(sys) removes matching pole-zero pairs in an ordinary SISO tf model; minreal(sys,tol) sets a positive absolute matching tolerance. The default is sqrt(eps).
Syntax
msys = minreal(sys)
msys = minreal(sys,tol)Inputs
sys- Type
Any- Required
- Yes
- Default
- —
- Description
- Scalar SISO transfer-function model.
tol- Type
NumericScalar- Required
- No
- Default
sqrt(eps)- Description
- Positive absolute pole-zero matching tolerance.
Returns
msys- Type
Any- Description
- Reduced transfer-function model with unchanged sample time and delays.
Errors
RunMat:minreal:InvalidArgument- When
- The arity, output count, model argument, or tolerance is invalid.
- Message
minreal: invalid argument
RunMat:minreal:UnsupportedModel- When
- The input is not an ordinary SISO tf model.
- Message
minreal: unsupported model
RunMat:minreal:NumericalFailure- When
- Polynomial root finding or pole-zero deflation is unreliable.
- Message
minreal: numerical failure
Supported model
This implementation supports one SISO transfer-function model with real or complex double coefficients. It preserves the variable, sample time, input delay, and output delay. State-space, zero-pole-gain, model-array, and MIMO reduction remain unsupported.
Cancellation is performed in physical polynomial coordinates, including models whose public coefficients use an inverse discrete variable. For real models, conjugate roots are canceled together so the result remains real.
Resource and numerical boundary
The current companion-root calculation has opaque host allocations. Managed finite-memory calls refuse before model-property gathering or output publication; ordinary calls preserve cancellation checks around numerical phases.
Removing a nearby pole and zero changes the transfer function. The tolerance bounds their root distance, not the resulting frequency-response error. Ill-conditioned roots can be rejected instead of publishing a nonfinite or nonreal polynomial.
Malformed model properties and failures in the shared transfer-function parser or companion-root solver retain their RunMat:tf:* identifiers. Tolerance, unsupported input class, and pole-zero deflation errors use RunMat:minreal:* identifiers.
Example
Cancel a shared pole and zero
sys = tf([1 3 2],[1 4 3]); reduced = minreal(sys);Using minreal with coding agents
Open a RunMat example with live inputs, then ask the agent to explain how minreal changes the result.
Run a small minreal example, explain the result, then change one input and compare the output.
FAQ
What does tol control?⌄
It is the maximum absolute distance between a pole and zero eligible for cancellation. The default is sqrt(eps).
Related Control functions
Source you can read
Every RunMat function's source is public. Read exactly how minreal is executed, line by line, in Rust.
- View the source for minreal in Rust on GitHub
- Learn how the RunMat runtime works
- Found a bug? Open an issue with a minimal reproduction.
About RunMat
RunMat is a runtime that executes MATLAB-syntax code fast on any GPU. The runtime is free for individuals, including freelancers; students and faculty at an academic institution, for teaching or research there; contributors to an open-source project, for work on that project; organizations with 250 or fewer people and US$10M or less in annual revenue; and anyone, for non-production use. See runmat.com/license.
- RunMat automatically optimizes your math for GPU execution on Apple, Nvidia, and AMD hardware. No code changes needed. Simulations that took hours now take minutes.
- Start running code in seconds. RunMat runs in the browser, on the desktop, or from the CLI. No license server, no IT ticket.