Idle Dwell and HRC-Txing Checks

lr has been updated to call the new routines:

 Find_Idle_Dwells.py
 HRC_Txing_Check.py

The purpose of Find_Idle_Dwells.py is to scan the load being reviewed and
identify long dwells between ACIS Stop Science commands and
ACIS Start Science commands. This is in response to the
1DPAMZT Red Limit reached during the OCT3122 load. There was
a long dwell between ACIS science runs with 3 FEPs on, and
at high pitch which caused the violation.

The routine will alert the ACIS load reviewer that there is a long
dwell between science runs so that the reviewer can double check to
determine if the dwell is safe.

HRC_Txing_Check.py determines the time delta between the beginning of loading
one of the Event Histogram SI modes used when HRC is observing, and the
activation of SCS-134. The delta t must be at least equal to the bias time of the
SI mode used plus the amount of time Txings takes to acquire 6 samples and determine
whether or not a shutdown should occur.

lr was modified to call both of the above routines and also satisfy a request to
untar the <load_week>.or file from the weekly tarball.

Additional small changes to lr were made to remove extraneous print
statements and fix a typo in a print statement.

Load Review SCS-155 Deadman and HETG Checks

Change Description

This update to the ACIS Ops Load Review software provides checks for
the two Priority 2 guidelines as described in:

https://occweb.cfa.harvard.edu/twiki/bin/view/Constraints/MPGuidelines/Release/GuidelineRadiationSafingWithoutHRC

These are:

"When HRC data is not used for onboard radiation monitoring and safing, ensure the following:

1. HETG is inserted by rad entry, either during the same maneuver used to safe the SIM or prior,
   and kept in until at least the start of the maneuver to the first target exiting the rad
   zone Priority 2.

2. Ensure the following is commanded for every rad entry Priority 2:

   Time Event
   Rad Entry Minus 48h Activate SCS-155 containing; A_NSM_XXHR.RTS timer = 48h, 10m
   Rad Entry Nominal SI Safing
   Rad Entry + 5m Disable SCS-155"

The second guideline is referred to as the SCS-155 Deadman check, or
Deadman Check in this document.

For item 1, the update includes a new program: HETG_Check.py, which
checks the status of the HETG as compared to the perigee passages and
will flag a load which does not have the HETG in for the perigee passage.

For item 2, the update includes an new program: Deadman_Check.py which
will determine if the SCS-155 enable, activate and disable commands
appear in the load, and checks the timing of those commands as
compared to the guideline. SCS-155 contain the deadman timer and code
which will execute at deadman timer timeout and which protects ACIS.

The load review program itself, lr, was modified to execute the two
programs. In addition, to handle the circumstance where the SCS-155
enable and activate commands appear at the end of the Review load, but
the subsequent Radzone entry does not appear in the load, lr was
modified to extract the Orbital Events file (DO*.orp) from the load
week tarball. Utility programs were written to extract the information
from the DO*.orp file for use by Deadman_check.py as well as other
convenience programs.

Output from the two programs appears on the screen while lr is
running, and also appears in the log file created when LR is run, and
stored in the OFLS directory for that load week.

Files Changed or added:

The changes can be seen here:

#33

Testing:

The changes were tested by running these regression test loads:

FEB2122
FEB2822
MAR0722
MAR1122
MAR1422
MAR2122
MAR2822
JAN1022 - prior to the guideline being implemented, tests failure modes.

TEST_MAR2122 - MAR2122 load hand modified to test placement of the
SCS-155 disable command after the deadman timeout

These tests included all examples of load where the guidelines were
implemented which included Normal and TOO load types.

All tests passed.

Interface impacts

None

Review

ACIS Ops

Deployment Plan

Will be deployed after FSDS approval.

New LR switch: VOR for Vehicle Only Review

Change Description

