NRAO Home  >  Green Bank  |  Wiki Topic:    GB > Data > GbtidlReleaseNotes_2_2 (r1.1 vs. r1.7)
   Changes | Index | Contents | Search | Statistics | Jump to Topic
 <<O>>  Difference Topic GbtidlReleaseNotes_2_2 (r1.7 - 13 Dec 2007 - BobGarwood)
Changed:
<
<

>
>

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

>
>

Changed:
<
<

  • To obtain GBTIDL, download the files here
>
>

  • To obtain GBTIDL, download the files here

 <<O>>  Difference Topic GbtidlReleaseNotes_2_2 (r1.6 - 10 Aug 2007 - AmyShelton)
Changed:
<
<

  • avgstack with the /noclear keyword set was not behaving as advertized. It was correctly not clearing the accumulation at the start but incorrrectly clearing it at the end.
>
>

  • avgstack with the /noclear keyword set was not behaving as advertised. It was correctly not clearing the accumulation at the start but incorrectly clearing it at the end.

 <<O>>  Difference Topic GbtidlReleaseNotes_2_2 (r1.5 - 09 Aug 2007 - JimBraatz)
Changed:
<
<

Bug's Fixed

>
>

Bugs Fixed


 <<O>>  Difference Topic GbtidlReleaseNotes_2_2 (r1.4 - 08 Aug 2007 - BobGarwood)
Changed:
<
<

  • molecule, recombc, recombhe, recombh*, recombn*, and recombo had a bug that resulted in the marked lines some times appearing at the wrong position. This would occur when the plotted x-axis included an additional offset (usually the source velocity). The shift due to that offset was applied in the wrong direction.
>
>

  • molecule, recombc, recombhe, recombh, recombn, and recombo had a bug that resulted in the marked lines some times appearing at the wrong position. This would occur when the plotted x-axis included an additional offset (usually the source velocity). The shift due to that offset was applied in the wrong direction.

 <<O>>  Difference Topic GbtidlReleaseNotes_2_2 (r1.3 - 08 Aug 2007 - PaulMarganian)
Changed:
<
<

  • Data selection by sampler name is now available in the following routines: flag, getbs, getfs, getnod, getps, getsigref and gettp. This done through the new sampler keyword in each of those procedures. This is a string specifying the sampler name (e.g. "A3"). The sampler name is synonymous with a single combination of ifnum, plnum, and fdnum. It is an error to use both types of data selection (sampler name and any of IF, polarization, or feed number) in the same call to one of these routines. Most users will continue to use the integer numbers to select the data to handle but in some cases users may find it more convenient to select data by sampler name.
>
>

  • Data selection by sampler name is now available in the following routines: flag, getbs, getfs, getnod, getps, getsigref and gettp. This is done through the new sampler keyword in each of those procedures. This is a string specifying the sampler name (e.g. "A3"). The sampler name is synonymous with a single combination of ifnum, plnum, and fdnum. It is an error to use both types of data selection (sampler name and any of IF, polarization, or feed number) in the same call to one of these routines. Most users will continue to use the integer numbers to select the data to handle but in some cases users may find it more convenient to select data by sampler name.
Changed:
<
<

  • Because the scan number may now be a larger, the format of the output of header as well as the header information on plots has been adjusted.
>
>

  • Because the scan number may now be larger, the format of the output of header as well as the header information on plots has been adjusted.

 <<O>>  Difference Topic GbtidlReleaseNotes_2_2 (r1.2 - 08 Aug 2007 - BobGarwood)
Changed:
<
<

*

  • New data file index. The index version number has changed because of the new data selection fields. When you open a data file with an index having an older version number GBTIDL will automatically recreate the index from the data file without any loss of information.
  • New arguments to existing procedures.
