SIS NAE-006, Rev. C

MARS GLOBAL SURVEYOR

Software Interface Specification

Maneuver Profile File

Jet Propulsion Laboratory

California Institute of Technology

Pasadena, California

Table of Contents

          PROJECT MARS GLOBAL SURVEYOR        Number   : SIS NAE-006
  SOFTWARE INTERFACE SPECIFICATION              Revision : Revision C
            Cover Sheet                         Date     : 15 August 1995
-------------------------------------------------------------------------------
SIS NAME:  Maneuver Profile File
-------------------------------------------------------------------------------
DOMAIN:

 Sub_System       Function                      Program         Make/Use

 NAE              Maneuver Analysis Software    MOPS            Make

 PSE								Use

 EAE								Use

 DSRE								Use

Computer System:  Navigation Computer
-------------------------------------------------------------------------------
PURPOSE OF INTERFACE (SUMMARY):  This interface specification provides the
format and syntax for transmission of the Maneuver Profile File from the
Maneuver Analysis Software to all users.
-------------------------------------------------------------------------------
INTERFACE MEDIUM:
Disk File:  [X]
Magnetic Tape:  [ ]     Tracks:         Density:            Data Code:
Other:
-------------------------------------------------------------------------------
SIS COORDINATOR:  J. E. Ekelund


-------------------------------------------------------------------------------
SIGNATURE:

    Elements/Subsystem/SSE      Signature                      Date Signed

        NAE                     _______________________      _________________
				J. E. Ekelund

-------------------------------------------------------------------------------

Author(s):  John E. Ekelund



                            SIS NAE-006, Rev. C

                           MARS GLOBAL SURVEYOR
                           MANEUVER PROFILE FILE
                      Software Interface Specification

                              15 August 1995



ABSTRACT:  This document describes the file interface which provides ideal
(desired) maneuver data to the Spacecraft Team for the production of the
Maneuver Implementation/Reconstruction File.


                         Jet Propulsion Laboratory
                    California Institute of Technology
                        Pasadena, California 91109



            MARS GLOBAL SURVEYOR DISTRIBUTION LIST

		Alwar, Vijayarghavan	 301--150
		Beaudoin, A. L.		 230--110
		Bollman, W. E.		 301--150
		Breckheimer, P. J.	 301--220G
		Ekelund, J. E.		 301--220G
		Esposito, P.		 264--235
		Neuman, J.		 LMC



                        DOCUMENT CHANGE LOG

     Change      Date       Affected Portions
     Letter

     Original    10/23/90   All

     Rev. A      3/12/91    Appendix A added.

     Rev. B      3/17/93    Section 4.2.2.1

     Rev. C      8/15/95    Section 4.2.2.1
			    Name Change: MARS OBSERVER to MARS GLOBAL SURVEYOR
                            Signature Page updated
 	                    Abstract Page, (Author(s):) updated
        	            Distribution List
                	    Section 1.1
	                    Appendix A.



                        List of TBD Items

        Page    Resolution Date         Item

1. GENERAL DESCRIPTION

1.1 PURPOSE OF INTERFACE

This SIS describes the content of the Maneuver Profile File that is supplied by the Maneuver Operations (MOPS) Software to the Spacecraft Team (SCT). This file contains the ideal maneuver parameters for use by the Spacecraft Team in generating the commandable maneuver parameter values.

1.2 SCOPE

This specification covers this file for 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

1.4 FUNCTIONAL DESCRIPTION

1.4.1 Data Source, Destination, and Transfer Method

The Maneuver Profile File will be generated by the Navigation Software MOPS in an ASCII file to be read by the SCT.

1.4.2 Pertinent Relationships with Other Interfaces

The SCT will respond to this file by producing a Maneuver Implementation/Reconstruction File.

1.4.5 Labeling and Identification (Internal/External)

1.4.4 Assumptions and Constraints

None

2. ENVIRONMENT

2.1 HARDWARE CHACTERISTICS AND LIMITATIONS

N/A

2.2 INTERFACE MEDIUM AND CHARACTERISTICS

This interface shall be provided by a standard ASCII data file on the Navigation computer. 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 Maneuver Profile 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

A listing of the file shall be maintained by the Maneuver Analysis Group. Also, the file may be regenerated.

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 file production (by MOPS) and reading (by SCT) mechanisms. Also, MOPS and SCT operations personnel will be trained in the file transfer procedures. In addition to these preparatory measures, it is required that:

  1. A file identification be provided in the file header (see section 4.2)
  2. A listing of each file transfered be maintained by the Maneuver Analysis Group to be used to verify (if necessary) that the correct file has been used.

2.5 END-OF-FILE (OR MEDIUM) CONVENTIONS

End-of-file conventions shall be in accordance with standard system procedures.

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

This file shall be generated by the NAV analyst using a text editor. It will be generated approximately three times per maneuver. The format of the file will be that of a Fortran namelist file.

3.1.2 Time Span of Product

This file will be produced after the ideal maneuver parameters have been computed using MOPS.

