PVROT is a program written by PDS which will read the Pioneer Venus Orbiter (PVO) high resolution magnetometer data from the Magnetometer/ Electric Field Detector / Ephemeris data CDROMs (PV01_00xx) and rotates the data from spacecraft into Venus Solar Orbital (VSO) coordinates and output an ASCII data file. Input: High resolution OMAG and EPHEM data read directly from CDROM Output: ASCII or IGPP Flatfile data files Supported Platforms: Sun (Sun O/S and Solaris) workstations HP Workstations (HPUX) VAX VMS 5.x systems IBM style PC's in a DOS window The user directs the program to produce the desired output by commanding the software with options given on the command line. All command line options may be shortened to the minimum number of characters required to uniquely identify the option. Usage: pvrot cd_location=XXX orbit=XXX file_type=XXX outfile=XXX host=XXX Options: cd_location: The location or path to the top directory of the CDROM. On a UNIX system this might be something like "/cdrom/pv01_0012" On a DOS system this might be something like "D:\" On a VMS system this might be something like "DUA0:" orbit: The orbit number of the data to be rotated into VSO coordinates. outfile: The name of the output data file (i.e. mydata.asc). If the output file type is flatfile, do not include an FFD extension (i.e. outfile=mydata , NOT outfile=mydata.ffd) file_type: The type of output data file to create. Valid options are ASCII, FLATFILE, FLOW. ASCII produces an ASCII data file FLATFILE produces an IGPP flatfile host: The type of platform on which the software is being run. Valid: SUN, HP, VAX, PC ------------------------------------------------------------------- UNIX Usage Examples - ------------------------------------------------------------------- pvrot.sun cd=/cdrom orb=2703 out=orb2703.asc This example uses the default output type of ASCII and the default host of SUN on a Sun O/S system to rotate and extract data from orbit 2703. pvrot.sol cd=/cdrom/PV01_0044 orb=2703 out=orb2703 file=flat This example creates an IGPP Flatfile (file=flat) on a Sun Solaris system for orbit 2703. pvrot.hp cd=/cdrom/PV01_0044 orb=2703 out=orb2703.asc host=hp This example creates an ASCII file on an HP workstation for orbit 2703. ------------------------------------------------------------------- DOS Usage Examples - ------------------------------------------------------------------- pvrot.exe cd="D:\" orb=2703 out=orb2703.asc host=PC This example uses the default output type of ASCII and the host of PC on a DOS system to rotate and extract data from orbit 2703. pvrot.exe cd="D:\" orb=2703 out=orb2703 file=flat host=PC This example creates an IGPP Flatfile (file=flat) on a DOS system for orbit 2703. ------------------------------------------------------------------- VMS Usage Examples - Running from a hard disk ------------------------------------------------------------------- Let's assume for this example that PVROT has been installed on your system at DISK$SOFT:[PDS.SOFTWARE.EXIES] and that the CDROM device on the system is called DISK$CDROM: To get the VMS system to accept command line input to the program, the executable must be pointed to by a logical variable which you can define using the following command: PVROT :== $DISK$SOFT:[PDS.SOFTWARE.EXIES]PVROT.EXE pvrot cd=DISK$CDROM: orb=2703 out=orb2703.asc host=vax This example uses the logical variable PVROT to extract data from orbit 2703 to an ASCII file located in the directory from which the command was issued. pvrot cd=DISK$CDROM: orb=2703 out=[-.DATA]orb2703.asc host=vax This example uses the logical variable PVROT to extract data from orbit 2703 to an ASCII file located in the directory DATA which is located back one directory level from where the command was issued. Normal termination of PVROT on VMS machines will return a traceback error message which has the appearance: ************************* End-of-File reached on Mag data file No Ephemeris data file read errors detected Normal termination - No errors detected %SYSTEM-F-ACCVIO, access violation, reason mask=01, virtual address=78617600, PC=000076F5, PSL=03C00000 %TRACE-F-TRACEBACK, symbolic stack dump follows module name routine name line rel PC abs PC L__MAIN gcc2_compiled. 1538 00000019 000076F5 803074B2 803074B2 00053699 00053699 PVROT main 00000797 00005709 ************************** As long as the line that says "Normal termination - No errors detected" appears, the program has completed without error. The error message that follows has to do with compiler incompatibilities between the various systems. ============================================================================== PVROT INSTALLATION GUIDE ============================================================================== The source code of PVROT comes in the following two files: Makefile pvrot.c To install PVROT you must have the following libraries on your system: binary - Binary Conversion library ffio - Flatfile I/O library parserc - Command parser library pipec - Command pipe library miscc - Miscellaneous library If you receive this software in a zipfile, then you must extract the above files using the "unzip" command. There are numerous versions of Zip/Unzip utilities. If you have one installed already, refer to its documentation in order to unzip these files. In the case that there is no Zip utility installed, or it does not unzip correctly, there is a version of InfoZip on this CD located at /SOFTWARE/SOURCE/ZIP_WARE. It should also be noted that all of these files (source code and executables for PVROT and InfoZip's Unzip) can be found at the PPI node at http://www.igpp.ucla.edu. A listing of the files that should be created through the unzipping of PVROT.ZIP can be found in the file PVROT/INSTALL.TXT. *** INSTALLATION **** If you are using a Sparc Station running SOLARIS then you can use the executable SOFTWARE/SOLARIS/PVROT already supplied. If you are using a Sparc Station running SunOS 4.x then you can use the executable SOFTWARE/SUNOS/PVROT already supplied. If you are using a PC running DOS then you can use the executable SOFTWARE/PC/PVROT.EXE already supplied. Other users: 1) Copy the appropriate MAKE_CONF.??? and MAKE_LIBS.??? files to Make.conf and Make.libs, respectively. Your System Use Copy to ========================================================================== PC MAKE_CONF.PC & MAKE_LIBS.PC \ HPUX MAKE_CONF.HPUX & MAKE_LIBS.HPUX \ Make.conf & SUN4.X MAKE_CONF.SUN4X & MAKE_LIBS.SUN4X / Make.libs SUN/SOLARIS 2 MAKE_CONF.SOL2 & MAKE_LIBS.SOL2 / 2) Make any changes to the Make.conf and Make.libs files if necessary (i.e. the type of C compiler you are using (cc, gcc, etc), where you want the executable to go, etc.) 3) set the DFSHOME environment variable to the path leading to and including the directory PVROT (created as the base of the zip extraction) ex. prompt>> setenv DFSHOME /usr/software/tools/PVROT 4) issue command "make". ex. prompt>> make NOTE: Depending on your compiler, warnings make appear when compiling the program. These can be ignored. ----------------------------------------------------------------------- Copyright(c) 1993 Regents of the University of California All rights reserved. Redistribution and use in source and binary forms are permitted provided that the above copyright notice and this paragraph are duplicated in all such forms and that any documentation, advertising materials, and other materials related to such distribution and use acknowledge that the software was developed by the University of California, Los Angeles. The name of the University may not be used to endorse or promote products derived from this software without specific prior written permission. THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. -----------------------------------------------------------------------