DIF-E-HRII-3/4-EPOXI-EARTH-V2.0

Review Result: Certified.

Symbol Key:
  o = Lien open
  x = Lien resolved or closed
  ! = Lien rejected or declined
  + = Comments (by SMcLaughlin unless otherwise indicated)   

Catalog
=======
! In the dataset.cat file description, please add full citations to the
  Calibration papers (i.e., as footnotes in the text in addition to the 
  REFERENCE objects that also exist).
+ Rejected by PI and archive lead.  The correct and full citations are
  already in ref.cat. 

x In dataset.cat. the CITATION_DESC year must be '2014' since 
  this is when the data were reviewed and released to the public.
+ Done.
 
! In dataset.cat, the DESCRIPTION is lacking the usual summary of why the
  data were taken in the first place.  A sentence or two should be added
  to address this.
+ Declined.  Both ABSTRACT_DESC and DATA_SET_DESC explicity state the data 
  were acquired by EPOCh to characterize Earth as an analog for extrasolar 
  planets.  That was one purpose of EPOCh.  Read the EPOCh overview in
  /document/.  

x The EPOXI mission.cat description misstates the wavelength coverage 
  range of the HRII instrument.  This should be corrected.
+ Done. 

x If there was a rationale for choosing/changing the position of Earth 
  within the slit, it was not clear.  If there was one, please document 
  it and/or point to existing documentation with a description of the 
  observing strategy.  (If this is very short it could be incorporated
  into the dataset.cat DESCRIPTION field.)
+  Done.  Improved description of scans in dataset.cat and in 
   /document/epoch_earth_obs.pdf.  Equivalent improvements were applied
   to DIF-M-HRII-3/4-EPOXI-EARTH-V1.0, dataset.cat and 
   /document/epoch_mars_obs.pdf
  
x Voldesc.cat references "EARTH.CAT", which is not in the data set.  The
  reference should be removed from voldesc.cat.
+ Done.  
  
Documents
=========
x Ensure these data sets have the latest versions of these document files:
    day_of_year_calendar.lbl
    epoxi_cal_pipeline_summ.lbl
    epoxi_sis.lbl
    instruments_hampton.lbl
    pdsdd_epoxi.lbl
    quaternion_desc.lbl
+ Done.

x In epoxi_sis.pdf:
  x This document says labels for HRIV, MRI, and ITS level 3/4 data, PDS keyword
    PROCESSING_HISTORY_TEXT contain
      FLAT_PRO=
      FLATCONS=
      FLATTEMP=
      CALWINDW=
      CALWINPY=
    but the sample labels in the SIS's 4.4.4.1 and 4.4.4.2 do not.
  x p. 27: "DIF-L-HRII-3_4-EPOXI-LUNAR-CALS-V1.0" should have a / not a _
    i.e.   "DIF-L-HRII-3/4-EPOXI-LUNAR-CALS-V1.0"
  x epoxy_sis.pdf pages 47-9 the figures are misaligned with the text.  This 
    needs to be corrected in every copy of the document in all data sets.
+ Done, except for the item about PROCESSING_HISTORY_TEXT. That PDS keyword
  will contain different processing keywords because the calibration pipeline 
  performs different steps for the VIS HRIV, MRI, and ITS CCDs and the IR
  spectrometer.  For example, the FITS header keywords FLAT_PRO, FLATCONS, 
  FLATTEMP, CALWINDW, & CALWINPY only apply to IR calibration, so those values
  are never included in PROCESSING_HISTORY_TEXT.  However, we noted this
  difference in the description of PROCESSING_HISTORY_TEXT in the SIS.
  For last item, had to print the Word file as a Postscript to force alignment
  of figure pieces with text, then distilled the Postscript to PDF/A.
    
x There are summary files with names like hriv_3_4_epoxi_garrad.pdf.  In at 
  least some of these labels in some data sets, the Julian Date field is 
  described as being in the form YYYYMMDD.  This needs to be fixed if it
  applies to this data set.
+ Done.

x In places that describe the file naming convention, there needs to be a 
  clear indication of which time (beginning, middle, end) is used for 
  creating the file name.
+ Not applicable.  Mid-obs is used in the filenames and for grouping products 
  into DOY directories, and this is already called out in the EPOXI SIS and
  dataset.cat files!  

x Need more description of "spectral scanning mode".  Could be in the 
  dataset.cat DESCRIPTION, if it's short, or in a separate document that
  can be referenced as needed.
+ Done. Improved description in document/epoch_earth_obs.pdf and dataset.cat.
  
! Please add at least one or two examples of displayed/plotted spectra as an 
  example for users who are working with the data, preferably with a recipe
  for reproducing them from the data/
+ Declined.  The PI and archive lead agreed that paragraph Lori wrote in
  ~2011 for the original Hartley2 archive adequately describes how to work
  with the IR scans. We've been adding that paragrpah to newer dataset.cats, 
  including Earth V2. 
  
x AAREADME.TXT should point users to the essential, point-of-entry type 
  documentation.
+ Done. Directed reader to DATASET.CAT in CATALOG.

! Consider adding a browse facility for this data set, if resources permit.
+ Declined.  Resources are limited, and project believes galleries adds very
  little benefit when viewing geometry does not vary much.