The starting point for GBTIDL documentation, bug reporting and tracking, and discussion is here: http://gbtidl.sourceforge.net/

The starting point for GBTIDL documentation, bug reporting and tracking, and discussion is here: http://gbtidl.nrao.edu/

• You can do this on the GBTIDL web site. Our on-line registration form was apparently not working properly for an unknown amount of time, so even if you think you are already registered, please re-register when you download version 2.1.1.

• You can do this on the GBTIDL web site. Our on-line registration form was apparently not working properly for an unknown amount of time, so even if you think you are already registered, please re-register when you download version 2.1.1.

• To obtain GBTIDL, download the files here

• To obtain GBTIDL, download the files here

%META:TOPICINFO{author="BobGarwood" date="1175113740" format="1.0" version="1.1"}% %META:TOPICPARENT{name="IDLMain"}%

GBTIDL Version 2.1 Patch (2.1.1) Release Notes

• Introduction
• Bug Fixes
• Register as a GBTIDL user
• Running GBTIDL in Green Bank, Socorro, or Charlottesville:
• Running your own copy of GBTIDL
  • IDL License
  • Download and Installation of GBTIDL

Introduction

These are the release notes to the first patch of GBTIDL version 2.1, known as GBTIDL version 2.1.1. See the release notes for version 2.1 for a complete list of the new features and bug fixes in version 2.1. As of 4:30 PM on Wednesday, March 28, 2007, gbtidl at all NRAO sites corresponds to version 2.1.1 and includes the patches described in this note.

The starting point for GBTIDL documentation, bug reporting and tracking, and discussion is here: http://gbtidl.sourceforge.net/

GBTIDL is an interactive package for the reduction and analysis of spectral line data taken with the Robert C. Byrd Green Bank Telescope. The package consists of a set of straightforward yet flexible calibration, averaging, and analysis procedures (the "GUIDE layer") modeled after the UniPOPS and CLASS data reduction philosophies, a customized plotter with many built-in visualization features, and Data I/O and toolbox functionality that can be used for more advanced tasks. The entire package is written in IDL.

GBTIDL version 2.1.1 is a patch of GBTIDL version 2.1. This patched version contains a small number of bug fixes, as described in these release notes.

Using the gbtidl command in Green Bank, Charlottesville or Socorro will automatically bring up this patched version of GBTIDL. If you are using a local installation, you will need to download and install this latest version from the Source Forge site.

Bug Fixes

The following bugs are fixed in this patch.

• dirin had an unintented limit of about 20 individual sdfits files in the directory being opened. As of this patch there should no longer be any limit.
• If the directory opened by dirin had any sdfits files created by gbtidl (e.g. using keep) and the directory index needed to be recreated (e.g. through the use of the /newindex parameter or due to an index version number change) then dirin would fail.
• moleculeread.pro was needlessly not releasing its file unit number when it finished thus tying up a limited IDL resource.
• The guide_struct definition no longer creates any empty data containers. This also needlessly tied up limited IDL resources.
• The following user contributed procedures were never changed to reflect the change from SUBSCAN to PROCSEQN made in version 2.1: gbt_tsys, getps_v2,and uni2sdd.
• The conversion of unipops data in the user contributed code (sdd__define.pro) has been improved. It should now correctly convert all of the unipops pointing coordinate types. It also now converts the weather parameters and it constructs an appropriate TIMESTAMP value from the original unipops data.

Register as a GBTIDL user

• You can do this on the GBTIDL web site. Our on-line registration form was apparently not working properly for an unknown amount of time, so even if you think you are already registered, please re-register when you download version 2.1.1.

Running GBTIDL in Green Bank, Socorro, or Charlottesville:

• At the unix prompt, simply type 'gbtidl'

Running your own copy of GBTIDL

IDL License

• You must have an IDL license to run GBTIDL. IDL version 6.0 and later is supported. If you don't have a license you can run GBTIDL remotely, using the computers in CV or GB. See the GBTIDL homepage for details. IDL 6.3 is needed for large file support on a Mac.

Download and Installation of GBTIDL

• To obtain GBTIDL, download the files here
• Create a directory for the installation and unzip the tar ball:

    mkdir mygbtidl
    mv gbtidl-2.1.1.tar.gz mygbtidl/.
    cd mygbtidl
    gzip -d gbtidl-2.1.1.tar.gz
    tar -xvf gbtidl-2.1.1.tar

• go to the top level directory, 'gbtidl':

    cd gbtidl

• copy 'run_gbtidl' to 'gbtidl':

    cp run_gbtidl gbtidl

• edit the 'gbtidl' script to replace "PLACE_INSTALLATION_DIR_HERE" with the full path to the gbtidl executable script. It should then look something like this:

    export GBT_IDL_DIR=/home/mygbtidl/gbtidl

• start the package by calling the script 'gbtidl':

    ./gbtidl

• You may wish to add the installation directory to your unix path.