WOLFRAM

Wolfram Language & System Documentation Center
Wolfram Language Home Page »

ArrayResample
✖
ArrayResample

✖
ArrayResample[array,{n1,n2,…}]

resamples array to have dimensions {n1,n2,…}.

✖
ArrayResample[array,dspec]

resamples array according to the dimension specification dspec.

✖
ArrayResample[array,dspec,scheme]

specifies resampling scheme, either point or bin based.

✖
ArrayResample[array,dspec,scheme,{{xmin,xmax},…}]

resamples only the data in the specified subrange {{xmin,xmax},…}.

Details and Options

  • ArrayResample can be used for resampling data arrays based on a large selection of interpolation and approximation models.
  • ArrayResample works with data arrays of any depth.
  • The dimension specification dspec can be of the form:
  • nn samples
    Scaled[s]rescale sampling resolution by factor s
    Allpreserve dimension
    Automaticpreserve dimension ratios
    {dspec1,…,dspeck}resample up to the ^(th) dimension
  • For a multidimensional array, the notation n is taken to be equivalent to {n,Automatic,…} and {n} equivalent to {n,All,…}.
  • The dimension ratios for an array of dimensions is taken to be .
  • The scheme determines the location of sample and resample positions and can be of the form:
  • "Point"point sampling (default)
    "Bin"bin sampling
    {"Bin",alignment}bin sampling with specified alignment
  • For input data of length n the "Point" resampling scheme assumes a data range from 1 to n and the "Bin" scheme assumes a data range from 0 to n with the alignment indicating the sample location within each bin.
  • Bin alignment alignment can be Left, Center, Right or any number between (Left) and 1 (Right).
  • The data range can be modified using the DataRange option.
  • By default, the data is resampled on the entire data domain, ranging from 1 to for the "Point" scheme and from 0 to for the "Bin" scheme. Use the DataRange option to modify the coordinates of the data domain.
  • With a subrange {{xmin,xmax},…} specified with respect to the DataRange, only the data values in the given interval are resampled. »
  • The following options can be given:
  • Antialiasing Falseapply antialiasing when downsampling
    DataRange Automaticrange of the input data
    Padding "Fixed"padding method
    Resampling Automaticresampling method
  • For possible settings for Padding, see the reference page for ArrayPad.

Examples

open allclose all

Basic Examples  (2)Summary of the most common use cases

Subsample an array:

In[1]:=1
✖
https://wolfram.com/xid/0mlcadhb2qbe-1dcwws
Out[1]=1

Downsample an array:

In[2]:=2
✖
https://wolfram.com/xid/0mlcadhb2qbe-60lkwk
Out[2]=2

Resize a 2D array of data:

In[1]:=1
✖
https://wolfram.com/xid/0mlcadhb2qbe-vrwnud

Scope  (8)Survey of the scope of standard use cases

Basic Uses  (4)

Exact computation:

In[1]:=1
✖
https://wolfram.com/xid/0mlcadhb2qbe-wbpyof
Out[1]=1

Precision of the input is preserved:

In[1]:=1
✖
https://wolfram.com/xid/0mlcadhb2qbe-ferdip
Out[1]=1

Resizing a symbolic array:

In[1]:=1
✖
https://wolfram.com/xid/0mlcadhb2qbe-6t2t7j
Out[1]=1

Resample a subdomain of the input signal:

In[1]:=1
✖
https://wolfram.com/xid/0mlcadhb2qbe-wsfnvr
In[2]:=2
✖
https://wolfram.com/xid/0mlcadhb2qbe-d6qfgl
Out[2]=2

Output Dimensions  (1)

With size specified as a scalar, output dimension is selected such that dimension ratio is preserved:

In[1]:=1
✖
https://wolfram.com/xid/0mlcadhb2qbe-g3a8h1
In[2]:=2
✖
https://wolfram.com/xid/0mlcadhb2qbe-cwcc8y
Out[2]=2

Sampling Schemes  (3)

By default, the "Point" sampling scheme is used:

In[1]:=1
✖
https://wolfram.com/xid/0mlcadhb2qbe-8ualo6
Out[1]=1

Use the "Bin" scheme, which uses center alignment by default:

In[1]:=1
✖
https://wolfram.com/xid/0mlcadhb2qbe-x95mx2
Out[1]=1

Specify the alignment of the bins:

In[2]:=2
✖
https://wolfram.com/xid/0mlcadhb2qbe-7xwuw3
Out[2]=2

Generate a "Point" resampling with three times the input resolution:

In[1]:=1
✖
https://wolfram.com/xid/0mlcadhb2qbe-z6uxxm
Out[1]=1

Compute the sampling positions:

In[2]:=2
✖
https://wolfram.com/xid/0mlcadhb2qbe-3refog
Out[2]=2
In[3]:=3
✖
https://wolfram.com/xid/0mlcadhb2qbe-b94glz
Out[3]=3

Options  (5)Common values & functionality for each option

Antialiasing  (1)

When downsampling, by default no antialiasing is happening:

In[1]:=1
✖
https://wolfram.com/xid/0mlcadhb2qbe-h1lis1
In[2]:=2
✖
https://wolfram.com/xid/0mlcadhb2qbe-dhmuqh
Out[2]=2

With antialiasing, all samples that fall in between new samples are averaged:

In[3]:=3
✖
https://wolfram.com/xid/0mlcadhb2qbe-pay01o
Out[3]=3

DataRange  (1)

DataRange specifies the domain of resampling. Subrange specification is defined with respect to this domain:

In[1]:=1
✖
https://wolfram.com/xid/0mlcadhb2qbe-7p8y7a

