STRETCH_CURVE

In Rollforward & time series

The STRETCH_CURVE function stretches the curve or curves defined in the curves input over the X axis by a factor defined in the stretch input.

You can specify the X coordinate where the stretching begins with the optional start input. The stretching begins at 0 by default. The X coordinates are represented by the Sequence level in the curves input, and the Y coordinates are represented by the values of the curves input.

Use this function when you want to stretch or compress an existing profile along the time axis instead of only delaying it.

Parameters

CurvesNodeNode referenceRequired

Definition of curves as a set of (X, Y) points in the coordinate system. X values are taken from the Sequence level and Y values from the node values. This input must contain the Sequence level.

StretchNodeNode reference or numberRequired

Stretch factor. It must not contain the Sequence level and may only contain levels that are also present in CurvesNode. It can also be a constant.

StartNodeNode reference or numberOptional

X coordinate where stretching begins. It must not contain the Sequence level and may only contain levels that are also present in CurvesNode. It can also be a constant. Default: 0.

Example

Stretching project-specific curves with an optional start point

This example shows two input curves, one for project A and one for project B. Each project uses its own stretch factor, and only project B receives an explicit start point; project A therefore defaults to 0.

Input node: 'CurvesNode'

Input node: 'StretchNode'

Input node: 'StartNode'

Formula: STRETCH_CURVE('CurvesNode', 'StretchNode', 'StartNode')

See also

TIMELAG

When you want a delayed effect at a chosen time granularity instead of stretching or compressing an existing profile.

SCHEDULEPROJECTS

When you want to place project blueprints onto actual start periods instead of reshaping an already defined profile along the sequence axis.