SIS EAE-014, Rev. A, Change 2

MARS OBSERVER

Software Interface Specification

Maneuver Implementation/Reconstruction File

Jet Propulsion Laboratory

California Institute of Technology

Pasadena, California

Table of Contents

Author(s):  John E. Ekelund



	                        SIS EAE-014

                               MARS OBSERVER
                MANEUVER IMPLEMENTATION/RECONSTRUCTION FILE
                      Software Interface Specification

                                17 MAY 1993



ABSTRACT:  This document describes a file created by the Spacecraft Team
for use by MOPS within NAV.  The file contains commands, achievable
attitudes and velocities, and statistics associated with a TCM.



                         Jet Propulsion Laboratory
                    California Institute of Technology
                        Pasadena, California 91109



Mars Observer Software Interface Specification Interface Title: MANEUVER IMPLEMENTATION/RECONSTRUCTION FILE Interface Id: EAE 014 VERSION: FINAL Author: J.E. EKELUND Signature: J. Ekelund 5/20/93 Generating Element Engineer: ENGINEERING ANALYSIS J. McLeod 5/20/93 Receiving Element Engineer: NAVIGATION ANALYSIS J.E. Ekelund 5/20/93 Receiving Element Engineer: SCIENCE SUPPORT M. McCullar 5/20/93 Receiving Element Engineer: DATA STORAGE & RETRIEVAL A. Cherino 5/20/93 Approval Name and Title P.B. Esposito 5/25/93 Cognizant Interface Engineer Ben Jai 5/25/93 MO GDS Software System Engineer
DISTRIBUTION LIST DOCUMENT CHANGE LOG Change Date Affected Portions Letter Original 1/17/91 All Rev. A 7/17/91 Section 4.2.2.3, Maneuver Block Description, Appendix A added. Change 1 5/25/92 Section 4.2.2.1, Date definition. Change 2 5/17/93 Section 4.2.2.3, BLKTYP definition. List of TBD Items Page Resolution Date Item


1. GENERAL DESCRIPTION

1.1 PURPOSE OF INTERFACE

This Software Interface Specification (SIS) contains the description of the Maneuver Implementation/Reconstruction File. This file will be made available for use in MOPS.

1.2 SCOPE

The format and syntax specifications in this SIS apply to all phases of the mission.

1.3 APPLICABLE DOCUMENTS


 SFOC0038-01-09-01    1 May 90     SFOC-1-CDB-ANY-CATALOGUE2

 SFOC0099-01-00       13 Jun 90    Data Dictionary

 SFOC0038-00-08-01    26 Feb 88    SFOC-1-CDB-MGN-TIMESFILE

 SFOC0038-01-09-03    6 Feb 90     SFOC-2-SYS-ANY-TIMEFORMS

                      1 Jul 90     DPTRAJ-ODP User Reference Manual,
                                   SOM Vol. 1 and Vol. 2

                      1 Jul 90     DPTRAJ and ODP Interfaces and File
                                   Format Descriptions, SOM, Vol. 3

 JPL IOM 	      17 May 91    Maneuver Implementation/Reconstruction
 314.9191-638			   File from GE ASTRO

Letters from S. Davis (GE/ASD)

 a) MO-MOS-103	      17 Apr 91	   GE Delivery of the Maneuver Implementation/
				   Reconstruction File

 b) MO-MOS-104	      18 Apr 91	   Maneuver Name Used in the Maneuver
				   Profile File

1.4 FUNCTIONAL DESCRIPTION

1.4.1 Data Source, Destination, and Transfer Method

The source of the data is SCT. The destination of the data is MOPS. Data transfer shall be via the Project Data Base (PDB) using the SFOC LAN.

1.4.2 Pertinent Relationships with Other Interfaces

This file, which is produced by SCT, is a response to the Maneuver Profile File (SIS) previously transmitted from NAV to SCT.

1.4.5 Labeling and Identification (Internal/External)

