LABEL MESH Attribute [Control]

  The command LABEL MESH allows the user to specify the labels that will be displayed on the mesh.

FEMGEN Command.                                                            

The user may specify the part name to which the labels will be applied, and the colour to be used for the labels. The command word ALL may be used instead of a part name if labels on all parts are required and the command word CURRENT if labels on all currently displayed parts are required (this is the default).

Attribute Control Comments

OFF -- All labelling will be switched off.

ELEMENTS [OFF] The requested attribute is labelled on the

NODES [ALL] [colour] parts of the mesh specified. The labels

MATERIALS [CURRENT] [colour] will be in the specified colour. When

PHYSICAL [Part_name] [colour] labelling nodes or elements a specific

CSYST `n' [colour] node or element number (rather than a

CONSTRNT part name) may be given. LOADS INITIAL TYPES MERGE AXES EXTERNAL

QUALITY Part_name [Test] Labels elements that fail quality tests (see note 5).

Return Level: LABEL MESH except for OFF

Notes:

1.

Use of colour
When displaying mesh labels, the use of either WHITE, RED, ORANGE, YELLOW, GREEN, BLUE or VIOLET colour may be specified.

2.

Difference between LABEL GEOMETRY andLABEL MESH
LABEL MESH labels each element but LABEL GEOMETRY labels each part.

3.

Labelling of loads
A graphical representation of the load will be displayed rather than the load name as is the case with the LABEL GEOMETRY LOADS command. When requesting that a load be labelled it is possible to specify the load name or the load number instead of a part name and this will display that load on all the parts it is assigned to. The display of vector loads is such that vectors are drawn proportional to the magnitude of the load, but additional control on the size of the displayed vectors is given by the LABEL OPTIONS LOADS command. Scalar loads and tensor components are represented as numeric values. A component of multiple scalars values or single components of tensor are selected by an optional integer.

4.

Labelling element types
If the User has selected an analysis environment (with PROPERTY FE ... or by the use of an environment variable) then the element name specific to the FE package will be displayed on each element. Otherwise the FEMGEN generic element type will be shown.

5.

Control of mesh quality labels
The keywords `MINANG', `MAXANG', `ASPECT', `NODOFF', `BULGE' `WARP' or `TOTAL' request that elements failing the specified quality test are labelled. The default is that the first test to fail is labelled (where the order is dependent on the relative weighting of the quality tests); and the keyword `NFAIL' requests that the number of failures per element be labelled. Further information on Mesh Quality is given in Appendix J of the User Manual Appendices.

6.

Labelling of local axes
When requesting that the local axes for a part be displayed it is possible to specify that either ALL axes or only the X, Y or Z axis be shown.

7.

Labelling of MERGES LABEL MESH MERGE will label all the nodes on parts that are referred to in any stored merges (as shown by UTILITY TABULATE MESH MERGE)

Examples:

1.

LABEL MESH NODES B1

Labels all the nodes on body B1

2.

LABEL MESH ELEMENTS 186 YELLOW

Labels element number 186 in yellow

3.

LABEL MESH MATERIALS ALL RED

Labels all the materials in red

4.

LABEL MESH LOADS CAS1 2 RED

Labels all parts that have Load Instance (name) CAS1 applied. The 2nd component of the load is displayed as a numerical value in the colour red.

5.

LABEL MESH QUALITY ALL MAXANG

Labels all elements that fail the Maximum Angle test.

6.

LABEL MESH QUALITY SUR5 NFAIL

Labels all elements on surface SUR5 to indicate how many quality tests each element failed.

7.

LABEL MESH AXES L12 X YELLOW

Displays the local x-axis of elements associated with line L12 in yellow.

See also the following commands

'LABEL OPTIONS'

FEMVIEW Command.                                    

It is possible to specify a range of nodes, elements, groups or materials for which labels are required. Alternatively, the graphics cursor may be used to interactively enquire the identity of a node, element number, group number or material number.

Attribute Range Comments

OFF -- All labelling will be switched off.

NODES OFF Labels attribute requested on the

ELEMENTS ALL [Colour] parts of the mesh defined in the

GROUPS /PICK range (see notes 1 and 2).

MATERIALS VIEWMODE [Colour] Set_name [Colour] n1 n2 n3 ... n17 n1 TO n2 [STEPS n3] IJK [BLOCK n] I n1 TO n2 ... J n3 TO n4 K n5 TO n6

TYPES Type Labels elements of the requested type. OFF

CONSTRNTS Colour Labels nodes that have constraints

EXTERNALS OFF applied, that have external degrees of

MPCS freedom, or labels multi-point constraints (see note 11).

RESULTS Colour Labels enumerative results (see note 13). OFF

