cos — Compute elementwise cosine values in radians.
cos evaluates the radian cosine of supported real or complex values while preserving shape and floating-point class.
Syntax
Y = cos(X)
Y = cos(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 cosine result.
Errors
RunMat:cos:TooManyOutputs- When
- More than one output is requested.
- Message
cos: too many output arguments
RunMat:cos:InvalidInput- When
- Input cannot be interpreted as supported numeric, logical, character, or complex data.
- Message
cos: invalid input
RunMat:cos:InvalidOption- When
- Optional arguments after X are malformed or unsupported.
- Message
cos: invalid option
Behavior
cos(X) evaluates the cosine 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 cos(a + bi) = cos(a)cosh(b) - i sin(a)sinh(b). The operation retains complex output and propagates non-finite components according to 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 cos(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 cosine operation when available, and the fusion planner can combine cos 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 cosine of zero
y = cos(0)Expected output:
y = 1Evaluate evenly spaced angles
theta = linspace(0, 2*pi, 5);
values = cos(theta)Expected output:
values = [1 0 -1 0 1]Evaluate a complex angle
z = cos(1 + 2i)Expected output:
z = 2.0327 - 3.0519iEvaluate a matrix elementwise
A = reshape(0:5, [3 2]);
result = cos(A)Expected output:
result is a 3-by-2 matrixRequest provider residency with a prototype
prototype = gpuArray(single(0));
deviceResult = cos(single([0 pi/2 pi]), "like", prototype);
result = gather(deviceResult)Expected output:
result = single([1 0 -1])Request host output for provider input
G = gpuArray([0 1 2]);
hostResult = cos(G, "like", zeros(1, "double"))Expected output:
hostResult = [1 0.5403 -0.4161]Using cos with coding agents
Open a RunMat example with live inputs, then ask the agent to explain how cos changes the result.
Run a small cos example, explain the result, then change one input and compare the output.
FAQ
When should I use cos?⌄
Use cos for elementwise cosine calculations on angles expressed in radians.
Does cos use radians or degrees?⌄
cos uses radians. Use cosd for degree input or convert with deg2rad.
Does cos preserve single precision?⌄
Yes. Real and complex single inputs return single; double inputs return double.
Does cos support complex values?⌄
Yes. Floating complex values use the analytic cosine and preserve their floating class.
Can cos accept integer input?⌄
In RunMat compatibility mode, all eight real integer classes are accepted when every value is exactly representable as binary64. The result is double.
Can cos accept logical or character arrays?⌄
Yes in RunMat compatibility mode. Logical values and Unicode character code points produce shape-preserving double results.
What if a provider lacks unary cosine?⌄
RunMat gathers through the owning provider, evaluates the host implementation, and applies any explicit "like" placement request.
What does the like prototype control?⌄
The RunMat-only form controls host/provider residency and real/complex representation. The input determines the computation class.
Related Math functions
Trigonometry
acos · acosd · acosh · acotd · acscd · asecd · asin · asind · asinh · atan · atan2 · atan2d · atand · atanh · cosd · cosh · cospi · deg2rad · pol2cart · rad2deg · sin · sind · sinh · sinpi · tan · 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 cos is executed, line by line, in Rust.
- View the source for cos 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.