ecl-logo Documentation
ECL`

PlotWaterfall

PlotWaterfall[StackedData]Plot

constructs a waterfall plot from StackedData, a collection of 2D coordinate pairs stacked in paired list form alongside their Z-coordinate values.

PlotWaterfall[DataObjects]MultiObjPlot

constructs a waterfall plot from DataObjects, a list of references to data objects that each contain a list of 2D coordinate pairs.

PlotWaterfall[DataObject]ObjPlot

constructs a waterfall plot from DataObject, a single data object reference that contains a paired list of 2D coordinates and their associated Z-coordinate values.

Details

    Input
    Output
    3D View Options
    Axes Options
    Box Options
    Data Specifications Options
    Image Format Options
    Legend Options
    Plot Labeling Options
    Plot Range Options
    Plot Style Options
    General Options

Examples

open allclose all

Example Setup

These expressions are used in the examples to follow:

Basic Examples  (4)

PlotWaterfall accepts a list of Object[Data] object IDs:

PlotWaterfall accepts a list of Object[Data] objects:

PlotWaterfall accepts numerical data in stacked form:

Plotwaterfall accepts standalone 3D data objects, including Kinetic NMR data:

Options  (30)

AspectRatio  (1)

AspectRatio sets the relative x- and y-axis lengths:

Axes  (2)

Setting Axes to a list of boolean values independently toggles whether the Z,X, and Y axes are displayed:

Setting Axes to False hides all axes, axes labels, and tick marks:

AxesEdge  (1)

AxesEdge specifies on which edges of the bounding box axes should be drawn:

AxesLabel  (1)

Set the Z, X, and Y axis labels:

AxesUnits  (1)

Set the Z, X, and Y axis label units:

Boxed  (1)

Boxed specifies whether the edges of the bounding box are drawn:

ContourLabelPositions  (1)

ContourLabelPositions specifies where the annotations appear with respect to the waterfall:

ContourLabels  (3)

Annotations are inferred from the input data when ContourLabels is set to Automatic:

Setting ContourLabels to a list of strings directly sets the annotation text:

Setting ContourLabels to None hides the annotations:

ContourLabelStyle  (1)

Setting ContourLabelStyle to a list of directives formats each annotation:

ContourSpacing  (2)

When ContourSpacing is set to Index, the waterfall lines are spaced by their index:

When ContourSpacing is set to Value, the waterfall lines are spaced by Z-coordinate value:

Filling  (1)

Filling specifies what content is drawn below each contour in the waterfall:

LabelField  (2)

LabelField sets the field from which contour Z-coordinate values are generated:

LabelField sets the value of ContourLabels when set to a field that contains non-numeric values:

Legend  (1)

Legend takes a list of strings:

PlotLabel  (1)

PlotLabel sets the title text that appears above the waterfall:

PlotRange  (1)

PlotRange sets the lower and upper bounds for all three dimensions:

PrimaryData  (1)

PrimaryData sets which object data field is used to generate the contours:

ProjectionAngle  (1)

ProjectionAngle sets the angle between the X and Z axes when WaterfallProjection is set to Parallel:

ProjectionDepth  (1)

ProjectionDepth sets the spacing between contours:

TargetUnits  (1)

Set the display units for the Z, X, and Y axes:

ViewPoint  (3)

Quantities appearing in ViewPoint are automatically converted to match the input data:

Specify the position in ZXY space from which the waterfall is viewed:

ViewPoint sets the position of the observer with respect to the center of the plot:

ViewVector  (1)

Specify the position and direction in ZXY space from which the waterfall is viewed:

WaterfallProjection  (2)

Depth is visualized isometrically when WaterfallProjection is set to Orthographic:

Depth is visualized using an oblique cabinet projection when WaterfallProjection is set to Parallel:

Messages  (11)

LabelFieldInvalid  (1)

LabelField not containing a list throws warning:

LabelFieldLengthMismatch  (1)

LabelField containing a list whose length does not match the number of contours throws warning:

LabelFieldNotFound  (1)

LabelField not found throws warning:

LabelsLengthMismatch  (1)

Mismatched number of contour labels throws warning:

MixedDataTypes  (1)

Input containing mixed data types throws warning:

NonNumericLabelField  (1)

LabelField containing a non-numeric and non-quantity type throws warning:

ParallelProjectionInvalid  (1)

Parallel projection of a single contour throws warning:

PrimaryDataEmpty  (1)

One or more objecs having an empty PrimaryData field throws error:

PrimaryDataInvalid  (1)

Invalid PrimaryData field throws warning and defaults to a valid alternative:

UnsupportedDataObject  (1)

One or more objecs lacking a valid PrimaryData field throws error:

ViewPointUnitMismatch  (1)

Mismatched ViewPoint units throws warning:

Last modified on Tue 7 Oct 2025 18:43:10