label option=value [, option=value, ...]
A plot option for the label plot. See table below.
A value associated with the matching option . See table below.
This number controls how much labels "jump around" when you are zooming. |
|||
Horizontal justification of labels with respect to labelled objects. |
|||
Name of variable or mesh whose values will be used as the labels. When this variable contains "default," MeshTV will use the first mesh it finds in the SILO file. When the string is the name of a variable (as opposed to a mesh variable), the type option (and thus the node and zone options) is ignored since the variable will print to nodes or zones as appropriate. This option is equivalent to the var option. (They used to be different, but both have been kept for backward compatibility.) |
|||
Set how many labels you want to see at a given time. For example, if the number is 100, you will see 100 labels in the image (if 100 exist) instead of seeing all the labels, which can lead to viewing problems if the number of labels gets to high. |
|||
Label all nodes if "all" is the argument, else label the listed node. One integer lists a specific node. 2 numbers indicates (on collinear meshes) a logical x,y index, and 3 indicates (again only on collinear meshes) a logical x,y,z index. See the description for more detail. Note that the type option must have an "n" in it for this to actually plot, and the var option must not be used. |
|||
The string with which to label nodes and zones if labeling a single element. |
|||
Color of labels. This can be specified as a color name or as a color index. Color Names |
|||
n
-- label nodes. Note that this must be set for node and zone to take effect. Note also that this option is ignored if the var option is used since the variable will print to nodes or zones as appropriate for the variable type. |
|||
Name of variable or mesh whose values will be used as the labels. When this variable contains "default," MeshTV will use the first mesh it finds in the SILO file. When the string is the name of a variable (as opposed to a mesh variable), the type option (and thus the node and zone options) is ignored since the variable will print to nodes or zones as appropriate. This option is equivalent to the mesh option. (They used to be different, but both have been kept for backward compatibility.) |
|||
Vertical justification of labels with respect to labelled object. |
|||
Place the label at some fraction of the screen width away from the point, either negative or positive. |
|||
Place the label at some fraction of the screen width away from the point, either negative or positive. |
|||
Label all zones if "all" is the argument, else label the listed zones. One integer lists a specific zone. 2 numbers indicates (on collinear meshes) a logical x,y index, and 3 indicates a logical x,y,z index. See the Description section for more detail. Note that the type option must have a "z" in it for this to actually plot, and the var option must not be used. |
The label command sets the options used when generating a mesh label plot. Note that this command does not change existing label plots, only future ones.
The label command can label meshes at the nodes and/or zones, or it can label variables (like pressure and density) at the nodes or zones as appropriate. To label variables, set the var option to the name of the variable. If the var option isn't specified, then node and/or zone numbers will be used for the plot, depending upon the value of the type option.
The type option indicates if we are labeling nodes, zones, or both. If "n" is chosen, then node must also have some value. It already has a default of "all". In contrast, if "z" is chosen for the value of type, then zone must also be set to something, and it starts without a default. If type is set to "n", then any value for zone is ignored, and if type is set to "z", any value for node is ignored. If type is set to "nz" or "zn", then both node and zone must have values. This option is ignored when var contains a variable.
All meshes supported by MeshTV can be labeled, but the node and zone options take different values depending on the mesh type. The values for node and zone options can be the word " all " for all mesh types. The values can also be, for certain meshes, a set of numbers. All mesh types will allow one number. If one number is given, it is assumed to be the number of the node or zone to label, starting at whatever offset (0 or 1) that was given to the data file. Quadrilateral meshes may also be given 2 or 3 numbers, depending on the dimensionality (2D or 3D) of the mesh. In the 2D case, the numbers are interpreted as offsets into the mesh, so {1,2} means one node/zone in the "x" direction, and two in the "y" direction. The 3D case is the same, with an extension in the "z" direction. The actual direction might not be exactly parallel to the "x", "y", or "z" axes in non-colinear problems, but it is conceptually along those axes. Note that if 2 or 3 numbers are supplied to the node or zone options, the numbers must be inside braces, as shown in the first example below.
label type=nz, mesh=mesh1, tc=red, node=all, zone={1,2}
label type=z, mesh=mesh1, tht=.02, hjust=l, vjust=b zone=2