Compile source catalogs for a list of input images. Note that you can graphically review the catalogs using the routine image_catalogs_review. The basis for this catalog methodology is discussed in Image Segmentation and Contouring.
% image_catalogs list.0 Set1 Y N Usage: image_catalogs list.0 Set1 Y N arg1 - Name of file with list of input FITS images arg2 - output directory name appendix (can be \"none") arg3 - Clean all but the table files (Y/N) arg4 - run in debug mode (Y/N)Note that this routine will delete any pre-existing VISCAT/ or IMGCAT0/ subdirectories in the ./local_red directory. All of the catalog information will be stored (using the arg2 value in the above example) in the subdirectory:
./local_red/IMAGE_CATS_Set1/ The catalogs are stored in subdirectories that se the image basename. A typical directory might be: % ls local_red/IMAGE_CATS_Set1/20191018T024545.3_acm_sci/ 20191018T024545.3_acm_sci_BGboxes.reg 20191018T024545.3_acm_sci.parlab 20191018T024545.3_acm_sci.table 20191018T024545.3_acm_sci.params 20191018T024545.3_acm_sci.props
For creating catalogs for astrometry, I use arg2="none". The catalogs will be stored in image-specific directories, as opposed to using wcsf_imgcat, which dumps all of the catalogs into a single directory named IMGCAT0. Here is an example for a single image:
Basename of image = 20191018T024545.3_acm_sci % ls ./local_red/IMGCAT0/ 20191018T024545.3_acm_sci_BGboxes.reg 20191018T024545.3_acm_sci_detsig.fits 20191018T024545.3_acm_sci.parlab 20191018T024545.3_acm_sci_bkg1.fits 20191018T024545.3_acm_sci.fits 20191018T024545.3_acm_sci.props 20191018T024545.3_acm_sci.cat0 20191018T024545.3_acm_sci_label0.fits 20191018T024545.3_acm_sci_sigma.fits 20191018T024545.3_acm_sci.cdfp 20191018T024545.3_acm_sci.params 20191018T024545.3_acm_sci.table % ls ./local_red/IMAGE_CATS/20191018T024545.3_acm_sci/ 20191018T024545.3_acm_sci_BGboxes.reg 20191018T024545.3_acm_sci_detsig.fits 20191018T024545.3_acm_sci.parlab 20191018T024545.3_acm_sci_bkg1.fits 20191018T024545.3_acm_sci.fits 20191018T024545.3_acm_sci.props 20191018T024545.3_acm_sci.cat0 20191018T024545.3_acm_sci_label0.fits 20191018T024545.3_acm_sci_sigma.fits 20191018T024545.3_acm_sci.cdfp 20191018T024545.3_acm_sci.params 20191018T024545.3_acm_sci.tableHence, we see that this routine (image_catalogs) creates the catalogs in a batch mode, and it stores them in a more organized and easily accessible manner. The presence of the ./local_red/IMAGE_CATS subdirectory indicates to wcsf that the image catalogs are already compiled and hence a run of wcsf_imgcat is skipped. This saves considerable user time during interactive runs.