ifftshift — Shift centered spectra back to origin ordering in MATLAB and RunMat.
ifftshift(X) circularly shifts data so zero-frequency components move back to origin ordering. Default and dimension-specific shifting behavior follow MATLAB semantics.
Syntax
Y = ifftshift(X)
Y = ifftshift(X, DIM)Inputs
X- Type
Any- Required
- Yes
- Description
- Numeric, complex, logical, or gpuArray input.
DIM- Type
Any- Required
- No
- Default
[]- Description
- Dimension selector (scalar, numeric vector, or logical mask vector).
Returns
Y- Type
Any- Description
- Shifted array with the same size and type family as X.
Errors
RunMat:ifftshift:ArgCount- When
- More than two input arguments are supplied.
- Message
ifftshift: invalid argument count
RunMat:ifftshift:InvalidDimensions- When
- DIM argument is malformed or out of range.
- Message
ifftshift: invalid dimension argument
RunMat:ifftshift:InvalidInput- When
- X is not a supported numeric/logical input type.
- Message
ifftshift: expected numeric or logical input
Provider and fusion contract
The provider hook advertises f32 and f64 floating precision with no broadcasting; integer and logical behavior follows the separate documented conversion or exact-reordering rules.
This operation is a fusion boundary, not an elementwise or reduction kernel. No fused FFT kernel is advertised, and provider launch details remain internal.
Behavior
When no dimensions are specified, every axis is shifted by ceil(size(X, dim) / 2).
A scalar dimension restricts shifting to one axis. RunMat additionally accepts a dimension vector or logical mask as a compatibility-gated extension.
Odd-length dimensions shift by one additional element compared with fftshift, matching MATLAB's ifftshift parity rules.
Works for real, complex, logical, and GPU-resident tensors.
Empty arrays and scalars are returned unchanged.
GPU execution
A read-only provider preflight decides whether the owning provider can admit this circshift request. A false preflight permits exact host fallback before provider effects; a failure after admission is terminal and never replayed.
GPU residency
After positive preflight, ifftshift accepts only a fresh result with matching shape, class, storage, precision, device, and ownership. Preflight-unavailable work uses one exact internal download and class-preserving restoration; admitted provider failures and malformed results are terminal.
GPU behavior
RunMat uses the owning provider's circshift hook when preflight admits the request. Otherwise it performs the reorder on the host and restores residency only when the owner can physically preserve the class. No-op scalars and empty arrays remain on their existing device without a hook call.
Examples
Undoing fftshift on an even-length spectrum
x = 0:7;
y = ifftshift(x)Expected output:
y = [4 5 6 7 0 1 2 3]Undoing fftshift on an odd-length spectrum
x = 1:5;
y = ifftshift(x)Expected output:
y = [3 4 5 1 2]Preparing data for inverse FFT
fx = fft(rand(1, 8));
centered = fftshift(fx);
restored = ifftshift(centered);
signal = ifft(restored)Shifting only selected dimensions
A = reshape(1:12, 3, 4);
rowsShifted = ifftshift(A, 1); % shift rows only
colsShifted = ifftshift(A, 2); % shift columns onlyExpected output:
rowsShifted =
2 5 8 11
3 6 9 12
1 4 7 10
colsShifted =
7 10 1 4
8 11 2 5
9 12 3 6Using ifftshift with gpuArray data
G = gpuArray(0:7);
shifted = ifftshift(G);
host = gather(shifted)Expected output:
host = [4 5 6 7 0 1 2 3]Using ifftshift with coding agents
Open a RunMat example with live inputs, then ask the agent to explain how ifftshift changes the result.
Run a small ifftshift example, explain the result, then change one input and compare the output.
FAQ
When should I call ifftshift?⌄
Call ifftshift right before ifft (or ifftn) after you have applied fftshift-based processing in the frequency domain. It restores the DC component to index 1.
Is ifftshift always the inverse of fftshift?⌄
Yes. For any supported input, ifftshift(fftshift(X)) returns X, including odd-length dimensions where the shift counts differ.
Does ifftshift modify data values?⌄
No. It only reorders elements. Magnitudes, phases, and overall content stay the same.
Can I restrict ifftshift to specific axes?⌄
Yes. Pass a dimension index, vector of indices, or logical mask exactly like in MATLAB.
Does ifftshift support gpuArray inputs?⌄
Yes. RunMat keeps GPU data on-device whenever possible and falls back to a single gather/upload cycle otherwise.
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 · 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
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 ifftshift is executed, line by line, in Rust.
- View the source for ifftshift 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.