Torus
#
- class ansys.geometry.core.shapes.surfaces.torus.Torus(origin: beartype.typing.Union[numpy.ndarray, ansys.geometry.core.typing.RealSequence, ansys.geometry.core.math.point.Point3D], major_radius: beartype.typing.Union[pint.Quantity, ansys.geometry.core.misc.measurements.Distance, ansys.geometry.core.typing.Real], minor_radius: beartype.typing.Union[pint.Quantity, ansys.geometry.core.misc.measurements.Distance, ansys.geometry.core.typing.Real], reference: beartype.typing.Union[numpy.ndarray, ansys.geometry.core.typing.RealSequence, ansys.geometry.core.math.vector.UnitVector3D, ansys.geometry.core.math.vector.Vector3D] = UNITVECTOR3D_X, axis: beartype.typing.Union[numpy.ndarray, ansys.geometry.core.typing.RealSequence, ansys.geometry.core.math.vector.UnitVector3D, ansys.geometry.core.math.vector.Vector3D] = UNITVECTOR3D_Z)#
Bases:
ansys.geometry.core.shapes.surfaces.surface.Surface
Provides 3D torus representation.
- Parameters:
- origin
Union
[ndarray
,RealSequence
,Point3D
], Centered origin of the torus.
- direction_x
Union
[ndarray
,RealSequence
,UnitVector3D
,Vector3D
] X-axis direction.
- direction_y
Union
[ndarray
,RealSequence
,UnitVector3D
,Vector3D
] Y-axis direction.
- major_radius
Union
[Quantity
,Distance
,Real
] Major radius of the torus.
- minor_radius
Union
[Quantity
,Distance
,Real
] Minor radius of the torus.
- origin
Overview#
Check a parameter is within the parametric range of the surface. |
|
Check a point is contained by the surface. |
Create a transformed copy of the torus from a transformation matrix. |
|
Create a mirrored copy of the torus along the y-axis. |
|
Evaluate the torus at the given parameters. |
|
Parameterize the torus surface as a tuple (U and V respectively). |
|
Project a point onto the torus and evaluate the torus. |
Origin of the torus. |
|
Semi-major radius of the torus. |
|
Semi-minor radius of the torus. |
|
X-direction of the torus. |
|
Y-direction of the torus. |
|
Z-direction of the torus. |
|
Volume of the torus. |
|
Surface_area of the torus. |
Equals operator for the |
Import detail#
from ansys.geometry.core.shapes.surfaces.torus import Torus
Property detail#
- property Torus.origin: ansys.geometry.core.math.point.Point3D#
Origin of the torus.
- property Torus.major_radius: pint.Quantity#
Semi-major radius of the torus.
- property Torus.minor_radius: pint.Quantity#
Semi-minor radius of the torus.
- property Torus.dir_x: ansys.geometry.core.math.vector.UnitVector3D#
X-direction of the torus.
- property Torus.dir_y: ansys.geometry.core.math.vector.UnitVector3D#
Y-direction of the torus.
- property Torus.dir_z: ansys.geometry.core.math.vector.UnitVector3D#
Z-direction of the torus.
- property Torus.volume: pint.Quantity#
Volume of the torus.
- property Torus.surface_area: pint.Quantity#
Surface_area of the torus.
Method detail#
- Torus.transformed_copy(matrix: ansys.geometry.core.math.matrix.Matrix44) Torus #
Create a transformed copy of the torus from a transformation matrix.
- Parameters:
- matrix
Matrix44
4x4 transformation matrix to apply to the torus.
- matrix
- Returns:
Torus
New torus that is the transformed copy of the original torus.
- Torus.mirrored_copy() Torus #
Create a mirrored copy of the torus along the y-axis.
- Returns:
Torus
New torus that is a mirrored copy of the original torus.
- Torus.evaluate(parameter: ansys.geometry.core.shapes.parameterization.ParamUV) TorusEvaluation #
Evaluate the torus at the given parameters.
- Parameters:
- parameter
ParamUV
Parameters (u,v) to evaluate the torus at.
- parameter
- Returns:
TorusEvaluation
Resulting evaluation.
- Torus.parameterization() beartype.typing.Tuple[ansys.geometry.core.shapes.parameterization.Parameterization, ansys.geometry.core.shapes.parameterization.Parameterization] #
Parameterize the torus surface as a tuple (U and V respectively).
The U parameter specifies the longitude angle, increasing clockwise (east) about the axis (right-hand corkscrew law). It has a zero parameter at
Geometry.Frame.DirX
and a period of2*pi
.The V parameter specifies the latitude, increasing north, with a zero parameter at the equator. For the donut, where the major radius is greater than the minor radius, the range is [-pi, pi] and the parameterization is periodic. For a degenerate torus, the range is restricted accordingly and the parameterization is non-periodic.
- Returns:
Tuple
[Parameterization
,Parameterization
]Information about how a torus’s u and v parameters are parameterized, respectively.
- Torus.project_point(point: ansys.geometry.core.math.point.Point3D) TorusEvaluation #
Project a point onto the torus and evaluate the torus.
- Parameters:
- point
Point3D
Point to project onto the torus.
- point
- Returns:
TorusEvaluation
Resulting evaluation.
- abstract Torus.contains_param(param_uv: ansys.geometry.core.shapes.parameterization.ParamUV) bool #
Check a parameter is within the parametric range of the surface.
- abstract Torus.contains_point(point: ansys.geometry.core.math.point.Point3D) bool #
Check a point is contained by the surface.
The point can either lie within the surface or on its boundary.