THE IDL ASTRONOMY USER'S LIBRARY (March 2004)

The IDL Astronomy Users Library is a central repository for general purpose 
astronomy procedures written in IDL.    The library currently contains
500+ procedures including general FITS I/O, interfaces with STSDAS and IRAF,
astronomical utilities, and photometry and spectral analysis procedures.  
The library is not meant to be an integrated package, but rather is a
collection of procedures  from which users can pick and choose (and possibly
modify) for their own use. Submitted procedures are given a cursory testing,
but are basically stored in the library as submitted.     The IDL
Astronomy User's Library was funded through November 2000 under the NASA 
Astrophysics Data program.

The IDL Astronomy Library is accessible via the World Wide Web home page 
http://idlastro.gsfc.nasa.gov/homepage.html.     The default version of the
Library requires IDL V5.3, although earlier versions are available for 
V4.0-V5.0, V5.1, and V5.2.     

The success of the IDL Astronomy User's Library depends upon the
willingness of users to give as well as take.   Submission of relevant
procedures is strongly encouraged.  Equally important is the notification 
(or correction) of programming bugs or documentation errors.

News about the Library is occasionally (no more than once a year) distributed to
a E-mail distribution list.  Please inform landsman@mpb.gsfc.nasa.gov about 
addresses to add, delete or modify from this list.

Questions about the IDL Astronomy Library can be addressed to 
Wayne Landsman     landsman@mpb.gsfc.nasa.gov
                   (301)-286-3625


The directory contains the following files

  astron.tar.gz - a gzip'ed Unix tar file containing all Library procedures 
        text files, and data files.    This file should be obtained in binary 
        mode.
  astron.dir.tar.gz - This file is an alternative to astron.tar.gz.   It 
        contains the same files as astron.tar.gz but maintains the library
        procedures in their respective sub-directories.
  astron.zip - A .zip version of the Astronomy Library, but with X-windows-only
        procedures (e.g. curs.pro) removed
  contents.txt - an ASCII file giving one-line descriptions of all
        500+ procedures currently in the Library.   This listing is also 
        available at http://idlastro.gsfc.nasa.gov/contents.html
  guidelines.txt - Suggested programming guidelines for Astronomy library
        procedures.
  news.txt - an ASCII file listing all additions or changes to the Library 
        in the past 6 months in reverse chronological order.  This file 
        should be checked periodically as new and modified procedures are added
        to the Library.   Also availabile as an HTML file at 
        http://idlastro.gsfc.nasa.gov/news.html
  README - this file

The following subdirectories are available

  text - contains a collection of ASCII and LaTex files concerning various 
            categories of IDL procedures.
  data - contains data files used by a couple of Library procedures.   *Due to
         their size, the files testpo.405 and JPLEPH.405 are not included in
         the .tar and.zip files.    This environment variable ASTRO_DATA should
         point to this directory.  
  obsolete - repository for procedures removed from the Library because their 
         use has diminished or their functionality has been replaced by other
         procedures.
  pro  - Contains all the Library procedures as individual ASCII files.
            These procedures are placed in subdirectories according to their
            category, e.g. pro/fits, pro/sdas, pro/idlphot
  v4 - Contains the IDL Astronomy Library procedures formatted for use with
            IDL V3.6 through V5.0.
  v51 - Contains a frozen version of the Library formatted for use with V5.1
  v52 - Contains a frozen version of the Library formatted for use with V5.2
  v54 - A beta test directory of procedures upgraded to take advantage of new
            features  introduced in IDL V5.4.   These procedures will *not* run
            in earlier versions of IDL.
  v55 -  A beta test directory of procedures upgraded to take advantage of new
            features  introduced in IDL V5.5.   These procedures will *not* run
            in earlier versions of IDL.
  v56 - A beta test directory of procedures upgraded to take advantage of new
            features  introduced in IDL V5.6.   These procedures will *not* run
            in earlier versions of IDL.
  zdbase - Contains compressed binary tar files of popular astronomical
           catalogs formatted as IDL databases.   See the file
           zdbase/README for more info. 
  contrib - contains self-contained IDL astronomy-related packages that
           are *not* part of the standard astronomy library distribution.
           See contrib/README for more info.






