dettool options (2006/12/14) partially updated 2008/03/26

Usage: dettool <mode> [<options>]

<mode>:

-pending list active detruns -definebytag -definebyquery -definebydetrun -makecorrection -tocorrectexp -tocorrectimfile -addcorrectimfile -raw -runs -childlessrun -input -toprocessedimfile -addprocessedimfile -processedimfile -revertprocessedimfile -toprocessedexp -addprocessedexp -revertprocessedexp -processedexp -tostacked -addstacked -stacked -revertstacked -tonormalize -addnormalizedstat -normalizedstat -revertnormalizedstat -tonormalizedstat -addnormalizedimfile -normalizedimfile -revertnormalizedimfile -tonormalizedexp -addnormalizedexp -normalizedexp -revertnormalizedexp -toresidimfile -addresidimfile -residimfile -revertresidimfile -toresidexp -addresidexp -residexp -revertresidexp -todetrunsummary -updateresidexp -adddetrunsummary -detrunsummary -revertdetrunsummary -updatedetrun -rerun -register_detrend -register_detrend_imfile

Pan-STARRS Detrend Tool Usage: dettool <mode> [<options>]

<mode> :

-pending Optional arguments, with default values:

-exp_tag () search by exposure ID -exp_type () search by exposure type -inst () search by camera -telescope () search by telescope -filter () search by filter -uri () search by URL -simple (FALSE) use the simple output format

-definebytag

Use this mode to specify a list of particular exposures to use by providing their exposure tags

Optional arguments, with default values:

-exp_tag () include this exposure (multiple OK, required) -det_type () define the type of detrend run (required) -mode (master) define the mode of this detrend run -exp_type () define exposure type -filter () define filter -airmass (nan) define airmass -exp_time (nan) define exposure time -ccd_temp (nan) define ccd tempature -posang (nan) define rotator position angle -object () define exposure object -registered (2006-12-14T20:09:48.0) time detrend run was registered -use_begin () start of detrend run applicable peroid -use_end () end of detrend run applicable peroid -simple (FALSE) use the simple output format

-definebyquery

Use this mode to select exposures based on a set of search parameters

Optional arguments, with default values:

-det_type () define the type of detrend run (required) -mode (master) define the mode of this detrend run -exp_type () define exposure type -filter () define filter -airmass (nan) define airmass -exp_time (nan) define exposure time -ccd_temp (nan) define ccd tempature -posang (nan) define rotator position angle -object () define exposure object -registered (2006-12-14T20:09:48.0) time detrend run was registered -use_begin () start of detrend run applicable peroid -use_end () end of detrend run applicable peroid -select_exp_type () search for exp_type -select_inst () search for camera -select_telescope () search for telescope -select_filter () search for filter -select_uri () search for uri -select_dateobs_begin () search for exposures by time (>=) -select_dateobs_end () search for exposures by time (<) -pretend (FALSE) print the exposures that would be included in the detrend run and exit -simple (FALSE) use the simple output format

-definebydetrun Optional arguments, with default values:

-det_id () det ID to base a new detRun on (required) -set_det_type () define the type of detrend run (required) -set_mode (master) define the mode of this detrend run -set_exp_type () define exposure type -set_filter () define filter -set_airmass (nan) define airmass -set_exp_time (nan) define exposure time -set_ccd_temp (nan) define ccd tempature -set_posang (nan) define rotator position angle -set_object () define exposure object -set_registered (2006-12-14T20:09:48.0) time detrend run was registered -set_use_begin () start of detrend run applicable peroid -set_use_end () end of detrend run applicable peroid -filter_input_begin () filter input detrun exp to be in this peroid -filter_input_end () filter input detrun exp to be in this peroid -simple (FALSE) use the simple output format

-raw Optional arguments, with default values:

-simple (FALSE) use the simple output format

-runs Optional arguments, with default values:

-det_type () search for type of detrend run -simple (FALSE) use the simple output format

-input Optional arguments, with default values:

-det_id () search for detrend ID -iteration (0) define iteration number -exp_tag () search for exp ID -simple (FALSE) use the simple output format

-toprocessedimfile Optional arguments, with default values:

-det_id () search for detrend ID -exp_tag () search for exp ID -class_id () search for class ID -limit (0) limit result set to N items -simple (FALSE) use the simple output format

