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.
Returns
Y- Type
NumericArray- Description
- Elementwise 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
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 = 1Evaluate 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 scalarCompare 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 precisionConvert 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 arrayUsing 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
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
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
Related guides
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.