From Liyun.Wang.1@gsfc.nasa.gov Tue Nov 18 16:41:34 2003
Date: Thu, 10 Apr 1997 16:47:00 -0400
From: Liyun Wang <Liyun.Wang.1@gsfc.nasa.gov>
Reply-To: sumer-soft@esa.nascom.nasa.gov
To: SUMER software list <sumer-soft@esa.nascom.nasa.gov>
Subject: SUMER-SOFT: Exploring SUMER IDL software with RT

Hi folks,

Some of you already know that I developed a Perl package called RT --
the Right Tool for IDL/PV~WAVE software exploring. This tool has been
used by the CDS team even since I made it available. RT is a set of perl
programs that allow you to explore IDL software installed on a machine.
The most important and useful feature of the package is that it can show
you the relationship, even in graphic format, of any given routine with
the rest of routines in the software tree: what routines it calls (and
therefore depends on) and by what routines it is called. To give you a
rough idea on what RT can do for you, here is a report by RT (rtree) on
dependence of a routine, tl_print_spec, written by Klaus Wilhelm in his
tl_sumer package:

tl_print_spec---tl_conversion
              |-tl_point_1---tl_sphel_list
              |-tl_point_2---tl_slit_list
              |-tl_point_3
              |-tl_point_4---tl_comp_list
              |-tl_point_5
              |-tl_point_6---tl_compress_list
              |-tl_check_1
              |-tl_point_8---tl_format_list
              |-tl_rate_p
              |-tl_text
              |-tl_overload_p
              |-tl_memory
              |-tl_storage
              |-tl_iteration---tl_rate_p
              |              |-tl_duration_c---tl_int_var---separation()
              |              |               |-tl_order
              |              |               \-tl_grating---tl_ramp_c
              |              |-tl_overload_p
              |              \-tl_memory
              \-tl_check_2

With RT's rtcaller command, we can see which routines call tl_iteration,
and they in tern are called by what other routines:

tl_iteration---tl_point_17---tl_print_euv---tl_sumer
             |             |-tl_print_expl---tl_sumer
             |             \-tl_print_rsc---tl_sumer
             |-tl_print_cel---tl_sumer
             |-tl_print_disk---tl_sumer
             \-tl_print_spec---tl_sumer

For more information on how to use the RT package, please refer to the
man pages (rt, rtwhich, rtarg, rtdoc, rtcaller, rtree, rtsearch, rtpath,
etc.).
All RT commands can be accessed and invoked from within the RT driver
program, rt.

I have started a mirror job that copies all IDL routines from SUMER's
PLROOT and CONTRIB directories to CDS machine achilles (and orpheus)
under my account; corresponding database files for use by RT are also
updated on the daily basis. This means that those of you who have
account on orpheus/achilles can now use RT to explore SUMER IDL software
as well. Please note that on orpheus/achilles, an environment variable,
RT_PATH, is set to /cds/idl by default for exploring CDS IDL software.
When you want to explore SUMER IDL software with RT, you must set
RT_PATH to ~lwang/sumer/idl by doing:

% setenv RT_PATH ~lwang/sumer/idl

When you want to deal with CDS software again, set RT_PATH back to
/cds/idl.

If you have any problem regarding RT, please let me know.

Regards,

Liyun

PS. I may port the RT package to VMS machines running VMS Perl in the
future; let's wait'n see.

-- 
==================================================================
Liyun Wang                |                      FAX: 301-286-0264
G1 Building 26, SOHO EAF  |                    Voice: 301-286-3126     
NASA, GSFC, Code 682.3    |             Liyun.Wang.1@gsfc.nasa.gov
Greenbelt, MD 20771       |  http://orpheus.nascom.nasa.gov/~lwang
==================================================================