-addprocessedimfile Optional arguments, with default values:

-det_id () define detrend ID (required) -exp_tag () define exp ID (required) -class_id () define class ID (required) -uri () define URI (required) -recip () define recipe (required) -bg (nan) define exposue background -bg_stdev (nan) define exposue background stdev -bg_mean_stdev (nan) define exposue background mean stdev -b1_uri () define banana 1 -b2_uri () define banana 2

-processedimfile Optional arguments, with default values:

-det_id () search for detrend ID -exp_tag () search for exp ID -class_id () search for class ID -chip (FALSE) restrict results to completed 'chip' sets -exp (FALSE) restrict results to complete 'exposures' -included (FALSE) restrict results to exposures 'includeded' in the current iteration -simple (FALSE) use the simple output format

-toprocessedexp Optional arguments, with default values:

-limit (0) limit result set to N items -simple (FALSE) use the simple output format

-addprocessedexp Optional arguments, with default values:

-det_id () define detrend ID (required) -exp_tag () define detrend ID (required) -recip () define recipe (required) -bg (nan) define exposue background -bg_stdev (nan) define exposue background stdev -bg_mean_stdev (nan) define exposue background mean stdev -b1_uri () define banana 1 -b2_uri () define banana 2

-processedexp Optional arguments, with default values:

-det_id () define detrend ID (required) -exp_tag () define detrend ID (required) -simple (FALSE) use the simple output format

-tostacked Optional arguments, with default values:

-limit (0) limit result set to N items -simple (FALSE) use the simple output format

-addstacked Optional arguments, with default values:

-det_id () define detrend ID (required) -iteration (0) define iteration number -class_id () define class ID (required) -recip () define recipe (required) -bg (nan) define exposue background -bg_stdev (nan) define exposue background stdev -bg_mean_stdev (nan) define exposue background mean stdev -uri () define URI (required)

-stacked Optional arguments, with default values:

-det_id () search for detrend ID -iteration (0) search for iteration number -class_id () search for class ID -recip () search for recipe -simple (FALSE) use the simple output format

-tonormalize Optional arguments, with default values:

-limit (0) limit result set to N items -simple (FALSE) use the simple output format

-addnormalizedstat Optional arguments, with default values:

-det_id () define detrend ID (required) -iteration (0) define iteration number -class_id () define class ID -norm (nan) define normal value (required)

-tonormalizedstat Optional arguments, with default values:

-limit (0) limit result set to N items -simple (FALSE) use the simple output format

-addnormalizedimfile Optional arguments, with default values:

-det_id () define detrend ID (required) -iteration (0) define iteration number -class_id () define class ID (required) -uri () define URI (required) -bg (nan) define exposue background -bg_stdev (nan) define exposue background stdev -bg_mean_stdev (nan) define exposue background mean stdev -b1_uri () define banana 1 -b2_uri () define banana 2

-normalizedimfile Optional arguments, with default values:

-det_id () search for detrend ID (required) -iteration (0) search for iteration number -class_id () search for class ID -recip () search for recipe -simple (FALSE) use the simple output format

-tonormalizedexp Optional arguments, with default values:

-limit (0) limit result set to N items -simple (FALSE) use the simple output format

-addnormalizedexp Optional arguments, with default values:

-det_id () define detrend ID (required) -iteration (0) define iteration number -recip () search for recipe -bg (nan) define exposue background -bg_stdev (nan) define exposue background stdev -bg_mean_stdev (nan) define exposue background mean stdev -b1_uri () define banana 1 -b2_uri () define banana 2

-normalizedexp Optional arguments, with default values:

-det_id () define detrend ID (required) -iteration (0) define iteration number -recip () search for recipe -bg (nan) define exposue background -bg_stdev (nan) define exposue background stdev -bg_mean_stdev (nan) define exposue background mean stdev -b1_uri () define banana 1 -b2_uri () define banana 2 -simple (FALSE) use the simple output format

-toresidimfile Optional arguments, with default values:

-limit (0) limit result set to N items -simple (FALSE) use the simple output format

-addresidimfile Optional arguments, with default values:

-det_id () define detrend ID (required) -iteration (0) define iteration number -exp_tag () define detrend ID (required) -class_id () define class ID (required) -uri () define resid file URI (required) -recip () define recipe (required) -bg (nan) define exposue background -bg_stdev (nan) define exposue background stdev -bg_mean_stdev (nan) define exposue background mean stdev -b1_uri () define banana 1 -b2_uri () define banana 2

