acis-backstop.pl CODE documentation

CODE storage:

Configuration control location:

/data/acis/LoadReviews/cvs-repository/acis-backstop

Execution location:

/data/acis/LoadReviews/script/acis-backstop.pl

Execution Machine:

prefer Rhodes, but acceptable on and HEAD-LAN machine

EXTRA DOCUMENTATION FOR REWRITES

A major rewrite of the tool occured in 2007 where the changes were documented in the file acis-backstop-changes.pdf.

A second major rewrite of this tool occured in 2011/2012 to support the Science Only Safing Action (SOSA). Information and discussion on the SOSA design can be found on the ACIS Ops Twiki.

Parameter checks The script will also check certain parameters from the OCAT and compare them to the parameter block. Items checks are:

1. Exposure Mode
2. Event Telemetry
3. Frame Time
4. Subarrys- including custom and preset(1/2, 1/4, 1/8)
5. Duty Cycle
6. OnChip Summing
7. Event Energy Filters
8. CCDs requested vs WSPOW command

1. Inserted Grating vs OCAT setting
2. SIM-Z offset
3. SIM-Z aimpoint

The TESTS this code performs can be categorized into the following 3 groups:

1. SIM and radiation zone tests
   • check that there is at least 5 hrs between EE1 entry and perigee
   • check that there is at least 5 hrs between perigee and XE1
   • check that there are ORBITAL EVENTS in the load (ie, perigee, e/p zones, etc) ensure that there is a 10 ks pad time on entry to the rad zone (defined as pad = <time of E1 entry>- <time of radmon DS>)
   • ensure that no SIM translation occurs during the entry leg pad time
   • ensure that the rad mon DS command is issued at least 10 ks before entry into the E1 rad zone but no earlier than 15 ks.
   • ensure that no SIM translation occurs during rad zone transit
   • ensure that no SIM translation occurs during the exit leg pad time
   • ensure that there is no SIM translation during an ACIS science run
   • ensure that the rad mon EN command is issued at least 13 ks after exit from the E1 rad zone but no later than 15 ks
   • ensure that there is a 10 ks pad time on exit from the rad zone defined as pad = <time of radmon EN>- <time of E1 exit>)
   • coupled with 2 of the above tests, I ensure that the rad mon DS occurs before E1 entry and that rad mon EN occurs after E1 exit
   • each SIMTRANS command is converted from motor steps to mm (397.67 motor steps/mm)
   • there is a check that is done on z-sim so that it does not occur in the blocked region of -8 mm to -11.5 mm because of possible fid light problems
2. ACIS tests
   • ensure an OBSID change occurs at least 3 mins after a stop science
   • check that there are at least as many occurences of OBSID changes as there start science commands
   • check that there is at least one WSVIDALLDN for every start science occurence
   • check that there is at least one RS_0000001 command for every start science
   • check that there is at least one stop science command for every start science command
   • checks to see if we are in FMT 2 if ACIS is in the focal plane
   • checks to see if we are in FMT 2 when doing a CTI measurement
   • checks that a FMT1 change happens at least 3 minutes after a stop science.
   • checks to see that we are in the HRC-S position prior to radiation belt entry
   • added check to see if RADMON is ENABLED if Chandra is in the focal plane.
   • computes time difference between LAST AA00000000 and EPERIGEE; ensures video boards are powered down well before the belts
   • computes time difference between LAST WSVIDALLDN and EPERIGEE; ensures video boards are powered down well before the belts
   • confirms that DITHER is enabled if ACIS is starting an observation and is in the focal plane

• Time of observation. Determined by start science to stop science OR SIM translation to stop science OR SIM focus to stop science OR grating insert to stop science. The start of the observation really depends on the bias times too and hopefully this can be added.
• Real time communication durations
• SIM-Z translation if not at the nominal point

Author:
Shanil Virani