fold - SpecTcl Command

SpecTcl Home  General Information User Guide Programmer's Guide Obtaining and Installing

Syntax

fold -apply gate spectrum ?spectrum...? fold -list ?pattern? fold -remove spectrum

Top

Synopsis

Manipulates gates as folds on gamma spectra.

• -apply Applies a gate as a fold on a gamma spectrum. The gate must be a gamma gate. The Spectra must all be gamma spectra. The fold causes the spectrum to be incremented for the set of parameters that don't make the gate when the gate as aa whole is made. Folds are applied in addition to gates.
• -list lists the spectra that have folds and their folds. If the pattern is supplied it is interpreted as a glob pattern. Only spectra that match the glob pattern are shown.
• -remove removes the fold from the spectrum.

Top

Detailed Description

Folds are a simple mechanism to unravel complex gamma spectra into coincident sets of peaks. Whenver a fold is applied to a gamma spectrum, if the gate on that spectrum allows the gamma spetrum to be incremented, the fold controls the way in which the gamma specrum is incremented.

Without a fold, a gamma 1d spectrum is incremented once for each parameter in the spectrum. A gamma 2d spectrum is incremented once for each parameter pair in the spectrum. This provides a means to aggregate all of the gamma ray detectors in an experiment into a single spectrum.

With a fold, each parameter (for a gamma slice) or parameter pair (for a gamma band or contour) is checked against the gate. Whenever a parameter or pair of parameters satisfies the gate, the spectrum is incremented for all other parameters (1D) or parameter pairs (2D) that make up the spectrum. The effect is to remove the peak around which the gate was drawn and leave only the peaks that occur in coincidence with that peak (note that a bump in a 2-d spectrum already represents a gamma-gamma coincidence allowing 4-fold coincidence spectra to be produced by looking for bumps in a 2-d spectrum on which a gamma contour e.g. has been applied).

fold -apply gate spectrum ?spectrum ...?

The -apply switch causes the single gamma gate to be applied as a fold to the set of spectra listed on the command line.

fold -list ?pattern?

The -list switch lists the set of spectra with folds that match the optional pattern. If the pattern is not supplied, it is taken to be * which matchs all spectra. The result of the fold -list command is a list of spectra with folds. Each list element is, itself a two element list consisting of, in order, the spectrum name and the name of the gate that is used to produce the folded spectrum.

fold -remove spectrum

Removes a gate fold application from a spectrum. Any gate that is applied as a normal gate remains.

Last Modified: May 27, 2005 by: fox@nscl.msu.edu
© Copyright NSCL 2005, All rights reserved