-residimfile Optional arguments, with default values:

-det_id () search for detrend ID (required) -iteration (0) search for iteration number -exp_tag () define detrend ID (required) -class_id () search for class ID -recip () search for recipe -simple (FALSE) use the simple output format

-toresidexp Optional arguments, with default values:

-limit (0) limit result set to N items -simple (FALSE) use the simple output format

-addresidexp Optional arguments, with default values:

-det_id () define detrend ID (required) -iteration (0) define iteration number -exp_tag () define detrend ID (required) -recip () define recipe (required) -bg (nan) define exposue background -bg_stdev (nan) define exposue background stdev -bg_mean_stdev (nan) define exposue background mean stdev -b1_uri () define banana 1 -b2_uri () define banana 2 -reject (FALSE) exposure is not to be stacked in the next iteration

-residexp Optional arguments, with default values:

-det_id () search for detrend ID (required) -iteration (0) search for iteration number -exp_tag () search for exp ID -recip () search for recipe -reject (FALSE) search for acceptable residuals -simple (FALSE) use the simple output format

-residdetrun Optional arguments, with default values:

-simple (FALSE) use the simple output format

-updateresidexp Optional arguments, with default values:

-det_id () define detrend ID -iteration (0) define iteration number -exp_tag () define exp ID -recip () define recipe -bg (nan) define exposue background -bg_stdev (nan) define exposue background stdev -bg_mean_stdev (nan) define exposue background mean stdev -b1_uri () define banana 1 -b2_uri () define banana 2 -reject (FALSE) exposure is not to be stacked in the next iteration

-adddetrunsummary Optional arguments, with default values:

-det_id () define detrend ID (required) -iteration (0) define iteration number -bg (nan) define exposue background -bg_stdev (nan) define exposue background stdev -bg_mean_stdev (nan) define exposue background mean stdev -accept (FALSE) declare that this detrun iteration is accepted as a master

-detrunsummary Optional arguments, with default values:

-det_id () search for detrend ID -iteration (0) search for iteration number -simple (FALSE) use the simple output format

-updatedetrun Optional arguments, with default values:

-det_id () search for detrend master for detrend ID (required) -again (FALSE) start a new iteration of this detrend run -state () set the state of this detrend run

-rerun

Start a new iteration of the specified detRun, providing an explicit list of the exposures to include. Useful if you've got a problem exposure that is not being weeded out by the rejections.

Optional arguments, with default values:

-det_id () search for detrend master for detrend ID (required) -exp_tag () include this exposure (multiple OK, required)

-register_detrend Optional arguments, with default values:

-det_type () define the type of detrend run (required) -mode (master) define the mode of this detrend run -exp_type () define exposure type -filter () define filter -airmass (nan) define airmass -exp_time (nan) define exposure time -ccd_temp (nan) define ccd tempature -posang (nan) define rotator position angle -object () define exposure object -registered (2006-12-14T20:09:48.0) time detrend run was registered -use_begin () start of detrend run applicable peroid -use_end () end of detrend run applicable peroid -bg (nan) define exposue background -bg_stdev (nan) define exposue background stdev -bg_mean_stdev (nan) define exposue background mean stdev -simple (FALSE) use the simple output format

-register_detrend_imfile Optional arguments, with default values:

-det_id () define detrend ID (required) -class_id () search for class ID (required) -uri () define resid file URI (required) -bg (nan) define exposue background -bg_stdev (nan) define exposue background stdev -bg_mean_stdev (nan) define exposue background mean stdev -b1_uri () define banana 1 -b2_uri () define banana 2

-revertprocessedimfile -revertprocessedexp -revertstacked -revertnormalizedstat -revertnormalizedimfile -revertnormalizedexp -revertresidimfile -revertresidexp -revertdetrunsummary

When a detRun fails and raises a fault flag in the database, it will not proceed until the fault is cleared. Use this family of modes to clear fault flags from the corresponding table (i.e. use -revertprocessedimfile for the detProcessedImfile table)

Optional arguments, vary somewhat by mode:

-det_id search for detrend ID (required) -exp_id search by exposure ID -class_id search by class ID -code search by fault code