Request for multiple dimensions (1, 2, 4 or 6) histogram output of particle coordinates.
Parallel capable? : no
GPU capable? : no
Back-tracking capable? : no
filename for 1d histogram output, possibly incomplete (see below)
filename for 2d x-x’ histogram output, possibly incomplete (see below)
filename for 2d y-y’ histogram output, possibly incomplete (see below)
filename for 2d dt-deltaP histogram output, possibly incomplete (see below)
filename for 4d x-x’-y-y’ histogram output, possibly incomplete (see below)
filename for 6d x-x’-y-y’-dt-deltaP histogram output, possibly incomplete (see below)
Name of SDDS file contains input bin number.
interval in passes between output.
starting pass for output
normalize histogram with number of particles?
If nonzero, no output will be generated.
If nonzero, then results at elements with same name will be output to a single multipage SDDS file.
Optionally used to assign an element to a group, with a user-defined name. Group names will appear in the parameter output file in the column ElementGroup
This element is used to generate multiple dimension (1, 2, 4, or 6) histogram output of particle coordinates.
The calculation is set up through output filename: FILE1D, FILE2DH, FILE2DV, FILE2DL, FILE4D, FILE6D. They may be an incomplete filename (see HISTOGRAM for detail). If LUMPED set to non zero, then results are directed to a multi page SDDS file with each page contains data of same elements MHISTOGRAM but at difference occurrence instead of multiple SDDS files. In this case the “%ld” in filename is ignored.
The bin number used to do histogram analysis is given through a SDDS file from INPUT_BINS. It contains 4 columns: Bins_1D, Bins_2D, Bins_4D, Bins_6D; and 6 rows (x, x’, y, y’, dt, delta). A non-zero value in Bins_1D is a switch for doing histogram analysis in corresponding dimension, and the maximum value in Bins_1D is used as bin number to do the analysis.
The normalization is different from HISTOGRAM as we alwayse treat bin-size = 1.
The output file uses the general format designed for a n-dimensional histogram data. It must contains a column named “Frequency” (Type: “double”), and following parameters:
The data is arranged as it has a “ND” index counter [iND-1|...|i1], where iND-1 takes value from “0” to “Variable[%02d ND-1]Dimension”.