RunMat
  • Pricing
RunMat
GitHub
GitHub
Sign inTry in browser
DesktopRuntimePhysicsCADAdministrationAgent

Get RunMat updates

New releases, guides and examples.

Product+
  • Runtime
  • GPU
  • Parallel
  • Compile
  • Interop and MEX
  • Simulation
  • MCAD
  • ECAD
  • Enterprise
  • AI integrations
  • Pricing
  • Download
Math+
  • Signal processing
  • Linear algebra
  • Statistics
  • Curve fitting
  • Differential equations
  • Control systems
  • Optimization
  • Finance
  • Data and tables
  • Plotting
Physics+
  • Simulation overview
  • Structural
  • Thermal
  • Electromagnetic
  • Joule heating
  • Thermal stress
  • Acoustics
  • Fluid flow
  • Conjugate heat transfer
  • Fluid–structure
  • What is FEA
Industries+
  • Aerospace
  • Automotive and transportation
  • Defense
  • Electronics and semiconductors
  • Energy
  • Industrial machinery
  • Life sciences
  • Quantitative finance
Learn+
  • Guides
  • Docs
  • Function reference
  • Language reference
  • Migration guide
  • Changelog
  • MATLAB Online
  • MATLAB AI agent
  • For students
Compare+
  • RunMat vs MATLAB
  • RunMat vs Ansys
  • RunMat vs SOLIDWORKS
  • RunMat vs Altium
  • RunMat vs Cadence
  • RunMat vs COMSOL
  • RunMat vs Python
  • RunMat vs Julia
  • RunMat vs Physics AI
  • RunMat vs Octave
  • Benchmarks
  • MATLAB alternatives
  • All comparisons
Company+
  • About
  • Blog
  • Contact
  • Source code↗
  • License
  • Privacy
  • Terms

Product

  • Runtime
  • GPU
  • Parallel
  • Compile
  • Interop and MEX
  • Simulation
  • MCAD
  • ECAD
  • Enterprise
  • AI integrations
  • Pricing
  • Download

Math

  • Signal processing
  • Linear algebra
  • Statistics
  • Curve fitting
  • Differential equations
  • Control systems
  • Optimization
  • Finance
  • Data and tables
  • Plotting

Physics

  • Simulation overview
  • Structural
  • Thermal
  • Electromagnetic
  • Joule heating
  • Thermal stress
  • Acoustics
  • Fluid flow
  • Conjugate heat transfer
  • Fluid–structure
  • What is FEA

Industries

  • Aerospace
  • Automotive and transportation
  • Defense
  • Electronics and semiconductors
  • Energy
  • Industrial machinery
  • Life sciences
  • Quantitative finance

Learn

  • Guides
  • Docs
  • Function reference
  • Language reference
  • Migration guide
  • Changelog
  • MATLAB Online
  • MATLAB AI agent
  • For students

Compare

  • RunMat vs MATLAB
  • RunMat vs Ansys
  • RunMat vs SOLIDWORKS
  • RunMat vs Altium
  • RunMat vs Cadence
  • RunMat vs COMSOL
  • RunMat vs Python
  • RunMat vs Julia
  • RunMat vs Physics AI
  • RunMat vs Octave
  • Benchmarks
  • MATLAB alternatives
  • All comparisons

Company

  • About
  • Blog
  • Contact
  • Source code↗
  • License
  • Privacy
  • Terms
GitHubXLinkedIn

© Dystr, Inc. · RunMat v0.7.1, Nov 17, 2026

RunMat® is a registered trademark of Dystr, Inc. MATLAB® is a registered trademark of The MathWorks, Inc. RunMat is not affiliated with, endorsed by, or sponsored by The MathWorks, Inc.

/
See all docs
Builtin Reference
    • 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

tan — Compute elementwise tangent values in radians.

tan evaluates the radian tangent of supported real or complex values while preserving shape and floating-point class.

Syntax

Y = tan(X)
Y = tan(X, "like", P)

Inputs

