PDS_VERESION_ID = PDS3 RECORD_TYPE = STREAM OBJECT = TEXT NOTE = "New Release of READPDS" SOFTWARE_VERSION_ID = "4.2" PUBLICATION_DATE = 2005-07-15 END_OBJECT = TEXT END ************************** File READPDS *********************************** READPDS was created at the Small Bodies Node (SBN) of the Planetary Data System (PDS) to read PDS image and data files. For complete explanations regarding the use of any of these programs, check the headers of the program source files, which end in '.pro'. A complete listing of the programs follows: apply_bitmask.pro - applies bitmask on integer arrays or scalars arrcolpds.pro - reads a PDS binary array or collection into IDL array or structure arr_struct.pro - populates an IDL structure for array object to be read break_string.pro - separates a scalar string into parts using ',' delimiter clean.pro - removes non-printable characters from scalar strings col_struct.pro - populates an IDL structure for collection object to be read elem_struct.pro - populates an IDL structure for element object to be read get_idl_type.pro - retrieves IDL data type for given PDS data type element get_index.pro - retrieves viable end_object index position in a PDS label headpds.pro - retrieves the PDS label from a file imagepds.pro - retrieves image data from PDS image files objpds.pro - retrieves viable PDS objects from the labels pdspar.pro - retrieves specified data from the PDS labels pointpds.pro - retrieves pointer information for PDS object from label preplabel.pro - prepares the label for parsing, removes comments, adds end object keyword values qubepds.pro - retrieves qube data from PDS qube files readpds.pro - calls other routines to obtain images, tables, arrays, etc remove.pro - removes specified characters from a string tablepds.pro - retrieves data from PDS ascii and binary table files test_integer.pro - tests whether given string is integer within given range verify_arrcol.pro - verifies the label's array/collection objects verify_arr.pro - verifies a given PDS array and its subobjects verify_col.pro - verifies a given PDS collection and its subobjects verify_elem.pro - verifies a given PDS element object verify_image.pro - verifies the label's image objects verify_label.pro - verifies the entire PDS label s.t. it meets PDS standards verify_qube.pro - verifies the label's qube objects verify_table.pro - verifies the label's table objects CHANGE LOGS: =========== Version Date Programmer Description 4.2 2005-07-15 P. Khetarpal This release is for IDL v. 6.0 and above. Combined TASCPDS and TBINPDS into TABLEPDS routine, which now handles both ascii and binary data processing. Reorganized the processing line by including verification of PDS label before any other action is performed. All routines were rewritten to stabilize the program. 4.1.1 2005-04-18 P. Khetarpal Fixed problem with headpds changing the name of the input file. Resolved row suffix bytes and padding bytes conflict, and fixed some minor errors in table object reading. 4.1 2004-01-28 P. Khetarpal Resolved compatibility for both MSB and LSB architectures of all routines. Array and collection objects routine was rewritten for updated standards. Re-instated the NOSCALE keyword for images and qubes. Included bit masking for signed and unsigned integers. 4.0 2004-08-01 P. Khetarpal Rewrote the major routines for reading images, tables, and qubes by using IDL structures to read data directly, instead of reading data element by element. Also, rewrote routines using many levels of subroutines, and thorough error-checking. Heavy comments were added to almost all routines. The previous releases of version 3.3.x are compiled into one in this release of pdsread. 3.3.x 2004-03-18 P. Khetarpal Fixed bugs for reading array objects included with other non-array objects for IDL. Wrote a new binary array routine to read arrays with axes greater than 2. 3.2 2003-12-02 P. Khetarpal Fixed bugs for reading tables with long int number of rows or columns; fixed item byte issue for reading tables. 3.1 2003-10-03 P. Khetarpal Updated for standards changes; fixed minor bugs; increased robustness of subroutines; added a subroutine to handle cleaning of string arrays. 3.0 2003-08-05 P. Khetarpal Updated for standards changes; added WINDOW support; added "examples" directory; included ARRAY and COLLECTION object support. COMPATIBILITY WARNINGS: These programs have only been tested on IDL version 6.1 for SunOS 8.0 and Mandrake Linux 10, they may not work as well on other systems/versions. PDS objects supported by these programs: Major Objects: ARRAY COLLECTION ELEMENT IMAGE TABLE INDEX_TABLE GAZETTEER_TABLE PALETTE QUBE SERIES SPECTRUM Sub-objects: COLUMN WINDOW ELEMENT PDS objects NOT supported by these programs: BIT_COLUMN BIT_ELEMENT CATALOG CONTAINER HISTOGRAM HISTORY IMAGE_MAP_PROJECTION SPICE_KERNEL PDS objects not needed by these programs: DATA_PRODUCT DATA_SUPPLIER DIRECTORY DOCUMENT FILE HEADER VOLUME ============================================================================== For instructions on using these routines, please see aareadme.txt file. ============================================================================== FITS: I/O software in the comercial language IDL is available from the IDL Astronomy Library (Landsman 1995), which is accessible from the WWW site http://idlastro.gsfc.nasa.gov/homepage.html Landsman, W.B. 1995, "The IDL Astronomy User's Library" in "Astronomical Data Analysis Software and Systems IV", ed. R. Shaw, H.E. Payne, J.J.E. Hayes, ASP Conference Series 77, p. 437 A listing of some particularly useful 'idlastro' procedures follow: headfits.pro - retrieves the FITS header from a file readfits.pro - reads a FITS file, returns data sxaddpar.pro - add or modify a parameter in a FITS array sxpar.pro - retrieves specified data from FITS headers wherenan.pro - finds the position of the IEEE NaN special values LICENSING INFORMATION: IDL is the property of Research Systems, Inc., Copyright 1989-2003 All rights reserved. Unauthorized reproduction prohibited. The University of Maryland is licensed to use IDL.