EQV3 Name
EQV3 Purpose
Execute IDL code using interactively varied parameters.
Category
Calling Sequence
eqv3, file Inputs
file = equation file. in
Instead of file name the contents of the file may be
given in a text array (same format).
Keyword Parameters
Keywords
P1=var1, P2=var2, ... P5=var5 Up to 5 variables.
may be passed into the program using these keywords.
May reference p1, p2, ... in the IDL code to execute.
/WAIT means wait until the routine is exited instead
returning right after startup.
PARVALS=pv Structure with parameter names and values.
Must be used with /WAIT or pv will be undefined.
EXITCODE=excd 0=normal, 1=cancel. Must use with /WAIT.
RES=res Returned widget ID of an unused top level
base that will on exit from EQV3 contain a structure
with parameter names and final values.
widget_control,res,get_uval=s,/dest
s.name and s.val are arrays of names and values.
TOP=top Returns widget ID of top level base.
Use widget_control to retrieve or store info structure.
OK=wid ID of widget to notify when OK button pressed.
If not given no OK button is displayed.
Useful to allow a higher level widget routine to call
EQV3. The OK button then sends an event to the higher
level widget which can then destroy the eqv3 widget.
WID_OK=wid Returned widget ID of the OK button.
Can use to set /input_focus.
GROUP_LEADER=grp Set group leader.
XOFFSET=xoff, YOFFSET=yoff Widget position.
XSCROLL=xpixels. Parameter X scrolling size (def=800 pix).
YSCROLL=ypixels. Parameter Y scrolling size (def=400 pix).
Outputs
Common Blocks
eqv3_var_com
eqv3_var_com
eqv3_help_com
eqv3_var_com
eqv3_help_com
Notes
Notes: This routine will not work in an IDL Virtual Machine.
Use the Help button for more details.
Equation file format: This text file defines the IDL code,
and range of each adjustable parameter.
Null and comment lines (* in first column) are allowed.
The tags are shown by an example:
title: Parabola
eq: x=maken(-10,10,100) & plot,a + b*x + c*x^2
par: a -50 50 0
par: b -50 50 0
par: c -10 10 1
The parameter tags are followed by 4 items: Parameter name (as in the
equation), min value, max value, initial value. An optional 5th item
may be the word int to force an integer value (for flags or harmonics).
Modification History
R. Sterner, 2000 May 11 --- From EQV2.
R. Sterner, 2000 Aug 21 --- Added XOFFSET, YOFFSET.
R. Sterner, 2001 Jun 19 --- Upgraded snapshot.
R. Sterner, 2001 Jun 20 --- Added optional parameter units.
R. Sterner, 2002 Oct 25 --- Switched to cw_dslider for drag on Windows.
R. Sterner, 2005 Apr 04 --- Added X/YSCROLL keywords.
R. Sterner, 2005 May 13 --- Better handling of YSCROLL.
May differ on Windows.
R. Sterner, 2006 Mar 07 --- Ignored leading spaces in eqv file.
R. Sterner, 2010 May 04 --- Converted arrays from () to [].
Copyright (C) 2000, Johns Hopkins University/Applied Physics Laboratory
This software may be used, copied, or redistributed as long as it is not
sold and this copyright notice is reproduced on each copy made. This
routine is provided as is without any express or implied warranties
whatsoever. Other limitations apply as described in the file disclaimer.txt.