The main driver for this update is handling the circumstance where the Review load is a full science + vehicle
commands load, but we know - prior to the review - that only the vehicle load command set, in the
review load, will be executed. The new LR switch: VOR for Vehicle Only Review was implemented. The Focal plane
thermal model had difficulties with the -109 database searches when the Vehicle-Only portion of a full load was
processed by lr (see FSDS-18).

The program which checks for power command timing errors had to be modified to handle loads without any ACISPKT commands.
Also the Check_Power_Cmds output messages were cleaned up and made more informative.

Files Changed or added:

lr, Release_Notes_V4.1.txt

The changes can be seen here:

#31

Must be installed with or after an acis_thermal_check update:

FSDS-18 - acisops/acis_thermal_check#48

Testing:

The changes were tested by running these regression test loads:

DEC2418A
DEC2418B
MAY2620
AUG3120
SEP2021
OCT2821
OCT3021
JAN1022
FEB1422

These test types included Normal, TOO, SCS-107 and Full Stop loads; loads with and without power commanding errors,
loads which were vehicle-only as built (e.g. MAY2620 and AUG3120), and loads which were built as full loads but
only the vehicle commands were activated (e.g. OCT2821 and FEB1422), and loads which were not affected by
Vehicle-Only Continuity or Review loads. In cases where there was no production case of a load type being executed as
a full Review load (science+vehicle) where the Vehicle-Only commands were executed, tests were run and checked by hand (e.g. JAN1022).

The assembled histories for OCT2821 and FEB1422 were checked by hand and these loads were added to the regression test suite.

Tests were also conducted using acis_thermal_check/pull/48 to assure that the problem was fixed and the results were correct.

Where applicable, thermal model output was checked. All differing results were accounted for: all tests passed.

Interface impacts

ACIS Ops lr user has a new switch to use when appropriate VOR.

Review

ACIS Ops

Deployment Plan

Install after FSDS approval.

Updates to handle full loads where only the Vehicle scs's are enabled

The main drivers for this update are:

1. Continuity load having the same load week name as the review load (e.g. SEP2121B SEP2021A)

   Prior to this update, the user did not specify the load letter for the continuity load in the lr
   command line. This prevented the prior load of the same load week as the review load from
   being specified as the continuity load.

2. A full weekly load being built with both science and vehicle commands, the load is uplinked,
   but only the vehicle commands executed (e.g. JAN1722).

   The thermal models need to know that when assembling a load history, only the vehicle commands
   should be included when reading ther continuity load. The ACIS Ops Load Review software (lr) was
   modified to give the user the ability to specify that, when reading continuity loads, the thermal models
   should read the vehicle-only VR*.backstop file. The default is to read the CR*.backstop file.

   This is accomplished by adding a --VO VOC switch to the lr command line. If not used the default read of
   CR*.backstop will be executed. If the switch is specified, it is first checked for legal values. If the value of
   VOC is supplied to the switch then the thermal models will read the VR*.backstop file. This is accomplished
   by appending "VO_" to the load type discerned by lr (Normal, TOO, SCS-107, FULL STOP).
   This load type is written out to the ACIS-Continuity.txt file, which is read by backstop history.

   This update must be done in concert with the update to Backstop_History as
   Backstop_History has been modified to recognize the VO_ prefix and knows how to handle it.

Additional updates were made to lr:

3. Fix the bug which incorrectly threw and error when checking for the "triplet" - a set of 3
   commands expected after the conclusion of the Perigee Passage inbound ECS measurement.
   Initially, lr expected the power command within the triplet to be WSVIDALLDN. Over time
   the triplet could contain WSPOW00000 and WSPOW0002A.

4. A --nomodels option to lr and run_models.pl which tells lr to not run the thermal models
   This can be used to speed up lr regression tests when the modification does not affect the
   thermal models.

5. Clarified the user prompts which, when the -break switch is used, determine what the
   load type is (TOO, SCS-107, STOP).

6. Added comments and fixed typos