photfitsplt - plot a fits photon file
photfitsplt [options] file1 [ file2 ... ]
photfitsplt uses PGPLOT to generate a scatter plot of the photons in a FITS file
adhering to the AXAF FITS photon standard.
Options may be abbreviated.
- -ask | -noask
-
If more than one file is to be plotted, photfitsplt will by default prompt before plotting up each file. -noask turns the prompt off.
- -box=float
-
Specify the dimension of a square region about the specified center (see -xc and -yc) to plot.
- -device=PGPLOT device
-
The device to which to plot. This defaults to
/xserve.
- -gc=perl expression
-
Guess the center of the ray distribution using the file name. The
expression is turned into a Perl subroutine. It may be composed of multiple
statements; the last must return an array containing the elevation and
azimuth, in that order (either implicitly, or with the
return statement). The filename will be available in the $_
variable. For instance, if the filename has the format
<tag>_<energy>_<el>_<az>, you could use
-gc '( split( "_" ) )[2,3]'
If the filename has an extension, it may be trimmed with the -trim
option (which is active by default).
- -help
-
print this message and exit
- -hrma
-
The photons are in the HRMA (orbit) coordinate system
- -n=integer
-
The number of photons to plot. It defaults to all the photons in the file.
- -nosym
-
If the file is a symbolic link, don't plot it.
- -xc=float
-
Explicitly specify the x coordinate of the center of the region to be plotted. See the discussion of
coordinates below.
- -xmin=float
-
Explicitly specify the minimum x coordinate of the region to plot. See the discussion of coordinates below.
- -xmax=float
-
Explicitly specify the maximum x coordinate of the region to plot. See the discussion of coordinates below.
- -yc=float
-
Explicitly specify the y coordinate of the center of the region to be plotted. See the discussion of
coordinates below.
- -ymin=float
-
Explicitly specify the minimum y coordinate of the region to plot. See the discussion of coordinates below.
- -ymax=float
-
Explicitly specify the maximum y coordinate of the region to plot. See the discussion of coordinates below.
- -zc=float
-
Explicitly specify the z coordinate of the center of the region to be plotted. See the discussion of
coordinates below.
- -zmin=float
-
Explicitly specify the minimum z coordinate of the region to plot. See the discussion of coordinates below.
- -zmax=float
-
Explicitly specify the maximum z coordinate of the region to plot. See the discussion of coordinates below.
- -osac
-
The photons are in the OSAC coordinate system. This is the default.
- -pcomm
-
Print the perl code used to convert coordinate systems.
- -print
-
Print the data for each photon to the UNIX standard output stream.
- -project=float
-
Project the photons to the given axial plane
- -trim
-
Trim the extension from the file name when guessing the center from it via
the -gc option. This is the default. To supress this, use the -notrim option.
- -um
-
plot in micrometers, rather than millimeters.
- -verbose
-
Be talkative.
- -version
-
print the version number and exit
- -xrcf
-
The photons are in the XRCF coordinate system.
photfitsplt reads one or more fits photon files and creates a scatter plot. The photons
may be projected to any plane perpendicular to the optical axis. The region
of that plane plotted may be determined a number of ways:
-
The program will autoscale (the default method)
-
The center may be specified with the -?c or -gc parameters and either a square box (use -box) or rectangle (use the -?min and -?max
parameters) plotted.
There are three sets of min, max, and center parameters, one for each
possible axis (x, y, z). You should use the pair consistent with the coordinate system that
you've specified (-osac, -xrcf,
-hrma).
If you've got a bunch of files to plot, and the center varies for each
according to the off-axis angle, and the file names included the elevation
and azimuth of the source position, you can use the -gc (``guess center'') option to extract that information from the filename and
determine a center appropriate for the source position.
Diab Jerius (djerius@cfa.harvard.edu)
$Revision: 1.2 $ $Date: 1997/01/19 17:59:20 $