INTRODUCTION

  IDLSave is a pure python module to import variables from IDL 'save' files
  (e.g. .sav) into python, and does not require IDL to work. It has a very
  simple command-line interface, and converts all IDL variables to python
  types. Arrays are converted to Numpy arrays, and Structures are converted to
  Numpy record arrays.

  The following example demonstrates how to read a .sav file into python.
  This is done using the idlsave.read method, which returns an IDLSaveFile
  instance:

    import idlsave
    s = idlsave.read('myidlfile.sav')

  This will print out a list of the contents of the IDL save file, including
  variable names. To access a variable named 'mydata', simply use:

    s.mydata

  IDL Structures are converted to recarrays. To access a given field in a
  structure, use

    s.mydata.field_name

NOTES

  There are certain records in 'save' files cannot be read by IDLSave. These
  include system variables, compiled code and procedures.

  IDLSave has been tested with a number of files generated by IDL versions 5
  to 7, and up to 5Gb in size. However, it is possible that you encounter
  problems when parsing files, in which case Exceptions should be raised. If
  that is the case, please let me know by sending a report to
  
                      robitaille@users.sourceforge.net

  There are no plans to allow IDLSave to write out save files from python in
  the near future.
    
IDL(r) is a registered trademark of ITT Visual Information Systems, Inc.