# Measure

Description

Draw measurement regions colored by attributes.

This plot item observes the Shape/Color By/Color Opt pattern to determine its rendering.

Visual Reference: Attribute List

Shape

Specify settings for rendering of the measurement sphere. There is no choice regarding shape; all measure plot items are rendered as spheres, and they use the common simple controls.

Color By

Specify what aspect of the item is to be rendered, from one of three mutually exclusive groups (only one selection from any group is active at one time): text values, numeric values, and vector quantities. If a Vector Qty is chosen, an additional field is added to specify whether a component ($$x$$, $$y$$, or $$z$$) or the magnitude (mag) of the vector should be rendered.

Selecting -->Add Prop at the bottom of a selector will provide a dialog that allows the user to specify a new property to add to the list (and make it the active color by selection).

The labels ATTRIBUTE and PROPERTY on a selector do nothing; these are provided to visually differentiate the two groups.

Table 1: Numeric Value options
Name Description
coordination
porosity
strain rate11
strain rate12
strain rate13
strain rate21
strain rate22
strain rate23
strain rate31
strain rate32
strain rate33
stress11
stress12
stress13
stress21
stress22
stress23
stress31
stress32
stress33
volume
Table 2: Vector Quantity options
Name Description
position

CS: the tables above need to be completed

Color Opt

Specify options for coloring the plot item. This must be set to either scaled (contoured) coloring, or coloring based on named items (group names, for instance). The former is the default option for numeric or vector items as set with the Color By attribute; the latter is the default setting when a textual value is specified with Color By. Setting ColorOpt to “scaled” on a textual value will result in nothing rendered. Setting a numeric or vector quantity to “named” causes the values within the numeric range to be treated as separate “names” to be colored, where the number of names is governed by the “max-names” sub-attribute.

Scaled

When scaled is selected, coloring is controlled by the following sub-attributes.

Contour: A container for settings that control contouring options.

Ramp: Set the color ramp to use for rendering. The five options, in order shown in the select box, are: rainbow (blue to red), grayscale, blue-white-red, blue-cyan-white-yellow-red, green-white-red.

Maximum: Set the highest value (right end) of the color ramp automatically (auto checked) or with a specified value (auto unchecked). Values above Maximum are filled with the Above color.

Minimum: Set the lowest value (left end) of the color ramp automatically (auto checked) or with a specified value (auto unchecked). Values below Minimum are filled with the Below color.

Interval: Specify the number of color intervals used in when rendering; this value defaults to a number between 8-16 if auto is checked.

Log Scale: Specify that the color intervals are logarithmically spaced when checked.

Reversed: Reverse the color sequence of the color ramp when checked.

Below: Specify which color to use for values below the Minimum. The left end of the color ramp is used with auto checked. When unchecked, the color swatch control specifies the color.

Above: Specify which color to use for values above the Maximum. The right end of the color ramp is used with auto checked. When unchecked, the color swatch control specifies the color.

Named

When named is selected, coloring is controlled by the following sub-attributes.

Max Names: Specify the maximum number of names and, correspondingly, the maximum number of unique colors, to be used. If more unique names exist they are assigned the name unknown and colored by a single color. The default value is 30.

Name Cont: Specify the existence of name or color controls. When many unique names (or colors) exist, the presence of the controls for each color drastically reduces rendering performance. By unchecking this option, many unique colors can be rendered efficiently.

Color List: If the plot item has selectable color items, the edit/spinbox allows specification of the number of colors to use when rendering the item. Additionally, the adjacent buttons (select all, select none, invert selection) will be active. If the plot item does not contain selectable color items, these controls are disabled. In any context, if there are colors present (colors > 0), this sub-attribute can be opened to show the list of colors used to render the plot item. The color swatches in the list may be used to change the color at the selected position. The text label adjacent to the color swatch may be edited. If there are selectable color items, each color item in the list will start with a checkbox that can be used to show (checked) or hide (unchecked) the item.

Map

Transform the orientation, location, or scale of the plot item according to the settings provided. This attribute allows multiple, differently visualized instances of a plot item to be rendered adjacent to one another, for instance.

Axis: Specify a coordinate transformation to use assuming a normal order of {XY in 2D; XYZ in 3D} (XZY, for instance, indicates that the Y and Z coordinates are swapped).

Translate: Translate the rendered objects’ {$$x$$ and $$y$$ in 2D; $$x$$, $$y$$, and $$z$$ in 3D} positions by the specified model units.

Scale: Set the plot item size to the specified percentage of the program window’s size.

Transparency

Set the transparency of the plot item. This setting is not available on 2D model objects.

Transparency: Apply transparency (checked) to the item. When on, transparency is set to a default value of 70 and is “locked.” When locked, the available range of transparency is constrained to 70 (lowest, somewhat transparent) to 100 (highest, completely invisible). To access the full range of transparency values (0-100), press the lock icon to “unlock” the transparency range; the icon changes accordingly ( ).

Use the help button to get help with this specific attribute.

Note

Users should be cautioned that values lower than 70 tend to be imperceptibly “less” transparent and they may result in depth perspectives that can seem strange or incorrect.

Legend

Set display of the item in the plot legend. All plot items, at minimum, have a Title attribute.

Legend: Show (checked) all information about the plot item in the legend.

Title: Show (checked) the title of the plot item in the legend. The “Alias:” field may be used to specify a custom title for the item.

Size: Set the size of text in the legend.

Font: Set the font face used for the text.

Style: Set the text style (the options are normal, bold, italic, bold-italic).

Color: Set the text color.

Beneath Title, the Measure plot item also provides controls in Legend for Count, Named, and Scaled.