1#!F-adobe-helvetica-medium-r-normal--18*
2#!N
3#!N
4 #!Rautogly AutoGlyph #!N #!N Category #!N #!N  #!Lcatann,dxall752 h Annotation  #!EL  #!N #!N Function
5#!N #!N Assigns an appropriate glyph to each point in a
6data field. #!N #!N Syntax #!CForestGreen #!N #!N  #!F-adobe-courier-bold-r-normal--18*    #!F-adobe-times-bold-r-normal--18*   #!N
7glyphs #!EF = AutoGlyph(  #!F-adobe-times-bold-r-normal--18*   data, type, shape, scale, ratio, min,
8max #!EF ); #!EF #!N #!N #!EC #!N #!N Inputs #!T,1,91,276,461,646
9 #!F-adobe-times-medium-r-normal--14*    #!F-adobe-times-bold-r-normal--18*   #!N TAB Name TAB Type TAB Default TAB Description
10#!EF #!N TAB data TAB data field TAB none TAB set
11of points to which glyphs will #!N TAB - TAB -
12TAB - TAB be assigned #!N TAB type TAB scalar, string,
13field, or group TAB input dependent TAB glyph type #!N TAB
14shape TAB scalar TAB 1.0 TAB factor to describe shape of
15glyph #!N TAB - TAB - TAB - TAB (must be
16greater than 0) #!N TAB scale TAB scalar TAB 1.0 TAB
17scale factor for size of glyphs #!N TAB - TAB -
18TAB - TAB (must be greater than 0) #!N TAB ratio
19TAB scalar TAB 0.05 or 0 TAB ratio in size (scalars
20or vectors) #!N TAB - TAB - TAB - TAB between
21smallest and largest #!N TAB - TAB - TAB - TAB
22glyphs (must be greater than or #!N TAB - TAB -
23TAB - TAB equal to 0) #!N TAB min TAB scalar
24or field TAB min of data value or 0 TAB data
25value that gets minimum-size #!N TAB - TAB - TAB -
26TAB glyph #!N TAB max TAB scalar or field TAB max
27of data TAB data value that gets maximum-size #!N TAB -
28TAB - TAB - TAB glyph #!N TAB - TAB -
29TAB - TAB #!EF #!N #!N Outputs #!T,1,161,321,646  #!F-adobe-times-medium-r-normal--14*    #!F-adobe-times-bold-r-normal--18*   #!N
30TAB Name TAB Type TAB Description #!EF #!N TAB glyphs TAB
31color field TAB set of glyphs #!N TAB - TAB -
32TAB #!EF #!N #!N Functional Details #!N #!N This module creates
33a glyph, or representation (e.g., an arrow), for each data value
34in a data field  #!F-adobe-times-bold-r-normal--18*   data #!EF . For data dependent
35on positions, a glyph is placed at the corresponding position. For
36data dependent on connections, a glyph is placed at the center
37of the corresponding connection element. If there is no "data" component,
38a glyph is placed at each position. #!N #!N The "base"
39size (i.e. size of a glyph for the average data value)
40is based on AutoGlyph's estimate of an appropriate glyph size, as
41modified by  #!F-adobe-times-bold-r-normal--18*   scale #!EF . #!N #!N For "text" glyphs,
42a "data" component is required. #!N #!N AutoGlyph differs from the
43Glyph module in the interpretation of the  #!F-adobe-times-bold-r-normal--18*   scale #!EF parameter.
44For AutoGlyph, you specify the size of the glyphs relative to
45the default-size glyph chosen by AutoGlyph. In contrast, when using Glyph,
46you may specify a scaling factor that is multiplied by the
47data value to obtain the size of the glyph in world
48units. #!N #!I0 #!N #!N #!I0 #!N  #!F-adobe-times-bold-r-normal--18*    #!F-adobe-times-bold-r-normal--18*   data #!EF
49#!EF #!I50 #!N is the data field for which glyphs are
50to be created. #!N #!I0 #!N  #!F-adobe-times-bold-r-normal--18*    #!F-adobe-times-bold-r-normal--18*   type #!EF #!EF
51#!I50 #!N specifies the kind of glyph to be used. #!N
52#!N By default, scalar fields are represented by filled circles or
53spheres, vector fields by arrows, tensor fields by groups of arrows,
54and string data by text. For 2-dimensional scalar fields, the glyphs
55are circles, and for 2-dimensional vector fields, the arrows are flat.
56For 3-dimensional fields, spheres or rounded arrows (rockets) are used. #!N
57#!N The  #!F-adobe-times-bold-r-normal--18*   type #!EF parameter will override a default glyph.
58If  #!F-adobe-times-bold-r-normal--18*   type #!EF is a string, it must specify one
59of the following: "arrow," "arrow2D," "circle," "colored text," "cube," "diamond," "needle,"
60"needle2D," "rocket," "rocket2D," "sphere," "speedy," "spiffy," "square," "standard," or "text." The
61value "standard" specifies the default glyph type and is a medium-quality
62glyph appropriate to the data; "spiffy," a higher-quality glyph; and "speedy,"
63a lower-quality, but more quickly rendered glyph. Lower quality glyphs also
64consume less memory. #!N #!N You may alternatively specify  #!F-adobe-times-bold-r-normal--18*   type
65#!EF as a scalar value between 0 and 1, where: #!N
66#!I0 #!N  #!F-adobe-times-medium-r-normal--18*   #!N #!N #!I30 #!N o 0 is the
67same as "speedy" #!N #!I30 #!N o 1 is the same
68as "spiffy" #!N #!I30 #!N o 0.5 is the same as
69"standard" #!N #!I0 #!N #!EF #!N There are approximately 5 different
70quality glyphs for each glyph type. The one closest to the
71value specified is used. #!N #!N Specifying "text" or "colored text"
72for  #!F-adobe-times-bold-r-normal--18*   type #!EF puts a text representation of the data
73value at each point. For text glyphs, the text is by
74default 15 pixels high, and the  #!F-adobe-times-bold-r-normal--18*   shape #!EF ,  #!F-adobe-times-bold-r-normal--18*
75ratio #!EF ,  #!F-adobe-times-bold-r-normal--18*   min #!EF , and  #!F-adobe-times-bold-r-normal--18*   max #!EF
76parameters have no effect. The  #!F-adobe-times-bold-r-normal--18*   scale #!EF parameter can be
77used to increase or decrease the size of the text glyphs.
78For example, specifying  #!F-adobe-times-bold-r-normal--18*   scale #!EF = 2 makes the text
7930 pixels high. The difference between "text" and "colored text" is
80that text is always white when "text" is specified, but will
81be the color of the input if "colored text" is specified.
82Note that after the AutoGlyph module, Color can be used to
83color text glyphs to a different color if desired. The font
84for the text glyphs can be specified by appending "font =
85 #!F-adobe-times-medium-i-normal--18*   fontname #!EF " to "text" or "colored text," where  #!F-adobe-times-medium-i-normal--18*
86fontname #!EF is any of the defined fonts supplied with Data
87Explorer: #!CForestGreen #!N #!N  #!F-adobe-courier-bold-r-normal--18*   #!N area gothicit_t pitman roman_ext #!N
88cyril_d greek_d roman_d script_d #!N fixed greek_s roman_dser script_s #!N gothiceng_t
89italic_d roman_s variable #!N gothicger_t italic_t roman_tser #!EF #!N #!N #!EC
90For more information, see  #!Lapc,dxall746 h Data Explorer Fonts  #!EL  in IBM Visualization Data Explorer User's
91Guide. In addition, you may supply user-defined fields and groups to
92the  #!F-adobe-times-bold-r-normal--18*   type #!EF parameter (see  #!Ltype,dxall776 s TYPE  #!EL  ). #!I0 #!N #!N
93#!N #!N The remaining five parameters are interpreted somewhat differently, depending
94on whether the type of data involved are (1) scalar or
95(2) vector or tensor. #!N #!N #!N  #!F-adobe-times-medium-i-normal--18*   Next Topic #!EF
96#!N #!N  #!Lall773,dxall774 h Scalar Data  #!EL  #!N  #!F-adobe-times-medium-i-normal--18*   #!N
97