Resample the whole data:

In[3]:=3
✖
https://wolfram.com/xid/0mlcadhb2qbe-0nclp7
Out[3]=3

Resample the first half using default DataRange->{1,n}, where n is the length of data:

In[6]:=6
✖
https://wolfram.com/xid/0mlcadhb2qbe-5bzdwb
Out[6]=6

Resample the first half of the data using a {0,1} data range:

In[5]:=5
✖
https://wolfram.com/xid/0mlcadhb2qbe-sz03bx
Out[5]=5

Padding  (2)

The default padding value is "Fixed":

In[1]:=1
✖
https://wolfram.com/xid/0mlcadhb2qbe-fe3o0z
Out[1]=1

Specify a different padding:

In[2]:=2
✖
https://wolfram.com/xid/0mlcadhb2qbe-e9cwcv
Out[2]=2

By default, the same padding is used for all dimensions:

In[1]:=1
✖
https://wolfram.com/xid/0mlcadhb2qbe-f5fqiw

Use different paddings for different dimensions:

In[2]:=2
✖
https://wolfram.com/xid/0mlcadhb2qbe-2ew1qr

Resampling  (1)

By default, "Linear" resampling is used:

In[1]:=1
✖
https://wolfram.com/xid/0mlcadhb2qbe-dx5z87
Out[1]=1

Use a different resampling scheme:

In[2]:=2
✖
https://wolfram.com/xid/0mlcadhb2qbe-ssnpo7
Out[2]=2

"Nearest" resampling averages the samples if the sampling position is halfway between samples:

In[3]:=3
✖
https://wolfram.com/xid/0mlcadhb2qbe-8hiobg
Out[3]=3

Use "NearestLeft" or "NearestRight" for a bias to left or right for half-integer sampling positions:

In[4]:=4
✖
https://wolfram.com/xid/0mlcadhb2qbe-c7ciec
Out[4]=4

Applications  (1)Sample problems that can be solved with this function

Reduce the size of a dataset for faster visualization:

In[1]:=1
✖
https://wolfram.com/xid/0mlcadhb2qbe-9p607x
In[2]:=2
✖
https://wolfram.com/xid/0mlcadhb2qbe-duyy66
Out[2]=2
In[3]:=3
✖
https://wolfram.com/xid/0mlcadhb2qbe-byig0t
Out[3]=3

Properties & Relations  (2)Properties of the function, and connections to other functions

Compare array resampling for a few different kernels:

In[1]:=1
✖
https://wolfram.com/xid/0mlcadhb2qbe-tr2vom
Out[4]=4

Downsample can be used to downsample by an integer factor:

In[1]:=1
✖
https://wolfram.com/xid/0mlcadhb2qbe-rx45ss
Out[1]=1
In[2]:=2
✖
https://wolfram.com/xid/0mlcadhb2qbe-qk50ke
Out[2]=2

Possible Issues  (1)Common pitfalls and unexpected behavior

Exact computations are performed with integer data:

In[1]:=1
✖
https://wolfram.com/xid/0mlcadhb2qbe-58zqqs
In[2]:=2
✖
https://wolfram.com/xid/0mlcadhb2qbe-nyedwm
Out[2]=2

Apply N to integer data for faster computation:

In[3]:=3
✖
https://wolfram.com/xid/0mlcadhb2qbe-j73d6a
Out[3]=3
Wolfram Research (2014), ArrayResample, Wolfram Language function, https://reference.wolfram.com/language/ref/ArrayResample.html (updated 2016).
✖
Wolfram Research (2014), ArrayResample, Wolfram Language function, https://reference.wolfram.com/language/ref/ArrayResample.html (updated 2016).

Text

Wolfram Research (2014), ArrayResample, Wolfram Language function, https://reference.wolfram.com/language/ref/ArrayResample.html (updated 2016).

✖
Wolfram Research (2014), ArrayResample, Wolfram Language function, https://reference.wolfram.com/language/ref/ArrayResample.html (updated 2016).

CMS

Wolfram Language. 2014. "ArrayResample." Wolfram Language & System Documentation Center. Wolfram Research. Last Modified 2016. https://reference.wolfram.com/language/ref/ArrayResample.html.

✖
Wolfram Language. 2014. "ArrayResample." Wolfram Language & System Documentation Center. Wolfram Research. Last Modified 2016. https://reference.wolfram.com/language/ref/ArrayResample.html.

APA

Wolfram Language. (2014). ArrayResample. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/ArrayResample.html

✖
Wolfram Language. (2014). ArrayResample. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/ArrayResample.html

BibTeX

@misc{reference.wolfram_2025_arrayresample, author="Wolfram Research", title="{ArrayResample}", year="2016", howpublished="\url{https://reference.wolfram.com/language/ref/ArrayResample.html}", note=[Accessed: 26-March-2025 ]}

✖
@misc{reference.wolfram_2025_arrayresample, author="Wolfram Research", title="{ArrayResample}", year="2016", howpublished="\url{https://reference.wolfram.com/language/ref/ArrayResample.html}", note=[Accessed: 26-March-2025 ]}

BibLaTeX

@online{reference.wolfram_2025_arrayresample, organization={Wolfram Research}, title={ArrayResample}, year={2016}, url={https://reference.wolfram.com/language/ref/ArrayResample.html}, note=[Accessed: 26-March-2025 ]}

✖
@online{reference.wolfram_2025_arrayresample, organization={Wolfram Research}, title={ArrayResample}, year={2016}, url={https://reference.wolfram.com/language/ref/ArrayResample.html}, note=[Accessed: 26-March-2025 ]}