An identification record shall be provided internally, describing the maneuver and the maneuver design stage (see section 4.2.1). The file name shall provide external identification.

1.4.4 Assumptions and Constraints

N/A

2. ENVIRONMENT

2.1 HARDWARE CHACTERISTICS AND LIMITATIONS

N/A

2.2 INTERFACE MEDIUM AND CHARACTERISTICS

The interface shall be a disk file written in formatted ASCII. The medium for transmittal to the Project Data Base (PDB) shall be the SFOC LAN.

2.3 INPUT/OUTPUT PROTOCOLS

None.

2.3.1 Device Addressing

N/A

2.3.2 Operating System Protocols

N/A

2.3.3 Deformatting

Users of the Implementation/Reconstruction File will be required to have software to remove the SFDU data.

2.3.4 Calling Sequence

N/A

2.4 FAILURE PROTECTION, DETECTION, RECOVERY FEATURES

2.4.1 Backup Requirements

This file may be recreated by the SCT.

2.4.2 Security/Integrity Measures

This file has no inherent security because it is directly text editable using system routines. Unit and system tests will debug the mechanisms for file creation by SCT and file reading by MOPS. As a stored file, the PDB security/integrity measures will be in effect.

2.5 END-OF-FILE (OR MEDIUM) CONVENTIONS

End-of-file shall be the standard end-of-file.

2.6 UTILITY PROGRAMS

A utility program will be required by the users of this file to remove the SFDU labels.

3. DATA FLOW CHARACTERISTICS

3.1 OPERATIONAL CHARACTERISTICS

3.1.1 Generation Method and Frequency

The file is produced by the SCT using the program PAS G&C MANEUVER. This file may be generated several times for a specific maneuver: for preliminary design, for final design, and for tweak.

3.1.2 Time Span of Product

N/A

3.2 DATA VOLUME

Less than 3 kilobytes of disk space.

3.3 FLOW RATE

TBD

4. DETAILED DATA OBJECT DEFINITION

4.1 STRUCTURE AND ORGANIZATION OVERVIEW

The Maneuver Implementation/Reconstruction File is an ASCII file which consists of the SFDU Header, the Maneuver Implementation/ Reconstruction File Headers, and Maneuver Implementation/Reconstruction Data. Each will be described in the following sections.

4.2 DATA FORMAT AND DEFINITION

4.2.1 SFDU Data Description

The SFDU information and structure, for the Maneuver Implementation/ Reconstruction File, (DDID = 0252) in diagramatic representation:
CCSD3ZS00001AAAAAAAA
    NJPL3KS0L015BBBBBBBB
        <CR><LF>
        MISSION_NAME=MARS_OBSERVER;<CR><LF>
        SPACECRAFT_NAME=MARS_OBSERVER1;<CR><LF>
        DATA_SET_ID=MANEUVER_IMPL;<CR><LF>
        FILE_NAME=mif.sff;<CR><LF>
        PRODUCER_ID=MO_SCT;<CR><LF>
        PRODUCT_CREATION_TIME=1990-07-18T22:00:00;<CR><LF>
    CCSD3RE00000BBBBBBBB
    NJPL3IS00252CCCCCCCC
In the actual Maneuver Implementation/Reconstruction File, the following SFDU data is located at the end of the file, following the non-SFDU data which is described in Section 4.2.2
    CCSD3RE00000CCCCCCCC
CCSD3RE00000AAAAAAAA

4.2.2 Non-SFDU Data Description

A TCM will usually consist of a sequence of maneuver blocks (example: roll, yaw, roll, burn, etc.). The file shall contain a separate record for the parameters describing each maneuver block. One additional record shall contain parameters describing the total maneuver.

Two dimensional matrices contained in this file are written by PAS/G&C/MANEUVER using the FORTRAN columnwise convention for cycling through the indices. MOPS must read two dimensional matrices using the FORTRAN column-wise convention. If an editor is used to produce a hardcopy of the file, printed matrices will appear as the transpose of the mathematical convention as shown below:

		A(1,1)     A(2,1)     A(3,1)

		A(1,2)     A(2,2)     A(3,2)

		A(1,3)     A(2,3)     A(3,3)