X
Type
Any
Required
Yes
Description
Single or double real/complex input; integer, logical, and character forms are RunMat-only extensions.
like
Type
StringScalar
Required
Yes
Default
"like"
Description
RunMat output-representation selector.
P
Type
LikePrototype
Required
Yes
Description
Prototype selecting host or provider residency and real or complex representation.
NameTypeRequiredDefaultDescription
XAnyYes—Single or double real/complex input; integer, logical, and character forms are RunMat-only extensions.
likeStringScalarYes"like"RunMat output-representation selector.
PLikePrototypeYes—Prototype selecting host or provider residency and real or complex representation.

Returns

Y
Type
NumericArray
Description
Elementwise tangent result.
NameTypeDescription
YNumericArrayElementwise tangent result.

Errors

RunMat:tan:TooManyOutputs
When
More than one output is requested.
Message
tan: too many output arguments
RunMat:tan:InvalidInput
When
Input cannot be interpreted as supported numeric, logical, character, or complex data.
Message
tan: invalid input
RunMat:tan:InvalidOption
When
Optional arguments after X are malformed or unsupported.
Message
tan: invalid option
IdentifierWhenMessage
RunMat:tan:TooManyOutputsMore than one output is requested.tan: too many output arguments
RunMat:tan:InvalidInputInput cannot be interpreted as supported numeric, logical, character, or complex data.tan: invalid input
RunMat:tan:InvalidOptionOptional arguments after X are malformed or unsupported.tan: invalid option
RunMat:tan:ArgCountToo many input arguments were supplied.tan: too many input arguments
RunMat:tan:LikePrototypeThe "like" prototype is unsupported for this output conversion path.tan: invalid "like" prototype
RunMat:tan:GpuUnavailableProvider output was requested through "like" but no active provider is available.tan: GPU provider unavailable
RunMat:tan:InternalInternal tensor conversion, allocation, or provider execution failed.tan: internal error

Behavior

tan(X) evaluates the tangent of each element in radians. Scalar, vector, matrix, empty, and N-D shapes are preserved. Real and complex single inputs return single; real and complex double inputs return double.

Complex inputs use tan(a + bi) = sin(2a)/(cos(2a) + cosh(2b)) + i sinh(2b)/(cos(2a) + cosh(2b)). Values near odd multiples of pi/2 can have very large magnitudes because floating-point pi/2 is an approximation to a pole; non-finite components follow floating-point arithmetic.

RunMat extensions

In runmat compatibility mode, real fixed-width integers, logical arrays, and character arrays are accepted. Integer values must be exactly representable at the binary64 transcendental boundary and return double; logical values and Unicode character code points also return shape-preserving double results.

The tan(X, "like", P) form is also a RunMat extension. The prototype selects host or provider residency and real or complex representation. It does not silently override the computation class established by X.

Execution placement

When acceleration is available, RunMat may place eligible work on the active provider without an explicit gpuArray call. Real floating provider-resident inputs use the provider's unary tangent operation when available, and the fusion planner can combine tan with neighboring elementwise operations to avoid intermediate transfers.

Unsupported provider representations gather through their owning provider. The host result returns to the source provider when that provider can represent its class; an explicit "like" prototype instead applies the requested host/provider and real/complex representation after evaluation. Manual gpuArray and gather calls remain available when a program needs an explicit residency boundary.

Sparse, string, table, timetable, tall, and unsupported object inputs are not accepted by this implementation.

Examples

Compute the tangent of pi over four

y = tan(pi/4)

Expected output:

y = 1

Evaluate a vector away from the poles

theta = linspace(-pi/2 + 0.1, pi/2 - 0.1, 5);
wave = tan(theta)

Expected output:

wave = [-9.9666 -0.9047 0 0.9047 9.9666]

Evaluate a matrix on a provider

G = gpuArray([0 pi/6; pi/4 pi/3]);
T = tan(G);
result = gather(T)

Expected output:

result = [0 0.5774; 1.0000 1.7321]

Evaluate a complex angle

z = 1 + 0.5i;
tz = tan(z)

Expected output:

tz is a complex scalar

Compare tangent with a small-angle approximation

angles = [-1e-6 0 1e-6];
approx = tan(angles)

Expected output:

approx = [-1e-6 0 1e-6] to displayed precision

Convert degrees before evaluating tangent

anglesInDegrees = [0 30 60 89];
radians = deg2rad(anglesInDegrees);
result = tan(radians)

Expected output:

result = [0 0.5774 1.7321 57.2900]

Request provider-resident single output