3.2 DATA VOLUME

Less than 1 kbyte of disk space.

3.3 FLOW RATE

TBD

4. DETAILED DATA OBJECT DEFINITION

4.1 STRUCTURE AND ORGANIZATION OVERVIEW

The Maneuver Profile File is an ASCII file which consists of the SFDU header, the Maneuver Profile File headers, and the Maneuver Profile File 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 Profile File, (DDID = 0250) is diagramatic representation:
CCSD3ZS00001AAAAAAAA
    NJPL3KS0L015BBBBBBBB
        <CR><LF>
        MISSION_NAME=MARS_OBSERVER;<CR><LF>
        SPACECRAFT_NAME=MARS_OBSERVER1;<CR><LF>
        DATA_SET_ID=MANEUVER_PROFILE;<CR><LF>
        FILE_NAME=mpf.sff;<CR><LF>
        PRODUCER_ID=NAV;<CR><LF>
        APPLICABLE_START_TIME=1990-07-25T20:00:00;<CR><LF>
        PRODUCT_CREATION_TIME=1990-07-17T13:30:00.00;<CR><LF>
        EVENT_NAME=TCM3;<CR><LF>
    CCSD3RE00000BBBBBBBB
    NJPL3IS00250CCCCCCCC
In the actual Maneuver Profile 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

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

4.2.2.1 Run Identification

A header record, with Namelist Name MPFHDR, shall be provided containing the following information:
Parameter       Type            Description
---------       ----            -----------
PRJNAM          CHAR*6          Project name: "MO"
SISID           CHAR*24         SIS name: "Maneuver Profile File"
PRGID           CHAR*12         Name of analyst creating file.
FILDAT          CHAR*18         File creation date and time,
                                "YYMMDD HH:MM:SS.FF"
MNVRID          CHAR*24         Maneuver name, e.g., TCMn or OTMn
                                where n denotes the number of the
                                maneuver.
STAGE           CHAR*24         Stage of maneuver design,
                                e.g., initial design, final tweak.
MPDFID          CHAR*24         Identifying information for
                                Maneuver Performance Data File (an
                                input file to MOPS).

4.2.2.2 Total Maneuver Description

This record, with Namelist Name MVRTOT, contains parameters describing the total maneuver.
Parameter      Type        Description                  Unit
---------------------------------------------------------------------
RADES,DECDES,   SP     Direction and magnitude of the   deg,deg,
DVDESM                 desired velocity increment in    km/s
                       J2000 system

DVDES(3)        SP     Desired velocity increment in    km/s
                       J2000 system

TSTART          DP     Nominal Spacecraft Event Time (UTC) secs past
                       of command implementation           J2000

TCALUT     CHAR*25     The burn start time represented     None
                       as a calendar date/time group (UTC),
                       e.g. 19-DEC-1997 04:27:26.1234.
PAXIS(3)        DP     Pitch axis, unit vector          EME2000

THRBEG(3)       DP     Initial thrust direction,        EME2000
                       unit vector

PTHRAT          DP     Pitch rate                       deg/sec

CHAR*n = ASCII character string of n characters
DP     = Double Precision
SP     = Single Precision

Appendix A. SAMPLE WRAPPED FILE

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

CCSD3ZS00001AAAAAAAANJPL3KS0L015BBBBBBBB
MISSION_NAME=MARS_GLOBAL_SURVEYOR;
SPACECRAFT_NAME=MARS_GLOBAL_SURVEYOR;
DATA_SET_ID=MANEUVER_PROFILE;
FILE_NAME=mpf_c_tcm1.sfdu;
PRODUCER_ID=NAV;
APPLICABLE_START_TIME=1996-04-15T12:34:56;
PRODUCT_CREATION_TIME=1996-106T12:34:56;
EVENT_NAME=TCM1;
CCSD3RE00000BBBBBBBBNJPL3IS00250CCCCCCCC $MPFHDR
    PRJNAM = 'MGS'
    SISID  = 'MANEUVER PROFILE FILE'
    PRGID  = 'E. GRAAT'
    FILDAT = '960415 12:34:56'
    MNVRID = 'TCM1'
    STAGE  = 'MGS TEST'
    MPDFID = 'mpf_c_tcm1.txt'
 $END
 $MVRTOT
    RADES  =   -.38306673821512E+1
    DECDES =    .67531342609602E+2
    DVDESM =    .0259316088
    DVDES  =   9.888348452723E-03,  -662.09962519E-06,  23.9631075139E-03
    TSTART =   -.9820086218286274D+08
    TCALUT = '20-NOV-1996 21:58:57.8171'
    PAXIS  =    .0000000000000000,    .0000000000000000,    .0000000000000000
    THRBEG =   0.38132414171234,    -25.5325317985E-03,   0.92408873424975,
    PTHRAT =    .0000000000000000
 $END
CCSD3RE00000CCCCCCCCCCSD3RE00000AAAAAAAA

Revision date: 17 May 1996

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