SEDR2ASC User's Guide *** NOTE: VAX-VMS users can find available software from UCLASP::DISK$SCRATCH:[PDSUSER.SOFTWARE]. =========================================================================== General Info: =========================================================================== The SEDR2ASC program is used to extract data from the PDS Archive CD-ROM's containing the Pioneer Venus Orbiter (PVO) Supplemental Experimenter Data Record (SEDR) dataset. The program is written in the C programming language and will compile using either the Gnu C Compiler (2.3) with the "-traditional" option or the VAX C compiler version 3.1. The original PVO SEDR tapes contained 6 files per orbit (logical header, pulse time, spin period, selected roll reference, attitude, and ephemeris). This program can extract any of these files and either display the data to the screen or output data to an ASCII file on the local system. In addition to the basic 6 files, this program can extract data identical to the ephemeris dataset submitted by the Magnetometer instrument team or it can output the matrix which rotates from Inertial Spacecraft Coordinates to Venus Solar Orbital coordinates. Please see the coordinate system description text on the CD-ROM for definitions of these coordinate systems. =========================================================================== Before Getting Started: =========================================================================== In order for this program to run under VMS, the user must define the path to the program before attempting to run the software. If the code is located at DISK$USER:[MYNAME.MYPROGRAMS]SEDR2ASC.EXE then the user must define that path by giving the command SEDR2ASC :== $DISK$USER:[MYNAME.MYPROGRAMS]SEDR2ASC.EXE If the software has been installed using the "INSTALL" program provided and the user selected the modify login.com option, then this becomes an unnecessary operation (but it won't mess things up either!) =========================================================================== Usage and Examples: =========================================================================== The program is command-line driven. All options to the program are given at run-time in the same command that executes the program. All options, except colfile, are required!!! Usage: SEDR2ASC [INFILE=AAA] [OUTFILE=BBB] [HOST=CCC] [FILETYPE=DDD] (COLFILE=EEEEE) Options: INFILE: The complete name including path to the input data file. OUTFILE: The name of the output file or "-" for output-to-screen. HOST: The type of host system you are working on. VALID: VAX, SUN, IBM, HP, MSB (MicroSoft DOS), PC (IBM DOS) FILETYPE: The type of input file. VALID: PULSE, SPIN, EPHEM, LOGISTIC, SEL_ROLL, ATTITUDE, MAG_EPHEM, SC2VSO_MAT COLFILE: An ASCII file containing a list of column (numbers) to be extracted from the "ephemeris" dataset. This file contains 1 column number per line. Examples: For all usage examples, we will assume a VAX/VMS computer with a CD-ROM reader called "MYSYS$DUA1:". The user should have the CD-ROM already mounted. VMS Mount Commands for various versions of VMS: ------------------------------------------------------------ Driver VMS vn Commands ------------------------------------------------------------ VFS010 4.7 MOUNT/STRUCTURE=ISO_9660/OVER=ID MYSYS$DUA1: VFS020 5.2 MOUNT/STRUCTURE=ISO_9660/OVER=ID MYSYS$DUA1: VFS022 5.4 CDMOUNT/STRUCTURE=ISO_9660/OVER=ID MYSYS$DUA1: DISMOUNT: DISMOUNT MYSYS$DUA1: F11CD055 5.5 CD_MOUNT/OVER=ID MYSYS$DUA1: DISMOUNT: CD_DISMOUNT MYSYS$DUA1: ISO support will be bundled with VMS in version 6.0. -------------------------------------------------------------- Example 1: -------------------------------------------------------------- Extract an ephemeris data file for orbit 291 to the file "mydata.asc" SEDR2ASC INFILE=MYSYS$DUA1:[DATA.EPHEM.ORB0201]EP0291.DAT OUTFILE=MYDATA.ASC HOST=VAX FILETYPE=EPHEM -------------------------------------------------------------- Example 2: -------------------------------------------------------------- Extract the list of columns specified in the file "ephem_cols.asc" from the ephemeris data file for orbit 291 to the file "mydata.asc" SEDR2ASC INFILE=MYSYS$DUA1:[DATA.EPHEM.ORB0201]EP0291.DAT OUTFILE=MYDATA.ASC HOST=VAX FILETYPE=EPHEM COLFILE=EPHEM_COLS.ASC -------------------------------------------------------------- Example 3: -------------------------------------------------------------- Extract a spin period data file for orbit 363 to the screen SEDR2ASC OUTFILE=- HOST=VAX FILETYPE=SPIN INFILE=MYSYS$DUA1:[DATA.SPIN.ORB0301]SP0363.DAT -------------------------------------------------------------- Example 4: -------------------------------------------------------------- Extract a spacecraft attitude data file for orbit 341 to the screen SEDR2ASC FILETYPE=ATTITUDE INFILE=MYSYS$DUA1:[DATA.ATTITUDE.ORB0301]AT0341.DAT OUTFILE=- HOST=VAX -------------------------------------------------------------- Example 5: -------------------------------------------------------------- Extract a pulse time data file for orbit 241 to the an ASCII file SEDR2ASC FILETYPE=PULSE INFILE=MYSYS$DUA1:[DATA.PULSE.ORB0201]PT0241.DAT HOST=VAX OUTFILE=MYDATA.ASC As you can see the order in which options are given is not important. The software only requires that all options be fully specified. It is also clear that the path to the input file is tiresome to type each time. The user can get around this problem by defining a logical name to the path: Here is the syntax: $ ASSIGN MYSYS$DUA1:[DATA.] CDROM which allows user to simply access any directory beneath [DATA] or $ ASSIGN MYSYS$DUA1:[DATA.SPIN.ORB0301] SP301 which provides a shorter path that can only access spin period files from orbit 301-400. -------------------------------------------------------------- Example 6: -------------------------------------------------------------- Repeat example 2 using the first new logical name we have created SEDR2ASC INFILE=CDROM:[SPIN.ORB0301]SP0363.DAT OUTFILE=- HOST=VAX FILETYPE=SPIN -------------------------------------------------------------- Example 7: -------------------------------------------------------------- Repeat example 2 using the second new logical name we have created SEDR2ASC INFILE=SP301:SP0363.DAT OUTFILE=- HOST=VAX FILETYPE=SPIN -------------------------------------------------------------- Example 8: -------------------------------------------------------------- Create a command procedure to extract 10 orbits of selected ephemeris data columns to the directory DISK$USER:[MYNAME.MYDATA.PVO_EPHEM], beginning with mounting the CD-ROM for VMS version 5.5 at the location MYSYS$DUA1: $!-------------------------------------------------------------- $! BEGIN: EPEXTRACT.COM $!-------------------------------------------------------------- $! $! CHANGE DIRECTORY TO THE OUTPUT AREA $! $ SET DEFAULT DISK$USER:[MYNAME.MYDATA.PVO_EPHEM] $! $! MOUNT CD AND DEFINE REQUIRED LOGICALS $! $ CD_MOUNT/OVER=ID MYSYS$DUA1: $ SEDR2ASC :== $DISK$USER:[MYNAME.MYPROGRAMS]SEDR2ASC.EXE $ ASSIGN MYSYS$DUA1:[DATA.EPHEM.ORB0101] EPDATA $! $! GET 10 ORBITS OF EPHEMERIS DATA $! $ SEDR2ASC INFILE=EPDATA:EP0113.DAT OUTFILE=EP113.ASC HOST=VAX FILETYPE=EPHEM - COLFILE=EPHEM_COLS.ASC $ SEDR2ASC INFILE=EPDATA:EP0114.DAT OUTFILE=EP114.ASC HOST=VAX FILETYPE=EPHEM - COLFILE=EPHEM_COLS.ASC $ SEDR2ASC INFILE=EPDATA:EP0115.DAT OUTFILE=EP115.ASC HOST=VAX FILETYPE=EPHEM - COLFILE=EPHEM_COLS.ASC $ SEDR2ASC INFILE=EPDATA:EP0116.DAT OUTFILE=EP116.ASC HOST=VAX FILETYPE=EPHEM - COLFILE=EPHEM_COLS.ASC $ SEDR2ASC INFILE=EPDATA:EP0117.DAT OUTFILE=EP117.ASC HOST=VAX FILETYPE=EPHEM - COLFILE=EPHEM_COLS.ASC $ SEDR2ASC INFILE=EPDATA:EP0118.DAT OUTFILE=EP118.ASC HOST=VAX FILETYPE=EPHEM - COLFILE=EPHEM_COLS.ASC $ SEDR2ASC INFILE=EPDATA:EP0119.DAT OUTFILE=EP119.ASC HOST=VAX FILETYPE=EPHEM - COLFILE=EPHEM_COLS.ASC $ SEDR2ASC INFILE=EPDATA:EP0120.DAT OUTFILE=EP120.ASC HOST=VAX FILETYPE=EPHEM - COLFILE=EPHEM_COLS.ASC $ SEDR2ASC INFILE=EPDATA:EP0121.DAT OUTFILE=EP121.ASC HOST=VAX FILETYPE=EPHEM - COLFILE=EPHEM_COLS.ASC $ SEDR2ASC INFILE=EPDATA:EP0122.DAT OUTFILE=EP122.ASC HOST=VAX FILETYPE=EPHEM - COLFILE=EPHEM_COLS.ASC $! $! UNMOUNT THE CD-READER $! $ CD_DISMOUNT MYSYS$DUA1: $! $! ALL DONE - EXIT $! $ EXIT $!------------------------------------------------------------------------- $! END: EPEXTRACT.COM $!--------------------------------------------------------------