peakmap - Builds a map of emission-line strength from a three-dimensional IFU NDF.

Description:

This shell script reads a three-dimensional IFU NDF as input and presents the user with a white-light image of the cube. You can then select and X-Y position using the cursor. The script will extract and display this spectrum. You will then be prompted to specify various fitting parameters, e.g. peak position, using the cursor. The script will then attempt to fit the emission line. The fit will be displayed and you are consulted regarding the goodness of fit. If you consider the fit to be good enough, the script will attempt to perform similar fits to all spectra within the cube, building a two-dimensional NDF image of the strength of the line.

If you do not force the fit to be considered ``good'' by using the -f command-line option, the script will offer the opportunity to manually refit the spectral feature for individual pixels, such as those that were unsuccessfully fitted by the automatic procedure.

Usage:

peakmap [-f] [-i filename] [-o filename] [-c number] [-p] [-v] [-z/+z]

Command-line Arguments

• -c number
  Number of contours in the white-light image. [15]
• -f
  Force the script to accept the first attempt to fit a Gaussian to the line. This is a dangerous option; if the fit is poor, or unobtainable the script may terminate abruptly if it is forced to accept the fit. [FALSE]
• -i filename
  The script will use this as its input file, the specified file should be a three-dimensional NDF. By default the script will prompt for the input file.
• -o filename
  The filename for the output NDF of the line-strength map.
• -p
  The script will plot the final image map to the current display as well as saving it to an NDF file. Additionally, it will overplot the white-light image as a contour map for comparison. [FALSE]
• -v
  The script will generate a VARIANCE array from the line fits and attach it to the velocity-map NDF. [FALSE]
• -z
  The script will automatically prompt the user to select a region to zoom before prompting for the region of interest. TRUE]
  +z
  The program will not prompt for a zoom before requesting the region of interest. [ FALSE]

Notes:

• The velocity map display scales between the 15 and 98 percentiles. The map uses a false-colour lookup table.

Implementation Status:

This script invokes a collection of A-tasks from the KAPPA and FIGAROsun86 packages.