
UpSample |
ptolemy.domains.sdf.lib.UpSample |
This actor upsamples an input stream by an integer factor by inserting
tokens with value zero. The upsample factor is given by the
factor parameter. On each firing, this actor reads one
token from the input produces factor tokens on the output
port. All but one of these is a zero-valued token of the same type
as the input. The remaining one is the token read from the input.
The position of this remaining one is determined by the phase
parameter. This parameter has a value between 0 and factor-1.
If it is 0, then the input token is the first output token, followed
by zeros. If it is factor-1, then it is the last output.
Thus, if this actor is followed by the DownSample actor with the same
factor, and the two phase parameters have a sum of
factor-1, the combination has no effect.
By default, factor is 2, and phase is the expression
"factor-1". This means that by default, the input token that is read
is the last one produced at the output.
This actor is data polymorphic. It can accept any token
type on the input that supports the zero() method,
and it sends output tokens of that type.
Author(s): Steve Neuendorffer, Edward A. Lee
Version:$Id: UpSample.java,v 1.30 2005/07/08 19:58:46 cxh Exp $
Pt.Proposed Rating:Yellow (neuendor)
Pt.Accepted Rating:Yellow (eal)
factor
The number of output tokens to produced per input token read.
This is an integer that defaults to 2 and must be greater than
zero.
phase
The phase of the output with respect to the input.
This is an integer that defaults to factor-1 and must be
between 0 and factor-1. If phase = 0, the input
is the first output, while if phase = factor-1
then the input is the last output.