Command Line Options

The program may be executed by typing

t3d [option [parameter]] ...

on the command line prompt with the following command line options:

 

-h

displays program usage description

-P

displays program command line parameters description

-F

displays format of input file, output file, and background mesh file;
note that the description of output file format takes into account the actually applied -p and -k options; the other options are ignored

-Q

silent mode (all messages to standard error channel are discarded)

-W

suppresses warning messages

-V

includes virtual entities into the domain extent

-C

enables curvature violation on surface and shell; (triangles with node normals differing by more than 120 are allowed)

-B

generates boundary conforming elements;
this option is relevant only for quadratic elements (see option -k)

-A

disables default designation of boundary model entities (curves, surfaces, patches, and shells) for output of boundary associated elements (triangles and tetrahedrons);
this option is relevant only if output of boundary associated elements is required (see option -p)

-S

disables nodal smoothing for surface, patch, shell, and region triangulation;
note that this option prevents removing slivers from region triangulation

-i

(string) input model file name;
if this option is not present an error occurs

-o

(string) output mesh file name;
the output is realized only if this option is used

-g

(string) output log file name;
standard error channel is used as default

-m

(string) input background mesh file name

-x

(string) output graphics (Elixir) file name

-n

(6x int #) number of model entities;
this option specifies the estimate on number of individual entities (including virtual ones) in model representation; the entities are ordered: vertices, curves, surfaces, patches, shell, and regions; must not be negative; by default zero number of model entities of each type is assumed; if applied no model entity of corresponding type is allowed to have larger id than the specified value; need not be applied to all types of model entities

-f

(2x int #) numbering shift;
this option specifies the shift for node and element numbering; must not be negative; no numbering shift is applied by default

-L

(int #) default listing size;
this option defines the length of listing which is allocated as a contiguous block of memory; ranges from 10 to 10000; default value is 1000

-T

(int #) hash table size;
this option defines the size of hash table used to access model entities; the larger value the faster access; must be positive; default value is 100

-r

(int #) renumbering type;
some cumulative combinations of the following specifications may be used

0

- no renumbering (default)

1

- renumbering of nodes

2

- renumbering of elements (disabled)

4

- fast renumbering

specification 4 is relevant only if used cumulatively with specification 1 or 2; it attempts to shorten the renumbering time by skipping passes the are not likely to produce the best renumbering

-s

(int #) type of weighting applied during the Laplacian smoothing;
this option is relevant only if option -S is not used; any cumulative combination of the following types may be used

0

- no weighting (default)

1

- mesh size weighting

2

- connectivity weighting

-k

(int #) element degree;
one of the following types must be used

1

- linear (default)

2

- quadratic

note that midside nodes on quadratic elements do not follow possible curvature of model boundary unless the -B option is specified

-p

(int #) additional output specification;
any cumulative combination of the following specifications may be used

0

- no additional output (default)

1

- output of parametric coordinate(s)
  (only nodes classified to a curve, surface, patch, or shell)

2

- output of node tangent
  (only nodes classified to a curve)

4

- output of node normal
  (only nodes classified to a surface, patch, or shell)

8

- output of boundary model entities
  (for triangles adjacent to a boundary curve and for tetrahedrons
  adjacent to a boundary surface, patch, or shell)

16

- output of elements associated with boundary model entities
  (triangles associated with a curve and tetrahedrons associated with
  a surface, patch, or shell)

32

- output of neighbouring elements
  this specification is enabled only if the code has been compiled with
  the T3D_OUTPUT_NEIGHBOUR directive

128

- output of nodes in T3d native order
  native ordering follows the mesh generation order: vertex, curve, surface,   patch, shell, region linear nodes, curve, surface, patch, shell, region quadratic   nodes;
  this specification is relevant only if used together
  with node renumbering request (see -r)

-q

(int #) type of mesh quality report;
any cumulative combination of the following types may be used

0

- no report

1

- element quality report (default)

2

- dihedral angle report

4

- nodal connectivity report

8

- report distribution of selected quantities

16

- disable triangle quality report

32

- disable tetrahedron quality report

64

- report all model entities

128

- per model entity report

256

- color triangle element quality

512

- color tetra element quality

note that if no from element quality, dihedral angle, or nodal connectivity is included in the mesh quality report type then no report is accomplished; implicitly only model entities designated for output are subjected to the quality report; color quality types work only together with option -X

-y

(int #) type of graphics output file;
one of the following types must be used

0

- no specific graphics output (default)

1

- Elixir graphics output

2

- VRML 2.0 graphics output

3

- VTK graphics output

note that this option is relevant only if used together with option -x and if the code has been compiled with the T3D_GRAPHICS_SUPPORT directive

-z

(int #) graphics output specification;
some cumulative combinations of the following specifications may be used

0

- no graphics output specification(default)

1

- wireframe graphics output

2

- mesh size contours output

4

- reverted mesh size contours output

8

- black & white mesh size contours output

specification 1 is applied only if VRML output is required; specifications 2, 4, and 8 are irrelevant if used together with specification 1; specifications 4 and 8 are relevant only if used cumulatively with specification 2; note that this option is effective only if used together with nonzero option -y; this option is independent of options -M; note that contour visualization might not be supported by all VRML viewers; also note that some VRML viewers do not support wireframe view unless explicitly specified; this option is relevant only if the code has been compiled with the T3D_GRAPHICS_SUPPORT directive

-d

(fpn #) default mesh size;
default mesh size is assigned to vertices and control points with zero mesh size specification if local mesh size control is applied (see -v option); is used in input file; must be positive

-u

(fpn #) uniform mesh size;
uniform mesh size is propagated over all model entities; is used in input file; must be positive

-v

(fpn #) mesh size multiplication factor;
each mesh size specification except the background mesh size specification is multiplied by this factor; must not be negative; default value is 1; zero value disables local mesh size control

-c

(fpn #) default curvature rate;
it is assigned to model entities without curvature rate specification; controls the ratio between the appropriate mesh size and radius of curvature; default value is 1; if set to 0 curvature based mesh size control is disabled for entities that do not specify any curvature rate; is used in input file; must not be negative

-w

(fpn #) curvature rate multiplication factor;
curvature rate specified for each curve and surface is multiplied by this factor; must not be negative; default value is 1; zero value disables the curvature based mesh size control

-t

(fpn #) default curve density;
it is assigned to model curves without density specification; dtermines the mesh size as the ratio between the length of the curve and the density; default value is 1; if set to 0 density based mesh size control is disabled for entities that do not specify any density; is used in input file; must not be negative

-a

(fpn #) background mesh size multiplication factor;
background mesh size specification is multiplied by this factor; must not be negative; zero value disables background mesh size control; default value is 1

-e

(fpn #) user defined epsilon;
the value of epsilon is used to resolve the geometrical ambiguity; the default value is 1.0e-5

-R

(fpn #) size of the root octant;
this option is ignored if the specified value is smaller then the largest dimension of the bounding box of the domain; must be positive; note that the value may be increased when -U option is specified

-U

(3x fpn #) origin of the root octant;
note that this option may cause increase of root octant size specified with -R option; by default root octant origin is placed in such a way that the root octant center coincides with the center of the domain bounding box

-E

(fpn #) octant size excess;
octant size excess controls the maximum ratio between the terminal octant size and the actual required element size; ranges from 1 to 1.5; default value is 1

-X

enables interactive X-window interface based on Elixir graphic library;
this option is available only when source code was compiled with the directive T3D_ELIXIR and all prerequisite libraries (Ckit, Elixir, X Window) and header files were available

-D

sets demonstration mode for run without user intervention;
this option works only together with option -X

-M

enables drawing of mesh size contours;
this option works only together with option -X

-N

enables drawing of background mesh;
this option works only together with option -X; when used together with option -M mesh size contours will be applied to background mesh only

-Y

(3x int #) sets plotting specifications for model, mesh, and octree (in this order);
the purpose of this option is to save memory when using graphic interface;
this option works only together with option -X
any cumulative combination of the following types may be used for the model drawing specification

0

- do not draw model

1

- draw model vertices (default)

2

- draw model curves (default)

4

- draw model surface, patches, and shells (default)

8

- draw model regions (default)

16

- draw model vertex numbers (default)

32

- draw model curve numbers (default)

64

- draw model surface, patch, and shell numbers (default)

128

- draw model region numbers (default)

any cumulative combination of the following types may be used for the mesh drawing specification

0

- do not draw mesh

1

- draw mesh nodes (default)

2

- draw mesh edges (default)

4

- draw mesh triangles (default)

8

- draw mesh tetrahedrons (default)

16

- draw mesh node numbers (default)

32

- draw mesh edge numbers (default)

64

- draw mesh triangle numbers (default)

128

- draw mesh tetrahedron numbers (default)

any cumulative combination of the following types may be used for the octree drawing specification

0

- do not draw octree

1

- draw octree (default)

note that drawing of the whole model, mesh, and octree is performed by default, which corresponds to -Y 255 255 1 plot specification

-@

enables phase by phase run;
this option works only if T3D_PC_VERSION directive is not defined

-$

enables step by step run;
this option works only if T3D_PC_VERSION directive is not defined

-#

specifies element removal when discretizing regions;
this option works only together with options -X and -$

When a t3d parametric option is specified more than once only the last value is accepted. This is not true for file name specification which is supposed to be unique.

The following command line options are not processed by t3d and are passed to the Elixir graphic interface (if available and required)

-display (string) - redirects the output

-geometry (string) - specifies the geometry

-fn (string) - specifies the font

-font (string) - specifies the font

-defcmap - sets the default color map

-defvisual - sets the default visual

-bestvisual - sets the best visual