Plotting ImmStats

This document describes the available plotting functions available for the ImmStats (MENA statistics) dataset, as of 19 June 2000.

Before you can plot anything, you must have read and selected data.

What's Available

There are three plotting routines available for use with ImmStats:

Name:	plot_stats	plot_stats_hist	plot_stats_image
Sample:
Description:	Scatterplot/spectrogram of five fields (Start/Stop Position, Start/Stop Height, Time of Flight) plotted against one another. Also includes a regenerated image.	Histograms for each of those five fields.	Regenerated images for all three heads.

Using each of these is simple. For example:

    Mena> plot_stats, d

The devil is in the details, of course. Here are some keyword options you can use to play around:

Keyword	plot_stats	plot_stats_hist	plot_stats_image
head=h	Display scatterplot for only the desired head (1, 2, or 3). Can be a vector, in which case the scatterplots are summed over the desired heads (but the image at right will be screwy)	Display a histogram for only the desired head (1, 2, or 3). Scalar only.	N/A
/Combine	N/A		Add all three heads together, instead of showing one panel for each.
zrange=[min,max]	Define the minimum and maximum values used in the color scale.	N/A	Define the minimum and maximum values used in the color scale.
/ZLog	Use a logarithmic scale for the scatterplot (not for the recreated image; sorry)	N/A
selection='expr'	Sorry, this is a complicated one. This keyword allows you to define criteria for excluding data points. IDL will evaluate the expression, and select only points that match it. All tests must be on an ImmStats data structure, called d (no matter what its name was when you read it). For example: Mena> plot_stats_image,dn,select='d.start_position gt 5' Mena> plot_stats_image,dn,select='d.start_position gt 5 and $ (d.stop_height + d.start_height GE 5) and $ (d.stop_position LE 55 or d.stop_position GE 82)'
resolution={az:xx, el:xx}	N/A		Allows you to specify the binning resolution, in degrees, for azimuth and/or elevation angles. You can specify az or el, or both. The defaults are 8 and 1, respectively. Note that azimuthal binning in non-multiples-of-8 may produce funky results.
/GIF, /PS, /PRINT, or PRINTER='sm1887rgb'	(standard for Ed code): Save as GIF or PostScript, or send a copy to the desired printer

Caveats

All these codes are in transition. Since we're still very much in discovery mode, I cannot guarantee the stability of any of these products.

You would do well to stay in touch with Ed, to see what new plots du jour are available.

Operated by the University of California for the National Nuclear Security Administration, of the US Department of Energy.     Copyright © 2002 UC | Disclaimer/Privacy