Return to Post-BCD pages
 
Manual Contents
 
Getting Started
 
Input Files
 
Background Matching (overlap.pl)
 
Mosaicking (mosaic.pl)
 
Point Source Extraction (apex*.pl)
 
Basic Concepts
 
Appendix 1: Full List of MOPEX Scripts
 
Appendix 2: Fatal Bit Patterns
 
Appendix 3: Full Lit of MOPEX Modules

APEX QA Modules: Point Source Subtract

Namelist Trigger: create_residual_images (for apex.pl mode) or create_residual_mosaic (for apex_1frame.pl mode).
Output Directory Keyword: OUTPUT_DIR
Default Output Directory: <output_dir>
Depends on: output of apex.pl or apex_1frame.pl

Important notes: This module has two different parameter blocks, depending on whether it is running on the output of apex.pl or apex_1frame.pl. When running on the output of apex.pl, the user must also supply a mosaic namelist in order to create a mosaic of the residual images.


PURPOSE

    This module (called pointsourceimage in the MOPEX code) is used to subtract the sources from the input images or the input mosaic to create a residual mosaic. This is extremely useful for testing how well the PRF fitting is working. The two modes (Single Frame and Multiframe) use different keywords for the trigger and parameter block of the module.

PARAMETER BLOCK

    When running in Multiframe mode (i.e. on the output of apex.pl):

    &POINTSOURCEIMAGE
     PRF_ResampleX_Factor = 4,
     PRF_ResampleY_Factor = 4,
     X_Column_Name = 'RA',
     Y_Column_Name = 'Dec',
     Input_RA_Dec = 1,
     Normalization_Radius = 44,
     Outer_Radius = 44,
     Hole_Radius = 21,
    &END


    When running in Single Frame mode (i.e. on the output of apex_1frame.pl) the parameters are identical but the module block starts with the keyword:

    &MOSAIC_POINTSOURCEIMAGE

INPUTS

    PRF_ResampleX(Y)_Factor (int): This is the same PRF_ResampleX(Y)_Factor as used in the Source Estimate module. It is the ratio of the input image pixel size to the PRF pixel size in the x- and y-direction.

    X(Y)_Column_Name (char): The name of the X and Y positional columns to be read from the source position table (*extract.tbl). Options are 'RA' and 'Dec' or 'x' and 'y'. If 'x' and 'y' are used, the Fiducial Image Frame table must also be specified in the Global Parameters section of the namelist, with the keyword FIF_FILE_NAME.

    Input_RA_Dec (switch): The units of the positional input data. '0' = pixel coordinates (x and y), 1 = 'RA' and 'Dec'.

    Normalization_Radius (int): This is the same parameter as used in the Source Estimate module. The PRF flux is normalized within this radius (in PRF pixels). By default, the PRF is normalized to the whole PRF array.

    Outer_Radius (int): Cuts a circular PRF image of this size in pixels. By default, the whole image is used.

    Hole Radius: (int) Cuts a hole in the PRF image of this size in pixels.


OUTPUTS

    The residual images are written to the specified output directory and are called residual*.fits


Discussion

This module (called pointsourceimage in the MOPEX code) is used to subtract the sources from the input images or the input mosaic to create a residual mosaic. This is extremely useful for testing how well the PRF fitting is working. The two modes (Single Frame and Multiframe) use different keywords for triggering the module to run, and for specifying the parameter block. Parameters PRF_ResampleX(Y)_Factor and Normalization_Radius are the same parameters as used in the Source Estimate module, and should be set to the same values as previously used.



SPITZER HOME || SPITZER SCIENCE || INSTRUMENTS || SCIENCE USER SUPPORT || SEARCH

help@spitzer.caltech.edu

This file was last modified on Tue Jun 10 17:37:46 PDT 2008.

California Institute of Technology Jet Propulsion Laboratory NASA