readme.txt
----------
Tom Woods
31 May 2005

The files in the plot_see_code directory are IDL procedures to read 
and display the TIMED SEE solar irradiance data.

The main procedure is the plot_see.pro.  
The other files are IDL procedures called by plot_see.pro.

The normal usage of plot_see.pro is with the TIMED SEE merged Level 3 data product
that can be downloaded from http://lasp.colorado.edu/see/.  From this web site, 
click on the "SEE Menu" and "Data" item in the menu on the left, then click 
on the "L3" item under the "Merged NetCDF" column to start the download.
The SEE Version 7 data products are currently available at this writing, but SEE
Version 8 data products are expected to be released soon and correct several 
known instrumental effects (such as degradation).  Note that the SEE Version 7 data
products are only corrected for degradation until August 2004.


 USAGE
 -----
 IDL> plot_see, wave_or_day, type=type, file=file,  $
                 line_num=line_num, /list_lines, xps_num=xps_num, $
                 xrange=xrange, data=data, /undo1au, $
                 proxy=proxy, ptitle=ptitle, pcolor=pcolor, $
                 planet=planet
 
where:

    wave_or_day = wavelength if type='TS' or 'CP'
                  (can be wavelength range)
                = Day (YYYYDOY) if type='SP'
                  (can be day range)
 
    /undo1au    = undo correction to 1 AU (put irradiance at Earth)
 
    line_num    = 1-38 are valid values for L3 LINEs (emission lines)
                  or  /line_num is option to plot the lines if type='SP'
    /list_lines = option to list the lines (name, wavelength)
 
    xps_num     = 1-12 (exclude 4,8,12) for plotting XPS diode data
 
    proxy       = fltarr(2,*) of proxy data used for type='CP'
    ptitle      = title for PROXY plots
    pcolor      = color for PROXY plots or color table for multiple SP plots
 
    file        = specify the file for the SEE L3 merged file
                  (normally not needed as it will search for latest version)
 
    planet      = planet name or number (1-9) to time shift SEE data to planet
 
    data        = output for this plot, fltarr(2,*) for 'TS' or 'SP'
                                    or  fltarr(3,*) for 'CP' type


EXAMPLES
--------
1.  Plot the 121.5 nm (H I Lyman-alpha) time series at 1 AU.

IDL>  plot_see, 121.5		

2.  Plot the 121.5 nm time series at Mars and return time series data into "mars_ts".

IDL>  plot_see, 121.5, planet="Mars", data=mars_ts

3.  Plot the solar spectrum (0-194 nm) for day 2002/111 at 1 AU.

IDL>  plot_see, 2002111L, type='SP'

4.  Plot the solar spectrum for day 2003/250 at Jupiter and return data into "jupiter_sp".

IDL>  plot_see, 2003250L, type='SP', planet=5, data=jupiter_sp

5.  Compare the 58.5 nm (He I) irradiance to 121.5 nm irradiance (H I) at 1 AU.

IDL>  plot_see, 121.5, data=ts121		; get 121.5 nm time series data first

IDL>  plot_see, 58.5, proxy=ts121, ptitle="H I 121.5 nm"

