sin — Compute elementwise sine values in radians.
sin evaluates the radian sine of supported real or complex values while preserving shape and floating-point class.
Syntax
Y = sin(X)
Y = sin(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 sine result.
Errors
RunMat:sin:TooManyOutputs- When
- More than one output is requested.
- Message
sin: too many output arguments
RunMat:sin:InvalidInput- When
- Input cannot be interpreted as supported numeric, logical, character, or complex data.
- Message
sin: invalid input
RunMat:sin:InvalidOption- When
- Optional arguments after X are malformed or unsupported.
- Message
sin: invalid option
Behavior
sin(X) evaluates the sine 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 sin(a + bi) = sin(a)cosh(b) + i cos(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 sin(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 sine operation when available, and the fusion planner can combine sin 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 sine of a scalar
y = sin(pi / 2)Expected output:
y = 1Evaluate several angles in radians
angles = [0 pi/6 pi/4 pi/3];
values = sin(angles)Expected output:
values = [0 0.5000 0.7071 0.8660]Evaluate a complex angle
z = sin(1 + 2i)Expected output:
z = 3.1658 + 1.9596iEvaluate a single-precision matrix on a provider
G = gpuArray(single([0 pi/2; pi 3*pi/2]));
result = gather(sin(G))Expected output:
result is a 2-by-2 single matrixRequest provider residency with a prototype
prototype = gpuArray(single(0));
deviceResult = sin(single([0 pi/2]), "like", prototype);
result = gather(deviceResult)Expected output:
result = single([0 1])Using sin with coding agents
Open a RunMat example with live inputs, then ask the agent to explain how sin changes the result.
Run a small sin example, explain the result, then change one input and compare the output.
FAQ
When should I use sin?⌄
Use sin for elementwise periodic calculations in signals, controls, geometry, simulation, and other numerical work expressed in radians.
Does sin use radians or degrees?⌄
sin uses radians. Use sind for degree input or convert with deg2rad.
Does sin preserve single precision?⌄
Yes. Real and complex single inputs return single; double inputs return double.
Does sin support complex values?⌄
Yes. Floating complex values use the analytic sine and preserve their floating class.
Can sin 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 sin 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 sine?⌄
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 · cos · cosd · cosh · cospi · deg2rad · pol2cart · rad2deg · 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 sin is executed, line by line, in Rust.
- View the source for sin 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.