next up previous contents
Next: Saving the settings of Up: Graphics Previous: Displaying graphics

Querying the settings of a graphic structure

 

getg Return the settings of a graphic structure
<graphic> name of the graphic structure
[<command>] command for the graphic structure
<command> tex2html_wrap_inline10402 layer, topo, cntr, traj, axis, saxis, ndiam, nshape, nsize, nplc, nvsbl, ncolor, ngray, nconn, umat, sons, bar, rngplt, rlab, fval, gcolor, datplc, hst, ldgr, ldgrc, ldgrcld, ldgrv, vecfld, pmat, en, viewp tex2html_wrap_inline10404
<command> tex2html_wrap_inline10402 src, scales, colors tex2html_wrap_inline10404
[-dout <data>] output data
[-fout <field>] output field

This command is meant for querying the settings of a graphic structure as commands. If parameter <command> has been omitted, then the whole state is returned. One can store results in a data frame and field using the parameters <data> and <field>. Their use is described below with various command settings.

<command> Returned data - Commands for selecting or setting...
layer the layer
topo the topology of the TS-SOM
cntr the contours on the TS-SOM layer
traj the trajectory on the TS-SOM layer
axis the axes
saxis the subaxes
ndiam the diameter of circles of the neurons
nshape the shape of the neurons
nsize the size of the neurons
nplc the location of neurons
nvsbl the neuron visibility
ncolor the color of the neurons
ngray the gray level of the background of the neurons
nconn the neuron connectors
umat the U-matrix presentation
sons the son links
bar the bars
rngplt the range plots
rlab the labels in the subgraphs
fval field values
gcolor the color of the group
datplc the data vector related to the axis
hst histograms
ldgr, ldgrc, ldgrv line diagrams
vecfld the vector field
pmat the point matrix
viewp the viewpoint to the graphic image
en commands for enabling components to be displayed

If the field (and data) is given, then the results are stored in the field. Otherwise, the output is directed to the output stream.

The flags src, scales and colors do not return commands. Instead they return data as follows.

<Other commands>
src Return names of the selected sources of data (stored in the graphic structure): SOM, data frame and classified data
scales Return the scales of graphical objects (minimum and maximum values). This flag requires an option to specify the type of objects to be queried. Possible options are axis, saxis, ndiam, ngray, bar, rngplt, ldgrc, ldgrcld, ldgrv, pmat
colors Return the colors of graphical objects (foreground and background colors). This flag requires an option to specify the type of objects to be queried. Possible options are bar, rngplt, ldgr, ldgrv, hst, gcolor, dtaplc, ndatplc, traj, cntr, vecfld

If the parameter <data> is given, then the scales and colors are stored in this data. The scales are stored in data that have three fields: name, min and max. Respectively, the colors will be stored in data that have three fields: name, fg and bg. The name refers to the parameter that identifies the graphic setting. The command src always results the output stream.

Example (ex7.31): First, run the example `ex7.31'. Then apply command getg.

...
NDA> mkgrp grp1 -s s1
...
NDA> getg grp1 bar
bar grp1 -inx 0 -f sta.crim_avg -co red -sca data 
bar grp1 -inx 1 -f sta.zn_avg -co green -sca abs  -min 10.000000
     -max 100.000000
NDA> getg grp1 axis
axis grp1 -ax x -f som_x -sca abs  -min 0.000000 -max 1.000000
 -step 3 
axis grp1 -ax y -f som_y -sca abs  -min 0.000000 -max 1.000000
 -step 3 
axis grp1 -ax z -f som_z -sca abs  -min 0.000000 -max 1.000000
 -step 3
NDA> getg grp1 scales bar
sta.crim_avg
0.000000
66.142067
sta.zn_avg
10.000000
100.000000
NDA> getg grp1 scales bar -dout bar_scales
NDA> getg grp1 -fout graphics_commands


next up previous contents
Next: Saving the settings of Up: Graphics Previous: Displaying graphics

Anssi Lensu
Tue Jul 23 11:58:18 EET DST 2002