sawtooth — Generate a periodic sawtooth waveform with optional peak position.
y = sawtooth(t) generates a periodic sawtooth wave with period 2*pi at sample times t, ranging in [-1, 1]. y = sawtooth(t, xmax) controls the peak position using xmax in [0, 1], following MATLAB-compatible waveform conventions.
Syntax
Y = sawtooth(t)
Y = sawtooth(t, xmax)Inputs
t- Type
NumericArray- Required
- Yes
- Description
- Sample times.
xmax- Type
NumericScalar- Required
- No
- Default
1- Description
- Peak position fraction in [0, 1].
Returns
Y- Type
NumericArray- Description
- Sawtooth output sampled at t.
Errors
RunMat:sawtooth:InvalidInput- When
- Primary input is not numeric-real tensor/scalar compatible.
- Message
sawtooth: expected numeric input
RunMat:sawtooth:ComplexUnsupported- When
- Primary input includes complex values.
- Message
sawtooth: input must be real; complex values are not supported
RunMat:sawtooth:XmaxInvalid- When
- xmax argument is not a real numeric scalar.
- Message
sawtooth: xmax must be a real numeric scalar in [0, 1]
Waveform and input
Evaluation is element-wise for real scalar and N-D sample times and retains their shape. The phase is reduced modulo 2*pi for positive and negative times. At the default xmax = 1, the waveform rises from -1 and wraps to -1 at the next period boundary.
At xmax = 0.5 the piecewise-linear wave peaks at one halfway through each period. xmax = 0 selects a falling ramp; xmax = 1 selects a rising ramp. The control must be finite, scalar, and in [0, 1].
Non-finite sample times yield NaN; complex and text inputs are rejected. Double sample times are the documented compatibility form. Single, integer, and logical inputs are RunMat extensions and produce double output; typed integer controls require exact conversion at the binary64 waveform boundary.
Resident data
The current runtime has no sawtooth GPU kernel or fusion path. Interactive gpuArray input is a RunMat-only extension; admitted resident data is downloaded through its owning provider and the result is returned on the host. Automatic placement must account for this transfer.
Examples
Default rising sawtooth over two periods
t = 0:pi/2:4*pi;
y = sawtooth(t)Expected output:
y = [-1 -0.5 0 0.5 -1 -0.5 0 0.5 -1]Triangle wave via xmax = 0.5
t = linspace(0, 2*pi, 5);
y = sawtooth(t, 0.5)Expected output:
y = [-1 0 1 0 -1]Pure falling sawtooth via xmax = 0
y = sawtooth([0 pi 2*pi], 0)Expected output:
y = [1 0 1]Using sawtooth with coding agents
Open a RunMat example with live inputs, then ask the agent to explain how sawtooth changes the result.
Run a small sawtooth example, explain the result, then change one input and compare the output.
FAQ
Why does sawtooth(2*pi) return -1 instead of +1?⌄
RunMat reduces the input modulo 2*pi, so 2*pi is folded back to the start of the next period. The default rising sawtooth therefore restarts at -1 exactly on each period boundary, matching MATLAB.
How do I produce a triangle wave?⌄
Pass xmax = 0.5 so the peak sits at the centre of each period and the waveform ramps symmetrically up and back down.
Can sawtooth accept complex inputs?⌄
No. sawtooth is defined on real samples and rejects complex inputs with a builtin-scoped error to match MATLAB.
Related Math functions
Signal
blackman · butter · buttord · cheb2ord · conv · conv2 · deconv · downsample · envelope · filter · filtfilt · fir1 · freqz · gauspuls · hamming · hann · hilbert · periodogram · pulstran · pwelch · rectpuls · resample · sinc · spectrogram · square · tripuls · unwrap · upsample · zplane
Elementwise
abs · angle · besselj · bsxfun · complex · conj · double · eps · erf · erfcinv · exp · expm1 · flintmax · gamma · gammaln · heaviside · hypot · imag · int16 · int32 · int64 · int8 · intmax · intmin · ldivide · log · log10 · log1p · log2 · minus · nextpow2 · plus · pow2 · power · rdivide · real · realmax · realmin · realsqrt · rescale · sign · single · sqrt · times · typecast · uint16 · uint32 · uint64 · uint8
Optim
acceptancesa · annealingboltz · annealingfast · coneprog · crossoverarithmetic · crossoverheuristic · crossoverintermediate · crossoverlaplace · crossoverscattered · crossoversinglepoint · crossovertwopoint · eqnproblem · EquationProblem.solve · EquationProblem.subsasgn · EquationProblem.subsref · evaluate · fgoalattain · fitscalingprop · fitscalingrank · fitscalingshiftlinear · fitscalingtop · fminbnd · fmincon · fminimax · fminsearch · fminunc · fseminf · fsolve · fzero · ga · gacreationlinearfeasible · gacreationnonlinearfeasible · gacreationsobol · gacreationuniform · gacreationuniformint · gaplotbestf · gaplotbestindiv · gaplotdistance · gaplotexpectation · gaplotgenealogy · gaplotmaxconstr · gaplotrange · gaplotscorediversity · gaplotscores · gaplotselection · gaplotstopping · integerConstraint · integral · intlinprog · linprog · lsqcurvefit · lsqlin · LsqlinWarmStart.subsasgn · LsqlinWarmStart.subsref · lsqnonlin · lsqnonneg · mutationadaptfeasible · mutationgaussian · mutationpositivebasis · mutationpower · mutationuniform · optimexpr · optimget · OptimizationConstraint.evaluate · OptimizationConstraint.subsasgn · OptimizationConstraint.subsref · OptimizationExitflag.double · OptimizationExitflag.eq · OptimizationExitflag.ne · OptimizationExitflag.string · OptimizationExpression.acos · OptimizationExpression.acosh · OptimizationExpression.acot · OptimizationExpression.acoth · OptimizationExpression.acsc · OptimizationExpression.acsch · OptimizationExpression.asec · OptimizationExpression.asech · OptimizationExpression.asin · OptimizationExpression.asinh · OptimizationExpression.atan · OptimizationExpression.atanh · OptimizationExpression.cat · OptimizationExpression.cos · OptimizationExpression.cosh · OptimizationExpression.cot · OptimizationExpression.coth · OptimizationExpression.csc · OptimizationExpression.csch · OptimizationExpression.ctranspose · OptimizationExpression.cumprod · OptimizationExpression.cumsum · OptimizationExpression.diag · OptimizationExpression.diff · OptimizationExpression.dot · OptimizationExpression.eq · OptimizationExpression.evaluate · OptimizationExpression.exp · OptimizationExpression.ge · OptimizationExpression.horzcat · OptimizationExpression.ldivide · OptimizationExpression.le · OptimizationExpression.log · OptimizationExpression.mean · OptimizationExpression.minus · OptimizationExpression.mldivide · OptimizationExpression.mpower · OptimizationExpression.mrdivide · OptimizationExpression.mtimes · OptimizationExpression.norm · OptimizationExpression.plus · OptimizationExpression.power · OptimizationExpression.prod · OptimizationExpression.rdivide · OptimizationExpression.reshape · OptimizationExpression.sec · OptimizationExpression.sech · OptimizationExpression.sin · OptimizationExpression.sinh · OptimizationExpression.sqrt · OptimizationExpression.subsasgn · OptimizationExpression.subsref · OptimizationExpression.sum · OptimizationExpression.tan · OptimizationExpression.tanh · OptimizationExpression.times · OptimizationExpression.trace · OptimizationExpression.transpose · OptimizationExpression.uminus · OptimizationExpression.uplus · OptimizationExpression.vertcat · OptimizationExpression.zeros · OptimizationExpression.zerosLike · OptimizationProblem.solve · OptimizationProblem.subsasgn · OptimizationProblem.subsref · OptimizationVariable.subsasgn · OptimizationVariable.subsref · optimoptions · optimplotconstrviolation · optimplotfirstorderopt · optimplotfunccount · optimplotfval · optimplotfvalconstr · optimplotmilp · optimplotstepsize · optimplotx · optimproblem · optimset · optimvar · optimwarmstart · particleswarm · patternsearch · psplotbestf · psplotbestx · psplotfuncount · psplotmaxconstr · psplotmeshsize · pswcreationuniform · pswplotbestf · quad · quadprog · QuadprogWarmStart.subsasgn · QuadprogWarmStart.subsref · saplotbestf · saplotbestx · saplotf · saplotstopping · saplottemperature · saplotx · savemilpsolutions · secondordercone · selectionremainder · selectionroulette · selectionstochunif · selectiontournament · selectionuniform · simulannealbnd · solve · surrogateopt · surrogateoptplot · temperatureboltz · temperatureexp · temperaturefast
Trigonometry
acos · acosd · acosh · acotd · acscd · asecd · asin · asind · asinh · atan · atan2 · atan2d · atand · atanh · cos · cosd · cosh · cospi · deg2rad · pol2cart · rad2deg · sin · sind · sinh · sinpi · tan · tand · tanh
Reduction
all · any · bounds · cummax · cummin · cumprod · cumsum · cumtrapz · diff · gradient · max · maxk · mean · median · min · mink · movmax · movmean · movmedian · movmin · movprod · movstd · movsum · movvar · nnz · prod · rms · std · sum · trapz · var
Structure
bandwidth · isdiag · ishermitian · issymmetric · istril · istriu · symrcm
Factor
chol · decomposition · decomposition.ctranspose · decomposition.mldivide · decomposition.mrdivide · decomposition.mtimes · decomposition.rdivide · decomposition.subsref · decomposition.times · decomposition.uminus · decomposition.uplus · eig · eigs · gmres · ichol · ilu · lu · ordeig · ordqz · ordschur · pcg · qr · qz · rsf2csf · schur · svd
Ops
cross · ctranspose · dot · mldivide · mpower · mrdivide · mtimes · pagemtimes · pagetranspose · trace · transpose
Interpolation
griddedInterpolant · griddedInterpolant.subsref · interp1 · interp1q · interp2 · pchip · ppval · spline
Integer Division
Source you can read
Every RunMat function's source is public. Read exactly how sawtooth is executed, line by line, in Rust.
- View the source for sawtooth 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.