1 .. |measurement.icon| image:: images/measurement.png
6 The feature **Measurement** calculates dimensions of sub-elements of a geometrical object (shape).
8 The measured dimension is displayed in the property panel and shown in 3D OCC viewer.
10 The properties of dimension text and line, such as font, color, arrow size, etc. can be defined in the Preferences :ref:`visualization_preferences`.
12 **Apply** button does not generate any result and has the same effect as **Cancel** for this feature.
14 To start Measurement in the active part:
16 #. select in the Main Menu *Part - > Measurement* item or
17 #. click |measurement.icon| **Measurement** button in the toolbar
19 The following dimensions can be calculated:
21 .. image:: images/meas_length_32x32.png
27 .. image:: images/meas_distance_32x32.png
31 distance between objects
33 .. image:: images/meas_radius_32x32.png
39 .. image:: images/meas_angle_32x32.png
45 .. image:: images/meas_angle3p_32x32.png
51 --------------------------------------------------------------------------------
56 The length can be measured for straight or curved edge built on two points.
58 .. image:: images/Measurement1.png
66 - **Edge** contains edge to be measured selected in 3D OCC viewer or object browser.
68 Note, that for curved edges length is displayed only in the property panel.
72 .. py:function:: model.measureLength(Part_doc, edge)
74 :param part: The current part object.
75 :param object: An edge in format *model.selection("EDGE", edge)*.
76 :return: Calculated value.
79 Distance between objects
80 ------------------------
82 **Distance between objects** calculates minimal distance for any pair of shapes: vertex, edge, face, solid.
84 .. image:: images/Measurement2.png
88 Distance between objects
92 - **From**, **To** contain shapes between which distance is measured. Shapes are selected in 3D OCC viewer or object browser.
96 .. py:function:: model.measureDistance(Part_doc, shape1, shape2)
98 :param part: The current part object.
99 :param object: A first edge in format *model.selection("EDGE", edge)*.
100 :param object: A second edge in format *model.selection("EDGE", edge)*.
101 :return: Calculated value.
106 **Radius** calculates radius for circular edge or cylindrical face.
108 .. image:: images/Measurement3.png
116 - **Object** contains shape to be measured selected in 3D OCC viewer or object browser.
121 .. py:function:: model.measureRadius(Part_doc, shape)
123 :param part: The current part object.
124 :param object: An edge in format *model.selection("TYPE", shape)*.
125 :return: Calculated value.
130 **Angle between edges** calculates angle between the selected pair of edges in the point of intersection. If there are several points of intersection, then angles are calculated in all points.
132 .. image:: images/Measurement4.png
140 - **First Edge**, **Second edge** contain edges between which angle is measured. Edges are selected in 3D OCC viewer or object browser.
144 .. py:function:: model.measureAngle(Part_doc, edge1, edge2)
146 :param part: The current part object.
147 :param object: A first edge in format *model.selection("TYPE", shape)*.
148 :param object: A second edge in format *model.selection("TYPE", shape)*.
149 :return: Calculated value.
154 **Angle by 3 points** calculates angle between the selected three points. The second point is in the corner of the angle.
156 .. image:: images/Measurement5.png
164 - **First point**, **Second point**, **Third point** contain point between which angle is measured. Points are selected in 3D OCC viewer or object browser.
168 .. py:function:: model.measureAngle(Part_doc, vertex1, vertex2, vertex3)
170 :param part: The current part object.
171 :param object: A first vertex in format *model.selection("TYPE", shape)*.
172 :param object: A second vertex in format *model.selection("TYPE", shape)*.
173 :param object: A third vertex in format *model.selection("TYPE", shape)*.
174 :return: Calculated value.