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

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.
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 cosine result.
NameTypeDescription
YNumericArrayElementwise 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
IdentifierWhenMessage
RunMat:cos:TooManyOutputsMore than one output is requested.cos: too many output arguments
RunMat:cos:InvalidInputInput cannot be interpreted as supported numeric, logical, character, or complex data.cos: invalid input
RunMat:cos:InvalidOptionOptional arguments after X are malformed or unsupported.cos: invalid option
RunMat:cos:ArgCountToo many input arguments were supplied.cos: too many input arguments
RunMat:cos:LikePrototypeThe "like" prototype is unsupported for this output conversion path.cos: invalid "like" prototype
RunMat:cos:GpuUnavailableProvider output was requested through "like" but no active provider is available.cos: GPU provider unavailable
RunMat:cos:InternalInternal tensor conversion, allocation, or provider execution failed.cos: internal error

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 = 1

Evaluate 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.0519i

Evaluate a matrix elementwise

A = reshape(0:5, [3 2]);
result = cos(A)

Expected output:

result is a 3-by-2 matrix

Request 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

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 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.

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 cosine of zero
  • Evaluate evenly spaced angles
  • Evaluate a complex angle
  • Evaluate a matrix elementwise
  • Request provider residency with a prototype
  • Request host output for provider input
  • Using cos 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