PDS_VERSION_ID   = PDS3
RECORD_TYPE      = STREAM
OBJECT           = TEXT
NOTE             = "Notes on using the reader software."
PUBLICATION_DATE = 2004-167
END_OBJECT       = TEXT
END

                                READERS
 
                           README User's Guide
 
This document describes the pds data object reader software and its use
in reading PDS data objects into a data analysis environment.  These readers
are provided as a convenience for users to access the data.  Users may choose
another approach if desired.  This software requires a Java class library
compatible with Java 1.4 and, optionally, RSI/IDL compatible with version 5.6.
 
In the following, the term <PDS_HOME> refers to the PDS ROOT directory.
 
In order to use this program, follow these instructions:
 
1. Copy READ_PDS_OBJECT.JAR, EUV_TEMPLATE.IDL, FUV_TEMPLATE.IDL, 
   HSP_TEMPLATE.IDL and HDAC_TEMPLATE.IDL from the <PDS_HOME>/SOFTWARE/READERS
   directory into the current working directory.  
 
2. Execute the following command line:
   java -jar READ_PDS_OBJECT.JAR
   The program will guide you through choosing a set of files for reading.
   You can use the <PDS_HOME>/INDEX/INDEX.TAB (and .LBL) files to aid in
   searching for particular types of files.  The output from the program is a
   file called pds_reader.pro or pds_reader.java and a set of files with the
   extension ".metadata".  Users do not need to be concerned with the contents
   of these files.
 
3a. IDL users invoke IDL
3b. in IDL execute the following statement: .run pds_reader.pro
    The pds_reader will load the data and print a description of the data
    to the user.
 
4. Java developers should read the pds_reader.java file and
   integrate it into their processing software
 
The following is an example of following the preceding sequence of commands.
The example is based on the UNIX operating system.
 
0.  setenv PDS_HOME <pds_home>
1.  cp $PDS_HOME/SOFTWARE/READERS/* .
2.  java -jar READ_PDS_OBJECT.JAR
    (the program will execute and guide you through the process of choosing
     a set of files).
4a.  idl
4b. .run pds_reader.pro
 
The following text is the result of applying this process to
.../DATA/D2001_001/EUV2001_001_02_12.DAT
 
Data from .../PDS/DATA/D2001_001/EUV2001_001_02_12.DAT is located in:
D0              INT       = Array[1024, 64]
The metadata is in: 
T0              STRUCT    = -> <Anonymous> Array[1]
The calibration data is in: 
C0              LONG      = Array[1024, 64]
The calibration scale factor is in: 
CALIBRATION_SCALE_FACTOR0
                FLOAT     =   4.55598e-06
 
 
Please refer to CATALOG/CUBEDS.CAT or /DOCUMENT/UVIS.TXT for a description of 
the D0 data structure.