Installation Issues for GBT IDL Single Dish Data Reduction Package T.M. Bania V2.0 30 April 2004 V2.1 15 May 2004 V3.0 15 June 2004 V3.1 08 July 2004 v3.2 21 July 2004 0. Make sure that you have the following directories installed in the same main directory: astrolib/ colors/ coyote/ data/ saves/ test/ figs/ textoidl/ lines/ v3.2/ gumley/ markwardt/ rtr/ dsb/ ==> /textoidl/ was updated to v2.1.2 by the author on 22 june 2004 these are *important* updates and must be used. (IDL v5.3 or higher). The /textoidl/ directory in /users/tbania/idl/ has been updated so get it there. N.B. the rtr/, dsb/, and test/ directories contain special procedures for the 3Helium experiment and may not be of use for you. They, however, do provide powerful procedures for averaging and bookkeeping TP PS spectral line data. You can get these from Tom Bania or from Dana Balser. (You may wish to read the INSTALL_V2.X and INSTALL_v3.x files.) Further documentation can be found in the v3.2/DOCS directory. 1. cd v3.2/ and run the package from the v3.2/ directory. Before you can run the package, you must modify the following files => <= ------------------------------------------------------------------------------ => IDL.INIT.V3.2 <= ------------- a. Change setenv IDL_STARTUP /users/tbania/idl/v3.2/STARTUP.IDL.v3.2 to the appropriate, fully qualified file name. b. Make sure that setenv IDL_PATH starts with the path appropriate for your IDL installation. c. Add all the directories from step 0 to the IDL_PATH d. Enter the correct logical name for the printer you intend to use. N.B. you can also assign this from within IDL via the SETPRINTER command. => STARTUP.IDL.V3.2 <= ---------------- a. Change all the file names to those appropriate for your installation. THIS SHOULD NOT BE NECESSARY IN v3.2. TRY INSTALLING WITH NO CHANGES. b. Change the file name of the input SDFITS data file which is to be used at startup to make the ONLINE data file: start_gbt,'/users/tbania/idl/data/TGBT02A_041_06.avg.acs.fits' <======= *** SDFITS data file name ***** ========> => init_files <= ---------- a. Change all the file names to those appropriate for your installation. AGAIN, THIS SHOULD NOT BE NECESSARY IN v3.2. 2. To run the package do the following. More details for this can be found in the COOK_BOOK file located in v3.2/DOCS cd v3.2 source IDL.INIT.v3.2 idl <= I recommend idl rather than idle This gives you the maximum clarity during normal operation of the GBT_IDL package. IDLDE is, however, the superior shell to use during procedure development and debugging. This starts your session. For explanations of the package you should look at various README files, as well as: OVERVIEW discusses philosophy of the package PROCEDURES_LIST_v3.2 gives explanations of the procedures COMMANDS summarizes commands by their functionality PRINTING explains how to get hardcopy out of IDL CONTINUUM discusses how the package handles DCR data NOTES_v3.2 summarizes changes since v2.1 3. To make .html files of the package and its main libraries which can then be viewed with your web browser do the following: Run IDL from the v3.2/ directory. From within IDL, .compile the following procedures which can be found in ../v3.2/DOCS/ mk_html_v3_2.pro create_v3_2.pro mk_html_libs.pro create_libs.pro Compile and execute them in the order given below and they will put these two .html files in your ../v3.2/DOCS/ directory: 1. gbt_idl_v3.2.html Provides hypertext links to all the text documents in the ../v3.2/DOCS directory. It also provides hypertext links to all the GBT_IDL commands as well as links to the .pro procedure files themselves. 2. gbt_idl_libs.html Provides hypertext links to all JHU ASTROLIB procedures as well as the TeXtoIDL package procedures. ORDER BELOW IS IMPORTANT: ; .compile ../v3.2/DOCS/mk_html_libs.pro .compile ../v3.2/DOCS/create_libs.pro create_libs .compile ../v3.2/DOCS/mk_html_v3_2.pro .compile ../v3.2/DOCS/create_v3_2.pro create_v3_2 ; N.B. We have hacked the IDL mk_html_help.pro command for this stuff. TMB tried to make the procedures installation independent but got lost in a mire of directory dependencies and HTML code. So you need to hack all four of those files and put in your local fully qualified file names for the directories where stuff is located: Here are the lines to change: create_v3_2.pro dir=['/idl/idl/v3.2/','/idl/idl/rtr/','/idl/idl/lines/'] outfile='/idl/idl/v3.2/DOCS/gbt_idl_v3.2.html' mk_html_v3_2.pro NOTHING create_libs.pro dir=['/idl/idl/astrolib/pro/','/idl/idl/textoidl/'] outfile='/idl/idl/v3.2/DOCS/gbt_idl_libs.html' mk_html_libs.pro ; dsb - hardwire user documents ddir = '/idl/idl/astrolib/' PRINTF,final_file,'' PRINTF,final_file,'

List of Documents

' PRINTF,final_file,'