Collect3D (Node)

Context	Analysis
Name Required?	Yes
Branches	SubCollect

Overview

The Collect3D node is used to accumulate a histogram over three dimensions, using values extracted from three Calculate-style nodes.

Description

Where the Calculate* nodes are responsible for calculating quantities, the Collect* nodes are responsible for accumulating averages, typically in histogram format.

Collect3D accumulates a histogram over three dimensions using target values taken from two Calculate* nodes, over a specified range and binwidth for each dimension. The values are treated as a triplet giving the {x,y,z} coordinate to bin in the histogram. No post-processing (e.g. normalisation) is performed by Collect3D - see the Process3D for processing options.

Branching

The Collect* nodes all have a branch (accessed through the hidden SubCollect keyword) which is executed if the value is successfully binned (i.e. is within all ranges specified).

Options

Quantities / Ranges

Keyword	Arguments	Default	Description
QuantityX	name [index]	–	Required The calculated observable to use for the x axis. The named node must be one of the Calculate* nodes. The index specifies which value to take from multi-dimensional observables, starting from zero for the first. If not specified, index defaults to zero.
QuantityY	name [index]	–	Required The calculated observable to use for the y axis. The named node must be one of the Calculate* nodes. The index specifies which value to take from multi-dimensional observables, starting from zero for the first. If not specified, index defaults to zero.
QuantityZ	name [index]	–	Required The calculated observable to use for the z axis. The named node must be one of the Calculate* nodes. The index specifies which value to take from multi-dimensional observables, starting from zero for the first. If not specified, index defaults to zero.
RangeX	min max delta	–	Defines the range and binwidth of the x-axis of the histogram.
RangeY	min max delta	–	Defines the range and binwidth of the y-axis of the histogram.
RangeZ	min max delta	–	Defines the range and binwidth of the z-axis of the histogram.