NAME

attjumpcorr - correct Swift attitude files for jumps

USAGE

attjumpcorr infile outfile

DESCRIPTION

The Swift spacecraft is known to report small (~arcminute) jumps in attitude while settling into pointing mode. It is believed that these jumps are not physical, but rather the result of a change of state within the spacecraft attitude control system. In particular, the jumps, if present, should occur after entering "10 arcminute" aquisition state, but before entering the "settled" state.

This task removes large magnitude jumps from Swift attitude files that have the above behavior. The magnitude of a detectable jump is governed by the "jumpthresh" parameter, expressed in arcsec/second. Both the spacecraft quaternions and the pointing vectors (R.A., Dec., and Roll) are adjusted.

The task has two correction methods. When method=CONSTANT, the attitude is assumed to be constant across the jump. When method=LINEAR, a constant slew slew rate is assumed.

After adjustment, the attitude file will of course still contain normal slews, so it is the user's responsibility to account for this while analyzing science data. However, sudden jumps in the attitude, during the settling phase after a slew, should be removed.

attjumpcorr has two safety mechanisms. Jumps larger than jumpmax arcseconds are ignored (in case the jump is "real"). If the number of jumps in a given slew exceeds njumpmax then the slew is ignored (the rationale being, if there are many jumps, there must be an uncorrectable error in the attitude data).

PARAMETERS

infile [filename]
The name of the input attitude file

outfile [filename]
The name of the output (adjusted) attitude file

(method = "LINEAR") [string]
Method of correction, either LINEAR (assume constant rate slew across jump) or CONSTANT (assume constant attitude across jump).

(maxgap = 60.0) [real]
Time gaps in the file larger than this value, in seconds, cause the algorithm to assume that a slew has occurred.

(jumpthresh = 20.0) [real]
If angular changes in the attitude file from one sample to the next, as measured in arcsec per second, are larger than this value, then a jump is assumed. A maximum one jump is allowed per slew (the largest is found).

(jumpmax = 600.0) [real]
Angular attitude jumps larger than jumpmax (in arcsec) are ignored.

(njumpmax = 2) [integer]
If the number of jumps in a given slew exceeds njumpmax, then the slew is ignored.

(clobber = NO) [boolean]
If the output file already exists, then setting "clobber = yes" will cause it to be overwritten.

(chatter = 2) [integer, 0 - 5]
Controls the amount of informative text written to standard output. Setting chatter = 1 produces a basic summary of the task actions; chatter = 2 (default) additionally prints a summary of input parameters; chatter = 3 prints a summary of each attitude jump; chatter = 5 prints extensive debugging information.

(history = YES) [boolean]
If history = YES, then a set of HISTORY keywords will be written to the header of the specified HDU in the output file to record the value of all the task parameters that were used to produce the output file.

EXAMPLES

1. Corrects the attitude file for jumps using the default parameters,

     attjumpcorr input.att output.att

SEE ALSO

attdump