This is a pre-release version (2.0.0.dev0+git20260907.41eeb59).Go to latest (1.18.0)
{ } Raw JSON

bundles / scipy 2.0.0.dev0+git20260907.41eeb59 / scipy / fft / _realtransforms / dstn

_Function

scipy.fft._realtransforms:dstn

source: build-install/usr/lib/python3.14/site-packages/scipy/fft/_realtransforms.py:141

Signature

def dstn(x, type = 2, s = None, axes = None, norm = None, overwrite_x = False, workers = None, orthogonalize = None)

Summary

Return multidimensional Discrete Sine Transform along the specified axes.

Parameters

x : array_like

The input array.

type : {1, 2, 3, 4}, optional

Type of the DST (see Notes). Default type is 2.

s : int or array_like of ints or None, optional

The shape of the result. If both s and axes (see below) are None, s is x.shape; if s is None but axes is not None, then s is numpy.take(x.shape, axes, axis=0). If s[i] > x.shape[i], the ith dimension of the input is padded with zeros. If s[i] < x.shape[i], the ith dimension of the input is truncated to length s[i]. If any element of shape is -1, the size of the corresponding dimension of x is used.

axes : int or array_like of ints or None, optional

Axes over which the DST is computed. If not given, the last len(s) axes are used, or all axes if s is also not specified.

norm : {"backward", "ortho", "forward"}, optional

Normalization mode (see Notes). Default is "backward".

overwrite_x : bool, optional

If True, the contents of x can be destroyed; the default is False.

workers : int, optional

Maximum number of workers to use for parallel computation. If negative, the value wraps around from os.cpu_count(). See fft for more details.

orthogonalize : bool, optional

Whether to use the orthogonalized DST variant (see Notes). Defaults to True when norm="ortho" and False otherwise.

Returns

y : ndarray of real

The transformed input array.

Notes

For full details of the DST types and normalization modes, as well as references, see dst.

Examples

import numpy as np
from scipy.fft import dstn, idstn
rng = np.random.default_rng()
y = rng.standard_normal((16, 16))
np.allclose(y, idstn(dstn(y)))
✓
True

See also

idstn

Inverse multidimensional DST

Aliases

  • scipy.fft.dstn