DownSample - Maple Help
For the best experience, we recommend viewing online help using Google Chrome or Microsoft Edge.
Our website is currently undergoing maintenance, which may result in occasional errors while browsing. We apologize for any inconvenience this may cause and are working swiftly to restore full functionality. Thank you for your patience.

Online Help

All Products    Maple    MapleSim


SignalProcessing

  

DownSample

  

down-sample a signal

 

Calling Sequence

Parameters

Options

Description

Thread Safety

Examples

Compatibility

Calling Sequence

DownSample( A, factor, phase )

Parameters

A

-

Array of real or complex values; the signal

factor

-

posint, down-sample factor

phase

-

nonnegint, (optional) phase

Options

• 

container : rtable, predefined Array for holding results

Description

• 

The DownSample( A, factor, phase ) command down-samples the signal in the Array A.

• 

The effect of this command is to copy one sample from each block of factor samples in A to the output.

• 

Before the code performing the computation runs, Maple converts A to a hardware datatype, first attempting float[8] and subsequently complex[8], unless it already has one of these datatypes. For this reason, it is most efficient if A has one of these datatypes beforehand.

• 

The phase argument determines an offset, so that the sample value from A occurs phase positions offset in the output array. The value of phase must be non-negative and less than the value of factor.

• 

If the container=C option is provided, then the results are put into C and C is returned. With this option, no additional memory is allocated to store the result. The container must be an Array of size iquo( N + factor - 1 - phase, factor ) where N is the number of elements of A, and it must have datatype float[8] if A is real and complex[8] if A is complex.

Thread Safety

• 

The SignalProcessing[DownSample] command is thread-safe as of Maple 17.

• 

For more information on thread safety, see index/threadsafe.

Examples

withSignalProcessing:

AArray1,2,3,4,5,6,7,8,9,datatype=float8

A1.2.3.4.5.6.7.8.9.

(1)

DownSampleA,1

1.2.3.4.5.6.7.8.9.

(2)

DownSampleA,2

1.3.5.7.9.

(3)

DownSampleA,3

1.4.7.

(4)

DownSampleA,4

1.5.9.

(5)

DownSampleA,3,0

1.4.7.

(6)

DownSampleA,3,1

2.5.8.

(7)

DownSampleA,3,2

3.6.9.

(8)

CArray1..4,datatype=float8:

DownSampleA,2,1,container=C

2.4.6.8.

(9)

C

2.4.6.8.

(10)

Compatibility

• 

The SignalProcessing[DownSample] command was introduced in Maple 17.

• 

For more information on Maple 17 changes, see Updates in Maple 17.

See Also

UpSample