sign — Compute elementwise sign values for real and complex input.
sign(X) returns real sign values or complex unit directions while preserving documented numeric classes and shape.
Syntax
Y = sign(X)Inputs
X- Type
Any- Required
- Yes
- Description
- Real numeric, logical, character, or floating-point complex input.
Returns
Y- Type
NumericArray- Description
- Elementwise sign result. Numeric inputs retain their class; logical and character inputs return double.
Errors
RunMat:sign:InvalidInput- When
- Input is not a supported numeric, logical, or character value.
- Message
sign: invalid input
RunMat:sign:Internal- When
- Internal tensor construction or provider interaction fails.
- Message
sign: internal error
Behavior
Y = sign(X) maps real values to -1, 0, or 1 and normalizes nonzero complex floating values as X ./ abs(X). Complex zero remains complex zero; NaN propagates; positive and negative infinity map to 1 and -1.
All eight fixed-width integer classes preserve class and shape and are transformed directly in native storage without overflow. Signed values map to -1, 0, or 1; unsigned values map to 0 or 1.
Logical and character input returns double results. Strings are unsupported. Complex values with infinite components normalize to their unit direction.
GPU execution
Providers with unary sign support keep real and complex-interleaved tensors resident, including complex unit normalization.
Typed unsupported operations gather through the exact owner, apply the same CPU contract, and restore representable output. Integer fallback preserves exact fixed-width class. Fusion can combine supported elementwise work.
Examples
Find the sign of a scalar
result = sign(-42)Expected output:
result = -1Apply sign to mixed real values
v = [-3 -0.0 0 2 5];
s = sign(v)Expected output:
s = [-1 0 0 1 1]Normalize complex values to unit magnitude
z = [3+4i -1+1i 0+0i];
u = sign(z)Expected output:
u = [0.6+0.8i -0.7071+0.7071i 0]Apply sign to character code points
codes = sign('RunMat')Expected output:
codes = [1 1 1 1 1 1]Apply sign to a logical mask
mask = [false true false; true false true];
numeric = sign(mask)Expected output:
numeric = [0 1 0; 1 0 1]Apply sign to provider-resident data
G = gpuArray([-3 0; 2 -1]);
S = sign(G);
host = gather(S)Expected output:
host = [-1 0; 1 -1]Handle infinities and NaN
values = [Inf -Inf NaN 0];
out = sign(values)Expected output:
out = [1 -1 NaN 0]Using sign with coding agents
Open a RunMat example with live inputs, then ask the agent to explain how sign changes the result.
Run a small sign example, explain the result, then change one input and compare the output.
FAQ
Does sign change NaN?⌄
No. NaN propagates under IEEE rules.
How does sign handle complex zero?⌄
Complex zero remains complex zero; other complex values normalize to the unit circle.
What happens for infinite complex components?⌄
RunMat returns the corresponding unit direction, including diagonal directions when both components are infinite.
Can I call sign on strings?⌄
No. sign accepts numeric, logical, or character arrays.
Does sign allocate?⌄
It returns a new value; fusion can avoid materializing an intermediate.
Does GPU execution match CPU behavior?⌄
Yes within the provider precision, including NaN propagation and zero handling.
Can sign participate in fusion?⌄
Yes. Supported elementwise sign operations can be folded into neighboring kernels.
How do I keep the result on the GPU?⌄
Avoid gather until host data is required; supported outputs remain resident.
Related Math functions
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 · 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
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 · tan · tand · tanh
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
Source you can read
Every RunMat function's source is public. Read exactly how sign is executed, line by line, in Rust.
- View the source for sign 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.