sphere#

Mapdl.sphere(rad1='', rad2='', theta1='', theta2='', **kwargs)[source]#

Create a spherical volume centered about the working plane origin.

APDL Command: SPHERE

Defines either a solid or hollow sphere or spherical sector centered about the working plane origin. The sphere must have a spatial volume greater than zero. (i.e., this volume primitive command cannot be used to create a degenerate volume as a means of creating an area.) Inaccuracies can develop when the size of the object you create is much smaller than the relative coordinate system values (ratios near to or greater than 1000). If you require an exceptionally small sphere, create a larger object, and scale it down to the appropriate size.

For a solid sphere of 360°, you define it with two areas, each consisting of a hemisphere. See the sph4 and sph5 commands for the other ways to create spheres.

Parameters:
rad1, rad2

Inner and outer radii (either order) of the sphere. A value of zero or blank for either rad1 or rad2 defines a solid sphere.

theta1, theta2

Starting and ending angles (either order) of the sphere. Used for creating a spherical sector. The sector begins at the algebraically smaller angle, extends in a positive angular direction, and ends at the larger angle. The starting angle defaults to 0.0° and the ending angle defaults to 360.0°. See the Modeling and Meshing Guide for an illustration.

Returns:
int

Volume number of the sphere.

Return type:

int

Examples

>>> vnum = mapdl.sphere(rad1=0.95, rad2=1.0, theta1=90, theta2=270)
>>> vnum
1