Document title: Readme file for NDADS ISEE1 and ISEE2 datatypes MAG_1M_FF and MAG_4S_FF Project: ISEE1 and ISEE2 NDADS Datatype: MAG_1M_FF and MAG_4S_FF Super-EID: SOFTWARE There may be other documents also identified by this super-EID. NDADS filename: 00README.TXT TRF entry: b46638.txt in NSSDC's controlled digital document library, Mar. 1998. Document text follows: ---------------------- * ------------------------------------------------------------------------- * * * * 00readme.txt - This file contains a list of the documentation files in the* * [000000] and the [SOURCE] directories of the Optimem 1000 * * Write-Once Read-Many disk platters containing the 4-second * * and 60-second averaged magnetic field data sets of the * * International Sun-Earth Explorers (ISEE) 1 and 2 spacecraft* * of the United States National Aeronautics and Space * * Adminstration (NASA). * * * * Copyright (c) 1975-94 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. * * * * For information about this software please contact: * * * * Principal Investigator: * * Christopher Russell * * UCLA - Institute of Geophysics and Planetary Physics * * 6871 Slichter Hall * * Los Angeles, Ca. 90024-1567 * * INTERNET e-mail: ctrussell@igpp.ucla.edu * * NSI/DECnet e-mail: BRUNET::CTRUSSELL * * Telephone: (310) 825-3188 * * * * Programmer: * * Harry Herbert * * UCLA - Institute of Geophysics and Planetary Physics * * 5833 Slichter Hall * * Los Angeles, Ca. 90024-1567 * * INTERNET e-mail: hherbert@igpp.ucla.edu * * NSI/DECnet e-mail: BRUNET::HARRY * * Telephone: (310) 825-9030 * * * * ------------------------------------------------------------------------- * =============================================================================== 00README.TXT =============================================================================== This file contains a map showing how the files in the [000000] and [SOURCE] directories of the ISEE 1 and 2 4-second and 60-second averaged magnetic field WORM disks are used to read and interpret the datasets. Included herein is a brief description of the purpose of each file. The files themselves contain more complete documentation. ------------------------------------------------------------------------------- Documentation files: voldesc.sfd - SFDU volume description file for this disk. This file contains spacecraft and instrument descriptions, an overview of the 4-second and 60-second averaged magnetic field datasets, a list of the data files included on the disk with their start and stop times, and a list of the support files that have been included on the disk. These support files are described more fully in this 00README.TXT file. 4second.sfd - SFDU detailed dataset description. This file provides the layout of the 4-second averaged magnetic field dataset including a description of each item. 60second.sfd - SFDU detailed dataset description. This file provides the layout of the 60-second averaged magnetic field dataset including a description of each item. errata.txt - Known problems description. This file contains a description of any data and documentation inaccuracies that have been discovered in previous logical volumes of this dataset. ffheader.sfd - UCLA/IGPP header flat file description. This SFDU compliant document contains a detailed description of the meta data file used with the UCLA/IGPP flat file data storage system. This system was used for storing the ISEE 4-second and 60-second averaged magnetic field data. As detailed in this document, a UCLA/IGPP flat file is made up of a pair of files: an ASCII file containing meta data with the file type extension ".ffh" (for flat file header); and a data file containing binary values with the file type extension ".ffd" (for flat file data). ffdata.sfd - UCLA/IGPP header data file description. This SFDU compliant document contains a detailed description of the binary data file used with the UCLA/IGPP flat file data storage system. This system was used for storing the ISEE 4-second and 60-second averaged magnetic field data. As detailed in this document, a UCLA/IGPP flat file is made up of a pair of files: an ASCII file containing meta data with the file type extension ".ffh" (for flat file header); and a data file containing binary values with the file type extension ".ffd" (for flat file data). DEC VMS files: 4s2asc - Program to read ISEE 1 and 2 4-second averaged magnetic field data files in UCLA/IGPP format and write their contents to a user specified ASCII text file. It is contructed from these files: 4S2ASC.COM - Compile and link command file 4S2ASC.FOR 4S2ASC.FOR - FORTRAN program to write out ISEE 4-second data CTIME.FOR - FORTRAN time subroutines used by 4S2ASC.FOR 60s2asc - Program to read ISEE 1 and 2 60-second averaged magnetic field data files in UCLA/IGPP format and write their contents to a user specified ASCII text file. It is contructed from these files: 60S2ASC.COM - Compile and link command file 60S2ASC.FOR 60S2ASC.FOR - FORTRAN program to write out ISEE 60-second data CTIME.FOR - FORTRAN time subroutines used by 60S2ASC.FOR Sun UNIX files: Makefile - Input file for the UNIX "make" command. It compiles and links the Sun/UNIX programs. 4s2asc - Program to read ISEE 1 and 2 4-second averaged magnetic field data files in UCLA/IGPP format that have been FTPed from VMS and write their contents to a user specified ASCII text file. The program includes routines to convert the binary data from VMS to IEEE floating point formats. It is contructed from these files: 4s2asc.f - FORTRAN program to write out ISEE 4-second data convert.c - FORTRAN callable C data conversion functions ctime.c - FORTRAN callable C time functions 60s2asc - Program to read ISEE 1 and 2 60-second averaged magnetic field data files in UCLA/IGPP format that have been FTPed from VMS and write their contents to a user specified ASCII text file. The program includes routines to convert the binary data from VMS to IEEE floating point formats. It is contructed from these files: 60s2asc.f - FORTRAN program to write out ISEE 60-second data convert.c - FORTRAN callable C data conversion functions ctime.c - FORTRAN callable C time functions USAGE NOTES - To use the DEC VMS programs, copy the source code off the WORM disk then type "@4S2ASC" and "@60S2ASC" to compile and link both of the flat file to ASCII programs. Both programs can read the data directly from the WORM disk and write their output to a user specified file on a magnetic disk. To use the Sun UNIX programs, FTP in ASCII mode the source code from VMS to UNIX. Type "make all" to compile and link both of the flat file to ASCII programs. To move the ISEE 4-second and 60-second data files use the BINARY mode of FTP for both the ".ffh" files and the ".ffd" files. ===============================================================================