File: refgu018.htm

package info (click to toggle)
dx 1%3A4.4.4-4
  • links: PTS
  • area: main
  • in suites: wheezy
  • size: 49,864 kB
  • sloc: ansic: 365,482; cpp: 156,594; sh: 13,801; java: 10,641; makefile: 2,373; awk: 444; yacc: 327
file content (280 lines) | stat: -rw-r--r-- 13,787 bytes parent folder | download | duplicates (12)
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
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 3//EN">
<HTML><HEAD>
		<TITLE>User's Reference - AutoGrayScale</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="refgu017.htm"><IMG src="../images/flcgh_06.gif" width=80 height=17 border="0" alt="Previous Page"></A></TD>
				<TD colspan=2><A href="refgu019.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="HDRAUTOGRA" ></A>AutoGrayScale</H3>
		<A NAME="IDX385"></A><A NAME="IDX386"></A>
<P><STRONG>Category</STRONG>
<P>
<A HREF="refgu008.htm#HDRCATTRN">Transformation</A>
<A NAME="IDX387"></A>
<A NAME="IDX388"></A>
<P><STRONG>Function</STRONG>
<P>
Automatically colors a field using a "gray" scale.
<P><STRONG>Syntax</STRONG>
<PRE><STRONG>mapped, colormap</STRONG> = AutoGrayScale(<STRONG>data, opacity, hue, start, range,
                                 saturation, min, max, delayed,
                                 outofrange</STRONG>);
</PRE>
<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%">data field
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">none
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="40%">field to be colored
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%"><TT><STRONG>opacity</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%">opacity (between 0 and 1)
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%"><TT><STRONG>hue</STRONG></TT>
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">scalar
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">0.0
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="40%">hue
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%"><TT><STRONG>start</STRONG></TT>
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">scalar
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">0.0
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="40%">starting intensity
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%"><TT><STRONG>range</STRONG></TT>
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">scalar
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">1.0
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="40%">range of intensity
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%"><TT><STRONG>saturation</STRONG></TT>
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">scalar
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">0.0
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="40%">saturation (between 0 and 1)
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%"><TT><STRONG>min</STRONG></TT>
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">scalar or data field
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">min of data
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="40%">minimum of data to be colored
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%"><TT><STRONG>max</STRONG></TT>
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">scalar or data field
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">max of data
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="40%">maximum of data to be colored
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%"><TT><STRONG>delayed</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%">0: apply maps
<BR>
1: delay applying color and
opacity maps (byte data only)
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%"><TT><STRONG>outofrange</STRONG></TT>
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">vector list or string list
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">&#123;"color of min, " "color of
max"&#125;
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="40%">how to color out-of-range data
values
</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>mapped</STRONG></TT>
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">color field
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="50%">color-mapped input field
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%"><TT><STRONG>color</STRONG></TT>map
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">field
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="50%">RGB color map used
</TD></TR></TABLE>
<P><STRONG>Functional Details</STRONG>
<P>
This module maps the <I>intensities</I>  of a color
(<TT><STRONG>hue</STRONG></TT>) to the data values of a
specified field (<TT><STRONG>data</STRONG></TT>).
<TABLE CELLPADDING="3">
<TR VALIGN="TOP"><TD><P><TT><STRONG>data</STRONG></TT>
</TD><TD><P>is an input field with data.
If the input is a vector field, the intensities are based
on the magnitude of the data.
If the input consists of matrices, the intensities are based on the
determinants.
</TD></TR><TR VALIGN="TOP"><TD><P><TT><STRONG>opacity</STRONG></TT>
</TD><TD><P>specifies the opacity of the resulting object.
Allowed values range from 0 to 1.
Its default value is 1 for surfaces and 0.5 for volumes.
</TD></TR><TR VALIGN="TOP"><TD><P><TT><STRONG>hue</STRONG></TT>
</TD><TD><P>sets the hue.
Blue is 0.6666, red is 0 or 1, and colors are defined cyclically from
&#45;&infinity; to &infinity (i.e., <TT><STRONG>hue</STRONG></TT> of
&#45;1 = <TT><STRONG>hue</STRONG></TT> of 0 =
<TT><STRONG>hue</STRONG></TT> of 1, and so on).
<P><B>Note: </B>This parameter will have no effect if
<TT><STRONG>saturation</STRONG></TT> is set
to 0 (see below).
</TD></TR><TR VALIGN="TOP"><TD><P><TT><STRONG>start</STRONG></TT> and
<TT><STRONG>range</STRONG></TT>
</TD><TD><P>specify the intensities applied to the minimum and maximum data
values mapped.
The value of <TT><STRONG>range</STRONG></TT> can be any positive number.
By default, the minimum data value has an intensity of 0, and the
maximum an intensity of 1.

See also <A HREF="refgu048.htm#HDRCVOLRND">"Coloring Objects for Volume
Rendering"</A>.

