This page was created by the IDL library routine
mk_html_help2.
Last modified: Wed Jul 1 14:02:38 2009.
NAME:
test_leap_yr
CALLING SEQUENCE:
lyr=test_leap_yr(iyr,modays=modays)
PURPOSE:
Determines whether a given year is a leap year, and
returns the number of days in every month
INPUT:
iyr = The year, as an integer
OUTPUT:
lyr= 1 if iyr is a leap year and 0 if not
KEYWORDS:
modays= the number of days in each month
modays= [31, 29, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31] for
a leap yr, [31, 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31] otherwise
HISTORY:
Written 19-OCt-93 by JM
Rewritten, 9-jul-2007, jmm
(See themis/thm_ui/thm_ui_timefix.pro)
NAME: Setting ptype
thm_ui_call_tplot
PURPOSE:
A widget interface for calling tplot from the themis_w widget,
currently of limited usefulness, but expandable
CALLING SEQUENCE:
thm_ui_call_tplot, master_widget_id
INPUT:
master_widget_id = the id number of the widget that calls this
OUTPUT:
none, there are button_master to push for plotting, setting limits, not
sure what else yet...
HISTORY:
14-dec-2006, jmm, jimm@ssl.berkeley.edu
13-feb-2007, jmm, fixed problem with !p.background resetting in
set_plot commands
12-mar-2007, jmm, Added wavelet button
2-apr-2007, jmm, Added pwrspc options, NEEDS TESTING.
jun-2007, jmm, split from dproc widget.
12-jul-2007, jmm, added a message widget, for invalid user input
errors, grays out all button_master while processing
31-jul-2007, jmm, various checks for windows present to avoid tplot
and ctime bombs
25-oct-2007, jmm, plot info, window number, size, ptyp, are no held
in the main GUI state structure
19-mar-2008, jmm, changed state.ptyp to pstate.ptyp to fix bug
1-apr-2008, cg, added a pop-up window to allow user to set size/units
for postscript files
5-may-2008, cg, fixed bug with scroll bar
15-may-2008, cg, added spacecraft/component plot capabilities
reorganized code
$LastChangedBy: cgoethel $
$LastChangedDate: 2008-07-08 08:41:22 -0700 (Tue, 08 Jul 2008) $
$LastChangedRevision: 3261 $
$URL: svn+ssh://thmsvn@ambrosia.ssl.berkeley.edu/repos/thmsoc/tags/tdas_5_11/idl/themis/thm_ui/thm_ui_call_tplot.pro $
(See themis/thm_ui/thm_ui_call_tplot.pro)
NAME:
thm_ui_check4spin
PURPOSE:
given a THEMIS tplot variable name, check to see if spin period and
phase exist, for coordinate transformations, If they do not, load
the state data for the appropriate time period
CALLING SEQUENCE:
thm_ui_check4spin, vname, vname_spin1, vname_spin2, history_out
INPUT:
vname = tplot variable name
OUTPUT:
vname_spin1 = the tplot variable containing the spin period. or
spinras
vname_spin2 = the tplot variable containing the spin phase or
spindec
history_out = a history string, if data needs loading
KEYWORDS:
rasdec = if set, return the variables for spinras, and spindec used
for dsl <-> gse tranformations
HISTORY:
26-feb-2007, jmm, jimm@ssl.berkeley.edu
$LastChangedBy: jwl $
$LastChangedDate: 2008-08-04 11:35:55 -0700 (Mon, 04 Aug 2008) $
$LastChangedRevision: 3335 $
$URL: svn+ssh://thmsvn@ambrosia.ssl.berkeley.edu/repos/thmsoc/tags/tdas_5_11/idl/themis/thm_ui/thm_ui_check4spin.pro $
(See themis/thm_ui/thm_ui_check4spin.pro)
NAME:
thm_ui_choose_dtype
PURPOSE:
A widget for choosing data for the THEMIS data analysis GUI
CALLING SEQUENCE:
thm_ui_choose_dtype, instr, dtyp, station, astation, probe
INPUT:
instr = the instrument, one of ['asi', 'ask', 'esa_pkt', $
'efi', 'fbk', 'fft', 'fgm', $
'fit', 'gmag', 'mom', 'scm', 'sst', 'state']
OUTPUT:
dtyp = the output datatype, a string of instr/datatype/datalevel,
e.g., 'state/spinras/l1'
station = the ground station(s) if gmag data was chosen
astation = the ground station(s) if asi data was chosen
probe = the spacecraft if spacecraft data was chosen
HISTORY:
jmm, jimm@ssl.berkeley.edu 1-may-2007
jmm, Changed the probe list to reflect probe assigments:
A (P5), B (P1), C (P2), D (P3) and E (P4)
14-jun-2007
jmm, correctly handles level 1 and level 2 datatypes, 11-jul-2007
jmm, really correctly handles level 1 and 2 data types, by using a
common block to handle them
jmm, changed default behavior of windows, when an invalid string is
used, then the available data types are set to 'None',
31-jul-2007
jmm, Changed call to thm_ui_valid_dtype to
reflect new version, 11-apr-2008
$LastChangedBy: cgoethel $
$LastChangedDate: 2008-07-08 08:41:22 -0700 (Tue, 08 Jul 2008) $
$LastChangedRevision: 3261 $
$URL: svn+ssh://thmsvn@ambrosia.ssl.berkeley.edu/repos/thmsoc/tags/tdas_5_11/idl/themis/thm_ui/thm_ui_choose_dtype.pro $
(See themis/thm_ui/thm_ui_choose_dtype.pro)
NAME:
thm_ui_cotrans
PURPOSE:
Widget for coordinate transforms
CALLING SEQUENCE:
thm_ui_cotrans, gui_id
INPUT:
gui_id = the widget id of the thm_gui widget that called this one.
OUTPUT:
none explicit, new variables are created
HISTORY:
26-feb-2007, jmm, jimm@ssl.berkeley.edu
10-apr-2007, jmm, changed input from state to the variable names
31-may-2007, jmm, rewrite to become its own widget, and to call
thm_cotrans, rather than cotrans directly
12-jul-2007, jmm, added a message widget, for invalid user input errors
06-may-2008, cg, rearranged gui so that message window is at bottom, is
longer and doesn't wrap
$LastChangedBy: cgoethel $
$LastChangedDate: 2008-07-08 08:41:22 -0700 (Tue, 08 Jul 2008) $
$LastChangedRevision: 3261 $
$URL: svn+ssh://thmsvn@ambrosia.ssl.berkeley.edu/repos/thmsoc/tags/tdas_5_11/idl/themis/thm_ui/thm_ui_cotrans.pro $
(See themis/thm_ui/thm_ui_cotrans.pro)
NAME:
thm_ui_dproc
PURPOSE:
A widget interface for calling tplot from the themis_w widget,
currently of limited usefulness, but expandable
CALLING SEQUENCE:
thm_ui_dproc, master_widget_id
INPUT:
master_widget_id = the id number of the widget that calls this
OUTPUT:
none, there are buttons to push for plotting, setting limits, not
sure what else yet...
HISTORY:
06-may-2008, cg, added check to validate data, any active data that
has dimensions ge 3 cannot be processed
added data check for despike, time deriv, wavelet,
powerspec, active data that has a y component > 6
cannot be processed
and finally, rearranged widgets to allow for a long
narrow message window
28-mar-2008, cg, added filename dialog box to ascii save option,
and passed file name to tplot_ascii
14-dec-2006, jmm, jimm@ssl.berkeley.edu
13-feb-2007, jmm, fixed problem with !p.background resetting in
set_plot commands
12-mar-2007, jmm, Added wavelet button
2-apr-2007, jmm, Added pwrspc options
5-jun-2007, jmm, rewritten
12-jul-2007, jmm, added a message widget, for invalid user input
errors, grays out all buttons while processing
31-jul-2007, jmm, changed time limits to 'set time limits'
17-mar-2008, jmm, changed smooth option to input seconds, not npts
$LastChangedBy: cgoethel $
$LastChangedDate: 2008-07-08 08:41:22 -0700 (Tue, 08 Jul 2008) $
$LastChangedRevision: 3261 $
$URL: svn+ssh://thmsvn@ambrosia.ssl.berkeley.edu/repos/thmsoc/tags/tdas_5_11/idl/themis/thm_ui/thm_ui_dproc.pro $
(See themis/thm_ui/thm_ui_dproc.pro)
NAME: thm_ui_error PURPOSE: A widget to display, edit and save the file 'thm_gui_error.txt' error $LastChangedBy: cgoethel_new $ $LastChangedDate: 2009-03-12 14:24:14 -0700 (Thu, 12 Mar 2009) $ $LastChangedRevision: 5269 $ $URL: svn+ssh://thmsvn@ambrosia.ssl.berkeley.edu/repos/thmsoc/tags/tdas_5_11/idl/themis/thm_ui/thm_ui_error.pro $
(See themis/thm_ui/thm_ui_error.pro)
NAME: thm_ui_help PURPOSE: A widget to display the file 'thm_gui.txt' help $LastChangedBy: cgoethel $ $LastChangedDate: 2008-07-08 08:41:22 -0700 (Tue, 08 Jul 2008) $ $LastChangedRevision: 3261 $ $URL: svn+ssh://thmsvn@ambrosia.ssl.berkeley.edu/repos/thmsoc/tags/tdas_5_11/idl/themis/thm_ui/thm_ui_help.pro $
(See themis/thm_ui/thm_ui_help.pro)
NAME:
thm_ui_load_data_fn
PURPOSE:
A widget interface to load CDF data for whatever instrument
CALLING SEQUENCE:
varnames = thm_ui_load_data_fn(st_time, en_time, $
dtype = dtype, $
station = station, $
astation = astation, $
probe = probe)
INPUT:
st_time, en_time = start and end times in seconds from
1-jan-1970 0:00
KEYWORDS:
dtype, the type of data, a string, of form
'instrument/datatype/datalevel', the default is 'gmag/mag/l2'
station, the ground station of the gmag data, default is '*', for all
astation, the ground station of the asi data, default is '*', for all
probe = one or more of ['a','b','c','d','e'], default is ['a','b','c','d','e']
scm_cal = a structure containing calibration parameters
OUTPUT:
varnames = an array of tplot variable names, to pass into tplot
HISTORY:
22-sep-2006, jmm, jimm@ssl.berkeley.edu
23-oct-2006, jmm, changed to call cdf2tplot
30-oct-2006, jmm, changed again, to call load_thg_mag, also added
dtype and station as inputs
13-nov-2006, jmm, changed the argument list, now the output is a
data id string, added a check for start time > end
time
08-dec-2006, krb, changed load_thg_mag to thm_load_gmag
13-dec-2006, jmm, Added call to cdf2tplot for data for which there
is no load program...
14-dec-2006, jmm, returns an array of variable names and
subscripts, which should be easier to read..
15-dec-2006, jmm, Added calls to thm_load_fgm, fit, sst, efi,
ask,probe can be an array
16-jan-2007, jmm, Add all of the thm_load routines
5-feb-2007, jmm, update calls to load routines
10-apr-2007, jmm, removed history tracking, which is now handled in
thm_gui_event, also changed dtype, station
astation and probe to keywords
1-may-2007, jmm, New version, new argument list,etc....
10-may-2007, jmm, New version, new argument list,etc... that last
one lasted a long time, didn't it
30-jul-2007, jmm, allow for string time input, this is needed to
run histories.
11-apr-2008, jmm, Added 'spin' ipnput option
21-apr-2008, WMFeuerstein, Changed THM_LOAD_SCM call as per Vassilis'
instructions.
30-may-2008, cg, added optional keyword scm_cal to pass in calibration
parameters
$LastChangedBy: jwl $
$LastChangedDate: 2009-01-09 11:53:47 -0800 (Fri, 09 Jan 2009) $
$LastChangedRevision: 4388 $
$URL: svn+ssh://thmsvn@ambrosia.ssl.berkeley.edu/repos/thmsoc/tags/tdas_5_11/idl/themis/thm_ui/thm_ui_load_data_fn.pro $
(See themis/thm_ui/thm_ui_load_data_fn.pro)
This program creates a string for the history array when multiple datatypes, spacecraft or stations are chosen, for use in the themis_w_event routine $LastChangedBy: cgoethel $ $LastChangedDate: 2008-07-08 08:41:22 -0700 (Tue, 08 Jul 2008) $ $LastChangedRevision: 3261 $ $URL: svn+ssh://thmsvn@ambrosia.ssl.berkeley.edu/repos/thmsoc/tags/tdas_5_11/idl/themis/thm_ui/thm_ui_multichoice_history.pro $
(See themis/thm_ui/thm_ui_multichoice_history.pro)
NAME:
thm_ui_npar
PURPOSE:
Simple widget that allows user to change n parameter values and units (if units were
specified)
CALLING SEQUENCE:
new_value = thm_ui_npar(name, init_value, [radio_array=radio_array], $
[radio_value=radio_value])
INPUT:
name = the name of the parameter, can be an array
init_value = the initial value of the parameter, e.g., '1.0', must
be a string array of the smae size as name
radio_array = optional string array containing radio button names
title=title = optional title for the panel
radio_value = optional string containing the radio button to set initially
OUTPUT:
new_value = the output value of the parameters, a string array of values,
e.g., ['4.67', '3.0', ...n]
if optional radio buttons were used the last element of the array
will contain the radio button selection,
e.g., ['4.67', '3.0', ..., 'inches']
METHODS:
thm_ui_npar0 - creates the window, widgets, and calls the xmanager
thm_ui_npar0_event - event handler for the window (handles parameter input, cancel/
accept buttons, and window close 'X'
thm_ui_rad_event - event handler for the radio buttons; thm_ui_npar0 - creates the window, widgets, and calls the xmanager
HISTORY:
5-feb-2007, jmm, jimm@ssl.berkeley.edu
25-OCt-2007, jmm, added KILL_REQUEST block
15-may-2008, cg, added optional title for widget
$LastChangedBy: jwl $
$LastChangedDate: 2009-06-11 14:54:28 -0700 (Thu, 11 Jun 2009) $
$LastChangedRevision: 6149 $
$URL: svn+ssh://thmsvn@ambrosia.ssl.berkeley.edu/repos/thmsoc/tags/tdas_5_11/idl/themis/thm_ui/thm_ui_npar.pro $
(See themis/thm_ui/thm_ui_npar.pro)
NAME:
thm_ui_npar_new
PURPOSE:
Simple widget that allows user to change n parameter values and units (if units were
specified)
CALLING SEQUENCE:
new_value = thm_ui_npar_new(name, init_value, [radio_array=radio_array], $
[radio_value=radio_value])
INPUT:
name = the name of the parameter, can be an array
init_value = the initial value of the parameter, e.g., '1.0', must
be a string array of the smae size as name
radio_array = optional string array containing radio button names
title=title = optional title for the panel
radio_value = optional string containing the radio button to set initially
OUTPUT:
new_value = the output value of the parameters, a string array of values,
e.g., ['4.67', '3.0', ...n]
if optional radio buttons were used the last element of the array
will contain the radio button selection,
e.g., ['4.67', '3.0', ..., 'inches']
METHODS:
thm_ui_npar_new0 - creates the window, widgets, and calls the xmanager
thm_ui_npar_new0_event - event handler for the window (handles parameter input, cancel/
accept buttons, and window close 'X'
thm_ui_rad_event - event handler for the radio buttons; thm_ui_npar_new0 - creates the window, widgets, and calls the xmanager
HISTORY:
5-feb-2007, jmm, jimm@ssl.berkeley.edu
25-OCt-2007, jmm, added KILL_REQUEST block
15-may-2008, cg, added optional title for widget
20-jan-2009, jmm, Testing SVN
20-jan-2009, jmm, Testing SVN again
20-jan-2009, jmm, And again
$LastChangedBy: jwl $
$LastChangedDate: 2009-06-11 14:54:28 -0700 (Thu, 11 Jun 2009) $
$LastChangedRevision: 6149 $
$URL: svn+ssh://thmsvn@ambrosia.ssl.berkeley.edu/repos/thmsoc/tags/tdas_5_11/idl/themis/thm_ui/thm_ui_npar_new.pro $
(See themis/thm_ui/thm_ui_npar_new.pro)
NAME: thm_ui_only_trange PURPOSE: This program oprerates on the tplot data_quants to strip out data the is not in the input time range: start time, end time, and the subscripts of the appropriate data_quants structures are used, this is designed to be used in thm_ui_load_data_fn only... jmm, 13-nov-2006 INPUT: st_time, en_time = time in seconds from 1-jan-1970 0:00 data_ss = the subscripts of the data array to on which to operate OUTPUT: None explicit, the tplot variables are changed HISTORY: jmm, 13-nov-2006, jimm@ssl.berkeley.edu jmm, 13-dec-2006, made to work for non thg_mag data $LastChangedBy: cgoethel $ $LastChangedDate: 2008-07-08 08:41:22 -0700 (Tue, 08 Jul 2008) $ $LastChangedRevision: 3261 $ $URL: svn+ssh://thmsvn@ambrosia.ssl.berkeley.edu/repos/thmsoc/tags/tdas_5_11/idl/themis/thm_ui/thm_ui_only_trange.pro $
(See themis/thm_ui/thm_ui_only_trange.pro)
NAME:
thm_ui_par
PURPOSE:
Simple widget that asks for a parameter
CALLING SEQUENCE:
new_value = thm_ui_par(name, init_value)
INPUT:
name = the name of the parameter, e.g., 'time_resolution'
init_value = the initial value of the parameter, e.g., '1.0', must
be a string.
OUTPUT:
new_value = the output value of the parameter, a string, e.g., '4.67'
HISTORY:
22-jan-2007, jmm, jimm@ssl.berkeley.edu
25-OCt-2007, jmm, added KILL_REQUEST block
$LastChangedBy: cgoethel $
$LastChangedDate: 2008-07-08 08:41:22 -0700 (Tue, 08 Jul 2008) $
$LastChangedRevision: 3261 $
$URL: svn+ssh://thmsvn@ambrosia.ssl.berkeley.edu/repos/thmsoc/tags/tdas_5_11/idl/themis/thm_ui/thm_ui_par.pro $
(See themis/thm_ui/thm_ui_par.pro)
NAME:
thm_ui_progobj__define
PURPOSE:
defines an object to pass through into file_retrieve and
file_http_copy that allows updates to the thm_gui progress widget
METHODS DEFINED IN THIS CLASS:
set = sets the parameter (only one, the gui widget id)
get = returns the parameter
update = if called, this updates the thm_gui progress widget, with
the input text
checkcancel = Currently does nothing, but will eventually allow the
user to cancel a download.
HISTORY:
15-may-2007, jmm, jimm@ssl.berkeley.edu
24-jul-2007, jmm, activated checkcancel, to see if it can do anything...
5-mar-2008, jmm, pass _extra through to thm_ui_update_progress, to
allow the message_wid value to be passed through
$LastChangedBy: jimm $
$LastChangedDate: 2009-01-20 11:23:55 -0800 (Tue, 20 Jan 2009) $
$LastChangedRevision: 4561 $
$URL: svn+ssh://thmsvn@ambrosia.ssl.berkeley.edu/repos/thmsoc/tags/tdas_5_11/idl/themis/thm_ui/thm_ui_progobj__define.pro $
(See themis/thm_ui/thm_ui_progobj__define.pro)
This puts the input data structure into the tplot common block as the data_quants structure, and undefines all of the other variables in the common block, using temporary, the original common block is saved in a different common block. This is needed to call the stackmagplot routine on a subset of stations 13-nov-2006, jmm, jimm@ssl.berkeley.edu $LastChangedBy: cgoethel $ $LastChangedDate: 2008-07-08 08:41:22 -0700 (Tue, 08 Jul 2008) $ $LastChangedRevision: 3261 $ $URL: svn+ssh://thmsvn@ambrosia.ssl.berkeley.edu/repos/thmsoc/tags/tdas_5_11/idl/themis/thm_ui/thm_ui_reset_common_block.pro $
(See themis/thm_ui/thm_ui_reset_common_block.pro)
NAME: thm_ui_sclist PURPOSE: creates an array for the different themis spacecraft, to be used in a list widget CALLING SEQUENCE: sclist = thm_ui_sclist() INPUT: none OUTPUT: sclist = ['THA', 'THB', 'THC', 'THD', 'THE'] $LastChangedBy: cgoethel $ $LastChangedDate: 2008-07-08 08:41:22 -0700 (Tue, 08 Jul 2008) $ $LastChangedRevision: 3261 $ $URL: svn+ssh://thmsvn@ambrosia.ssl.berkeley.edu/repos/thmsoc/tags/tdas_5_11/idl/themis/thm_ui/thm_ui_sclist.pro $
(See themis/thm_ui/thm_ui_sclist.pro)
NAME: thm_ui_scmcal PURPOSE: A widget for choosing data for the THEMIS data analysis GUI This was specifically built for SCM data and displays additional user inputs for configuration settings CALLING SEQUENCE: thm_ui_scmcal, gui_id, instr_in0 INPUT: gui_id - gui id number for the main panel instr_in0 - instrument name OUTPUT: cal_params - structure of SCM calibration parameters HISTORY: AUTHOR: Cindy Goethel $LastChangedBy: cgoethel $ $LastChangedDate: 2008-07-08 08:41:22 -0700 (Tue, 08 Jul 2008) $ $LastChangedRevision: 3261 $ $URL: svn+ssh://thmsvn@ambrosia.ssl.berkeley.edu/repos/thmsoc/tags/tdas_5_11/idl/themis/thm_ui/thm_ui_scmcal.pro $ cal_base
(See themis/thm_ui/thm_ui_scmcal.pro)
NAME:
thm_ui_set_active_dset
PURPOSE:
sets active datasets in themis GUI to given tplot varnames, used in
the call_tplot widget.
CALLING SEQUENCE:
ss = thm_ui_set_active_dset(gui_id, active_names)
INPUT:
gui_id = the widget id for the master widget
active_names = the tplot variable names
OUTPUT:
ss = the subscripts of the valid active varnames in the full
tnames() array
HISTORY:
22-jan-2007, jmm, jimm@ssl.berkeley.edu
27-feb-2007, jmm, removed call to set_state_ptrs routine
10-may-2007, jmm, changed argument list, to use the GUI_ID and not
the state structure
7-may-2008, jmm, Slight change to avoid putting in invalid names
$LastChangedBy: cgoethel $
$LastChangedDate: 2008-07-08 08:41:22 -0700 (Tue, 08 Jul 2008) $
$LastChangedRevision: 3261 $
$URL: svn+ssh://thmsvn@ambrosia.ssl.berkeley.edu/repos/thmsoc/tags/tdas_5_11/idl/themis/thm_ui/thm_ui_set_active_dset.pro $
(See themis/thm_ui/thm_ui_set_active_dset.pro)
NAME: thm_ui_set_data_id PURPOSE: This program sets the data_id values of the pointer in the thm_gui state structure, given the tplot common block: INPUT: state_or_id = thm_gui state structure, or gui_id HISTORY: 26-feb-2007, jmm, jimm@ssl.berkeley.edu 10-may-2007, jmm, allow for input of the gui_id instead of the state $LastChangedBy: cgoethel $ $LastChangedDate: 2008-07-08 08:41:22 -0700 (Tue, 08 Jul 2008) $ $LastChangedRevision: 3261 $ $URL: svn+ssh://thmsvn@ambrosia.ssl.berkeley.edu/repos/thmsoc/tags/tdas_5_11/idl/themis/thm_ui/thm_ui_set_data_id.pro $
(See themis/thm_ui/thm_ui_set_data_id.pro)
NAME: thm_ui_set_trange PURPOSE: A widget interface for setting time ranges for the thm_gui widget CALLING SEQUENCE: thm_ui_set_trange, master_widget_id INPUT: master_widget_id = the id number of the widget that calls this OUTPUT: none, the start and end time are set HISTORY: 9-may-2007, jmm, jimm@ssl.berkeley.edu 12-jul-2007, jmm, Removed ability to type in time values.. 19-jul-2007, jmm, typed time values are back.. 25-oct-2007, jmm, Added kill_request block $LastChangedBy: cgoethel $ $LastChangedDate: 2008-07-08 08:41:22 -0700 (Tue, 08 Jul 2008) $ $LastChangedRevision: 3261 $ $URL: svn+ssh://thmsvn@ambrosia.ssl.berkeley.edu/repos/thmsoc/tags/tdas_5_11/idl/themis/thm_ui/thm_ui_set_trange.pro $
(See themis/thm_ui/thm_ui_set_trange.pro)
Name:
THM_UI_SHOW_DLIM.PRO
Syntax:
THM_UI_SHOW_DLIM ,tplot_name, group=group
where,
tplot_name is the name string or index number of a single tplot
variable.
Purpose:
Display the output of help,/structure for the default limits
structure of specified tplot variable.
Keywords:
group
Example:
This is a subroutine to THM_GUI.PRO -- not intended for outside
calls (but it wil work).
Author: W.M.Feuerstein, 2008/2/4
Modification History:
Padded names array with white space to make widget output left
justified, WMF.
Fixed group kw (must die with parent), fixed Windows bug,
added DLIMITS.DATA_ATT info (if present), WMF, 3/5/2008.
History:
A J. McTiernan request.
Adapted from TPLOT_LABEL.PRO
$LastChangedBy: cgoethel $
$LastChangedDate: 2008-07-08 08:41:22 -0700 (Tue, 08 Jul 2008) $
$LastChangedRevision: 3261 $
$URL: svn+ssh://thmsvn@ambrosia.ssl.berkeley.edu/repos/thmsoc/tags/tdas_5_11/idl/themis/thm_ui/thm_ui_show_dlim.pro $
(See themis/thm_ui/thm_ui_show_dlim.pro)
NAME: thm_ui_summplot PURPOSE: This widget prompts the user for a choice of probe, and then Calls the thm_gen_overplot routine. HISTORY: 21-jun-2007, jmm, jimm@ssl.berkeley.edu 31-jul-2007, jmm, resets active data in correct order after plotting $LastChangedBy: cgoethel $ $LastChangedDate: 2008-07-08 08:41:22 -0700 (Tue, 08 Jul 2008) $ $LastChangedRevision: 3261 $ $URL: svn+ssh://thmsvn@ambrosia.ssl.berkeley.edu/repos/thmsoc/tags/tdas_5_11/idl/themis/thm_ui/thm_ui_summplot.pro $
(See themis/thm_ui/thm_ui_summplot.pro)
NAME: thm_ui_timefix PURPOSE: Will fix an input time string of yyyy-mm-dd hh:mm:ss.xxxx if there is only 1 digit in the day or hour or second, etc. Will also return an error message, if the months, days, hours, seconds are not valid $LastChangedBy: jwl $ $LastChangedDate: 2009-06-11 14:54:28 -0700 (Thu, 11 Jun 2009) $ $LastChangedRevision: 6149 $ $URL: svn+ssh://thmsvn@ambrosia.ssl.berkeley.edu/repos/thmsoc/tags/tdas_5_11/idl/themis/thm_ui/thm_ui_timefix.pro $ unction thm_ui_timefix, time_in, progobj = progobj, _extra = _extra
(See themis/thm_ui/thm_ui_timefix.pro)
NAME: thm_ui_tselect PURPOSE: A list widget for time selection, this is a blocking widget, it must be exited for anything to happen CALLING SEQUENCE: thm_ui_teslect INPUT: none OUTPUT: the selected time is held in the common block saved_time_sel HISTORY: sep-2006, jmm, jimm@ssl.berkeley.edu $LastChangedBy: cgoethel $ $LastChangedDate: 2008-07-08 08:41:22 -0700 (Tue, 08 Jul 2008) $ $LastChangedRevision: 3261 $ $URL: svn+ssh://thmsvn@ambrosia.ssl.berkeley.edu/repos/thmsoc/tags/tdas_5_11/idl/themis/thm_ui/thm_ui_tselect.pro $
(See themis/thm_ui/thm_ui_tselect.pro)
Calls the thm_tselect widget, returns the value.. 16-jul-2007, jmm added the init_time input $LastChangedBy: cgoethel $ $LastChangedDate: 2008-07-08 08:41:22 -0700 (Tue, 08 Jul 2008) $ $LastChangedRevision: 3261 $ $URL: svn+ssh://thmsvn@ambrosia.ssl.berkeley.edu/repos/thmsoc/tags/tdas_5_11/idl/themis/thm_ui/thm_ui_tselect_fn.pro $
(See themis/thm_ui/thm_ui_tselect_fn.pro)
NAME:
thm_ui_update_data_all
PURPOSE:
Calls thm_ui_set_data_id, thm_ui_set_active_dset and
thm_ui_update_data_display in one procedure,
CALLING SEQUENCE:
thm_ui_update_data_all, gui_id, active_vnames
INPUT:
gui_id = a widget id for the gui
OUTPUT:
none
HISTORY:
5-jun-2007, jmm, jimm@ssl.berkeley.edu
7-may-2008, jmm, sort and uniq functionality is handled by tnames
call. This is now a short program....
$LastChangedBy: cgoethel $
$LastChangedDate: 2008-07-08 08:41:22 -0700 (Tue, 08 Jul 2008) $
$LastChangedRevision: 3261 $
$URL: svn+ssh://thmsvn@ambrosia.ssl.berkeley.edu/repos/thmsoc/tags/tdas_5_11/idl/themis/thm_ui/thm_ui_update_data_all.pro $
(See themis/thm_ui/thm_ui_update_data_all.pro)
NAME: thm_ui_update_data_display PURPOSE: update the loaded-data display for the themis_w widget CALLIMG SEQUENCE: thm_ui_update_data_display, widget_id INPUT: widget_id = the id number of the widget HISTORY: dec-2006, jmm jimm@ssl.berkeley.edu 18-jun-2007, jmm, changed to access 'active data' widget 16-jul-2007, jmm, changed to add coordinate system to display $LastChangedBy: cgoethel $ $LastChangedDate: 2008-07-08 08:41:22 -0700 (Tue, 08 Jul 2008) $ $LastChangedRevision: 3261 $ $URL: svn+ssh://thmsvn@ambrosia.ssl.berkeley.edu/repos/thmsoc/tags/tdas_5_11/idl/themis/thm_ui/thm_ui_update_data_display.pro $
(See themis/thm_ui/thm_ui_update_data_display.pro)
NAME:
thm_ui_update_history
PURPOSE:
Adds the string input to the state structure history array
INPUT:
string = a string to add to the history array. Note that this is
returned undefined, if it is passed in by reference, i/e/, if it's a
named variable.
OUTPUT:
state.history is updated
HISTORY:
sep-2006, jmm, jimm@ssl.berkeley.edu
26-feb-2007, jmm, fixed problem with multiple lines when choosing
multiple probes, datatypes, sataiotns, etc...
8-may-2007, jmm, changed so that the thm_gui widget id is now passed
in, since the history widget is now on the main
widget, removed some error checking, if things are
undefined in here i want to know
$LastChangedBy: cgoethel $
$LastChangedDate: 2008-07-08 08:41:22 -0700 (Tue, 08 Jul 2008) $
$LastChangedRevision: 3261 $
$URL: svn+ssh://thmsvn@ambrosia.ssl.berkeley.edu/repos/thmsoc/tags/tdas_5_11/idl/themis/thm_ui/thm_ui_update_history.pro $
(See themis/thm_ui/thm_ui_update_history.pro)
NAME:
thm_ui_update_progress
PURPOSE:
Write a string into the progress widget for the THEMIS GUI
CALLING SEQUENCE:
thm_ui_update_progress, gui_id, input_string
INPUT:
gui_id = the widget_id for the GUI
input_string = a string to be displayed
OUTPUT:
None
KEYWORDS:
message_wid = id for any other message widgets that you might like
to display the messages
HISTORY:
jmm, 9-may-2007, jimm@ssl.berkeley.edu
jmm, 5-mar-2008, added multiple lines, and the ability to show in
multiple message widgets.
$LastChangedBy: cgoethel $
$LastChangedDate: 2008-07-08 08:41:22 -0700 (Tue, 08 Jul 2008) $
$LastChangedRevision: 3261 $
$URL: svn+ssh://thmsvn@ambrosia.ssl.berkeley.edu/repos/thmsoc/tags/tdas_5_11/idl/themis/thm_ui/thm_ui_update_progress.pro $
(See themis/thm_ui/thm_ui_update_progress.pro)
NAME: thm_ui_userdef PURPOSE: A widget that allows the user to define his own operator to be used on the data from a tplot variable, e.g., the user types in the string '2.0*!pi*q', and a temporary function is created which takes the data and does this multiplication. This is pretty experimental. CALLING SEQUENCE: thm_ui_userdef, gui_id INPUT: gui_id = the id of the main gui widget OUTPUT: none explicit, hopefully new tplot variables are created HISTORY: 7-jun-2007, jmm, jimm@ssl.berkeley.edu $LastChangedBy: cgoethel $ $LastChangedDate: 2008-07-08 08:41:22 -0700 (Tue, 08 Jul 2008) $ $LastChangedRevision: 3261 $ $URL: svn+ssh://thmsvn@ambrosia.ssl.berkeley.edu/repos/thmsoc/tags/tdas_5_11/idl/themis/thm_ui/thm_ui_userdef.pro $
(See themis/thm_ui/thm_ui_userdef.pro)
NAME:
thm_ui_valid_dtype
PURPOSE:
get valid datatype names from thm_load_* routines, using the
valid_names keyword and returns a list of data types that can be
loaded for each instrument.
CALLING SEQUENCE:
datalist = thm_ui_valid_dtype(instrument, ilist, llist)
INPUT:
none
OUTPUT:
datalist = a list of the datatypes that can be loaded
instrument = the instrument responsible for this datatype
ilist = a list of the input instrument replicated for each datalist
element
llist = the level of the data, some have 'l1', some have 'l2' some
have one for each
HISTORY:
16-jan-2007, jmm, jimm@ssl.berkeley.edu
29-jan-2007, jmm, various changes, now station isn't returned, gmag
and asi output are hard-wired, other changes will ensue when load
routines are standardized.
4-feb-2007, jmm, Rewritten back to the old hard-wired version....
5-jul-2007, jmm, Added level information
11-apr-2008, jmm, now calls thm_data2load.pro, for 1 instrument
$LastChangedBy: cgoethel $
$LastChangedDate: 2008-07-08 08:41:22 -0700 (Tue, 08 Jul 2008) $
$LastChangedRevision: 3261 $
$URL: svn+ssh://thmsvn@ambrosia.ssl.berkeley.edu/repos/thmsoc/tags/tdas_5_11/idl/themis/thm_ui/thm_ui_valid_dtype.pro $
(See themis/thm_ui/thm_ui_valid_dtype.pro)
NAME:
thm_ui_wavelet
PURPOSE:
wavelet transform of the input tplot variables, fist calls split_vec
to split up any multi-component vectors.
CALLING SEQUENCE:
thm_ui_wavelet, vnames, new_names, polar=polar,_extra=_extra
INPUT:
vnames = the tplot variable names to transform
OUTPUT:
new_names = new variable names generated by the process
KEYWORDS:
polar = if set, passes the /polar keyword into the split_vec
procedure, new variable names for 3-d data will be polar,
and not '_x','_y','_z'
gui_id = the main GUI widget ID, for messages
messw_id = the dproc widget id, for messages
temp_names = the names of temporary variables create by the process
so that they can be reliably removed
HISTORY:
12-mar-2007, jmm, jimm@ssl.berkeley.edu
5-jun-2007, jmm, no longer handles history
7-may-2008, W. Michael Feuerstein, Test for >= 2 finite points.
11-may-2009,prc(pcruce@igpp.ucla.edu) added keyword to return the names of temporary variables created in process
$LastChangedBy: jimmpc $
$LastChangedDate: 2009-05-29 15:10:52 -0700 (Fri, 29 May 2009) $
$LastChangedRevision: 6004 $
$URL: svn+ssh://thmsvn@ambrosia.ssl.berkeley.edu/repos/thmsoc/tags/tdas_5_11/idl/themis/thm_ui/thm_ui_wavelet.pro $
(See themis/thm_ui/thm_ui_wavelet.pro)
NAME: thm_ui__scmcal_help PURPOSE: A widget to display the file 'thm_gui.txt' help $LastChangedBy: cgoethel $ $LastChangedDate: 2008-07-08 08:41:22 -0700 (Tue, 08 Jul 2008) $ $LastChangedRevision: 3261 $ $URL: svn+ssh://thmsvn@ambrosia.ssl.berkeley.edu/repos/thmsoc/tags/tdas_5_11/idl/themis/thm_ui/thm_ui_scmcal_help.pro $
(See themis/thm_ui/thm_ui_scmcal_help.pro)
NAME:
tpwrspc
PURPOSE:
wapper for pwrspc.pro for calling from GUI, a split_vec is performed
on the data if necessary
CALLING SEQUENCE:
thm_ui_pwrspc, varnames, new_names, trange, history_ext, $
polar = polar, dynamic = dynamic, _extra = _extra
INPUT:
varnames = an array (or scalar) of tplot variable names
Output
new_names = the variable names of any new variables
HISTORY:
28-mar-2007, jmm, jimm.ssl.berkeley.edu
2-apr-2007, jmm, added the /dynamic keyword
5-jun-2007, jmm, no longer handles history
$LastChangedBy: cgoethel $
$LastChangedDate: 2008-07-08 08:41:22 -0700 (Tue, 08 Jul 2008) $
$LastChangedRevision: 3261 $
$URL: svn+ssh://thmsvn@ambrosia.ssl.berkeley.edu/repos/thmsoc/tags/tdas_5_11/idl/themis/thm_ui/thm_ui_pwrspc.pro $
(See themis/thm_ui/thm_ui_pwrspc.pro)