The non-SFDU portion of the file is as follows:

Header Record

A header record will be provided containing the following information:

LINE     COLUMN     FORMAT     DESCRIPTION
------------------------------------------
 1          1       A12        `MANEUVER'
 1         13       A36        Text identifying this maneuver

 2          1       A12        `MODE'
 2         13       A36        Text identifying maneuver mode

 3          1       A12        `STAGE'
 3         13       A36        Text describing maneuver design
                               stage

 4          1       A12        `BLOCKS'
 4         13       I3         Number of blocks in the maneuver

 5          1       A12        `S/C'
 5         13       A36        Text identifying the spacecraft

 6          1       A12        `CRS TAPE'
 6         13       A36        Text identifying CRS tape used
                               to generate this file

 7          1       A12        `P-FILE'
 7         13       A36        Text identifying the NAV P-file
                               used to generate the CRS tape

 8          1       A12        `PREP'
 8         13       A36        Name and extension of the analyst
                               who generated this file
 9          1       A12        `CREATION'
 9         13       A8         Creation date of this file in
                               the format MM-DD-YY
 9         25       A8         Creation time of this file in
                               the format HH:MM:SS
10          1       A12        `PROGRAM'
10         13       A12        Name of the program
10         45       A8         Date of program collection
10         55       A8         Time of program collection
Since the format of the header is fixed, there is no need for an "end-of-header" indicator.

Total Maneuver Description

This record contains parameters describing the total maneuver.
                PARAMETER
LN  COL  FORMAT        NAME        UNITS      DESCRIPTION
---------------------------------------------------------
 1   1   F10.3         VRA          deg       Right ascension of
                                              total achievable
                                              velocity, in
                                              J2000 coordinates
 1  11   F10.3         VDEC         deg       Declination of total
                                              achievable velocity, in
                                              J2000 coordinates
 1  21   D20.9         VMAG         km/sec    Magnitude of total
                                              achievable velocity
 2   1   3D20.9        VE(3)        km/sec    Total achievable
                                              velocity in J2000
                                              coordinates
 3   1   2(3D20.9/),   ETOX(3,3)    none      Initial J2000 to S/C
           3D20.9                             XYZ transformation
                                              matrix
 6   1   F20.3         TSTART     SCE time    Time when first burn
                                  (sec past   of first block
                                  2000.0)UTC  begins
 6  31   F20.3         TEND       SEC time    Time when last burn of
                                  (sec past   last block ends
                                  2000.0)UTC
 7   1   F10.3         MSTART       kg        Vehicle Mass at start
                                              of first block
 7  11   F10.3         MFINAL       kg        Vehicle Mass at end of
                                              last block
 8   1   2(3E15.7/),   VECOV(3,3) (km/sec)2   Covariance of total
           3E15.7                             achievable velocity
                                              in J2000 system
                                              coordinates (one sigma)
11   1   2(3E15.7/),   COV(3,3)     none      Covariance associated
           3E15.7                             with initial ETOX
                                              matrix (one sigma)
14   1   E15.7         FMVERR       km/sec    Fixed magnitude un-
                                              certainty in velocity
                                              (one sigma)
14  16   E15.7         FPVERR       km/sec    Fixed pointing un-
                                              certainty in velocity
                                              (one sigma)
14  31   E15.7         PMVERR         %       Proportional magnitude
                                              uncertainty in velocity
                                              (one sigma)
14  46   E15.7         PPVERR       mrad      Proportional pointing
                                              uncertainty in velocity
                                              (one sigma)

Maneuver Block Description

