|AHELP for CIAO 4.2||
Match sources between two source lists by their 2-D separation files.
tgmatchsrc infile refsrcfile outfile max_separation [clobber] [verbose]
`tgmatchsrc' attempts to reconcile two source lists: an input source list, and a reference source list. It is assumed that there will not be multiple matches between the lists, so once a match is found, no further matches are searched for, and both sources are removed from future match searches. A match is determined by comparing the distance between the sources with the threshold separation parameter (in arcsec).
All reference sources are written to the output with the same ID, but if there is a match, the output data will be for the highest SNR of the two. Unmatched input sources are appended to the output with new sequential IDs. Then any unmatched new sources are appended to the end of the file; they also have new source ids assigned to them.
It should be noted that if refsrcfile is set to none, NONE, or "", then a copy of the infile will be made.
This tool is used by tgdetect for determining zero-order sources over multiple observation intervals. It is not normally run independently.
Both of the input files should share the same format. This is important in that the output file is going to be defined to have the same structure as the infile, and rows are going to be written to the outfile from both the infile and the refsrcfile. In particular though, the following columns are required, and if they cannot be found in both source files, the task will exit with an error:
|RA||in decimal degrees|
|DEC||in decimal degrees|
The output file name will have an extension name of SRCLIST.
If there are any errors the task will return -1 and print the errors that occurred to the screen. Otherwise zero will be returned.
The Source Matching algorithm works as follows:
if source_separation <= separation threshold then the sources match,
where source_separation is determined as follows:
sqrt((ref_src_RA - new_src_RA)**2 + (ref_src_DEC - new_src_DEC)**2)
Note that the RA and DEC are in decimal degrees while the input separation threshold is in arcsec. The later is converted to decimal degrees within the code.
tgmatchsrc tgmatchsrc_new_src.fits tgmatchsrc_ref_src.fits . 1 clobber=yes verbose=4
Match sources between tgmatchsrc_new_src.fits and the reference file, tgmatchsrc_ref_src.fits, setting the separation threshold to one arcsecond.
Parameter=infile (file required)
New sources file to compare with the reference table.
Parameter=refsrcfile (file required default=NONE)
Reference sources file.
Parameter=outfile (file required default=. autoname=yes)
Output file name
Parameter=max_separation (real required default=3 min=0 max=20 units=arcsec)
Maximum allowed separation (arcsec) for sources to match.
Parameter=clobber (boolean default=no)
Overwrite existing output file, or don't.
Parameter=verbose (integer default=0 min=0 max=5)
Control amount of diagnostic chatter from none (0) to most (5).
See the bugs page for this tool on the CIAO website for an up-to-date listing of known bugs.