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