       Bundles three programs: tg_findzo, tg_choose_method, and
        tgdetect into one in order to provide a more convenient interface
        for determination of the zeroth order centroid.

CIAO provides two algorithms for for determining the zeroth order centroid location in ACIS observations. First is the familiar point-source image-detection tool tgdetect (which runs celldetect). For bright sources where the zeroth order is heavily distored by pileup or if it was blocekd from telemetry, the tg_findzo tool should be used. The choice of which tool can be determined automatically by performing some simple analysis of the tg_findzo results.

This program will run tg_findzo, tg_choose_method, and tgdetect and provide a source table ("src1a" file) created using the best method. Note that the choices are only appropriate for grating observations using the ACIS detector; with HRC, tgdetect is always used.

The method used will be recorded in the output file's header with the keyword TGMETHOD.

tgdetect2 infile=evt1.fits outfile=src1a.fits zo_pos_x=default zo_pos_y=default

Take evt1 file and create a src1a fits file.

Input event file name.

output src1a file name.

Initial guess for the target sky coordinate X. It can be "default" or a real number. For 'default', the tool takes RA_TARG, DEC_TARG in the input header and converts it to the sky coordinates.

Initial guess for the target sky coordinate Y. It can be "default" or a real number. For 'default', the tool takes RA_TARG, DEC_TARG in the input header and converts it to the sky coordinates.

Default value is yes to do a punlearn on tgdetect to set all its parameters to the defaults.

Default value is yes to do a punlearn on tg_findzo to set all its parameters to the defaults.

Program verbosity, 0 (least) to 5 (most).

    Remove output file if it already exists?

Changes in CIAO 4.15

The header of the new file (the outfile parameter) will now contain the parameter settings for this tool. It can be retrieved with the dmhistory tool or the get_history_records method of the pycrates python library.

See the bugs page for this tool on the CIAO website for an up-to-date listing of known bugs.

December 2022