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
19 **By three dimensions** creates an axis by dimensions along X, Y, Z axes starting form existing origin.
21 .. image:: images/by_two_points_32x32.png
25 **By two points** creates an axis using existing points.
27 .. image:: images/axis_by_line_32x32.png
31 **By line** creates an axis using a line.
33 .. image:: images/cylindrical_face_32x32.png
37 **As an axis of cylindrical face** creates an axis using a cylindrical face.
39 .. image:: images/axis_by_plane_and_point_32x32.png
43 **By plane and point** creates an axis using a plane and point.
45 .. image:: images/axis_by_two_planes_32x32.png
49 **By two planes** creates an axis as the intersection of two planes.
51 --------------------------------------------------------------------------------
56 .. image:: images/Axis1.png
60 **By dX, dY, dZ values**
62 An axis is defined by dX, dY and dZ values of a vector.
66 .. py:function:: model.addAxis(Part_doc, 10, 10, 10)
68 :param part: The current part object.
72 :return: Result object.
77 The Result of the operation will be an axis defined by vector from origin:
79 .. image:: images/CreatedAxis1.png
83 **Axis by three dimensions**
85 **See Also** a sample TUI Script of :ref:`tui_create_axis_xyz` operation.
91 .. image:: images/Axis2.png
97 An axis is defined by two points or vertices.
101 .. 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"))
103 :param part: The current part object.
104 :param object: Vertex 1.
105 :param object: Vertex 2.
106 :return: Result object.
108 **See Also** a sample TUI Script of :ref:`tui_create_axis_points` operation.
113 The Result of the operation will be an axis based on two points:
115 .. image:: images/CreatedAxis2.png
119 **Axis by two points**
121 **See Also** a sample TUI Script of :ref:`tui_create_axis_points` operation.
127 .. image:: images/Axis3.png
133 An axis is defined by a linear edge.
137 .. py:function:: model.addAxis(Part_doc, model.selection("EDGE", "Box_1_1/Left&Box_1_1/Top"))
139 :param part: The current part object.
141 :return: Result object.
146 The Result of the operation will be an axis based on the selected line:
148 .. image:: images/CreatedAxis3.png
154 **See Also** a sample TUI Script of :ref:`tui_create_axis_line` operation.
157 As an axis of cylindrical face
158 ------------------------------
160 .. image:: images/Axis4.png
166 An axis is defined by a cylindrical face. Axis of the cylinder will be an axis object.
170 .. py:function:: model.addAxis(Part_doc, model.selection("FACE", "Cylinder_1_1/Face_1"))
172 :param part: The current part object.
173 :param object: Cylindrical face.
174 :return: Result object.
179 The Result of the operation will be an axis of the selected cylinder:
181 .. image:: images/CreatedAxis4.png
185 **Axis cylindrical face**
187 **See Also** a sample TUI Script of :ref:`tui_create_axis_cylinder` operation.
193 .. image:: images/Axis5.png
197 **By a plane and point**
199 An axis is defined by a point or vertex and plane (or planar face) as a normal from the point to the plane.
203 .. 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"))
205 :param part: The current part object.
206 :param object: Plane.
207 :param object: Point.
208 :return: Result object.
213 The Result of the operation will be an axis:
215 .. image:: images/CreatedAxis5.png
219 **Axis by plane and point**
221 **See Also** a sample TUI Script of :ref:`tui_create_axis_plane` operation.
227 .. image:: images/Axis6.png
233 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.
237 .. py:function:: model.addAxis(Part_doc, model.selection("FACE", "Box_1_1/Top"), 5, False, model.selection("FACE", "Box_1_1/Front"), 3, False)
239 :param part: The current part object.
240 :param object: Plane 1.
241 :param real: Offset value.
242 :param boolean: Is reversed.
243 :param object: Plane 2.
244 :param real: Offset value.
245 :param boolean: Is reversed.
246 :return: Result object.
251 The Result of the operation will be an axis:
253 .. image:: images/CreatedAxis6.png
257 **Axis by two planes**
259 **See Also** a sample TUI Script of :ref:`tui_create_axis_twoplanes` operation.