STRETCH_CURVE
Category: Rollforward & time series
Overview
Description | 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 Use when you want to stretch or compress an existing profile along the time axis instead of only delaying it. |
|---|---|
Syntax |
|
Parameters |
|
Examples
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
| Project | Sequence | Value |
|---|---|---|
| A | 0 | 0 |
| A | 1 | 1 |
| A | 2 | 1 |
| A | 3 | 2 |
| B | 0 | 0 |
| B | 1 | 1 |
| B | 2 | 2 |
Input node: StretchNode
| Project | Value |
|---|---|
| A | 1.5 |
| B | 2 |
Input node: StartNode
| Project | Value |
|---|---|
| B | 2 |
Formula: STRETCH_CURVE('CurvesNode', 'StretchNode', 'StartNode')
| Project | Sequence | → STRETCH_CURVE Result |
|---|---|---|
| A | 0 | 0 |
| A | 1 | 0.67 |
| A | 2 | 1 |
| A | 3 | 1 |
| A | 4 | 1.67 |
| A | 5 | 2 |
| B | 0 | 0 |
| B | 1 | 1 |
| B | 2 | 1.33 |
| B | 3 | 1.67 |
| B | 4 | 2 |
Related Functions
| Function | When to use instead |
|---|---|
| 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. |