Use a source catalog made with the image_catalogs routine to build ds9 region files.
% imgcat0_region_files --help
usage: imgcat0_region_files Rsco2043.fits [-v] [-h] [-n NumPixMin] [-far ApRadPix] [-mia MinApRadPix]
Additional options:
-v | --verbose = print verbose comments and run in debug mode
-h | --help = show a help file and then exit
-n | -npix = minimum (integer) number of pixels for imgcat0 sources
-far | -fixedap = fixed aperture radius in pixel units (can be "none")
-mia | -minap = minimum allowed aperture radius in pixel units (can be "none")
NOTE: ApRadPix and MinApRadPix are mutially exclusive. You never use
them both at the same time.
The basic function of this routine is to check that a catalog is resent, pull the sources from that catalog and make regions files, and make a local copy of the input FITS image.
% ls local_red/ S/ % imgcat0_region_files /home/sco/AUTO_match_for_wcs/S/20191018T024545.3_acm_sci.fits % ls 20191018T024545.3_acm_sci_apertures.cdfp 20191018T024545.3_acm_sci.cdfp 20191018T024545.3_acm_sci.fits S/ 20191018T024545.3_acm_sci_apertures.cdfp.reg 20191018T024545.3_acm_sci.cdfp.reg local_red/ The cdfp files (CoorDinate Floating Point) will contain Ra,Dec only if a valid WCS was present in the image header. Otherwise, only the Xcent,Ycent (intensity-weighted centroid) positions in pixel units are used. 20191018T024545.3_acm_sci_apertures.cdfp.reg region file for objects selected to have fixed apertures 20191018T024545.3_acm_sci.cdfp.reg region file for objects with apertures set using the number of pixels inthe thresholded image detection.A lot of error checking is performed by this routine. If an error occurs, the a file named "ERROR.imgcat0_region_files" that contains an explanation of why the run failed. Return to top of page.
What determines which objects in the image catalog from image_catalogs end up being measured with an aperture? The basic answer involves the routine that takes objects from the catalog and build a ds9 regions file. This routine is reg_from_imgcat. Here is the call in the imgcat0_apmags script that does this:
reg_from_imgcat ${basename}.fits -n $NumPixMin -far $ApRadPix >/dev/null
The NumPixMin parameter is the basic controlling parameter here. If the
number of pixels in the threshold-detected image falls below the value of
NumPixMin, then this source is not written to the output cdfp and regions files.
Return to top of page.