******************************************************************************* lanl_geo module V.1.0 September 15, 1998 Module author: Reiner Friedel, friedel@lanl.gov Los Alamos Geostationary Satellites - Energetic Particles ******************************************************************************* Use this window to add new lanl_geo panels to the Panel Composer or to edit existing lanl_geo panels. Energetic Particle data from Los Alamos geostationary satellites are used, both from the SOPA and CPA instruments. For a full description of the data and instruments see the LANL Energetic particle Home Page: http://leadbelly.lanl.gov/lanl_ep_data/lanl_ep.html DATA AVAILABILITY ------------------------------------------------------------------------------- A full data archive is maintained at Los Alamos National Laboratory with data available since 1976. This data is made available via an interactive web site where the user can submit requests for the data: http://leadbelly/lanl_ep_data/ep_request.html Once a request has been processed, the user is informed via email of the location of the data (directory) on the leadbelly ftp server: ftp://leadbelly.lanl.gov/pub/ This data can then be obtained in two ways: 1. Download it manually (outside of PAPCO) and copy it to the lanl_geo archive directory pointed at by LA_DATA_ARCHIVE 2. Set the LA_FTP_ARCHIVE environmental variable to the URL of the data using the configure window and use the panel editor to download the data. NB. THIS REQUIRES THE UTILITY wGet AND WORKS ONLY ON UNIX PLATFORMS. See the description of the panel editors widgets below. This module is designed to work with the format of data obtained through this request procedure. For Users at LANL only: ----------------------- If you're at LANL on the NIS UNIX scheme and belong to the group "epdata" then you can use this module to submit a request for data directly, without going through the Web page. The module will write the request file, and manually execute the request on leadbelly. See the description of the panel editors widgets below. Contact Geoff Reeves (reeves@lanl.gov) for large data requests. FORM OF PLOTS ------------------------------------------------------------------------------- Data is plotted in the form of stacked line plots. You may choose any combination of channels, which are then plotted with different colors, and are labeled with their energy in the same color. CONFIGURE OPTIONS ------------------------------------------------------------------------------- Pressing the Configure button calls up this module's configure widget. This sets a series of environmental variables which are needed for this module to function. THESE HAVE TO BE SET BEFORE THE MODULE IS USED THE FIRST TIME. LA_DATA working directory of idl binaries LA_DATA_ARCHIVE directory of archive data (original format0 LA_FTP_ARCHIVE url of remote data site the url string needed to access data remotely of the form ftp://user:password@remote.host.name/data/dir/ If user:password are absent, anonymous ftp is used. If the string "user:password" is used exactly, the user is prompted for that information. Getting of remote data used the utility wGet and will only work on Unix platforms. PAPCO SUPPORT ------------------------------------------------------------------------------- Y-SCALING SUPPORT yes Z-SCALING SUPPORT yes/no PAPCO COLOR SCHEME SUPPORT yes ZOOMING SUPPORT yes NO DATA FOUND SUPPORT yes PLOT BY ORBIT AVAILABLE? no OVERPLOT POSSIBLE? yes PLOT OVER FILE BOUNDARIES POSSIBLE? yes REMOTE DATA GET? yes OUTPUT DATA TO FILE? no SLICE SUPPORT yes/no Slices supported: =============================================================================== DESCRIPTION OF PANEL EDITOR FUNCTIONS =============================================================================== HEIGHT OF THE PLOT ------------------------------------------------------------------------------- Use this slider to modify the plot's height. Effectively, this slider is the third element of the panel-vector which is displayed in the plot list-box in PAPCO's main window. You may as well change the plot's height by using the buttons to the right of the plot-description list-box in PAPCO's main-window. ------------------------------------------------------------------------------- ************************************************** ****************** Begin Module Specific Section Widgets ********************** ************************************************** GET LOCALLY / GET VIA FTP ------------------------------------------------------------------------------- This sets how data is obtained which you do not have available locally for the time chosen. Get locally is only available at LANL and enables the widgets which set options for the local data request (counts/flux, energy channel groups, time resolution). For users outside LANL, use the get via ftp option. You then have to submit a request for data manually via the web (see "DATA AVAILABILITY" above). COUNTS / FLUX (get local option only) ------------------------------------------------------------------------------- Requests data in either counts or flux units. Does not change the way the data is plotted. Date files contain the sting "flux" when that option is chosen. ENERGY RANGE SELECTION (get local option only) ------------------------------------------------------------------------------- The request program can provide data grouped in several species/energy ranges. Select any combination desired, or choose "All" for all channels. TIME RESOLUTION CHOICE (get local option only) ------------------------------------------------------------------------------- Select the data time resolution. All data is spin averaged, highest resolution possible one spin (10 sec). Choose the resolution needed. Lower resolution requests execute faster of course... CHANNEL SWITCHES ------------------------------------------------------------------------------- This series of 32 switches is used to select the channel combinations for plotting. Initially they are labeled "empty", as long as no satellite / file extension is chosen. Once you choose a satellite ID, the channel information for that satellite and file is displayed. Depending on the data requested, files will contain different energy channels. When the data is only available in the original archive format (the way produced by the request program on leadbelly), these channels are not known. The FIRST time the data is plotted, the original format is read and converted into an idl binary (for quicker subsequent read operations) and a header file is written with the channel information, which is subsequently used to display the channel information. SATELLITE ID / extension - data file chooser ------------------------------------------------------------------------------- At any given time data might be available for several geostationary satellites, and in files with different extensions depending on what data was requested. This widget manages/displays what satellites and file extensions are available for the currently set time in PAPCO, both locally and remotely. Note: The "locally gotten" file extensions are more verbose than the ones you get over the Web request program. In that case, you'll have to "remember" what type of data is in the files you requested, or look into the file header yourself. local sat ID: A list of satellite ID's available in the directory pointed at by LA_DATA_ARCHIVE for the time period chosen local ext: File extensions available for the satellites available. The list gives the choices available, the fields above show the current choice you've made out of the list by clicking on an entry. remote sat ID: Assuming you've downloaded a list of files from the remote site pointed at by LA_FTP_ARCHIVE a list of the satellites available at the remote site for the time period chosen is displayed. remote ext: Assuming you've downloaded a list of files from the remote site pointed at by LA_FTP_ARCHIVE a list of the file extensions for the satellites available at the remote site for the time period chosen is displayed. remote download: Operates on the files selected in the list. If you're "getting locally", this will send of the request for your data and copy the resulting files into LA_DATA_ARCHIVE. If you're getting via ftp this will set up a wGet request to the remote site and download the files into LA_DATA_ARCHIVE. get remote list: Downloads a list of files available on the remote site (ftp get only) which are then displayed. do local request: run the request program to make the data files. refresh all info: rereads local and remoe lists if IDs and extensions. If no satellites are available for the time chosen, a message will appear. NOTE: You HAVE to choose a satellite in order to exit the panel editor. Otherwise you may only exit with CANCEL. ************************************************** ******************* End Module Specific Section Widgets *********************** ************************************************** ------------------------------------------------------------------------------- SYMBOL / COLOR ------------------------------------------------------------------------------- Choose a line style and color for your line plots THIS FUNCTION NEEDS TO BE SUPPORTED BY THE PLOT ROUTINE TO WORK. IT IS ONLY MEANINGFUL FOR LINE PLOTS. If SYMBOL is clicked use the slider below to set your symbol type for each data point. Default (0) is no symbols (connect data with line). The graphics window to the right shows an example of the symbol chosen. Positive SYMBOL numbers are for symbols not connected with lines. Negative SYMBOL numbers are for symbols connected with lines. If COLOR is clicked a color for your lines and symbols can be chosen. YSCALING ------------------------------------------------------------------------------- Choose automatic or manual Y-scaling. THIS FUNCTION NEEDS TO BE SUPPORTED BY THE PLOT ROUTINE TO WORK. For Use automatic y-scaling, the common block vector yscl has it's first element set to zero, which tells the plot routine to use it's own yscaling - which is either hard-wired or employs some auto-scaling routines (autoscale, ylim). For Use manual y-scaling the entry fields below are activated: enter your own y-range values. These are stored in the 2nd and 3rd elements of the common block vector yscl. Once a plot has been done, the automatic values chosen are displayed in the entry field to guide the user if he wants to change them. The lin/log buttons set the 4th element in the common block vector yscl and can be used directly to set the ylog keyword to the IDL plot routine. HELP ------------------------------------------------------------------------------- Displays this help widget. THE EXIT BUTTONS ------------------------------------------------------------------------------- CANCEL closes the window and does nothing. ADD and CONTINUE closes the current window, adds the plot to the composer, and re-enters the panel editor where it left off and allows you to add a further panel with possibly another choice of parameters. ADD and CLOSE adds the plot to the composer and closes the window. ADD and CONTINUE and ADD and CLOSE are replaced by UPDATE lanl_geo when the editor is called to edit an existing panel.