+.. |Sphere_button.icon| image:: images/Sphere_button.png
Sphere
======
-Sphere feature creates a sphere solid.
+Sphere feature creates a sphere solid or a part of a sphere solid.
To create a Sphere in the active part:
#. select in the Main Menu *Primitives - > Sphere* item or
-#. click **Sphere** button in the toolbar
+#. click |Sphere_button.icon| **Sphere** button in the toolbar
-.. image:: images/Sphere_button.png
- :align: center
+There are 2 algorithms for creation of a Sphere
-.. centered::
- **Sphere** button
+.. figure:: images/sphere_32x32.png
+ :align: left
+ :height: 24px
-The following property panel appears.
+**By a center and a radius**
-.. image:: images/Sphere.png
- :align: center
+.. figure:: images/sphere_part_32x32.png
+ :align: left
+ :height: 24px
+
+**By radii (inner and outer) and angle limits (theta and phi)**
+
+--------------------------------------------------------------------------------
+
+By a center and a radius
+------------------------
+
+Sphere is created by a center (origin by default) and a radius.
+
+.. figure:: images/Sphere_full.png
+ :align: center
-.. centered::
- Sphere property panel
-
Input fields:
- **Point** defines the center of the sphere selected in 3D OCC viewer or object browser;
- **Radius** defines the radius.
+
+**TUI Command**:
+
+.. py:function:: model.addSphere(Part_doc, Point, Radius)
-**TUI Command**: *model.addSphere(Part_doc, Point, Radius)*.
+ :param part: The current part object.
+ :param object: Vertex.
+ :param real: Radius.
+ :return: Result object.
+
+Result
+""""""
+
+A solid sphere based on the origin and a radius.
+
+.. figure:: images/Sphere1.png
+ :align: center
+
+**See Also** a sample TUI Script of a :ref:`tui_create_sphere` operation.
+
+By radii (inner and outer) and angle limits (theta and phi)
+-----------------------------------------------------------
+
+Part of sphere is created by radii (inner and outer) and angle limits (phi and theta).
+
+.. figure:: images/Sphere_part.png
+ :align: center
+
+Input fields:
-**Arguments**: Part + 1 vertex + 1 real value (radius).
+- **RMin** defines the inner radius;
+- **RMax** defines the outer radius;
+- **PhiMin** defines the lower phi limit;
+- **PhiMax** defines the higher phi limit;
+- **ThetaMin** defines the lower theta limit;
+- **ThetaMax** defines the higher theta limit.
+
+**TUI Command**:
+
+.. py:function:: model.addSphere(Part_doc, RMin, RMax, PhiMin, PhiMax, ThetaMin, ThetaMax)
+
+ :param part: The current part object.
+ :param real: Inner radius.
+ :param real: Outer radius.
+ :param real: Lower phi.
+ :param real: Hiher phi.
+ :param real: Lower theta.
+ :param real: Hiher theta.
+ :return: Result object.
Result
""""""
-An example is shown below.
+A solid sphere based on the origin with radii (inner and outer) and angles (phi and theta).
-.. image:: images/Sphere_res.png
- :align: center
-
-.. centered::
- Sphere created
+.. figure:: images/Sphere2.png
+ :align: center
-**See Also** a sample TUI Script of :ref:`tui_create_sphere` operation.
+**See Also** a sample TUI Script of a :ref:`tui_create_part_sphere` operation.
+
+
+
