1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
|
<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 3//EN">
<HTML><HEAD>
<TITLE>User's Reference - ScalarList</TITLE>
<META HTTP-EQUIV="keywords" CONTENT="GRAPHICS VISUALIZATION VISUAL PROGRAM DATA
MINING">
<meta http-equiv="content-type" content="text/html;charset=ISO-8859-1">
</HEAD><BODY BGCOLOR="#FFFFFF" link="#00004b" vlink="#4b004b">
<TABLE width=510 border=0 cellpadding=0 cellspacing=0>
<TR>
<TD><IMG src="../images/spacer.gif" width=80 height=1></TD>
<TD><IMG src="../images/spacer.gif" width=49 height=1></TD>
<TD><IMG src="../images/spacer.gif" width=24 height=1></TD>
<TD><IMG src="../images/spacer.gif" width=100 height=1></TD>
<TD><IMG src="../images/spacer.gif" width=3 height=1></TD>
<TD><IMG src="../images/spacer.gif" width=127 height=1></TD>
<TD><IMG src="../images/spacer.gif" width=6 height=1></TD>
<TD><IMG src="../images/spacer.gif" width=50 height=1></TD>
<TD><IMG src="../images/spacer.gif" width=71 height=1></TD>
</TR>
<TR>
<TD colspan=9><IMG src="../images/flcgh_01.gif" width=510 height=24 alt="OpenDX - Documentation"></TD>
</TR>
<TR>
<TD colspan=2><A href="../allguide.htm"><IMG src="../images/flcgh_02.gif" width=129 height=25 border="0" alt="Full Contents"></A></TD>
<TD colspan=3><A href="../qikguide.htm"><IMG src="../images/flcgh_03.gif" width=127 height=25 border="0" alt="QuickStart Guide"></A></TD>
<TD><A href="../usrguide.htm"><IMG src="../images/flcgh_04.gif" width=127 height=25 border="0" alt="User's Guide"></A></TD>
<TD colspan=3><B><A href="../refguide.htm"><IMG src="../images/flcgh_05d.gif" width=127 height=25 border="0" alt="User's Reference"></A></B></TD>
</TR>
<TR>
<TD><A href="refgu127.htm"><IMG src="../images/flcgh_06.gif" width=80 height=17 border="0" alt="Previous Page"></A></TD>
<TD colspan=2><A href="refgu129.htm"><IMG src="../images/flcgh_07.gif" width=73 height=17 border="0" alt="Next Page"></A></TD>
<TD><A href="../refguide.htm"><IMG src="../images/flcgh_08.gif" width=100 height=17 border="0" alt="Table of Contents"></A></TD>
<TD colspan=3><A href="refgu009.htm"><IMG src="../images/flcgh_09.gif" width=136 height=17 border="0" alt="Partial Table of Contents"></A></TD>
<TD><A href="refgu175.htm"><IMG src="../images/flcgh_10.gif" width=50 height=17 border="0" alt="Index"></A></TD>
<TD><A href="../srchindx.htm"><IMG src="../images/flcgh_11.gif" width=71 height=17 border="0" alt="Search"></A></TD>
</TR>
</TABLE>
<H3><A name="HDRSCALARL" ></A>ScalarList</H3>
<A NAME="IDX674"></A><A NAME="IDX675"></A>
<P><STRONG>Category</STRONG>
<P>
<A HREF="refgu008.htm#HDRCATINT">Interactor</A>
<A NAME="IDX676"></A>
<P><STRONG>Function</STRONG>
<P>
Generates a list of scalar values.
<P><STRONG>Syntax</STRONG>
<P>
Available only through the user interface.
<P><STRONG>Inputs</STRONG>
<BR>
<TABLE BORDER>
<TR>
<TH ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">Name
</TH><TH ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">Type
</TH><TH ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">Default
</TH><TH ALIGN="LEFT" VALIGN="TOP" WIDTH="40%">Description
</TH></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%"><TT><STRONG>data</STRONG></TT>
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">object
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">no default
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="40%">object from which interactor
attributes can be derived
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%"><TT><STRONG>refresh</STRONG></TT>
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">flag
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">0
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="40%">reset the interactor
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%"><TT><STRONG>min</STRONG></TT>
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">scalar
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">minimum data value
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="40%">minimum output value
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%"><TT><STRONG>max</STRONG></TT>
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">scalar
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">maximum data value
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="40%">maximum output value
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%"><TT><STRONG>delta</STRONG></TT>
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">scalar
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">input dependent
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="40%">increment between successive
scalar outputs
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%"><TT><STRONG>method</STRONG></TT>
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">string
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">input dependent
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="40%">defines interpretation of delta
input
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%"><TT><STRONG>decimals</STRONG></TT>
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">integer
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">input dependent
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="40%">number of decimal places to be
displayed in output values
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%"><TT><STRONG>nitems</STRONG></TT>
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">integer
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">11
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="40%">number of items in the initial
list
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%"><TT><STRONG>label</STRONG></TT>
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">string
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">"ScalarList"
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="40%">global name applied to interactor
stand-ins
</TD></TR></TABLE>
<P><STRONG>Outputs</STRONG>
<BR>
<TABLE BORDER>
<TR>
<TH ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">Name
</TH><TH ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">Type
</TH><TH ALIGN="LEFT" VALIGN="TOP" WIDTH="50%">Description
</TH></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%"><TT><STRONG>output</STRONG></TT>
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">scalar list
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="50%">interactor output
</TD></TR></TABLE>
<P><STRONG>Functional Details</STRONG>
<P>
This interactor allows the user to interactively change a list of
scalar values.
The range over which the module acts is governed by its attributes
(e.g., minimum, maximum, and delta), which in turn are either
(1) specified by the parameter values in its <TT><STRONG>Set
Attributes...</STRONG></TT> dialog box or (2) determined
from input to the module (e.g., a data field).
In the second case, the interactor is said to be "data driven."
<P>
If an interactor is not data-driven, its attributes are taken from its
<TT><STRONG>Set Attributes...</STRONG></TT> dialog box (accessed from the
<TT><STRONG>Edit</STRONG></TT> pull-down menu in the Control Panel).
<P>
Because the module is interactive, the user can change the current
controlling value directly in the control panel.
<P><B>Note: </B>The module's control panel is invoked by double-clicking on
its icon in the VPE window.
Its configuration dialog box is accessed from the
<TT><STRONG>Edit</STRONG></TT> pull-down menu in
the same window.
<TABLE CELLPADDING="3">
<TR VALIGN="TOP"><TD><P><B><TT><STRONG>data</STRONG></TT>
</B></TD><TD><P>is the object (usually a data field) from which the interactor
can
derive any or all of the minimum, maximum, and delta attributes
when the corresponding input tabs are up.
</TD></TR><TR VALIGN="TOP"><TD><P><B><TT><STRONG>refresh</STRONG></TT>
</B></TD><TD><P>resets the interactor so that the output is computed from the
current
input. If <TT><STRONG>refresh</STRONG></TT> = 0 (the default), the output
is recomputed only if the current output does not lie within the range
of the current <TT><STRONG>data</STRONG></TT>.
</TD></TR><TR VALIGN="TOP"><TD><P><B><TT><STRONG>min</STRONG></TT> and
<TT><STRONG>max</STRONG></TT>
</B></TD><TD><P>specify the minimum and maximum values of the interactor's
scalar output.
If set, these values override those implied by <TT><STRONG>data</STRONG></TT>.
<P>
If neither <TT><STRONG>min</STRONG></TT> nor <TT><STRONG>data</STRONG></TT> is
specified, the interactor uses the minimum set in the
<TT><STRONG>Set Attributes...</STRONG></TT> dialog box.
<P>
If neither <TT><STRONG>max</STRONG></TT> nor <TT><STRONG>data</STRONG></TT> is
specified, the interactor uses the maximum in the
<TT><STRONG>Set Attributes...</STRONG></TT>
dialog box.
This value overrides the value implied by <TT><STRONG>data</STRONG></TT>.
</TD></TR><TR VALIGN="TOP"><TD><P><B><TT><STRONG>delta</STRONG></TT>
</B></TD><TD><P>specifies a scalar value as a factor for calculating the
increment
between successive outputs over the specified range.
The actual value depends on the interpretation specified by
<TT><STRONG>method</STRONG></TT>
(see below).
</TD></TR><TR VALIGN="TOP"><TD><P><B><TT><STRONG>method</STRONG></TT>
</B></TD><TD><P>specifies the interpretation of <TT><STRONG>delta</STRONG></TT>:
<UL COMPACT>
<LI>"rounded": the increment (<TT><STRONG>max</STRONG></TT> -
<TT><STRONG>min</STRONG></TT>) × <TT><STRONG>delta</STRONG></TT> is
rounded to a "nice" number.
The spacing between successive values will approximate the interval
specified by <TT><STRONG>delta</STRONG></TT>.
(For example, the default value of 0.01 specifies an interval of 1/100
of the specified range.)
<LI>"relative": the interpretation is the same as for
"rounded," but the increment is <I>not</I>
rounded.
<LI>"absolute": <TT><STRONG>delta</STRONG></TT> is the absolute value
of the interval.
(If <TT><STRONG>delta</STRONG></TT> has not been specified, its default
is 1.)
<P>
The default value for <TT><STRONG>method</STRONG></TT> depends on other input.
The default is:
<UL COMPACT>
<LI>"rounded" if <TT><STRONG>data</STRONG></TT> is specified
<I>or</I> if both <TT><STRONG>min</STRONG></TT> and
<TT><STRONG>max</STRONG></TT> are specified.
<LI>"absolute" in all other cases.
</UL>
</UL>
</TD></TR><TR VALIGN="TOP"><TD><P><B><TT><STRONG>decimals</STRONG></TT>
</B></TD><TD><P>specifies the number of decimal places displayed
in the interactor.
If neither <TT><STRONG>data</STRONG></TT> nor <TT><STRONG>delta</STRONG></TT>
is specified, the interactor uses the value in its own
<TT><STRONG>Set Attributes...</STRONG></TT> dialog box.
</TD></TR><TR VALIGN="TOP"><TD><P><B><TT><STRONG>nitems</STRONG></TT>
</B></TD><TD><P>specifies the number of items in the interactor list.
These are evenly spaced between the minimum and maximum values (see
above).
For example, if this parameter is given a value of 5, and the range
is 0-100, the output list will be {0, 25, 50,
75, 100 }.
<P><B>Note: </B>If <TT><STRONG>nitems</STRONG></TT> changes, a new list is
computed.
</TD></TR><TR VALIGN="TOP"><TD><P><B><TT><STRONG>label</STRONG></TT>
</B></TD><TD><P>is the global label of all instances of the corresponding
interactor
stand-in.
An interactor instance's local label (set from the Control Panel)
overrides a global label.
If not specified, the global label is set by the user interface.
</TD></TR></TABLE>
<P><STRONG>Example Visual Program</STRONG>
<PRE>
ContoursAndCaption.net
</PRE>
<P><STRONG>See Also</STRONG>
<P>
<A HREF="refgu078.htm#HDRINTEGER">Integer</A>,
<A HREF="refgu079.htm#HDRINTEGEL">IntegerList</A>,
<A HREF="refgu127.htm#HDRSCALAR">Scalar</A>,
<A HREF="refgu169.htm#HDRVECTOR">Vector</A>,
<A HREF="refgu170.htm#HDRVECTORL">VectorList</A>
<P>
<HR>
<DIV align="center">
<P><A href="../allguide.htm"><IMG src="../images/foot-fc.gif" width="94" height="18" border="0" alt="Full Contents"></A> <A href="../qikguide.htm"><IMG src="../images/foot-qs.gif" width="94" height="18" border="0" alt="QuickStart Guide"></A> <A href="../usrguide.htm"><IMG src="../images/foot-ug.gif" width="94" height="18" border="0" alt="User's Guide"></A> <A href="../refguide.htm"><IMG src="../images/foot-ur.gif" width="94" height="18" border="0" alt="User's Reference"></A></P>
</DIV>
<DIV align="center">
<P><FONT size="-1">[ <A href="http://www.research.ibm.com/dx">OpenDX Home at IBM</A> | <A href="http://www.opendx.org/">OpenDX.org</A> ] </FONT></P>
<P></P>
</DIV>
<P></P>
</BODY></HTML>
|