A record containing the parameters listed below will be given for each maneuver block. The line number of each parameter is a function of the maneuver block number I which ranges from 0 to NB-1 (where NB is the total number of maneuver blocks given on line 4 of the header.) Parameters contained in the following list are sufficient to construct the components of whichever of these commands are relevant to the specified maneuver block type.
                      PARAMETER
LN      COL  FORMAT       NAME       UNITS     DESCRIPTION
----------------------------------------------------------
23*I+15   1  A5           BLKTYP     CHAR*5    Maneuver Block Type.
                                               Possible Values are:
                                               FIXED, PITCH.
23*I+15  11  F10.3        RA         deg       Right ascension of HGA
                                               in J2000 coordinates
23*I+15  21  F10.3        DEC        deg       Declination of HGA in
                                               J2000 coordinates
23*I+15  31  I10          NREV       none      NOT USED, ZERO FILLED
23*I+15  41  F10.3        DUR1       sec       NOT USED, ZERO FILLED
23*I+15  51  F10.3        DUR2       sec       NOT USED, ZERO FILLED
23*I+15  61  E15.7        AXDV       km/sec    NOT USED, ZERO FILLED

23*I+16   1  3E15.7       DVRA(3)   parameter  NOT USED, ZERO FILLED
23*I+17   1  3E15.7       DVDEC(3)  units      NOT USED, ZERO FILLED
23*I+18   1  3E15.7       DVNREV(3)  over      NOT USED, ZERO FILLED
23*I+19   1  3E15.7       DVAXDV(3)  km/sec    NOT USED, ZERO FILLED

23*I+20   1  F20.3        TSTART     SEC time  Nominal time of
                                    (sec past  command implementation
                                    2000.0)UTC
23*I+20  21  F20.3        TOPEN      SEC time  NOT USED, ZERO FILLED
                                    (sec past
                                    2000.0)UTC
23*I+20  41  F20.3        TCLOSE     SEC time  NOT USED, ZERO FILLED
                                    (sec past
                                    2000.0)UTC
23*I+20  61  F20.3        TEND       SEC time  Nominal time when
                                    (sec past  block's burn or last
                                    2000.0)UTC pulse ends

23*I+21   1  F10.3        DM         kg        Propellant mass
                                               expended in block
23*I+21  11  I10          KTCON      none      NOT USED, ZERO FILLED

23*I+22   1  3D20.9       VS(3)      km/sec    Velocity achieved by
                                               block in spacecraft
                                               coordinate system (as
                                               oriented at start of
                                               Block)

23*I+23   1  3D20.9       VE(3)      km/sec    Velocity achieved by
                                               block in J2000
                                               coordinates

23*I+24   1  E15.7        FMVERR     km/sec    Fixed magnitude un-
                                               certainty in velocity
                                               (one sigma)
23*I+24  16  E15.7        FPVERR     km/sec    Fixed pointing un-
                                               certainty in velocity
                                               (one sigma)
23*I+24  31  E15.7        PMVERR       %       Proportional magnitude
                                               uncertainty in
                                               velocity (one sigma)
23*I+24  46  E15.7        PPVERR     mrad      Proportional pointing
                                               uncertainty in
                                               velocity (one sigma)

                                             2
23*I+25   1  2(3E15.7/),  VSCOV(3,3) (km/sec)  NOT USED, ZERO FILLED

                                             2
23*I+28   1  2(3E15.7/),  VECOV(3,3) (km/sec)  Covariance of
               3E15.7                          achievable block
                                               velocity in J2000
                                               coordinates (one
                                               sigma)

23*I+31   1  2(3D20.9/),  ETOX(3,3)   none     J2000 to S/C XYZ
                                               transformation matrix
                                               at end of maneuver
                                               block

23*I+34   1  2(3E15.7/),  COV(3,3)    none     Covariance associat-
               3E15.7                          ed with ETOX (one
                                               sigma)

23*I+37   1  I10          ACC1        integer  NOT USED, ZERO FILLED
23*I+37  11  I10          ACC2        integer  NOT USED, ZERO FILLED
23*I+37  12  E15.7        DVZEST      km/sec   NOT USED, ZERO FILLED

