evalfr — Evaluate a SISO transfer function at one complex s- or z-plane point.
evalfr(sys,x) evaluates a scalar, zero-delay tf model at x in the continuous s plane or discrete z plane. A discrete model with unspecified sample period can still be evaluated at an explicit z point. Forward and inverse discrete coefficient conventions are honored. The current implementation accepts a finite host scalar point and returns a real or complex double scalar. State-space, model arrays, delays and generalized models remain unsupported.
Syntax
frsp = evalfr(sys,x)Inputs
sys- Type
Any- Required
- Yes
- Default
- —
- Description
- Scalar SISO tf model.
x- Type
Any- Required
- Yes
- Default
- —
- Description
- Finite scalar point in the continuous s plane or discrete z plane.
Returns
frsp- Type
Any- Description
- Real or complex double response scalar.
Errors
RunMat:evalfr:InvalidArgument- When
- Point or invocation is invalid, singular, or cannot produce a finite response.
- Message
evalfr: invalid argument
RunMat:evalfr:UnsupportedModel- When
- The model is outside the supported zero-delay SISO tf domain.
- Message
evalfr: unsupported model
RunMat:evalfr:InvalidModel- When
- A required transfer-function property is malformed.
- Message
evalfr: invalid model
Point semantics
For continuous-time frequency response at angular frequency w, pass 1i*w; for discrete time pass exp(1i*w*Ts). evalfr does not interpret x as a frequency by itself. Exact poles at x and unrepresentable finite response are errors.
Execution
The canonical transfer-function polynomial evaluator runs on the host. A context-bound finite operation without a complete output owner rejects before gathering model properties; the unbounded path may gather resident model properties through their provider.
Example
Evaluate a continuous transfer function
H = tf(2,[1 3]); y = evalfr(H,1i);Using evalfr with coding agents
Open a RunMat example with live inputs, then ask the agent to explain how evalfr changes the result.
Run a small evalfr example, explain the result, then change one input and compare the output.
FAQ
Does evalfr accept a frequency in rad/s directly?⌄
No. Supply the matching s- or z-plane point; use freqresp for a frequency vector.
Related Control functions
Source you can read
Every RunMat function's source is public. Read exactly how evalfr is executed, line by line, in Rust.
- View the source for evalfr 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.