doc/salome/gui/SMESH/input/mesh_preferences.rst

   1 .. _mesh_preferences_page:
   2
   3 ****************
   4 Mesh preferences
   5 ****************
   6
   7 In the Mesh module you can set mesh preferences, which can be used right now or in later sessions with this module according to the preferences.
   8
   9 General Preferences
  10 ###################
  11
  12 .. image:: ../images/pref21.png
  13         :align: center
  14
  15 .. _automatic_update_pref:
  16
  17 Automatic Update
  18 =================
  19
  20 * **Automatic Update**
  21
  22         * **Automatic Update** - if activated, the mesh in your viewer will be automatically updated after it's computation, depending on values of additional preferences specified below.
  23         * **Size limit (elements)** - allows specifying the maximum number of elements in the resulting mesh for which the automatic updating of the presentation is performed. This option affects only :ref:`compute_anchor` operation. Zero value means "no limit". Default value is 500 000 mesh elements.
  24         * **Incremental limit check** - if activated, the mesh size limit check is not applied to the total number of elements in the resulting mesh, it is applied iteratively to each entity type in the following order: 0D elements, edges, faces, volumes, balls. At each step the number of entities of a certain type is added to the total number of elements computed at the previous step - if the resulting number of elements does not exceed the size limit, the entities of this type are shown, otherwise the user is warned that some entities are not shown.
  25
  26 .. _display_mode_pref:
  27
  28 Display mode
  29 ============
  30
  31 * **Display mode**
  32         * **Default display mode** - allows to set Wireframe, Shading, Nodes or Shrink :ref:`display_mode_page` as default.
  33
  34 .. _quadratic_2d_mode_pref:
  35
  36 Quadratic 2D preferences
  37 ========================
  38
  39 * **Representation of the 2D quadratic elements**
  40         * **Default mode of the 2D quadratic elements** - allows to select either *Lines* or *Arcs* as a default :ref:`quadratic_2d_mode` of 1D and 2D :ref:`adding_quadratic_elements_page`.
  41         * **Maximum Angle** - maximum deviation angle used by the application to build arcs.
  42
  43 * **Quality Controls**
  44         * **Display entity** - if activated, only currently :ref:`quality_page` entities are displayed in the viewer and other entities are temporarily hidden. For example if you activate :ref:`length_page` quality control, which controls the length of mesh segments, then only mesh segments are displayed and faces and volumes are hidden.
  45         * **Use precision** - if activated, all quality controls will be computed at precision defined by **Number of digits after point** - as integers by default.
  46
  47 .. _dbl_nodes_tol_pref:
  48
  49 Double nodes tolerance
  50 ======================
  51
  52         * **Double nodes tolerance** - defines the maximal distance between two mesh nodes, at which they are considered coincident by :ref:`double_nodes_control_page` quality control. This value is also used in :ref:`mesh_quality_info_anchor` tab page of :ref:`mesh_infos_page` dialog.
  53
  54 * **Mesh export**
  55
  56 .. _export_auto_groups_pref:
  57
  58 Automatically create groups for MED export
  59 ==========================================
  60
  61         * **Automatically create groups for MED export** - defines a default state of a corresponding check-box in :ref:`export_auto_groups` dialog.
  62
  63 .. _group_export_warning_pref:
  64
  65 Show warning when exporting group
  66 =================================
  67
  68         * **Show warning when exporting group** - if activated, a warning is displayed when exporting a group.
  69
  70 .. _show_comp_result_pref:
  71
  72 Mesh computation
  73 ================
  74
  75 * **Mesh computation**
  76         * **Show a computation result notification** - allows to select the notification mode about a :ref:`compute_anchor` result. There are 3 possible modes:
  77                 * **Never** - not to show the :ref:`meshing_result_anchor` at all;
  78                 * **Errors only** - the result dialog will be shown if there were some errors during a mesh computation;
  79                 * **Always** - show the result dialog after each mesh computation. This is a default mode.
  80
  81 .. _mesh_information_pref:
  82
  83 Mesh information
  84 ================
  85
  86 * **Mesh information**
  87
  88         * **Mesh element information** - allows changing the way :ref:`mesh_element_info_anchor` is shown:
  89                 * **Simple** - as a plain text
  90                 * **Tree** - in a tree-like form
  91
  92 .. _nb_nodes_limit_pref:
  93
  94 Automatic nodes compute limit
  95 =============================
  96
  97         * **Automatic nodes compute limit** - allows defining the size limit for the :ref:`mesh_addition_info_group_anchor` for which the number of underlying nodes is calculated automatically. If the group size exceeds the value set in the preferences, the user will have to press \em Compute button explicitly. Zero value means "no limit". By default the value is set to 100 000 mesh elements.
  98
  99 .. _auto_control_limit_pref:
 100
 101 Automatic controls compute limit
 102 ================================
 103
 104         * **Automatic controls compute limit** - allows defining a maximal number of mesh elements for which the quality controls in the :ref:`mesh_quality_info_anchor` tab page are calculated automatically. If the number of mesh elements exceeds the value set in the preferences, it is necessary to press **Compute** button explicitly to calculate a quality measure. Zero value means "no limit". By default the value is set to 3 000 mesh elements.
 105
 106 .. _group_detail_info_pref:
 107
 108 Detailed info for groups
 109 ========================
 110
 111         * **Show details on groups in element information tab** - when this option is switched off (default), only the names of groups, to which the node or element belongs, are shown in the :ref:`mesh_element_info_anchor` tab of "Mesh Information" dialog box. If this option is switched on, the detailed information on groups is shown.
 112         * **Dump base information** - allows dumping base mesh information to the file, see :ref:`dump_mesh_infos`.
 113         * **Dump element information** - allows dumping element information to the file, see :ref:`dump_mesh_infos`.
 114         * **Dump additional information** - allows dumping additional mesh information to the file, see :ref:`dump_mesh_infos`.
 115         * **Dump controls information** - allows dumping quality mesh information to the file, see :ref:`dump_mesh_infos`.
 116
 117 * **Automatic Parameters**
 118
 119 .. _diagonal_size_ratio_pref:
 120
 121 Ratio Bounding Box Diagonal
 122 ===========================
 123
 124         * **Ratio Bounding Box Diagonal / Max Size** - defines the ratio between the bounding box of the meshed object and the Max Size of segments. It is used as a default value of :ref:`a1d_meshing_hypo_page` defining length of segments, especially by :ref:`max_length_anchor` hypothesis.
 125
 126 .. _nb_segments_pref:
 127
 128 Default Number of Segments
 129 ==========================
 130
 131         * **Default Number of Segments** - defines the default number of segments in :ref:`number_of_segments_anchor` hypothesis.
 132
 133 * **Mesh loading**
 134
 135         * **No mesh loading from study file at hypothesis modification** - if activated, the mesh data will not be loaded from the study file when a hypothesis is modified. This allows saving time by omitting loading data of a large mesh that is planned to be recomputed with other parameters.
 136
 137 * **Input fields precision** - allows to adjust input precision of different parameters. The semantics of the precision values is described in detail in **Using input widgets** chapter of GUI documentation (Introduction to Salome Platform / Introduction to GUI / Using input widgets). In brief: **positive** precision value is the maximum allowed number of digits after the decimal point in the fixed-point format; **negative** precision value is the maximum allowed number of significant digits in mantissa in either the fixed-point or scientific format.
 138
 139         * **Length precision** - allows to adjust input precision of coordinates and dimensions.
 140         * **Angular precision** - allows to adjust input precision of angles.
 141         * **Length tolerance precision** - allows to adjust input precision of tolerance of coordinates and dimensions.
 142         * **Parametric precision** - allows to adjust input precision of parametric values.
 143         * **Area precision** - allows to adjust input precision of mesh element area.
 144         * **Volume precision** - allows to adjust input precision of mesh element volume.
 145
 146 * **Preview**
 147         * **Sub-shapes preview chunk size** - allows to limit the number of previewed sub-shapes shown in the hypotheses creation dialog boxes, for example "Reverse Edges" parameter of :ref:`number_of_segments_anchor` hypothesis.
 148
 149 * **Python Dump**
 150         * **Historical python dump** - allows switching between *Historical* and *Snapshot* dump mode:
 151         * In *Historical* mode, Python Dump script includes all commands performed by SMESH engine.
 152         * In *Snapshot* mode, the commands relating to objects removed from the Study as well as the commands not influencing the current state of meshes are excluded from the script.
 153
 154 .. _mesh_tab_preferences:
 155
 156 Mesh Preferences
 157 ################
 158
 159 **Mesh** tab page contains parameters defining the way the mesh is displayed in the 3D Viewer.
 160
 161 .. image:: ../images/pref22.png
 162         :align: center
 163
 164 * **Nodes** - allows to define default parameters for nodes, which will be applied for a newly created mesh only. Existing meshes can be customized using :ref:`colors_size_page` available from the context menu of a mesh.
 165         * **Color** -  allows to select the color of nodes. Click on the downward arrow near the colored line to access to the **Select Color** dialog box.
 166         * **Type of marker** - allows to define the shape of nodes.
 167         * **Scale of marker** - allows to define the size of nodes.
 168
 169 * **Elements** - allows to define default parameters for different elements, which will be applied to a newly created mesh only. Existing meshes can be customized using :ref:`colors_size_page` available from the context menu of a mesh.
 170         * **Surface color**  - allows to select the surface color of 2D elements (seen in Shading mode). Click on the downward arrow near the colored line to access to the **Select Color** dialog box.
 171         * **Back surface color** - allows to select the back surface color of 2D elements. This is useful to differ 2d elements with reversed orientation. Use the slider to select the color generated basing on the **Surface color** by changing its brightness and saturation.
 172         * **Volume color** - allows to select the surface color of 3D elements (seen in Shading mode).
 173         * **Reversed volume color** - allows to select the surface color of reversed 3D elements. Use the slider to select the color generated basing on the **Volume color** by changing its brightness and saturation.
 174         * **0D element color** - allows to choose color of 0D mesh elements.
 175         * **Ball color** - allows to choose color of discrete mesh elements (balls).
 176         * **Outline color** - allows to select the color of element borders.
 177         * **Wireframe color** - allows to select the color of borders of elements in the wireframe mode.
 178         * **Preview color** - allows to select the preview color of the elements, which is used while :ref:`adding_nodes_and_elements_page`.
 179         * **Size of 0D elements** - specifies default size of 0D elements.
 180         * **Size of ball elements** - specifies default size of discrete elements (balls).
 181         * **Scale factor of ball elements** - specifies default scale factor of discrete elements (balls) allowing to adjust their size in the Viewer.
 182         * **Line width** - allows to define the width of 1D elements (segments).
 183         * **Outline width** - allows to define the width of borders of 2D and 3D elements (shown in the Shading mode).
 184         * **Shrink coef.** - allows to define relative size of a shrunk element compared a non-shrunk element in percents in the shrink mode.
 185
 186 * **Groups**
 187         * **Names color** - specifies color of group names to be used in the 3D viewer.
 188         * **Default color** - specifies the default group color, which is used to create a new mesh group (see :ref:`creating_groups_page`).
 189
 190 * **Numbering** allows to define properties of numbering functionality:
 191         * **Nodes** - specifies text properties of nodes numbering (font family, size, attributes, color).
 192         * **Elements** - same for elements.
 193
 194 * **Orientation of Faces** - allows to define default properties of orientation vectors. These preferences will be applied to the newly created meshes only; properties of existing meshes can be customized using :ref:`colors_size_page` available from the context menu of a mesh.
 195         * **Color** - allows to define the color of orientation vectors;
 196         * **Scale** - allows to define the size of orientation vectors;
 197         * **3D Vector** - allows to choose between 2D planar and 3D vectors.
 198
 199 Selection Preferences
 200 #####################
 201
 202 .. image:: ../images/pref23.png
 203         :align: center
 204
 205 * **Selection** - performed with mouse-indexing (preselection) and left-clicking on an object, whose appearance changes as defined in the **Preferences**.
 206         * **Object color** - allows to select the color of mesh (edges and borders of meshes) of the selected entity. Click on the colored line to access to the **Select Color** dialog box.
 207         * **Element color** - allows to select the color of surface of selected elements (seen in Shading mode). Click on the colored line to access to the **Select Color** dialog box.
 208
 209 * **Preselection** - performed with mouse-indexing on an object, whose appearance changes as defined in the **Preferences**.
 210         * **Highlight color** - allows to select the color of mesh (edges and borders of meshes) of the entity. Click on the colored line to access to the **Select Color** dialog box.
 211
 212 * **Precision** - in this menu you can set the value of precision used for **Nodes**, **Elements** and **Objects**.
 213
 214 Scalar Bar Preferences
 215 ######################
 216
 217 .. image:: ../images/pref24.png
 218         :align: center
 219
 220 .. note::
 221         The following settings are default and will be applied to a newly created mesh only. Existing meshes can be customized using local :ref:`scalar_bar_dlg` available from the context menu of a mesh.
 222
 223 * **Font** - in this menu you can set type, face and color of the font of **Title** and **Labels**.
 224
 225 * **Colors & Labels** - in this menu you can set the **number of colors** and the **number of labels** in use.
 226
 227 * **Orientation** - here you can choose between vertical and horizontal orientation of the **Scalar Bar**.
 228
 229 * **Origin & Size Vertical & Horizontal** - allows to define placement (**X** and **Y**) and lookout (**Width** and **Height**) of Scalar Bars.
 230         * **X** - abscissa of the point of origin (from the left side).
 231         * **Y** - ordinate of the origin of the bar (from the bottom).
 232
 233 * **Distribution** in this menu you can Show/Hide distribution histogram of the values of the **Scalar Bar** and specify the **Coloring Type** of the histogram:
 234         * **Multicolor** - the histogram is colored as **Scalar Bar**.
 235         * **Monocolor** - the histogram is colored as selected with **Distribution color** selector.
 236
 237