PDSREAD 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: addeobj.pro - inserts END_OBJECT keyword values in label if not present apply_bitmask.pro - applies bitmask on integer arrays or scalars arrcolpds.pro - reads a PDS binary array or collection into IDL array or structure arrcol_struct.pro - populates IDL structure for a given array/collection object from PDS label arr_struct.pro - populates an IDL structure for array object to be read btabvect2.pro - retrieves vectors from PDS binary tables cleanarr.pro - removes non-printable characters from string arrays clean.pro - removes non-printable characters from scalar strings coll_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_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 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 str2num.pro - converts character string to numerical form tascpds.pro - retrieves data from PDS ascii table files tbinpds.pro - retrieves data from PDS binary table files timepds.pro - retrieves time from PDS labels or ASCII tables CHANGE LOGS: =========== Version Date Programmer Description 4.2.1 2007-11-20 P. Choganwala Fixed problem with = sign in description field and leading zero problem in pdspar. 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. NOTE: Additional programs not written at SBN are required to properly access binary table data. They are 'conv_vax_unix.pro' and 'ieee_to_host.pro', and may be found in NASA/Goddard's IDL Astronomy Users Library (anonymous ftp at idlastro.gsfc.nasa.gov /pub/astron.tar.Z or WWW URL listed below) COMPATIBILITY WARNINGS: These programs have only been tested on IDL version 5.3 and 6.0 for SunOS 8.0, 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.