.. |axis_button.icon|    image:: images/axis_button.png

Axis
====

Axis feature creates a new constructive axis line.

Axis is a construction object and it can be created in a part or in a partset. To create an axis:

#. select in the Main Menu *Construction - > Axis* item  or
#. click |axis_button.icon| **Axis** button in the toolbar

There are 6 algorithms for creation of an Axis:

.. figure:: images/axis_dxyz_32x32.png
   :align: left
   :height: 24px

**By three dimensions** creates an axis by dimensions along X, Y, Z axes starting form existing origin.

.. figure:: images/by_two_points_32x32.png
   :align: left
   :height: 24px

**By two points** creates an axis using existing points.

.. figure:: images/axis_by_line_32x32.png
   :align: left
   :height: 24px

**By line** creates an axis using a line.

.. figure:: images/cylindrical_face_32x32.png
   :align: left
   :height: 24px

**As an axis of cylindrical face** creates an axis using a cylindrical face.

.. figure:: images/axis_by_plane_and_point_32x32.png
   :align: left
   :height: 24px

**By plane and point** creates an axis using a plane and point.

.. figure:: images/axis_by_two_planes_32x32.png
   :align: left
   :height: 24px

**By two planes** creates an axis as the intersection of two planes.

--------------------------------------------------------------------------------

By three dimensions
-------------------

.. figure:: images/Axis1.png
   :align: center

   **By dX, dY, dZ values**

An axis is defined by dX, dY and dZ values of a vector.

**TUI Commands**:

.. py:function:: model.addAxis(Part_doc, 10, 10, 10)

    :param part: The current part object.
    :param real: dX.
    :param real: dY.
    :param real: dZ.
    :return: Result object.

Result
""""""

The Result of the operation will be an axis defined by vector from origin:

.. figure:: images/CreatedAxis1.png
   :align: center

   **Axis by three dimensions**

**See Also** a sample TUI Script of :ref:`tui_create_axis_xyz` operation.


By two points
-------------

.. figure:: images/Axis2.png
   :align: center

   **By two points**

An axis is defined by two points or vertices.

**TUI Commands**:

.. 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"))

    :param part: The current part object.
    :param object: Vertex 1.
    :param object: Vertex 2.
    :return: Result object.

**See Also** a sample TUI Script of :ref:`tui_create_axis_points` operation.

Result
""""""

The Result of the operation will be an axis based on two points:

.. figure:: images/CreatedAxis2.png
   :align: center

   **Axis by two points**

**See Also** a sample TUI Script of :ref:`tui_create_axis_points` operation.


By line
-------

.. figure:: images/Axis3.png
   :align: center

   **By a line**

An axis is defined by a linear edge.

**TUI Commands**:

.. py:function:: model.addAxis(Part_doc, model.selection("EDGE", "Box_1_1/Left&Box_1_1/Top"))

    :param part: The current part object.
    :param object: Edge.
    :return: Result object.

Result
""""""

The Result of the operation will be an axis based on the selected line:

.. figure:: images/CreatedAxis3.png
   :align: center

   **Axis by line**

**See Also** a sample TUI Script of :ref:`tui_create_axis_line` operation.


As an axis of cylindrical face
------------------------------

.. figure:: images/Axis4.png
   :align: center

   **By a cylinder**

An axis is defined by a cylindrical face. Axis of the cylinder will be an axis object.

**TUI Commands**:

.. py:function:: model.addAxis(Part_doc, model.selection("FACE", "Cylinder_1_1/Face_1"))

    :param part: The current part object.
    :param object: Cylindrical face.
    :return: Result object.

Result
""""""

The Result of the operation will be an axis of the selected cylinder:

.. figure:: images/CreatedAxis4.png
   :align: center

   **Axis cylindrical face**

**See Also** a sample TUI Script of :ref:`tui_create_axis_cylinder` operation.


By plane and point
------------------

.. figure:: images/Axis5.png
   :align: center

   **By a plane and point**

An axis is defined by a point or vertex and plane (or planar face) as a normal from the point to the plane.

**TUI Commands**:

.. 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"))

    :param part: The current part object.
    :param object: Plane.
    :param object: Point.
    :return: Result object.

Result
""""""

The Result of the operation will be an axis:

.. figure:: images/CreatedAxis5.png
   :align: center

   **Axis by plane and point**

**See Also** a sample TUI Script of :ref:`tui_create_axis_plane` operation.


By two planes
-------------

.. figure:: images/Axis6.png
   :align: center

   **By two planes**

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.

**TUI Commands**:

.. py:function:: model.addAxis(Part_doc, model.selection("FACE", "Box_1_1/Top"), 5, False, model.selection("FACE", "Box_1_1/Front"), 3, False)

    :param part: The current part object.
    :param object: Plane 1.
    :param real: Offset value.
    :param boolean: Is reversed.
    :param object: Plane 2.
    :param real: Offset value.
    :param boolean: Is reversed.
    :return: Result object.

Result
""""""

The Result of the operation will be an axis:

.. figure:: images/CreatedAxis6.png
   :align: center

   **Axis by two planes**

**See Also** a sample TUI Script of :ref:`tui_create_axis_twoplanes` operation.