From neese@psi.edu Mon Jun 5 18:27:39 2000 Received: from boojum.psi.edu (boojum.psi.edu [192.102.219.11]) by earth.astro.umd.edu (8.9.1a/8.9.1/WLS8.9) with ESMTP id SAA19308; Mon, 5 Jun 2000 18:27:38 -0400 (EDT) Received: (from neese@localhost) by boojum.psi.edu (8.9.3+Sun/8.9.1) id PAA11025; Mon, 5 Jun 2000 15:27:32 -0700 (MST) Date: Mon, 5 Jun 2000 15:27:32 -0700 (MST) From: Carol Neese Message-Id: <200006052227.PAA11025@boojum.psi.edu> To: Tyler.L.Brown@jpl.nasa.gov, dbritt@utk.edu, drd@psi.edu, grayzeck@astro.umd.edu, holladb1@spacemsg.jhuapl.edu, ma@astro.umd.edu, mcfadden@astro.umd.edu, msharlow@igpp.ucla.edu, msykes@as.arizona.edu, neese@psi.edu, raugh@astro.umd.edu, sjoy@galsun.igpp.ucla.edu, tholen@ifa.hawaii.edu Subject: "known problems" Content-Length: 9836 X-Lines: 324 Status: RO Known problems with the NEAR Eros Approach data sets under review. May 8, 2000. Geometry ======== root/ - The aareadme.txt file has no label. - The errata.txt file contains only filler text. catalog/ - The catinfo.txt file contains only filler text. - The data set catalog file (spiceds.cat) has TARGET_NAME = MARS and INSTRUMENT_HOST_ID = MGS. No valid reference is listed. document/ - The docinfo.txt and volinfo.txt files contains only filler text. - None of the files in this directory have labels. MAGNETOMETER ============ root/ o There is no PDS label in the AAREADME.TXT file. o VOLDESC.CAT: - This file is incomplete. - VOLUMES should be "1", not "0001" (which implies an octal number) - Omit "THE" from INSTITUTION_NAME - The DATA_SUPPLIER object is missing several values which should be readily available (some of them may be "N/A"). - Inside the CATALOG object, the pointers should NOT have "_CATALOG" appended to them (i.e., "^DATA_SET", *not* "^DATA_SET_CATALOG") CALIB/ o Empty directory CATALOG/ o MAGDATASET.CAT - Contains the incorrect line, "This data set underwent external peer review within PDS on April, 1999." - A REFERENCE object is included in this file. All REFERENCE objects should be collected in a separate file in the CATALOG directory (called "magref.cat", "nearref.cat", "references.cat" or something similar). - There is an inappropriate MSI reference under "Parameters". o NEARINSTHOST.CAT: - The INSTRUMENT_HOST_DESC references figures which are not, apparently, included on the archive volume, as well as footnotes that do not seem to exist. - The INSTRUMENT_HOST_DESC text needs tech-editing. - This file is hideously long. It would best be pulled out into a separate document so that the referenced figures, tables and footnotes could all be included. A short (about 250 words) description with a reference to the full file is sufficient. o NEARMISSION.CAT: - The MISSION_DESC text is far too long and complex. It should be packaged as a separate document and referenced by a much more managable MISSION_DESC. (This would obviate the need to address the 100-byte line lengths and numerous occurences of double quotes within double quotes.) - The MISSION_OBJECTIVES_SUMMARY is poorly formatted. - There is a REFERENCE object included in this file. REFERENCE objects belong in a separate file. o The following catalog files are expected but missing: - CATINFO.CAT file (text documentation of the directory contents) - CATALOG.CAT file (ODL [like a label] documentation of volume contents) - TARGETs for all TARGET_NAMEs mentioned elsewhere (these can be copies of existing files created by other missions, if they exist) - REFERENCE.CAT file (or similar name, to contain all the REFERENCE objects) DATA/ o The MINIMUM and MAXIMUM keywords are being used incorrectly. These values should be identical to what's in the file, BEFORE applying the offset. Either change the value to the actual file values, or use DERIVED_MINIMUM and DERIVED_MAXIMUM, which indicate values after scaling and offset are applied. o A UNIT value of "COUNTS" appears to have been applied will-he/nill-he to every column without some other obvious unit, including things like PROBE_TEMPERATURE, ACTUAL_RANGE and AC_AXIS_SELECT. If there are no units, then the UNIT lement can be omitted entirely (or a value of "N/A" used). o There are no COLUMN_NUMBERs in these labels. [NOTE: These are not required, but they do make life much, much easier for the reviewers - especially for tables with many columns.] DOCUMENT/ o None of the files in the mission subdirectory have labels. There must be one label for each document. o MAGDEFINITIONS.TXT - I can make no sense of the first sentence. - The definition of "utc" is grammatically ambiguous. - This file needs serious tech-editing. o MISSIONOVERVIEW.TXT appears to contain the same text as the MISSION_DESC part of the NEARMISSION.CAT file, although the latter is in a more readable format (i.e., not double-spaced). There is no point in repeating this text - it should be removed from the catalog file in favor of a reference to this file. o There is no DOCINFO.TXT file (describing directory contents) GEOMETRY/ o The GEOMINFO.TXT has no label. o There are no other files in this directory. INDEX/ o INDXINFO.TXT contains placeholder information only. o INDEX.LBL incorrectly has 24 bytes for column 3 - it should be 26 - All subsequent START_BYTE values will need to be changed SOFTWARE/ o This directory is empty. Multi-Spectral Imager ===================== MSI/1 ===== root/ o The VOLDESC.CAT file is incomplete. o The catalog pointer to MSIFILTERS.CAT in the VOLDESC.CAT file does not correspond to an actual file. o There is no PDS label in the AAREADME.TXT file. o The file errata.txt contains only filler text. CATALOG/ o There are syntax errors in NEARINSTHOST.CAT and NEARMISSION.CAT. o The data set catalog for the MSI filter profiles is missing. o msidataset.cat has the incorrect line, "This data set underwent external peer review within PDS on April, 1999." DOCUMENT/ o There are no mission documents (as there are for the other instruments.) GEOMETRY/ o The GEOMINFO.TXT file has no label, and very little content. o There are no other files in this directory. SOFTWARE/ o This directory is empty. MSI/6 ===== root/ o Catalog pointers in the VOLDESC.CAT file do not correspond to actual files. o The VOLDESC.CAT file is incomplete. o There is no PDS label in the AAREADME.TXT file. o There is no PDS label in the ERRATA.TXT file. o The ERRATA.TXT file contains only filler text. DATA/ INDEX/ o INDXINFO.TXT file has no label and no content. Near Infrared Spectrometer ========================== root/ o The VOLDESC.CAT file is incomplete. o There is no PDS label in the AAREADME.TXT file. o There is no PDS label in the ERRATA.TXT file. o The ERRATA.TXT file contains only filler text. o AAREADME.TXT should show the EXTRAS directory and tell that it is organized by YY_DDD. CATALOG/ o The nisdataset.cat file contains the incorrect line, "This data set underwent external peer review within PDS on April, 1999." o The nisdataset.cat file lists INSTRUMENT_ID = MSI. o The nisdataset.cat file has an inappropriate reference to MSI under "Parameters". DATA/ DOCUMENT/ o None of the files in the MISSION subdirectory have labels. There must be one label for each document. o In the INSTRUMENT subdirectory, the calpaper is missing a number of tif files containing figures and equations for the calibration paper. The label for this document is also incorrect. The correct label and the tif files are available for review at the NEAR SDC web site at ftp://loring.jhuapl.edu/pub/PDS/PADS/SBNREVIEW. GEOMETRY/ o The geominfo.txt has no label and very little content. o There are no other files in this directory. INDEX/ o INDXINFO.TXT file has no label and no content. SOFTWARE/ o This directory is empty. NEAR Laser Rangefinder ====================== root/ o The VOLDESC.CAT file is incomplete. o There is no PDS label in the AAREADME.TXT file. o There is no PDS label in the ERRATA.TXT file. o The ERRATA.TXT file contains only filler text. CALIB/ o Empty directory. CATALOG/ o Syntax errors in NEARINSTHOST.CAT and NEARMISSION.CAT. o NLRDATASET.CAT has the incorrect line, "This data set underwent external peer review within PDS on April, 1999." o NLRDATASET.CAT has INSTRUMENT_ID = MSI. o NLRDATASET.CAT has an inappropriate MSI reference under Parameters. DATA/ DOCUMENT/ o None of the files in the mission subdirectory have labels. There must be one label for each document. GEOMETRY/ o The GEOMINFO.TXT has no label and very little content. o There are no other files in this directory. INDEX/ o INDXINFO.TXT file has no label and no content. o INDEX.LBL incorrectly has 24 bytes for column 3 - it should be 26 - All subsequent START_BYTE values will need to be changed SOFTWARE/ o Empty directory X-ray Gamma Ray Spectrometer ============================ root/ o The VOLDESC.CAT file is incomplete. o There is no PDS label in the AAREADME.TXT file. o There is no PDS label in the ERRATA.TXT file. o The ERRATA.TXT file contains only filler text. CATALOG/ o XGRSDATASET.CAT - There is an inappropriate reference to MSI under "Parameters". - Contains the incorrect line, "This data set underwent external peer review within PDS on April, 1999." - Has INSTRUMENT_ID = MSI. DATA/ o GRB and GRF column definitions do not match the acronyms. o In GRF, 16 columns have been added, but not included in the definitions file (e.g., GRAY_DATA_QUALITY_BIT). DOCUMENT/ o None of the files in these directories have labels. There must be one label for each document. o In the definitions files, some of the parameters used in the data files are missing or not defined. INDEX/ o INDXINFO.TXT file has no label and no content. o The GRB INDEX.LBL file references the "grf_definitions.txt" file. This is both the wrong file and the wrong format for the name of the file (presumably "GRBDEFINITIONS.TXT"). Similar errors in the INDEX.LBL of the other data types. o INDEX.LBL incorrectly has 24 bytes for column 3 - it should be 26 - All subsequent START_BYTE values will need to be changed end of list.