<acis-fluence_FP6pscaling.pl> script documentation
- Introduction:
This script is the same as acis-fluence_P3pscaling.pl
except that it monitors the ACE/EPAM FP6' channel rather than
the P3' channel.
acis-fluence_FP6pscaling.pl is a perl script that reads in the
output file produced by ace-flux.pl, ACE-flux.dat, as
well as reading in the instrument focal plane and OTG history
files (FPHIST-2001.txt and GRATHIST-2001.txt, respectively) produced
by acis-backstop.pl.
It multiplies the latest ACE/EPAM flux measurement found in
ACE-flux.dat by the
following "attenuation factors": 0 if the HRC is in the focal
plane, 1 if ACIS is in the focal plane, 0.2 if the HETG are
deployed, 0.5 if the LETG are deployed, and 1 if neither
gratings are deployed. This script is run every 5 minutes via
CRON so therefore, keeps a running sum of the "ACIS" fluence
as determined by the ACE/EPAM fluxes for each
orbit. Specifically, this script monitors the ACE/EPAM FP6'
channel. If the fluence (ie, the "running sum") in this
channel exceeds 1E9, an alert is issued to
'acisdude'. An alert from this monitor may serve as
an "heads-up" to the science operations team as a violation
from this monitor is an indication that the radiation
environment is elevated. There is only 1 version of this monitor
operational and it is run out of
/data/acis/acisdude/FLU-MON/ and it is visible from any
HEAD LAN machine. Moreover, this script reads in the Chandra
ephemeris file located in
/proj/rac/ops/ephem/gephem.dat which is produced and
maintained by Tom Aldcroft. It reads this file to determine
the transition from "descending" to "ascending" (via the log
file cxodirect.dat) -- ie, to
determine when Chandra has crossed perigee. When it has, the
script resets all fluences to zero and writes the fluence for
all EPAM channels to a fluence archive (ACIS-fluence.arc). The
script also reads in the DSN schedule located in
/proj/rac/ops/ephem/dsn_summary.dat which is also produced
and maintained by Tom Aldcroft. If an alert is issued, the
text message includes the times for next 3 DSN passes. The
script keeps track of alerts spawned in an orbit by keeping a
log in falert.dat. Lastly,
the ACIS fluences for all the ACE/EPAM channels are output to
a txt file -- ACIS-FLUENCE.dat.
- Execution dependencies:
Requires access to the Chandra ephemeris file located at
/proj/rac/ops/ephem/gephem.dat and the DSN schedule in
/proj/rac/ops/ephem/DSN.sch.
- Script dependencies:
- Scripts used by acis-fluence_FP6pscaling.pl
- none
- Scripts that depend on the outputs
- ace-fluence.pl
-
-
- File dependancies:
- Input files:
- ACE-flux.dat (created by ace-flux.pl)
- FPHIST-2001.txt (created by ACE-update.ksh)
- GRATHIST-2001.txt (created by ACE-update.ksh)
- /proj/rac/ops/ephem/dsn_summary.dat (produced and maintained by TST)
- /proj/rac/ops/ephem/gephem.dat (produced and maintained by TST)
- Output files:
- ACIS-FLUENCE.dat (used by ace-fluence.pl)
- ACIS-fluence.arc (used by ace-fluence.pl)
- ACE-fluence.arc (see ace-flux.pl)
- falert.dat
- cxodirect.dat
- Code Location and execution
- Problems and Issues
- Notes
Go up one level
Last modified: Wed Jan 14 10:17:37 EST 2004