AEATTCOR (May 2007) ftools.suzaku AEATTCOR (May 2007)
NAME
aeattcor -- correct Euler angles in attitude file for Suzaku
USAGE
aeattcor ae123456789.att ae123456789.attcor \
ae123456789.orb ae123456789.hk
DESCRIPTION
This tool calculates the effects of the "thermal wobbling"
caused by thermal distortions of the satellite bodies,
and correct the Euler angles in attitude file for Suzaku.
The attitude correction function is described in
'Empirical Correction of Thermal Wobbling',
JX-ISAS-SUZAKU-MEMO-2007-04, as
XOFFSET = -38.5*(b/60) - 9.25 + 0.4*T_86 [pixel]
YOFFSET = 10.0 + ( 7.0/1000)*T_DY [pixel] for T_DY < 0 [s]
= 10.0 + ( 5.0/2000)*T_DY [pixel] for 0 < T_DY < 2000 [s]
= 45.0 - (15.0/1000)*T_DY [pixel] for 2000 < T_DY [s]
b: Ecliptic latitude [deg]
T_86: Temperature difference, HK_XIS_RAD8_T1_CAL - HK_XIS_RAD6_T1_CAL
T_DY: Time after night-day transision [s], defined as
T_DY = T_DY_NT, for day-time
T_DY = -TN_DY_NT, for night-time
Following columns are also added.
EULER_OLD: contains original Z-Y-Z euler angles [deg]
XOFFSET: calculated XOFFSET by the above formula [pixel]
YOFFSET: calculated YOFFSET by the above formula [pixel]
T_86: HK_XIS_RAD8_T1_CAL - HK_XIS_RAD6_T1_CAL [K]
T_DY: T_DY_NT for day-time, -TN_DY_NT for night-time [s] in EHK
FLAG_ATTCOR: attitude correction was conducted (=1) or not (=0)
If the EULER_OLD column already exists in the input attitude file,
the aeattcor task reads the Euler angles from this column.
Therefore, applying the aeattcor to the corrected products gives
the same output with the input attitude file, except for history.
PARAMETERS
infile [file name]
input attitude file name
outfile [file name]
output attitude file name
orbit [file name]
orbit file name
hkfile [file name]
common HK file name
(hk_time_margin = 60.0) [real]
HK time margin in second
(num_event = -1) [integer]
number of event (-1=all,0=exit)
(event_freq = 10000) [integer]
Event number printout frequency
(anl_verbose = 0) [integer]
ANL verbose level (-1:full, 0:minimum)
(anl_profile = no) [integer]
Enable ANL module profiling
(chatter = 2) [integer]
message chatter level (0:min,2:norm,5:max)
EXAMPLES
% aeattcor ae400006010.att.gz ae400006010.attcor \
ae400006010.orb.gz ae400006010.hk
aeattcor version 2007-04-08
Written by Y.ISHISAKI (TMU)
Built on ANL HEADAS converter 1.73 for ANL version 1.73
aeattcor: *** show parameter ***
INFILE 'ae400006010.att.gz'
OUTFILE 'ae400006010.attcor'
ORBIT 'ae400006010.orb.gz'
HKFILE 'ae400006010.hk'
HK_TIME_MARGIN 60.0 (s)
CLOBBER YES
aste_orbit: reading 'ae400006010.orb.gz[EXTNAME=PAR_ORBIT,EXTVER=0]' ...
nrow=28805, nkp=25921, tstart=183340800.0, tstop=184896000.0
aste_gethk-2.5: found 'HK_XIS_RAD6_T1_CAL' at hdu=3, col=134 \
in 'ae400006010.hk'
aste_gethk-2.5: t=184176126.248 < TSTART=184209153.963 \
for 'HK_XIS_RAD6_T1_CAL' in 'ae400006010.hk'
aeattcor: INFO: TSTART=184209154.0 for ae400006010.hk
aste_gethk-2.5: found 'HK_XIS_RAD6_T1_CAL' at hdu=3, col=134 \
in 'ae400006010.hk'
aste_gethk-2.5: found 'HK_XIS_RAD8_T1_CAL' at hdu=3, col=138 \
in 'ae400006010.hk'
aste_gethk-2.5: t=184289964.983 > TSTOP=184289962.826 \
for 'HK_XIS_RAD6_T1_CAL'
aeattcor: INFO: TSTOP=184289962.8 for ae400006010.hk
aste_gethk-2.5: found 'HK_XIS_RAD6_T1_CAL' at hdu=3, col=134 \
in 'ae400006010.hk'
NUM_CORR = 150819 / number of corrected Euler angles
AVG_LAMB = 350.4655 / average ecliptic longitude (deg)
AVG_BETA = +52.6553 / average ecliptic latitude (deg)
AVG_XOFF = -42.4934 / average DETX offset (pixel)
AVG_YOFF = 6.1975 / average DETY offset (pixel)
SGM_XOFF = 5.1810 / 1 sigma DETX offset standard deviation (pixel)
SGM_YOFF = 18.5209 / 1 sigma DETY offset standard deviation (pixel)
aeattcor: INFO: created 'ae400006010.attcor'
SEE ALSO
none
AUTHOR
This program was developed primarily in the ASTRO-E ANL environment by
Yoshitaka Ishisaki (TMU).
CONTACT
Questions and comments should be addressed to
astroehelp@olegacy.gsfc.nasa.gov.