Spitzer Documentation & Tools
MOPEX User's Guide

 

6.5.3        APEX Modules: APEX Single Frame and APEX User List Single Settings

Command Line Equivalent: N/A

Default Output Directory: N/A

Depends On: Initial Setup

Relevant Pipelines: APEX Single Frame; APEX User List Single Frame

 

PURPOSE

To set the input parameters specific to the APEX Single Frame and APEX User List Single Frame pipelines. Parameters that are specific to only one of these pipelines are marked.

 

INPUT

User Input Fixed Positions Table File Name: (User List only) The input file containing the list of user-specified positions for source extraction. See §8.10 for more information.

 

Use Input List Type: (User List only) The type of positional input listed in the User Input Fixed Positions Table File. Options are 0 - positions in [x,y] (pixels); 1 - positions in [RA,Dec] (degrees) or 3 - positions in both [x,y] & [RA,Dec].

 

PRF File Name: The name of the PRF file to use for source fitting. Standard MIPS PRFs are available in the <mopex_dir>/cal/ directory, or you can make your own PRF from your data by using the PRF Estimate pipeline (Chapter 7). Note that you should not carry out PRF fitting on IRAC mosaics; use APEX Multiframe instead.

 

PRF Map File Name: The name of a variable PRF map file, which allows the use of different PRFs depending on the location of the source on the array. See §8.7 for more information on the format of the PRF Map file. Note that

 

DCE Status Mask: The (optional) status mask image flagging bad pixels in the input image or mosaic.

 

Fatal Mask Bit Pattern: The bit pattern identifying the flags in the DCE Status Mask that you wish to set as fatal. See §8.11 for more information about Fatal Mask Bit Patterns.

 

Use PSP to detect: This parameter determines which image should be used as input into the Detect module.

 

Probability Threshold: (float from 0.0 to 1.0, default = not set). If the Point Source Probability image is used for detection, it is in principle possible that a large proportion of pixels will have values close to 1, which is the maximum.  The calculation of the initial detection threshold could be skewed upward by these high values with a possible result of no detections. If this parameter is set, values larger than Probability Threshold will not be included in the initial threshold calculation.  This is an unlikely scenario, and this parameter generally does not need to be set.

 

Use Background Subtracted Image for Fitting: If checked, the background subtracted version of the image created by the Extract MedFilter module is used for PRF fitting.

 

Use Data Uncertainties for PRF-fitted SNR: If checked, APEX will use the data uncertainties for calculating the PRF-fitted SNR. The default is off, in which case it will use the current Gaussnoise noise estimate (i.e. basically the background RMS).

 

Use Background Subtracted Image for Aperture: If checked, the background subtracted version of the image created by the Extract MedFilter module is used for aperture photometry. The Aperture Photometry module can perform an annular background subtraction, so it may be better not to use this option.

 

Use Extract Table for Aperture: If checked, the output table of the extracted sources (from Source Estimate) is used as input to the Aperture photometry module. If not, the output table of detected sources (by the Detect module) is used.

 

Use Refined Pointing: Check this to use the alternate FITS pointing keywords created by the offline pointing refinement script (pointing_refine.pl). Do not switch this on unless you have manually run pointing refinement outside of the normal BCD pipeline products. Most users will never use this option, as pointing refinement is not recommended for Spitzer data. If you believe that there is a problem with the pointing of your data with respect to e.g. the 2MASS catalog, please email the Spitzer Helpdesk for assistance.

 

Use Bright Object Mask: Select this option to use the object mask generated by the Bright Detect module in the full image segmentation.

 

Delete Intermediate Files: Check this to delete all of the intermediate files created by the APEX pipeline. This leaves only the input files and the files created by the final module. This is useful for saving disk space once you are satisfied with your reduction setup. Note that MOPEX will prompt you with a pop-up dialogue box when you set the flow running, to be sure that you meant to select this irreversible option.

 

COMMAND LINE INPUT

The following parameters are set in the Global Parameters part of the namelist. Note that if both MOSAIC_PIXEL_SIZE_X(Y) and MOSAIC_PIXEL_RATIO_X(Y) are both set, the former takes precedence and will override the latter.

INPUT_USER_LIST = <working_dir>/user_input.tbl

use_input_list_type = 1

PRF_file_name = cal/apex_sh_IRAC1_col129_row129_x100.fits

PRFMAP_FILE_NAME = cal/ch1_prfmap.tbl

DCE_STATUS_MASK = ch1_imask.fits

DCE_Status_Mask_Fatal_BitPattern = 32544

use_psp_to_detect = 1

PROBABILITY_THRESHOLD = 0.0

use_background_subtracted_image_for_fitting = 1

use_data_unc_for_fitted_SNR = 1

use_background_subtracted_image_for_aperture = 0

use_extract_table_for_aperture = 1

USE_REFINED_POINTING = 0

use_bright_object_mask = 0

delete_intermediate_files = 0

 

OUTPUT

None

 

DISCUSSION

None