</TD></TR><TR VALIGN="TOP"><TD><P><TT><STRONG>saturation</STRONG></TT>
</TD><TD><P>specifies the saturation of the colors used.
This value must be between 0 (the default) and 1.
</TD></TR><TR VALIGN="TOP"><TD><P><TT><STRONG>min</STRONG></TT> &nbsp;and&nbsp;
<TT><STRONG>max</STRONG></TT>
</TD><TD><P>specify the minimum and maximum data values mapped.
If neither is specified, the minimum and maximum values of
<TT><STRONG>data</STRONG></TT> are mapped.
If <TT><STRONG>min</STRONG></TT> is scalar, the minimum data value is mapped
to that value.
If <TT><STRONG>min</STRONG></TT> is a data field, the minimum data value of
that field is used.
<P>
The <TT><STRONG>max</STRONG></TT> parameter is interpreted in corresponding
fashion.
If <TT><STRONG>min</STRONG></TT> is a data field and
<TT><STRONG>max</STRONG></TT>
is unspecified, the module uses the minimum and maximum values of
that field.
<P>
For volumes, regions with values outside the
<TT><STRONG>min</STRONG></TT>-<TT><STRONG>max</STRONG></TT>
range are invisible;
for surfaces, such regions are gray by default.
</TD></TR><TR VALIGN="TOP"><TD><P><TT><STRONG>delayed</STRONG></TT>
</TD><TD><P>determines whether "delayed colors" are created.
Such colors are available only for byte data and they use less memory.
<P>
When <TT><STRONG>delayed</STRONG></TT> = 1:
<UL COMPACT>
<LI>The "colors" component is a pointer to the "data"
component, and a "color map" component is created.
(This component is a color lookup table with 256 entries, representing
the appropriate color for each of the 256 possible data values.)
<LI>If <TT><STRONG>opacity</STRONG></TT> is also specified, an opacity map
is created with 256 entries, while the "opacities" component is
a copy of the "data" component.
<LI>The module adds a "direct color map" attribute to the output
object.
(See <A HREF="refgu048.htm#HDRUDCMPS">"Using Direct Color Maps"</A>.)
</UL>
</TD></TR><TR VALIGN="TOP"><TD><P><TT><STRONG>outofrange</STRONG></TT>
</TD><TD><P>specifies the coloring of data that fall outside the
<TT><STRONG>min</STRONG></TT>-<TT><STRONG>max</STRONG></TT> range.
This parameter applies only to surfaces; out-of-range data values for
volumes are always invisible.
If the parameter value is a single color (RGB vector or color-name
string), it is applied to both the upper and lower out-of-range
points.
If it is a list of two colors, then it is applied to the lower
and upper out-of-range points, respectively.
Color strings can be any of the defined color-name strings (see
<A HREF="refgu033.htm#HDRCOLOR">Color</A>) or either of the
strings "color of min" and
"color of max."
</TD></TR></TABLE>
<P><B>Notes: </B><OL>
<P><LI>Directly displayed grayscale images will use more distinct colors
if you take advantage of direct color maps by using the
<TT><STRONG>delayed</STRONG></TT> parameter.
Use Compute to convert your data to bytes if they are not already
in that form.
<P><LI>AutoGrayScale adds colors to the "colors" component.
For "front colors" or "back colors," use the Rename module
following AutoGrayScale.
<P><LI>This module also outputs the RGB color map used, in the output
<TT><STRONG>colormap</STRONG></TT>.
The "positions" component contains the data values, and the
"data" component contains the corresponding RGB colors.
You can use this color map as an input to the ColorBar module.
For byte data, the color map always contains 256 entries for the 256
possible data values.
If the input to AutoGrayScale is a group, then a different color map
will be constructed for each member of the group.
In that case, the <TT><STRONG>colormap</STRONG></TT> output of the module is
a group of color maps.
Use the Select module to select the color map you want to display
using ColorBar.
<P><LI>If you AutoGrayScale a group of volumes, you may find that the
resulting image is black because the renderer does not support
coincident volumes.
</OL>
<P><STRONG>Components</STRONG>
<P>
Adds a "colors" component.
An "opacities" component is added if <TT><STRONG>opacity</STRONG></TT>
is less than 1 or the input data is a volume.
If <TT><STRONG>delayed</STRONG></TT> = 1, the "colors" component is a
copy of the "data" component, and a "color map"
component is created.
Likewise, an "opacity map" component is created if
<TT><STRONG>opacity</STRONG></TT> is less than 1 or the input
is a volume.
<P><STRONG>Example Visual Program</STRONG>
<PRE>
AlternateVisualizations.net
</PRE>
<P><STRONG>See Also</STRONG>
&nbsp;<A HREF="refgu033.htm#HDRCOLOR">Color</A>,
&nbsp;<A HREF="refgu016.htm#HDRAUTOCOL">AutoColor</A>,
&nbsp;<A HREF="refgu034.htm#HDRCOLORBA">ColorBar</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>&nbsp;|&nbsp;<A href="http://www.opendx.org/">OpenDX.org</A>&nbsp;] </FONT></P>
			<P></P>
		</DIV>
		<P></P>
	</BODY></HTML>