Set_name Colour If the set is a node set then the nodes in the set are labelled. If the set is an element set then the elements in the set are labelled.

AXES NODAL X [Colour] [QUICK] Labels nodal, element or

ELEMENT Y [Colour] [QUICK] gaussian results local axes

GAUSSIAN Z [Colour] [QUICK] (see note 10). ALL [Colour] [QUICK] OFF

Notes:

1.

Labelling elements on node sets
Any element connected to any of the nodes in the node set will be labelled.

2.

Labelling nodes on element sets
All the nodes that define the elements in the element set will be labelled.

3.

Notation for Material and Group labels
To distinguish them from element labels and from each other, material labels are prefixed by `M' and group labels are prefixed by `G'.

4.

Positioning of labels
If labelling of nodes has been requested then node numbers are displayed adjacent to the corresponding nodal point. If labelling of element attributes has been requested then labels are displayed as a list starting at the centroids of the appropriate elements. A label is not displayed if any part of it would lie outside the current viewport.

5.

Effect of model subsets
Only nodes and elements in the current model subset are considered regardless of the 'Range' specified.

6.

Effect of visualisation
If no `Range' is specified, or the command VIEWMODE is used, then only `visible' elements or nodes in the subset will be labelled. For a node to be `visible' it would have attached mesh lines shown as a result of the command VIEW OPTIONS EDGES ALL; (the effect of commands VIEW OPTIONS EDGES OUTLINE and VIEW OPTIONS EDGES INHIBIT is ignored). For a beam or shell element to be `visible', all of its nodes must be `visible'; whereas a solid element is considered `visible' if one or more of its nodes is `visible'. (The exception to this rule is that with models comprising only beam and/or plate/shell elements, the visualisation test is not applied for element labels unless a hidden line view is current).

7.

Use of the graphics cursor
The command word /PICK enables the user to enquire the identity of a node or element by using the graphics cursor. Only `visible' nodes or elements will be sensitive to the cursor (see note 4. above). An element is located by the position of its centroid. To terminate cursor picking it is necessary to make two approximately coincident cursor hits.

8.

Effect of changing the model visualisation mode
If the VIEW mode is changed whilst labels are displayed, the labels are not effected and remain displayed as they were. The exception to this rule is when going to or from a cross-section, in which case all labels will be removed.

9.

Node labels on cross-sections
Intersection points are generated where the cross-section intersects an edge of a finite element. An intersection point is labelled with the number of the nearest node on the intersected finite element edge as long as this node is within 1/10th of the edge length to the intersection point. Otherwise the intersection point will not be given a node label.

10.

Labelling results local axes
Local axes systems can only be displayed if the required results local axes system dataset has been input, see Appendix B of the User Manual Appendices. The exception is for element results local systems where, if no data has been input, then a single local system will be displayed at the element centroid based on the definition of the element. A colour RED, ORANGE, YELLOW, GREEN, BLUE or VIOLET may be chosen. For the display of both element and gaussian local systems the QUICK option will display an axes system at only the 1st node or gauss point encountered for the element. Note that, by default, on 2D displays the axes system vectors will have 3D heads and on 3D displays the vectors will have 2D heads.

11.

Labelling Constraints, Externals and MPCS
These labels can only be displayed if the required dataset has been input, see Appendix B of the User Manual Appendices. A colour RED, ORANGE, YELLOW, GREEN, BLUE or VIOLET may be chosen.

12.

Labelling using IJK values
With IJK regular models it is possible to specify a range of nodes or elements by their IJK reference values. To have the actual IJK values themselves displayed as labels the command LABEL OPTIONS IJK ON must be used.

13.

Labelling of enumerative results
Currently only element gaussian results can be labelled. The first field of the enumerative data is used as the label.

Examples:

1.

LABEL MESH NODES /PICK

The cursor is made available, and the user can make cursor hits at or near node points and the node numbers will be displayed.

2.

LABEL MESH ELEMENTS

All elements in the current model subset will have their element numbers displayed, if these form part of the current visualisation mode (see Note 2 above).

3.

LABEL MESH NODES ALL

All nodes in the model subset will be labelled regardless of whether they are `visible' or not.

4.

LABEL MESH MATERIALS 1 TO 4

Elements of materials 1 through to 4 inclusive will have their material numbers displayed.

5.

LABEL MESH GROUPS 21 TO 51 STEPS 10

Elements in groups 21, 31, 41 and 51 will have their group numbers displayed.

6.

LABEL MESH ELEMENTS IJK J 5

Elements with a J value of 5 will be labelled

7.

LABEL MESH NODES IJK J 5 K 1 TO 3

Nodes with a J value of 5 and a K value between 1 and 3 will be labelled