"Fossies" - the Fresh Open Source Software Archive
Member "dx-4.4.4/man/catl/dx.l" (8 May 2002, 29703 Bytes) of package /linux/misc/old/dx-4.4.4.tar.gz:
As a special service "Fossies" has tried to format the requested text file into HTML format (style: standard
) with prefixed line numbers.
Alternatively you can here view
the uninterpreted source code file.
1 DX(1V) DX(1V)
6 dx - start the Data Explorer visualization system.
7 Optionally directly start the User Interface (_d_x_u_i), the
8 executive (_d_x_e_x_e_c), the Data Prompter, the Module Builder
9 or the Tutorial.
12 dx [ -8bitcmap < private | shared | 0-1 > ]
13 [ -builder ]
14 [ -cache < on | off > ]
15 [ -colors < colors file > ]
16 [ -connect < host:port > ]
17 [ -data < path list > ]
18 [ -directory < dir > ]
19 [ -display < display name > ]
20 [ -dxroot < dir > ]
21 [ -echo ]
22 [ -edit ]
23 [ -encode ]
24 [ -exec < executable > ]
25 [ -execonly ]
26 [ -execute ]
27 [ -execute_on_change ]
28 [ -full ]
29 [ -file < filename > ]
30 [ -help ]
31 [ -highlight < on | off > ]
32 [ -host < host name > ]
33 [ -hwrender < gl | opengl > ]
34 [ -image ]
35 [ -include < path list > ]
36 [ -key < 64bit hex > ]
37 [ -license < type > ]
38 [ -local ]
39 [ -log < on | off > ]
40 [ -macros < path list > ]
41 [ -mdf < filename > ]
42 [ -memory < # of Mbytes > ]
43 [ -menubar ]
44 [ -metric ]
45 [ -modules < path list > ]
46 [ -morehelp ]
47 [ -nodeid ]
48 [ -optimize < memory | precision > ]
49 [ -outboarddebug ]
50 [ -processors ]
51 [ -program < filename > ]
52 [ -prompter ]
53 [ -readahead < on | off > ]
54 [ -script [ < script file > ] ]
55 [ -startup ]
56 [ -suppress ]
57 [ -timing < on | off >]
58 [ -trace < on | off > ]
59 [ -trialkey ]
60 [ -tutor ]
61 [ -uionly | -execonly ]
62 [ -verbose ]
63 [ -version]
65 dx -prompter ( start the Data Prompter )
66 [ -full ]
67 [ -file ] [ < header file name > ]
69 dx -builder ( start the Module Builder )
70 [-file ] [ < .mb file name > ]
79 _d_x is the command that starts the Data Explorer Startup
80 Window, and optionally starts the _D_a_t_a _E_x_p_l_o_r_e_r _U_s_e_r
81 _I_n_t_e_r_f_a_c_e, _D_a_t_a _E_x_p_l_o_r_e_r _E_x_e_c_u_t_i_v_e, _D_a_t_a _E_x_p_l_o_r_e_r _D_a_t_a
82 _P_r_o_m_p_t_e_r, _D_a_t_a _E_x_p_l_o_r_e_r _M_o_d_u_l_e _B_u_i_l_d_e_r or the _D_a_t_a
83 _E_x_p_l_o_r_e_r _T_u_t_o_r_i_a_l.
85 The Data Explorer Startup Window is an X windows/Motif
86 based application which allows easy access to the other
87 subsystemes of the Data Explorer visualization system.
89 The _D_a_t_a _E_x_p_l_o_r_e_r _U_s_e_r _I_n_t_e_r_f_a_c_e is an X windows/Motif
90 based application that provides a visual programming envi-
91 ronment and an interface to the executive. The executive
92 provides the computational tools and mechanisms to create
93 data visualizations. The
95 _D_a_t_a _E_x_p_l_o_r_e_r _D_a_t_a _P_r_o_m_p_t_e_r is an X windows/Motif based
96 application that helps users import data in a variety of
97 formats, and provides general purpose visual programs to
98 visual imported data, leading to a shortened "time to
99 first picture".
101 The _D_a_t_a _E_x_p_l_o_r_e_r _M_o_d_u_l_e _B_u_i_l_d_e_r is an X windows/Motif
102 based application that helps users build their own modules
103 to be included in a custom version of Data Explorer.
105 The _D_a_t_a _E_x_p_l_o_r_e_r _T_u_t_o_r_i_a_l is an application that helps
106 users learn to use Data Explorer by leading them through a
107 sequence of tasks. Users can easily skip around in the
108 tutorial in order to concentrate on tasks of most use to
109 their work.
111 For a more complete description of the _D_a_t_a _E_x_p_l_o_r_e_r _U_s_e_r
112 _I_n_t_e_r_f_a_c_e _a_n_d _E_x_e_c_u_t_i_v_e see the IIBBMM VViissuuaalliizzaattiioonn DDaattaa
113 EExxpplloorreerr UUsseerr''ss GGuuiiddee. For a more complete description of
114 the _D_a_t_a _E_x_p_l_o_r_e_r _D_a_t_a _P_r_o_m_p_t_e_r see the IIBBMM VViissuuaalliizzaattiioonn
115 DDaattaa EExxpplloorreerr QQuuiicckkSSttaarrtt GGuuiiddee. For a more thorough
116 description of the _D_a_t_a _E_x_p_l_o_r_e_r _M_o_d_u_l_e _B_u_i_l_d_e_r see the
117 IIBBMM VViissuuaalliizzaattiioonn DDaattaa EExxpplloorreerr PPrrooggrraammmmeerr''ss RReeffeerreennccee.
120 With no options the _d_x command starts the Startup Window,
121 an X windows/Motif program from which the other parts of
122 the Data Explorer system can be started. The various com-
123 mand line options and environment variables listed below
124 can be specified to change the default behavior.
126 Options set by including them in the DXARGS environment
127 variable are placed at the start of the command line, fol-
128 lowed by any options set by environment variables, fol-
129 lowed by explicit command line arguments. When conflict-
130 ing options are given, the last option has precedence.
132 --88bbiittccmmaapp < private | shared | 0-1 | -1 >
133 Overrides the DX8BITCMAP environment variable (see
134 ENVIRONMENT VARIABLES below).
136 --ccaacchhee < on | off >
137 Turn on or off the executive caching system. When
138 the Data Explorer caching mechanism is enabled the
139 Data Explorer executive automatically caches the
140 intermediate results generated during its visual-
141 ization computations. Unlike standard caching
142 mechanisms, these results are accessed by means of
143 their functional derivation. This allows for auto-
144 matic graph optimization and helps to avoid the
145 recomputation of previously utilized intermediates,
146 especially when the Data Explorer sequencer is
147 being used. In certain rare instances, a machine
148 with a small amount of memory may want to disable
149 this caching to conserve memory and reduce paging.
150 Default = on.
152 --ccoolloorrss < colors file >
153 Override DXCOLORS environment variable (see ENVI-
154 RONMENT VARIABLES below).
156 --ccoonnnneecctt < host:port >
157 Start a distributed executive only (no user inter-
160 --ddaattaa < path list >
161 Override DXDATA environment variable (see ENVIRON-
162 MENT VARIABLES below).
164 --ddiirreeccttoorryy < dir >
165 Cause the executive to be run in the given direc-
168 --ddiissppllaayy < display name >
169 Set the name of the X display to be used by the
170 user interface and the executive.
172 --ddxxrroooott < dir >
173 Overrides the default dx root directory.
175 --eecchhoo < dir >
176 Echo the command lines without executing them.
178 --eeddiitt Cause the user interface to be started with the
179 Visual Program Editor (VPE) window as the top level
180 window of the user interface (the top level window
181 is denoted by an anchor in the upper left hand cor-
182 ner). Also see -image, -startup, and -menubar.
184 --eennccooddee < filename >
185 Encode the given file into a binary format with a
186 key (which must be specified with the -key option).
187 For example
188 dx -encode -key 1234567890abcdef foo.net The
189 resulting file can only be encoded by the DX user
190 interface when the same key is used. For example
191 dx -image -key 1234567890abcdef foo-e.net
193 --eexxeecc < executive executable >
194 Use the given file as a replacement for the execu-
195 tive. This option allows a user to build and use
196 his/her own custom executive.
199 Start the executive in remote mode in which it will
200 then await a connection from the user interface.
201 The user interface is not started with this option.
202 Also see -script.
205 Execute once after the user interface has made a
206 connection with the executive.
209 Cause Data Explorer to go into execute-on-change
210 mode at start up. Execute-on-change mode causes
211 the Visual Program to be executed any time any of
212 the values (i.e. module inupts, interactor val-
213 ues...) in the program change.
215 --ffiillee < filename >
216 Start the Data Prompter, Module Builder, or Data
217 Explorer User Interface with the header file file-
220 --ffuullll When used with -prompter, starts the full Data
223 --hheellpp Print a brief listing of options and usage for _d_x.
225 --hhiigghhlliigghhtt < on | off >
226 Turn on or off module execution highlighting. If
227 highlighting is turned on, the user interface will
228 highlight each module as it is executed. Default =
231 --hhoosstt < host name >
232 Override DXHOST environment variable (see ENVIRON-
233 MENT VARIABLES below).
235 --hhwwrreennddeerr < gl | opengl >
236 Override the default hardware rendering choice on
237 platforms where both are supported. Default is
238 opengl. Sets the DXHWMOD environment variable to
239 either DXhwdd.o or DXhwddOGL.o.
241 --iimmaaggee Cause the user interface to be started with the
242 image window as the top level window of the user
243 interface. Also, control panels that are config-
244 ured to open automatically are opened. Also see
245 -edit, -startup and -menubar.
247 --iinncclluuddee < path list >
248 Override DXINCLUDE environment variable (see ENVI-
249 RONMENT VARIABLES below).
251 --kkeeyy < 64bit hex >
252 16 character hexidecimal (64bit) number that is
253 used to encode and decode .net files. See -encode.
255 --lliicceennssee < type >
256 Force a specific license for either the user inter-
257 face or executive. The following are valid values
258 for type:
260 runtime: forces a run-time license (UI or execu-
263 timed: forces a timed (limited function) license
264 (UI only).
266 develop: forces a developer license (UI or execu-
269 --llooccaall Override the DXHOST environment variable (if set)
270 and cause the executive to be run on the local
271 host. In the absence of the DXHOST environment
272 variable, this is the default.
274 --lloogg < on | off >
275 Turn on or off executive logging. If logging is on
276 then the executive logs output to the file _d_x_._l_o_g
277 in the directory where the executive is executing.
278 Default = off.
280 --mmaaccrrooss < path list >
281 Override the DXMACROS environment variable (see
282 ENVIRONMENT VARIABLES below).
285 Start Data Explorer with a menubar as the anchor
286 window. Also, control panels that are configured
287 to open automatically are opened. See also -image,
288 -edit, and -startup.
290 --mmddff < mdf file >
291 Override the DXMDF environment variable (see ENVI-
292 RONMENT VARIABLES below).
294 --mmeemmoorryy < # of MB >
295 Set the maximum amount of memory, in megabytes
296 rounded up to a two megabyte boundary, that the
297 executive is able to allocate. Default = the
298 amount of physical memory minus 8 MB.
301 Have the ui use metric units when possible, for
302 example for setting the image size for printing
303 postscript images.
305 --mmoodduulleess < pathlist >
306 Set the list of directories to be searched for out-
307 board modules.
310 Displays this information
313 print out the node id of the machine that the com-
314 mand is run on. The node id is used when generat-
315 ing a license.
317 --ooppttiimmiizzee < memory | precision >
318 Select whether to minimize memory usage or produce
319 more color-accurate images. When memory is opti-
320 mized, image objects are generated with 24
321 bits/pixel instead of 96, and ReadImage will pro-
322 duce delayed color images if supported by the for-
323 mat. The default is precision.
326 Enable user to start outboard modules manually for
327 debugging when they are called in a visual program.
330 For Data Explorer SMP, sets the number of
331 processors to use.
333 --pprrooggrraamm < programname >
334 Start the user interface with the visual program
338 Start the data prompter.
340 --rreeaaddaahheeaadd < on | off >
341 Specify whether or not the executive reads ahead in
342 its input stream before executing the commands it
343 receives from the stream. If this is turned off,
344 then the executive will execute each command line
345 as it is received. This is useful for certain
346 debugging purposes, such as memory leak detection.
347 Default = on.
349 --ssccrriipptt [ < script file > ]
350 Run just the executive in script mode. If a file
351 name is provided then the executive reads and exe-
352 cutes commands from the given script and then ter-
353 minates. If a file is not provided then when the
354 executive starts up it enters _i_n_t_e_r_a_c_t_i_v_e mode
355 where it waits for script commands. Also see -exe-
359 Start Data Explorer with the startup window as the
360 initial window. This is the default. See also
361 -image, -edit, and -menubar.
364 Do not open any control panels at start-up. This is
365 used in -image mode and -menubar mode only.
367 --ttiimmeedd Start DX using a timed license.
369 --ttiimmiinngg < on | off >
370 Turn on or off the executive timing mechanism. If
371 enabled, then when the executive exits it will list
372 on standard output or the logging file timing
373 statistics for each module that was used during the
374 course of execution. Default = off.
376 --ttrraaccee < on | off >
377 Turn on or off the executive trace mechanism. When
378 tracing is enabled the executive displays informa-
379 tive messages about the execution sequence on
380 either standard output or the log file if logging
381 is enabled. Default = off.
384 Determines the information necessary for generating
385 a trialkey.
387 --ttuuttoorr Start the Data Explorer tutorial.
390 Cause the user interface to be started without mak-
391 ing a connection to an executive.
394 Echo commands in the _d_x script as they are exe-
398 Print version numbers of various executables.
400 EENNVVIIRROONNMMEENNTT VVAARRIIAABBLLEESS
401 The following environment variables provide an alternate
402 way to set certain of the command line options, or alter
403 the default behavior of Data Explorer in some way. Options
404 set with environment variables are overridden if the same
405 option is also specified on the command line. Options set
406 with DXARGS are overridden by both environment variables
407 and explicit command line options.
410 When Data Explorer displays images in 8-bit win-
411 dows, it makes every effort to create an accurate
412 representation of the image using the default col-
413 ormap shared among applications using 8-bit win-
414 dows. If the colors required by Data Explorer are
415 not present in the colormap and there are not
416 enough free color cells available in the shared
417 color map for their allocation, Data Explorer will
418 find approximations among the colors that are
419 available. However, in certain circumstances, the
420 difference between the desired color and the
421 approximation is found to be too great to be
422 acceptable. In such circumstances, DX will allo-
423 cate a private colormap for more accurate results.
424 In this case, depending on your X server, you may
425 need to move the mouse to select the Image or Dis-
426 play window in order for the correct colors to
427 appear. The -8bitcmap flag sets the level at which
428 the change to using a private colormap is made.
429 The value of this parameter should be a number
430 between 0 and 1, or "private" or "shared", and it
431 repressents the Euclidean distance in RGB color
432 space, normalized to 1, for the maximum allowed
433 discrepancy. If you set this parameter to 1, then
434 a private colormap will never be used. If you set
435 it to -1, then a private colormap will always be
436 used. The default is 0.1.
438 DDXXAARRGGSS This contains the default set of arguments used by
439 the _d_x script. The arguments are prepended to
440 those given to _d_x on the command line. This vari-
441 able allows for the _d_x command to be easily cus-
445 Sets the number of digits in axes tick labels at
446 which a switch to scientific notation is made. The
447 default is 7.
450 This contains the name of an alternate file that
451 contains mappings of color names to red, green,
452 blue triplets in a format like that of the default
453 color file found in /usr/lpp/dx/lib/colors.txt.
455 DDXXDDAATTAA This contains a colon separated list of directories
456 in which the executive will search for data files.
457 Also see the -data option.
460 If set to anything other than 0, enables ReadImage
461 to create delayed color images if the image is a
462 tiff format image saved in a byte-with-colormap
463 format or a gif image.
465 DDXXEEXXEECC Specifies an executive to be run at start-up.
468 If DXFLING is set to 1, then for hardware-rendered
469 images, in rotation mode and execute-on-change
470 mode, if you drag the mouse across the image, and
471 release the mouse button outside the image, the
472 object in the image will begin to rotate, and will
473 continue to rotate until you click inside the
474 image. The direction and speed of the mouse motion
475 before release will affect the rotation direction
476 and rotation speed of the object in the window.
479 Sets the gamma correction for software-rendered
480 images displayed to the screen using the Display
481 and Image tools. The default value is 2, except
482 for 8-bit windows on the sgi architecture.
485 DDXXGGAAMMMMAA__1122BBIITT,, DDXXGGAAMMMMAA__2244BBIITT sets the gamma correc-
486 tion factor for software-rendered images for the
487 windows with the indicated window depth. Overrides
488 the value set by DXGAMMA.
490 DDXXHHOOSSTT This contains the name of the host machine that
491 will run the executive. If this is not set then a
492 default of "localhost" is used, unless the local
493 host is a PVS console in which case the default is
494 to run the executive on the PVS. Also see the
495 -host, -local and -server options.
498 Sets the gamma correction for hardware-rendered
499 images displayed to the screen using the Display
500 and Image tools. The default value is 2.
503 Specifies the name of the hardware rendering
504 library to use when more than one is supported.
505 Should be either DXhwdd.o or DXhwddOGL.o.
508 This contains a colon separated list of directories
509 in which the executive will search for "included"
510 scripts. Also see the -include option.
513 This contains a colon separated list of directories
514 in which the user interface searches for macros
515 that will be automatically loaded. When running in
516 script mode one must "include" all the macros by
517 hand prior to referencing them. Also see the
518 -macros option.
520 DDXXMMDDFF This contains the name of a module description file
521 (mdf) that contains user defined modules for a cus-
522 tomized version of the executive. Also see the
523 -mdf option.
526 sets the amount of memory (in megabytes) that can
527 be used by the executive.
530 This contains a colon separated list of directories
531 in which the executive searches for outboard mod-
532 ules. Also see the -modules option.
535 For faces, loops, and edges data, if set, allows
536 loops other than the enclosing loop for a face to
537 be listed first. However, there is a consequent
538 decrease in performance if this environment vari-
539 able is set.
542 If set to anything, disables framebuffer readbacks.
543 Setting this environment variable may improve per-
544 formance of interaction with hardware rendered
545 images, especially for machines for which readback
546 is slow. The default behavior is that framebuffer
547 readbacks are enabled. If you set this environment
548 variable, not that some interactions using the
549 Image tool will result in a black image while
550 interaction is taking place. However, if you are
551 not using the Image tool, it is strongly recom-
552 mended that you set this environment variable.
555 sets the image type to either 24-bit color images
556 or floating-point-based 96-bit images (the
557 default). This affects the behavior of Render and
558 ReadImage. This variable can be set to either
559 DXByte (24 bits) or DXFloat (96 bits). Setting
560 this variable to DXByte will result in images tak-
561 ing up less memory.
564 Sets the number of processors to be used for Data
565 Explorer SMP.
567 DDXXRRSSHH Specifies the remote shell command to use when con-
568 necting to other systems (such as those when using
569 distributed execution). The default is the the path
570 to rsh.
573 Prevents the remote "invoke dxexec" script from
574 being written with a full carbon copy of the local
575 environment (only DISPLAY is set).
577 DDXXRROOOOTT Specifies the top-level directory for all the files
578 and directories needed by Data Explorer.
581 If set to anything other than -1, forces shared
582 memory to be used (if allowed by the architecture).
583 If set to -1, (if allowed by the architecture) will
584 cause the data segment to simply be extended.
585 Please see Appendix C of the Data Explorer User
586 Guide for more information.
589 Allows the user to specify the size of the send and
590 recieve buffers for the socket connection between
591 the UI and the exec. This value is clamped to the
592 max allowed by the system. This can fix a problem
593 where the executive and UI hang involving a dead-
594 lock situation in the socket communication. The
595 value assigned to it is passed as the parameter to
596 setsockopt for SOL_SNDBUF and SOL_RCVBUF. A typcial
597 increased value may be 262144.
600 Specifies a file containing user interactors for
601 use by the SuperviseState and SuperviseWindow mod-
605 Under UNIX specifies the web browser to launch for
606 viewing the HTML documentation. Under Windows and
607 MacOS X setting this environment variable will
608 launch the systems default web browser.
611 The next few examples assume that none of the DX environ-
612 ment variables have been set.
614 1. To start both the user interface and the executive with
615 the network named _c_f_d_._n_e_t:
616 dx -edit -program cfd
619 2. To start and execute the visual program _c_f_d_._n_e_t in
620 image mode with /usr/users/me and /usr/data as data direc-
622 dx -image -execute -data '/usr/users/me:/usr/data'
625 3. To run just the executive on the script named _f_1_5_w_i_n_g:
627 dx -script -file f15wing
629 4. To start the user interface and execute the user cus-
630 tomized executive named _m_y_d_x_e_x_e_c containing user defined
631 modules described in _c_u_s_t_o_m_._m_d_f:
633 dx -edit -mdf custom.mdf -exec mydxexec
635 5. To start the Data Prompter :
637 dx -prompter
639 6. To start the Module Builder :
641 dx -builder
642 7. To start the Tutorial :
644 dx -tutorial
647 SSEEEE AALLSSOO
648 README* - The README file(s) found in the dx
649 installation directory are an added source of
650 information. html/allguide.htm contains html ver-
651 sions of the documentation.
655 IBM Visualization Data Explorer DX(1V)