Description of the Structure of the CRRES "CRRES ONR-604 C2ETs on CD-ROM" _________________________ Version of 15 July 1997 Eugene M. Murphy Structure: ---------- ISO-9660 Level-1 compatible with no "Rockridge" extensions. All direc- tory and file names as they appear in the disks conform to that standard (e.g. 8-capital-character names; filenames terminate with a period followed by a 0-3 character extension followed by a semicolon followed by a 0-1 character version number). Special software is provided in case translation of an ISO-9660 file/directory name was constructed from a non-conformant (e.g., Unix) name and it is desired to translate back to the original name on reading (See "Def- initions", topic 1, below). Note that in the naming of files and directories below, we type them in all-capital-letters since that is the way they are actually recorded on the CD-ROM. The original filenames were either lower-case, or combinations of upper and lower-case, names; this can be checked by looking at the (ASCII- text) file YMTRANS.TBL in each subdirectory which, as noted below, associates the original Unix file-name with the translated filename. At least on a Sun Unix system running SunOS-4.1.2 the capitalized names on the CD-ROM are converted to all-lower-case when displayed with "ls" -- however, the names can be referred to using either upper or lower-case characters. For example, either: lpr -Plw5 /document/"crres dead times" or lpr -Plw5 /DOCUMENT/"CRRES DEAD TIMES" will print out the rate & PHA dead time description file on our printer lw5, assuming the command was issued from the base directory of the CD-ROM. Also, under that operating system, the CD-ROM handler will ignore the semicolon and version number which follows a file name on the CD-ROM so they need not be en- tered in a file reference statement. The C2ET data on this CD-ROM covers as many orbits as would fit on one CDROM. The orbits are specified in the title of the CD-ROM. Definitions: ------------ 1. The YMi "Original Name Recovery" scheme. The software that we use to generate the C2ET CD-ROMs is produced by Young Minds, inc. (YMi). One of the functions of this software is to pro- duce an ISO-conformant directory- or file-name from a (possibly) non-conformant name on the host system -- as a trivial example, a unix file to be placed on the CD may have a 60-character long filename with no extension on the host. The YMi software produces a unique, conformant filename before it places this file/directory on the CD (the resulting filename may not be particularly mnem- onic one, however -- for example two files with the original name "filename- this.data" and "filenamethat.dat" will end up with the names FILENAM1.DAT;1 and FILENAM2.DAT;1). In these CD-ROMs we produce, in each directory of the CD- ROM, a translation table (YMTRANS.TBL;) this allows one to translate back to the original filename -- it is just a simple concordance-list. YMi also supp- lies 2 C-language programs which can be compiled on any host that supports a C-compiler; these are (i) 'CD_COPY.C', which copies to a hard disk on a host reading the CD-ROM, with its original name, any CD file or directory and (ii) 'CD_LINK.C' which sets up links in a directory on a hard disk on the host (with the original file/directory names) to the files/directories on the CD with the conformant names. The source for these routines will be found in the "/Software/utility" subdirectory (see "Directory/File Structure", below). Docu- mentation files for each program also exist in that directory 2. "Tape-Image" CD-files. Certain UC software is written so that it can either directly access a magnetic tape or operate on tape data copied to disk. Since a tape copied to a Unix disk with standard utilities loses its record structure (and may lose its file structure) and becomes a "stream-file" on the disk, a widely used utility at the UC copies tape to disk with eight ASCII bytes added to the be- ginning and end of each record. These contain the record-size in bytes; a "tape-EOF" is represented by a record of zero-length -- i.e. contains only the 16 leading and trailing byte-count bytes with no data between. This form of the data is known as a "Tape-Image" file. A C-language program 'tpstrip.c' is provided (in the "Software" subdirectory) which will strip these leading and trailing record-size bytes off the "Tape-Image" form and produce a "stream- file". 3. Directory/File Structure. This CD-ROM is generated with a directory-tree structure. The root-dir- ectory (the top level, in which this READAME file exists) has the following sub- directories: |-C2ETs----- |-DOCUMENTS- |-ProdLogs-- | | |-COALT--------------- | |-IGOR---------------- |-Software--|-MAGTAPE------------- |-PHRATER------------- |-coal_type_10_and_11- |-utility------------- /(root directory): contains only this README description file and the sub-directories listed above. /C2ETs (subdirectory): this subdirectory will contain 1 file for each orbit. The file is in tape image format. The content of the file is described in /DOCUMENT/CRRES_DATA_PROCESSING.sit. The file name is in terms of the orbit it contains: c2etxxxx. For example, c2et1067 contains the data from the last orbit, orbit 1067. /ProdLogs (subdirectory): Contains the production logs generated by ADO and PHRETTER when processing the relevant data. |-ProdLogs-|-MasterAdoLog.Z |-MasterPhraterLog.Z The suffix .Z means that these files have been compressed by the standard UNIX compressor. The format and content of these files are described in /DOCUMENTS/CRRES_DATA_PROCESSING.sit /DOCUMENTS (subdirectory): Contains: |-CRRES DEAD TIMES |-CRRES Mission Stat Summary |-DOCUMENTS-|-CRRES--InstDesc--Word.sit |-CRRES_DATA_PROCESSING.sit |-OverallStats--Excell |-StuffIt Expander:aa where: CRRES DEAD TIMES--is a UNIX text description of the dead time sizes in the PHAs and RATES CRRES Mission Stat Summary--is a Microsoft EXCEL spread- sheet of the mission's totals. CRRES--InstDesc--Word.sit--is a Word 6 Instrument desc- ription that has been compressed with Stuffit to a sit file. CRRES_DATA_PROCESSING.sit--is a Microsoft Word 6 comp- ressed version of the "CRRES Data Processing & Analysis" 108 page document. OverallStats--Excell--is a Microsoft EXCEL spread- sheet of the statistics for the each orbit in the mission--# of each type of log. rec., # of events, etc... StuffIt Expander:aa--is a Macintosh pgm to uncompress the Word 6 documents above. /Software (subdirectory): Contains copies of software that was used to GENERATE the C2ETs and the special Type10 (despiked priority rates) and Type 11 (PHA events--final atomic mass and Z) records. Also, it contains software needed to access the data. |-COAL--------------- COmputation and AnaLysis pgm |-IGOR---------------- COAL subroutines to gen IGOR waves -Software--|-MAGTAPE------------- Mag. Tape package handles tape image. |-PHRATER------------- The primary processor pgm. |-coal_type_10_and_11- Gen'd despiked Rates & final A & Z. |-utility------------- tpstrip, cd_copy, etc... FILES IN EACH Subdirectory: |-0103GEN0PNXCAL:S |-COALChexs.c |-COALCodingHarris.c |-COALCodingSun.c |-COALEquations.c |-COALGlobals.c |-COALInFiles.c |-COALInit.c |-COALInput.c |-COALMain.c |-COALOutput.c |-COALRecIDs |-COALSignals.c |-COALSummary.c |-COALSys.c |-Makefile |-PrintLog.c |-c2e |-c2e.f |-coal.h |-coaleq.h |-coalf77.h |-COALT---------------|-coalf77subs.c | |-coallist.c | |-coallistsp.c | |-coalsys.h | |-glob.c | |-hical5.f | |-iProcEvnts.c | |-phnxcal.f | |-phnxcal.h | |-procedure | |-qcc3d.c | |-qccm3d.c | |-qccn3d.c | |-quickcoalcp.c | |-quickin | |-testzcalFlight.c | |-testzcalFlight.o | |-vFormatOutHdr.c | |-vInputHdrMod.c | |-vParseCmdLn.c | |-zcal2.c | |-zcalFlight.c | |-zcalFlight.c.orig | |-zcalFlight.o | | |-IgorInput.c | |-IgorOutput.c |-IGOR----------------|-IgorSys.c | |-Igorf77.c | |-Makefile | |-igor.h | | |-Makefile | |-tapedef | |-tfopen.f |-Software-| |-tp.h | |-tpclose.c | |-tpinit.c | |-tpinput.c |-MAGTAPE-------------|-tpmtio.c | |-tpopen.c | |-tpoutput.c | |-tpstatus.c | |-tpsubf77.c | |-tpswap.c | |-tpsys.c | |-tpsys.h | | |-AGMOD.f | |-CCTGEN.c | |-CoaltSurvey.c | |-Magnet_Code_from_Singer.f | |-Phrater.c | |-PhraterGlobals.h | |-ado.c | |-c2eMurphyCopy.f | |-coal.c | |-compile_agmod.f | |-ephdo.c |-PHRATER-------------|-fortest.f | |-gengbList.c | |-interp.f | |-make_header.c | |-make_interpolate.c | |-make_log1.c | |-make_log3.c | |-make_log4.c | |-make_log5.c | |-make_log6.c | |-restoreC2ET.c | |-sproti.f | |-sprotiSubs.f | | |-checkevent.f | |-coalctl | |-coalctly | |-control.gal | |-eventlist4.f | |-fluxctl.f | |-fluxcuts.f |-coal_type_10_and_11-|-fluxgen4.f | |-geofacts | |-geofacts.old | |-parsecmd.f | |-rateave.f | |-rateaveshell | |-ratefix.f | |-ratefixshell | |-zcalFlight.c | | |-cd_copy.c | |-cd_copy.doc |-utility-------------|-cd_link.c |-cd_link.doc |-tpstrip.c