STScI Logo

stamps axe


NAME · USAGE · PARAMETERS · DESCRIPTION · FILE_NAMING_CONVENTION
EXAMPLES · TIME_REQUIREMENTS · BUGS · REFERENCES · SEE_ALSO

NAME

stamps -- generate stamp images from a pixel extraction table

USAGE

stamp grism config

PARAMETERS

grism
Name of grism/prism image.
config
Name of grism/prism extraction configuration file.
(sampling = drizzle) [drizzle|rectified|trace]
Which sampling should be used generating the stamp?
(drzpath = false) [boolean]
Use the directory indicated by the system variable $AXE_DRIZZLE_PATH to located the input PET and write the output stamp image (STP).
(out_STP = "") [string]
Name to use for the output file with the stamp images instead of the default.

DESCRIPTION

This task uses the content of a Pixel Extraction Table (PET) file to generate a Stamp Image File (STP) containing stamp images of the BEAMs that were extracted.

The task can create different kind of stamp images:

sampling="drizzle"  : fully resampled stamp images in the
                      trace length - cross dispersion plane
                      with the trace axis parallel to the
                      x-axis
sampling="rectified": not resampled stamp images in the
                      trace length - cross dispersion plane
                      with the trace axis parallel to the
                      x-axis
sampling="trace":     trace axis and cross dispersion axis
                      as in the flt-image

This task allows one to quickly check that the extraction angle used was the appropriate one. Because this task uses the content of a PET and not the original input slitless image, it offers a good check of what pixels were used during the extraction process.

Using drizzle sampling the stamp images could even be used to combine spectra of the same object from different images (similar to axedrizzle). To aid this usage, each stamp image (extension [BEAM_<object id><beam id>]) is accompanied by the corresponding weight image (extension [WEIG_<object id><beam id>]).

FILE NAMING CONVENTION

aXe tasks use default names for input and output files based on the given name of the "grism" image. For this task the default input PET would be called <grism-rootname>_<science extension>.PET.fits and the output stamps image file would be <grism-rootname>_<science extension>.STP.fits.

EXAMPLES

1. Create a stamp image for all beams in the corresponding PET file using the drizzle-sampling:

  ax> stamps test_grism_1.fits SLIM.conf.test.0 sampling='drizzle'

2. As in 1., but use the environmental variable $AXE_DRIZZLE_PATH to load the PET and save the resulting stamp file:

  ax> stamps test_grism_1.fits SLIM.conf.test.0 sampling='drizzle'
             drzpath='yes'

TIME REQUIREMENTS

BUGS

REFERENCES

Refer to manual for more detailed information about using this aXe task:


http://www.stecf.org/instruments/ACSgrism/axe/

SEE ALSO


Search Form · STSDAS