prototype = gpuArray(single(0));
angles = gpuArray(single([0 pi/6 pi/4]));
deviceResult = tan(angles, "like", prototype);
result = gather(deviceResult)

Expected output:

result = single([0 0.5774 1.0000])

Evaluate Unicode character code points

codes = tan('ABC')

Expected output:

codes is a 1-by-3 double array

Using tan with coding agents

Open a RunMat example with live inputs, then ask the agent to explain how tan changes the result.

Run a small tan example, explain the result, then change one input and compare the output.

FAQ

When should I use tan?⌄

Use tan for elementwise tangent calculations on angles expressed in radians.

What happens near odd multiples of pi over two?⌄

Those angles are poles of tangent. Floating-point inputs near a pole produce large finite magnitudes or non-finite results according to the represented value.

Does tan support complex values?⌄

Yes. Floating complex values use the analytic tangent and preserve their floating class.

Can tan keep its result on a provider?⌄

Yes. A provider unary operation or fused kernel can keep the result resident. Unsupported hooks gather through the owner, compute on the host, and restore the declared placement.

Does tan use radians or degrees?⌄

tan uses radians. Convert degree input with deg2rad, or use tand where appropriate.

Does tan preserve single precision?⌄

Yes. Real and complex single inputs return single; double inputs return double. RunMat-only integer, logical, and character inputs return double.

Can tan accept logical or character arrays?⌄

Yes in RunMat compatibility mode. Logical values and Unicode character code points produce shape-preserving double results.

Can tan be fused with neighboring operations?⌄

Yes. Eligible elementwise expressions can use a fused provider kernel, avoiding intermediate host transfers and allocations.

Related Math functions

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 · tand · tanh

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

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

Bitwise

bitand · bitcmp · bitget · bitor · bitset · bitshift · bitxor · swapbytes

Signal

blackman · butter · buttord · cheb2ord · conv · conv2 · deconv · downsample · envelope · filter · filtfilt · fir1 · freqz · gauspuls · hamming · hann · hilbert · periodogram · pulstran · pwelch · rectpuls · resample · sawtooth · sinc · spectrogram · square · tripuls · unwrap · upsample · zplane

Rounding

ceil · fix · floor · mod · rem · round

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

Solve

cond · det · inv · linsolve · norm · null · pinv · rank · rcond · rref · vecnorm

Ops

cross · ctranspose · dot · mldivide · mpower · mrdivide · mtimes · pagemtimes · pagetranspose · trace · transpose

Symbolic

digits · int · limit · piecewise · sym · syms · vpa

Discrete

factor · factorial · gcd · isprime · lcm · primes

Fft

fft · fft2 · fftn · fftshift · ifft · ifft2 · ifftn · ifftshift

Interpolation

griddedInterpolant · griddedInterpolant.subsref · interp1 · interp1q · interp2 · pchip · ppval · spline

Integer Division

idivide

Ode

ode15s · ode23 · ode45 · odeset

Poly

poly · polyder · polyfit · polyint · polyval · roots

Related guides

  • GPU execution

Source you can read

Every RunMat function's source is public. Read exactly how tan is executed, line by line, in Rust.

  • View the source for tan 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.

Getting started · Benchmarks · Pricing

Download RunMat

Download RunMat for full performance, or use RunMat in your browser for zero setup.

Download RunMatOpen Sandbox
On this page
  • Syntax
  • Inputs
  • Returns
  • Errors
  • Behavior
  • RunMat extensions
  • Execution placement
  • Examples
  • Compute the tangent of pi over four
  • Evaluate a vector away from the poles
  • Evaluate a matrix on a provider
  • Evaluate a complex angle
  • Compare tangent with a small-angle approximation
  • Convert degrees before evaluating tangent
  • Request provider-resident single output
  • Evaluate Unicode character code points
  • Using tan with coding agents
  • FAQ
  • Related Math functions
  • Trigonometry
  • Elementwise
  • Optim
  • Reduction
  • Structure
  • Bitwise
  • Signal
  • Rounding
  • Factor
  • Solve
  • Ops
  • Symbolic
  • Discrete
  • Fft
  • Interpolation
  • Integer Division
  • Ode
  • Poly
  • Related guides
  • Source you can read
  • About RunMat