SignalProcessing - Maple Programming Help

Online Help

All Products    Maple    MapleSim


Home : Support : Online Help : Science and Engineering : Signal Processing : Sampling Rate : SignalProcessing/UpSample

SignalProcessing

  

UpSample

  

up-sample a signal

 

Calling Sequence

Parameters

Options

Description

Thread Safety

Examples

Compatibility

Calling Sequence

UpSample( A, factor, phase )

Parameters

A

-

Array of real or complex numeric values; the signal

factor

-

posint, up-sample factor

phase

-

nonnegint, (optional) phase

Options

• 

container : Array, predefined Array for holding results

Description

• 

The UpSample( A, factor, phase ) command up-samples the signal in the Array A.

• 

The effect of this command is to place factor - 1 zeroes between each pair of samples in the Array A.

• 

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 N * 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[UpSample] command is thread-safe as of Maple 17.

• 

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

Examples

withSignalProcessing:

interface'rtablesize'=20:

AArray1,2,3,4,5,6,'datatype'='float'8

A:=1.2.3.4.5.6.

(1)

UpSampleA,1

1.2.3.4.5.6.

(2)

UpSampleA,2

1 .. 12 ArrayData Type: float8Storage: rectangularOrder: Fortran_order

(3)

UpSampleA,3

1 .. 18 ArrayData Type: float8Storage: rectangularOrder: Fortran_order

(4)

UpSampleA,3,0

1 .. 18 ArrayData Type: float8Storage: rectangularOrder: Fortran_order

(5)

UpSampleA,3,1

1 .. 18 ArrayData Type: float8Storage: rectangularOrder: Fortran_order

(6)

UpSampleA,3,2

1 .. 18 ArrayData Type: float8Storage: rectangularOrder: Fortran_order

(7)

CArray1..18,'datatype'='float'8:

UpSampleA,3,'container'=C

1 .. 18 ArrayData Type: float8Storage: rectangularOrder: Fortran_order

(8)

C

1 .. 18 ArrayData Type: float8Storage: rectangularOrder: Fortran_order

(9)

AArrayI,I,1+I,I1,datatype=complex[8]

A:=0.+1.I0.1.I1.+1.I1.+1.I

(10)

CArray1..8,'datatype'='complex'8:

UpSampleA,2,1,'container'=C

0.+0.I0.+1.I0.+0.I0.1.I0.+0.I1.+1.I0.+0.I1.+1.I

(11)

C

0.+0.I0.+1.I0.+0.I0.1.I0.+0.I1.+1.I0.+0.I1.+1.I

(12)

Compatibility

• 

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

• 

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

See Also

DownSample

 


Download Help Document

Was this information helpful?



Please add your Comment (Optional)
E-mail Address (Optional)
What is ? This question helps us to combat spam