bode — Compute or plot SISO transfer-function magnitude and phase.
[mag,phase,wout] = bode(sys,w) evaluates a scalar, zero-delay tf model. Discrete models require a known positive sample period. Magnitude is absolute (not dB); unwrapped phase is in degrees. Both response arrays have size 1-by-1-by-N and wout is a column in rad/s. Statement form draws magnitude in dB and phase on logarithmic frequency axes when plotting is available. MIMO/state-space/model-array, delay, multiple-system and LineSpec forms are not yet supported.
Syntax
bode(sys)
bode(sys,w)
mag = bode(sys,w)
[mag,phase] = bode(sys,w)
[mag,phase,wout] = bode(sys,w)
[mag,phase,wout] = bode(sys)Inputs
sys- Type
Any- Required
- Yes
- Default
- —
- Description
- Scalar SISO tf model.
w- Type
NumericArray- Required
- No
- Default
- —
- Description
- Finite nonnegative angular-frequency vector.
Returns
mag- Type
NumericArray- Description
- Absolute magnitude, 1×1×N.
phase- Type
NumericArray- Description
- Unwrapped phase in degrees, 1×1×N.
wout- Type
NumericArray- Description
- Angular-frequency column vector.
Returned values from bode depend on how many outputs the caller requests.
Errors
RunMat:bode:InvalidArgument- When
- Invocation or frequency vector is invalid, singular, or cannot produce a finite response.
- Message
bode: invalid argument
RunMat:bode:InvalidModel- When
- A transfer-function property is malformed.
- Message
bode: invalid model
RunMat:bode:UnsupportedModel- When
- The model is outside the supported zero-delay SISO tf domain.
- Message
bode: unsupported model
Frequency and phase
Continuous models are evaluated on s=1i*w; discrete models on z=exp(1i*w*Ts). An omitted frequency vector uses a deterministic grid derived from poles and zeros. Phase is unwrapped in source frequency order; supply an ordered grid for the usual continuous plot.
Execution
The shared host transfer-function evaluator computes the numeric response. Context-bound finite execution without a complete output owner rejects before model-property gathering. Statement-form plotting may suspend and uses the existing plotting service; numeric outputs have no UI effect.
Example
Magnitude and phase at one radian per second
H = tf(1,[1 1]); [mag,phase,w] = bode(H,1);Using bode with coding agents
Open a RunMat example with live inputs, then ask the agent to explain how bode changes the result.
Run a small bode example, explain the result, then change one input and compare the output.
FAQ
Are returned magnitudes in decibels?⌄
No. Numeric mag is absolute; only the statement-form plot converts magnitude to dB.
Related Control functions
Source you can read
Every RunMat function's source is public. Read exactly how bode is executed, line by line, in Rust.
- View the source for bode 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.