>
>

  • Data selection by sampler name is now available in the following routines: flag, getbs, getfs, getnod, getps, getsigref and gettp. This done through the new sampler keyword in each of those procedures. This is a string specifying the sampler name (e.g. "A3"). The sampler name is synonymous with a single combination of ifnum, plnum, and fdnum. It is an error to use both types of data selection (sampler name and any of IF, polarization, or feed number) in the same call to one of these routines. Most users will continue to use the integer numbers to select the data to handle but in some cases users may find it more convenient to select data by sampler name.
  • The structure returned by scan_info now includes N_SAMPLERS and SAMPLERS fields giving the number of unique samplers and the array of unique sampler names in that scan.
  • Two new functions, samplerinfo and whichsampler can be used to convert between an (ifnum, plnum, fdnum) combination and sampler.
  • As reported in the sdfits release notes several columns are now wider. The OBJECT column is now 32 characters (was 16 characters) and the SCAN, LASTON, LASTOFF, INT, and NSAVE integer columns are now long integers (32 bits) instead of short integers (16 bits). The INT and NSAVE columns are not written by sdfits but are written by GBTIDL (keep and nsave). NOTE if you are saving to an existing, older, file it will still have the short integer columns and consequently you can lose information if you use a large NSAVE value. In order to take advantage of these larger integers it is necessary to write to a new output file.
  • New data file index. The index version number has changed because of the new long integer columns also found in the index (SCAN, INT, and NSAVE). GBTIDL will re-create the index file as necessary when an sdfits file is opened and the existing index file has an older version number. There will be an informational message when that happens.
  • Because the scan number may now be a larger, the format of the output of header as well as the header information on plots has been adjusted.
  • A procedure, oplotfn, allows you to over-plot a function on the GBTIDL plotter. You supply an IDL function name and the parameters used to generate the values to be plotted. The GBTIDL plotter then invokes this procedure using those parameters as needed to generate the values to be plotted. This allows for a smooth display of the function at any zoom level. The Gaussian plotting in GBTIDL has been modified to use this new procedure.
  • New arguments to existing procedures
    • unflag has a new /all keyword. When used, all flags are unflagged.
    • bias has a new buffer keyword to identify which buffer to apply the bias to (the default is the primary data container, buffer 0).
Changed:
<
<

*

>
>

  • molecule, recombc, recombhe, recombh*, recombn*, and recombo had a bug that resulted in the marked lines some times appearing at the wrong position. This would occur when the plotted x-axis included an additional offset (usually the source velocity). The shift due to that offset was applied in the wrong direction.
  • avgstack with the /noclear keyword set was not behaving as advertized. It was correctly not clearing the accumulation at the start but incorrrectly clearing it at the end.
  • In scale the buffer keyword could be unexpectedly set when the procedure was invoked. The buffer keyword is intended as an input keyword, meaning that the procedure itself should just use this value and not change it internally. In some cases, scale was changing the value of buffer to 0. This would happen when scale was intentionally called with an unset value for the buffer keyword. That can be a useful technique when used within another procedure which itself has a buffer value. That could cause unexpected results if that value of buffer was subsequently used or tested.
Changed:
<
<

*

>
>

  • Use of the IDL plot procedure may some times cause the GBTIDL oplot procedure to fail. This will be fixed in the next release of GBTIDL.
    • This works
      getrec, 0
      plot, x, y1
      oplot, x, y2
* But in this example, oplot fails
      plot, x, y1
      getrec, 0
      oplot, x, y2
Changed:
<
<

  • 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.
>
>

  • 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 or later is needed for large file support on a Mac.

 <<O>>  Difference Topic GbtidlReleaseNotes_2_2 (r1.1 - 07 Aug 2007 - BobGarwood)
Added:
>
>

%META:TOPICINFO{author="BobGarwood" date="1186525320" format="1.0" version="1.1"}% %META:TOPICPARENT{name="Software.ReleaseNotes_7_5"}%

GBTIDL Release Notes Version 2.2

Introduction

We are pleased to announce the release of GBTIDL, version 2.2. GBTIDL is an interactive package for 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.2 contains numerous new features and bug fixes, as described in these release notes.

Users may wish to also read the release notes of the latest version of sdfits which includes changes of interest to GBTIDL users.

Getting Started

  • The starting point for GBTIDL documentation, bug reporting and tracking, and discussion is here: http://gbtidl.sourceforge.net/
  • A comprehensive User's Guide is also available although it has not yet been updated to include the changes discussed here.

New Features

*
  • New data file index. The index version number has changed because of the new data selection fields. When you open a data file with an index having an older version number GBTIDL will automatically recreate the index from the data file without any loss of information.
  • New arguments to existing procedures.

Bug's Fixed

*

Known Issues

*

Register as a GBTIDL user

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.2.tar.gz mygbtidl/.
    cd mygbtidl
    gzip -d gbtidl-2.2.tar.gz
    tar -xvf gbtidl-2.2.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.

Topic GbtidlReleaseNotes_2_2 . { View | Diffs | r1.7 | > | r1.6 | > | r1.5 | More }
Revision r1.1 - 07 Aug 2007 - 22:22 GMT - BobGarwood
Revision r1.7 - 13 Dec 2007 - 21:29 GMT - BobGarwood
Content copyright © 1999-2007 by the contributing authors.
All material on this collaboration platform is the property of the contributing authors.