This article describes how to search for and retrieve JWST engineering telemetry.

On this page...

Engineering Database Contents

Mnemonics

Data associated with the thousands of engineering telemetry points on JWST are stored in the Engineering Database. The data take the form of timeseries, and they may be searched with the Engineering Database Portal by means of an identifier, or mnemonic. The mnemonics have a naming convention which has the form:

<X><Y>_<Z>

where:

  • <X> indicates the system, with one of the characters:
    • I: for ISIM (the integrated science instrument module)

    • S:  for Spacecraft
  • <Y> indicates the subsystem, instrument, controller, or component (1 to 4 letters)
  • <Z> indicates the telemetry name (2 to as many as 20 alphanumeric characters or underscores)

For instance, a mnemonic name beginning with INRS_ pertains to the instrument NIRSpec, INIS_ pertains to NIRISS; SA_ to the spacecraft attitude control system, and so on. To search for and retrieve engineering data with these mnemonics, see the article: Using the Engineering Data Portal.

Time Sampling

Some mnemonics are sampled at a predefined frequency, whether the value has changed or not. Others mnemonics are reported only if they have changed since the last time they were sampled (e.g., for changes of state among a small number of possible values).

Data Tuples

Some engineering data occur in tuples, that is, two or more values may be needed to fully define an engineering quantity of interest. For instance,

  • SA_ZATTESTn, where the value n ranges from 1 through 4, define the coefficients of the quaternion, i.e., the 4-dimensional quantity that defines the JWST pointing and roll.
  • SA_ZADUCMDX and SA_ZADUCMDY define the commanded x- and y-position of the fine steering mirror (FSM).

Such quantities are generally analyzed together, as illustrated in the plot below for the FSM position as simulated during an exercise. See the JWST EDB Retrieval tutorial in the Using MAST APIs article for details. Be aware that engineering data as retrieved from MAST are stored one mnemonic per file.


Trace of FSM position with timePlot of the commanded (x,y) position of the Fine Steering Mirror as a function of time. Colors correspond to time intervals when the FSM was being actively commanded. The color of the trace is different for each time interval: see legend.

For Further Reading...

See the following articles for instructions on querying the Engineering Database:

Data Use | Acknowledgements | DOI | Privacy

Send comments & corrections on this MAST document to: archive@stsci.edu