1 .. |axis_button.icon| image:: images/axis_button.png
6 Axis feature creates a new constructive axis line.
8 Axis is a construction object and it can be created in a part or in a partset. To create an axis:
10 #. select in the Main Menu *Construction - > Axis* item or
11 #. click |axis_button.icon| **Axis** button in the toolbar
13 There are 6 algorithms for creation of an Axis:
15 .. image:: images/axis_dxyz_32x32.png
17 **By three dimensions** creates an axis by dimensions along X, Y, Z axes starting form existing origin.
19 .. image:: images/by_two_points_32x32.png
21 **By two points** creates an axis using existing points.
23 .. image:: images/axis_by_line_32x32.png
25 **By line** creates an axis using a line.
27 .. image:: images/axis_by_line_32x32.png
29 **As an axis of cylindrical face** creates an axis using a cylindrical face.
31 .. image:: images/axis_by_line_32x32.png
33 **By plane and point** creates an axis using a plane and point.
35 .. image:: images/axis_by_line_32x32.png
37 **By two planes** creates an axis as the intersection of two planes.
42 .. image:: images/Axis1.png
46 **By dX, dY, dZ values**
48 An axis is defined by dX, dY and dZ values of a vector.
52 .. py:function:: model.addAxis(Part_doc, 10, 10, 10)
54 :param part: The current part object.
58 :return: Result object.
63 The Result of the operation will be an axis defined by vector from origin:
65 .. image:: images/CreatedAxis1.png
69 **Axis by three dimensions**
71 **See Also** a sample TUI Script of :ref:`tui_create_axis_xyz` operation.
77 .. image:: images/Axis2.png
83 An axis is defined by two points or vertices.
87 .. py:function:: model.addAxis(Part_doc, model.selection("VERTEX", "Box_1_1/Back&Box_1_1/Left&Box_1_1/Top"), model.selection("VERTEX", "Box_1_1/Front&Box_1_1/Right&Box_1_1/Bottom"))
89 :param part: The current part object.
90 :param object: Vertex 1.
91 :param object: Vertex 2.
92 :return: Result object.
94 **See Also** a sample TUI Script of :ref:`tui_create_axis_points` operation.
99 The Result of the operation will be an axis based on two points:
101 .. image:: images/CreatedAxis2.png
105 **Axis by two points**
107 **See Also** a sample TUI Script of :ref:`tui_create_axis_points` operation.
113 .. image:: images/Axis3.png
119 An axis is defined by a linear edge.
123 .. py:function:: model.addAxis(Part_doc, model.selection("EDGE", "Box_1_1/Left&Box_1_1/Top"))
125 :param part: The current part object.
127 :return: Result object.
132 The Result of the operation will be an axis based on the selected line:
134 .. image:: images/CreatedAxis3.png
140 **See Also** a sample TUI Script of :ref:`tui_create_axis_line` operation.
143 As an axis of cylindrical face
144 ------------------------------
146 .. image:: images/Axis4.png
152 An axis is defined by a cylindrical face. Axis of the cylinder will be an axis object.
156 .. py:function:: model.addAxis(Part_doc, model.selection("FACE", "Cylinder_1_1/Face_1"))
158 :param part: The current part object.
159 :param object: Cylindrical face.
160 :return: Result object.
165 The Result of the operation will be an axis of the selected cylinder:
167 .. image:: images/CreatedAxis4.png
171 **Axis cylindrical face**
173 **See Also** a sample TUI Script of :ref:`tui_create_axis_cylinder` operation.
179 .. image:: images/Axis5.png
183 **By a plane and point**
185 An axis is defined by a point or vertex and plane (or planar face) as a normal from the point to the plane.
189 .. py:function:: model.addAxis(Part_doc, model.selection("FACE", "Box_1_1/Front"), model.selection("VERTEX", "Box_1_1/Back&Box_1_1/Right&Box_1_1/Top"))
191 :param part: The current part object.
192 :param object: Plane.
193 :param object: Point.
194 :return: Result object.
199 The Result of the operation will be an axis:
201 .. image:: images/CreatedAxis5.png
205 **Axis by plane and point**
207 **See Also** a sample TUI Script of :ref:`tui_create_axis_plane` operation.
213 .. image:: images/Axis6.png
219 An axis is defined by two planes. The intersection of the planes defines an axis. It is possible to define offset for axis definition from both planes.
223 .. py:function:: model.addAxis(Part_doc, model.selection("FACE", "Box_1_1/Top"), 5, False, model.selection("FACE", "Box_1_1/Front"), 3, False)
225 :param part: The current part object.
226 :param object: Plane 1.
227 :param real: Offset value.
228 :param boolean: Is reversed.
229 :param object: Plane 2.
230 :param real: Offset value.
231 :param boolean: Is reversed.
232 :return: Result object.
237 The Result of the operation will be an axis:
239 .. image:: images/CreatedAxis6.png
243 **Axis by two planes**
245 **See Also** a sample TUI Script of :ref:`tui_create_axis_twoplanes` operation.