spectrum

This spectrum requires a single parameter. The values of that parameter are the X axis of the spectrum. For each even that satisfies the applied gate and defines the spectrum's parameter, the axis specification is used to compute a spectrum channel which, if it is in the range of the axis, is incremented.

A list containing a single axis specification is required. Recall that an axis specification is a three element list consisting of axis low and high limits and bin count.

See EXAMPLES for concrete examples of spectrum definitions.

This spectrum requires a list of two parameters. The first parameter in the list is the x parameter. The second the y. A list of two axis specifications, the first for the X the second for the y are required.

For each event that satisfies the gate and defines both parameters, The X axis specification and X parameter value are used to compute an x channel. The Y axis specification and Y parameter value are used to compute a y channel. If both the x and y channels are within the spectrum bounds, the channel selected by x, y is incremented.

Actually more useful than that. This spectrum requires an arbitrary list of X axis parameters. It also requires a single X axis axis specification.

For each event in which the spectrum's applied gate is satisfied, and for which at least one of the parameters is defined by the event, the spectrum can be incremented. Each defined parameter in the parameter list computes an x axis bin and, if that bin is in range it is incremented.

Note that this means the spectrum can be incremented several times for each event.

The increment logic can drastically change if the spectrum has a fold applied. In this case, if the fold is satisfied by one or more parameters, the increments are only performed for parameters that do not satisfy the fold.

This spectrum requires an arbitrary list of at least two parameters. It also requires two axis specification. g2 spectra can be incremented more than once per event.

For each event that satisfies the applied gate and defines at least two of the spectrum's parameters the spectrum can be incremented. Each pair of parameters is used as an x/y pair and an increment is done for that pair as if the spectrum were an ordinary 2-d spectrum. For example, suppose that there are three parameters, p1, p2, p3 all of which are defined in an event. Increments will occur for (p1,p2), (p1,p3) and (p2, p3)

As with g1 spectra folds have an effect on the increment logic as well. Increments only occur for parameter pairs that are not involved in satisfying the fold.

A summary spectrum is useful to visualize the health and gain matching of several identical detectors in a system. It has an arbitrary number of parameters and a single (y) axis specification. Each parameter is assigned a sequential position on the X axis. For example, if the parameter list is, in order, p1, p2, p3; p1 is assigned X=0, p2: X=1, p3: x=2.

For each event that satsifies the applied gate and defines at least on of the parameters, the spectrum will be incremented once for each defined parameter. For each defined parameter, the value of the parameter is used, along with the axis specification, to compute a y bin. The channel incremented has an X coordinate determined by the x assigned to the parameter and a Y coordinate determined by the channel value.

A summary spectrum is therefore, effectively a bunch of 1-d spectra where each 1-d spectrum is vertically displayed along a single X channel.

A single parameter and a single axis specification are needed. The parameter is assumed to be fundamentally an integer. The axis specification defines how bits in that spectrum map to channels on the spectrum's X axis. Suppose, for example, the axis specification is {0 15 16}. Bits 0-15 are in the range of the axis (bits are numbered from least to most significant). Each of those 16 bits gets its own channel.

For each event that satisfies the applied gate and defines the spectrum's parameter an increment can take place for each set bit in the parameter. The channel for each set bit is incremnted. Suppose, for example, using the axis specification {0 15 16}, the hexadecimal representation of the paramters is 0x10055. The following channels will be incremented 0, 2, 4, 6. This is because 0x55 has is binary: 0101 0101 Note that since the 0x10000 is out of range of the axis (it's bit 16) it does not result in an increment.

This requires two parametrs. The first is an X axis parameter, the second is a value parameter. Only one axis specification (for the X axis) is required and this is an initial condition. While the spectrum is intended cases where the X axis parameter monotonically varies, this is not required.

For each event that satisfies the gate and has defined both parameters, the X parameter is converted into an X axis bin. If the bin is not in the spectrum, the channels are shifted appropriately so that it is (think of a strip chart scrolling). The integer valued value parameter is then added to that channel.

Consider one application. Suppose the X parameter is run time in say minutes and the Y parameter is the number of counts in some scaler. The scaler rate strip chart can then be plotted using one of these spectra.

Requires an event number of parameters. Each pair of parameters is an X/Y pair. Requires two axis specifications, one for X and one for Y.

If the gate is satisfied for the spectrum, the parameter pairs are iterated over. For each X/Y pair that is defined in the event, bins are computed and, if possible a channel is incremented. The result is a spectrum that would be the sum of 2-d spectra on the individual parameter pairs.

Requires two parameter lists. The first parameter list is the set of X parameters. The second parameter list the set of Y parameters. The spectrum needs both X and Y axis specifications.

If the spectrum's gate is satisifed and the event has at least one X and one Y parameter defined, the spectrum can be incremented. All pairs of X/Y parameters can cause increments. Suppose the X parameters are x1, x2, x3 and all are present. Suppose the Y parameters are y1, y2, y3 and only y1 and y3 are present. Increments can occur for (x1,y1) (x1,y3), (x2, y1), (x2, y3), (x3, y1), (x3, y3).

As with any gamma spectrum folds can be applied in which case increments only occurs for parameter pairs where one or both parameters don't satisfy the fold.

Gamma summary spectrum. This works just like a summary spectrum, however each x channel has a list of parameters and the vertical strip of that channel is a g1 spectrum of the parameters for that X channel.