Appendix A. SAMPLE WRAPPED FILE

A sample wrapped Maneuver Implementation/Reconstruction File is provided in order to show the expected format of the data. The user should not code specifically to the real numbers that are printed.

CCSD3ZS00001AAAAAAAANJPL3KS0L015BBBBBBBB^M
MISSION_NAME=MARS_OBSERVER;^M
SPACECRAFT_NAME=MARS_OBSERVER1;^M
DATA_SET_ID=MANEUVER_IMPL;^M
FILE_NAME=mif.tcm3_data.wrap;^M
PRODUCER_ID=MO_SCT;^M
PRODUCT_CREATION_TIME=1993-05-17T10:57:55;^M
CCSD3RE00000BBBBBBBBNJPL3IS00252CCCCCCCCMANEUVER    Man22N_primary

MODE
STAGE       TCM3 SAMPLE DESIGN
BLOCKS        1
S/C
CRS TAPE
P-FILE
PREP        cah
CREATION    05-17-93    10:57:55
PROGRAM     manuvr.tsk                      03-10-93  16:57:55
   266.110    54.621     4.631472311e-04
    -1.819298543e-05    -2.675349655e-04     3.776233775e-04
    -2.277250203e-01     9.729328350e-01    -3.928121385e-02
    -7.893236931e-01    -2.080712743e-01    -5.776456114e-01
    -5.701836745e-01    -1.005387658e-01     8.153419736e-01
      -214247253.647                -214247236.917
  2427.341  2426.921
  1.0715953e-11  7.6215898e-14 -1.0757811e-13
  7.6215898e-14  1.1831555e-11 -1.5819781e-12
 -1.0757811e-13 -1.5819781e-12  1.2943719e-11
  5.8505934e-12  0.0000000e+00  0.0000000e+00
  0.0000000e+00  5.8505934e-12  0.0000000e+00
  0.0000000e+00  0.0000000e+00  2.4342240e-12
  1.5602000e-06  2.4188000e-06  7.3650000e-01  4.7600000e+00
FIXED          0.000     0.000         0     0.000     0.000  0.0000000e+00
  0.0000000e+00  0.0000000e+00  0.0000000e+00
  0.0000000e+00  0.0000000e+00  0.0000000e+00
  0.0000000e+00  0.0000000e+00  0.0000000e+00
  0.0000000e+00  0.0000000e+00  0.0000000e+00
      -214247253.647               0.000               0.000      -214247236.91
7
     0.420         0
    -3.426078865e-17     2.364915989e-17     4.631472311e-04
    -1.819298543e-05    -2.675349655e-04     3.776233775e-04
  1.5602000e-06  2.4188000e-06  7.3650000e-01  4.7600000e+00
  0.0000000e+00  0.0000000e+00  0.0000000e+00
  0.0000000e+00  0.0000000e+00  0.0000000e+00
  0.0000000e+00  0.0000000e+00  0.0000000e+00
  1.0715953e-11  7.6215898e-14 -1.0757811e-13
  7.6215898e-14  1.1831555e-11 -1.5819781e-12
 -1.0757811e-13 -1.5819781e-12  1.2943719e-11
    -2.277250203e-01     9.729328350e-01    -3.928121385e-02
    -7.893236931e-01    -2.080712743e-01    -5.776456114e-01
    -5.701836745e-01    -1.005387658e-01     8.153419736e-01
  5.8505934e-12  0.0000000e+00  0.0000000e+00
  0.0000000e+00  5.8505934e-12  0.0000000e+00
  0.0000000e+00  0.0000000e+00  2.4342240e-12
         0         0  0.0000000e+00
CCSD3RE00000CCCCCCCCCCSD3RE00000AAAAAAAA

Revision date: 24 May 1996

For information about this on-line document, contact Vic Legerton
For information about the file described by this document, contact John Ekelund