******************************************************************************* polar_ceppad_pitch V.2.0 February 26, 1999, Reiner Friedel ******************************************************************************* Use this window to add new polar_ceppad_pitch panels to the Panel Composer or to edit existing polar_ceppad_pitch panels. This module is based on pitch angle files produced from the RAL Intermediate Format (if) files and also "look" like if files themselves (they are IDL savesets which are portable to other platforms). A limited set of if files has been produced for the whole POLAR mission: DATA AVAILABILITY ------------------------------------------------------------------------------- At the LANL site only a limited set of pitch angle files have been produced, and will only be producede on demand for limited periods. The files can be produced in varying resolutions, based on averaging the orignal data by spin and sector. The files have the following naming convention: yyyymmdd_seZsp_ins_pitch.idl where yyyy is the 4 digit year number mm is the 2 digit month number dd is the 2 digit day number se is the 2 digit number of sectors averaged sp is the 2 digit number of spins averaged ins is the instrument id srting (ips,ies,histe,histp) se can have values 32 (highest), 16, 8, 4 which will produce associated pitch angle bins 18 (highest), 12, 9, 6 sp can have values 1 (lowest), 2, 4, 8, 16, 32 The basic survey-type pitch angle file is averaged over 8 spins and 16 sectors (seZsp = 16Z8). Higher resolutions produce larger files. The highest resolution possible (32Z1) can only be produced for limited intervals as the files get huge. FORM OF PLOTS ------------------------------------------------------------------------------- Color plots of spectra or pitch angle distributions PAPCO SUPPORT ------------------------------------------------------------------------------- Y-SCALING SUPPORT yes SLICE SUPPORT no ZOOMING SUPPORT yes NO DATA FOUND SUPPORT yes PLOT BY ORBIT AVAILABLE? yes OVERPLOTPOSSIBLE? no PLOT OVER FILE BOUNDARIES POSSIBLE? yes Remote get? no OUTPUT DATA yes =============================================================================== 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. SECTOR/SPIN AVERAGE COMBINATIONS BUTTONS ------------------------------------------------------------------------------- Listed herec are all the possible sector and spin combinations. Depending on the files you have available on your site for the time chosen in the PAPCO main widget, ONLY THOSE BUTTONS FOR WHICH THERE IS DATA ARE ACTIVE. If you've speciefied a time period over many days, only the data that's there for the FIRST of those days is searched. ENERGY / PITCH ANGLE SLIDERS ------------------------------------------------------------------------------- The two buttons toggle the display mode of the slider. "energy spectrum & pitch angle" allows you to select a pitch angle range for an energy spectrum. "pitch angle distribution & energy allows you to select an energy for a pitch angle distribution. COLORBAR ------------------------------------------------------------------------------- Choose a PAPCO color subtable. THIS FUNCTION NEEDS TO BE SUPPORTED BY THE PLOT ROUTINE TO WORK. IT IS ONLY MEANINGFUL FOR COLOR PLOTS. PAPCO provides the user with four internal color tables. These can be used in several plots at the same time as PAPCO subdivides the IDL color-table into four. The buttons choose the color sub-table to be used, the names given are those for the color tables loaded at startup. The first one is the default PAPCO color table (GSFC rainbow) and cannot be changed. The other three can be user defined. The colorbars indicate the current status of the loaded color sub-tables. 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. ZSCALING ------------------------------------------------------------------------------- Choose automatic or manual Z-scaling. THIS FUNCTION NEEDS TO BE SUPPORTED BY THE PLOT ROUTINE TO WORK. IT IS ONLY MEANINGFUL FOR COLOR OR 3-D PLOTS. For Use automatic z-scaling, the common block vector zscl 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 z-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 zscl. 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 zscl and can be used directly to set the zlog 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 polar_ceppad_pitch when the editor is called to edit an existing panel.