doc/salome/gui/VISU/input/cut_lines.doc

   1 /*!
   2
   3 \page cut_lines_page Cut Lines presentation
   4
   5 \n <b>Cut Lines</b> is a type of presentation which displays colored
   6 cells with applied scalar values on the mesh where lines are placed.
   7 \n The procedure of construction of <b>Cut Lines</b> presentation
   8 reuses the algorithm of creation <b>Cut Planes</b> presentation and
   9 consists of two steps:
  10 <ol>
  11 <li>From <b>Cut Planes</b> presentation one plane is taken and it is
  12 used as base plane for construction of cut lines.</li>
  13 <li>This plane is cut by a regular array of planes. The result of this
  14 operation is a regular array of lines in space,  belonging to the same
  15 plane and having the same orientation. They are located inside or on
  16 the mesh.</li>
  17 </ol>
  18
  19 <em>To create a Cut Lines presentation:</em>
  20 \par
  21 &ndash; Right-click on one of the time stamps of the field in the
  22 Object browser and from the pop-up menu choose <b>Cut Lines</b>, or
  23 \n &ndash; Click on one of the time stamps of the field in the Object
  24 browser and select from the main menu <b>Visualization > Cut
  25 Lines</b>, or click <em>"Cut Lines"</em> icon in the <b>Visualization
  26 Toolbar</b>.
  27
  28 \image html cutlinesicn.jpg
  29 <center><em>"Cut Lines" icon</em></center>
  30
  31 \image html cutlines.png
  32
  33 \par
  34 <b>Plane of lines:</b> this tab of the dialog box contains the
  35 parameters of the base plane, on which the cut lines will be located.
  36 <ul>
  37 <li><b>Orientation</b> check boxes allow to set the orientation of cut
  38 planes in 3D space. You should select two of three axis (XY, YZ, or
  39 ZX) in which your planes will be located in 3D space.</li>
  40 <li><b>Rotations</b> of the planes in 3d space around the axes of the
  41 selected orientation. (The angle of rotation is set in degrees)</li>
  42 <li><b>Base plane position:</b> position of the base plane. This value
  43 can be set by default or entered manually.</li>
  44 <li><b>Displacement</b> of the plane. This parameter defines position
  45 of the base plane in 3d space.</li>
  46 <li><b>Show preview</b> check box allows to edit the parameters of the
  47 presentation and simultaneously observe the preview of this
  48 presentation in the viewer.</li>
  49 <li><b>Invert all curves</b> check box allows to invert the resulting
  50 curves.</li>
  51 <li><b>Use absolute length</b> check box allows to see the real length
  52 of the line, instead of [0,1] interval.</li>
  53 <li><b>Generate Data Table:</b> If this check box is marked, Post-Pro
  54 will automatically generate a data table on the basis of your Cut
  55 Lines presentation. This table will be created in the structure of the
  56 study.</li>
  57 <li><b>Generate Curves:</b> If this check box is marked, Post Pro
  58 will automatically generate curve lines on the basis of values taken
  59 from the generated data table. These curves will be created in the
  60 structure of the study and can be visualized in a XY plot.</li>
  61 </ul>
  62 See more about table presentations and curve lines
  63 \ref about_tables_page "here".
  64
  65 \par
  66 <b>Cut Planes:</b> this tab of the dialog box contains the parameters of cut
  67 planes, which will be used for construction of the cut lines.
  68 <br><br>
  69 <b>Scalar Bar</b> tab allows to define the parameters of the scalar bar
  70 displayed with this presentation (\ref scalar_map_page "see also").
  71
  72 After you have finished with setting these parameters, click \b
  73 OK. Your presentation with scalar bar will be immediately displayed in
  74 the viewer:
  75
  76 \image html cutlinesprsnt.png
  77
  78 <b>Tip:</b> From <b>Cut Lines</b> presentation you can create a
  79 <b>data table</b>. This table will consist of the field scalar values
  80 located on each cut line of the constructed presentation (see also:
  81 \ref creating_tables_from_cut_lines_page "Creating tables from Cut
  82 Lines presentations"). After that your data table can be used for
  83 construction of a 2d plot of curves based on the scalar values from
  84 the table (see also: \ref creating_curves_page "Creating curves" and
  85 \ref creating_xy_plots_page "Creating XY plots").
  86
  87 */