create_ellipse#

Modeler3D.create_ellipse(orientation, origin, major_radius, ratio, is_covered=True, name=None, material=None, segments=0, **kwargs)[source]#

Create an ellipse.

Parameters:

orientationstr or int: Coordinate system plane for orienting the ellipse. ansys.aedt.core.constants.PLANE Enumerator can be used as input.
originlist: List of [x, y, z] coordinates for the center point of the ellipse.
major_radiusfloat: Base radius of the ellipse.
ratiofloat: Aspect ratio of the secondary radius to the base radius.
is_coveredbool, optional: Whether the ellipse is covered. The default is True, in which case the result is a 2D sheet object. If False, the result is a closed 1D polyline object.
namestr, optional: Name of the ellipse. The default is None, in which case the default name is assigned.
materialstr, optional: Name of the material. The default is None, in which case the default material is assigned.
segmentsint, optional: Number of segments to apply to create the segmented geometry. The default is 0.
**kwargsoptional: Additional keyword arguments may be passed when creating the primitive to set properties. See ansys.aedt.core.modeler.cad.object_3d.Object3d for more details.

Returns:

ansys.aedt.core.modeler.cad.object_3d.Object3d: 3D object.

References

>>> oEditor.CreateEllipse

Examples

The following example shows how to create an ellipse in HFSS. The required parameters are cs_plane, position, major_radius, ratio, and is_covered. The cs_plane parameter provides the plane that the ellipse is designed on. The position parameter provides the origin of the ellipse. The major_radius parameter provides the radius of the ellipse. The ratio parameter is a ratio between the major radius and minor radius of the ellipse. The is_covered parameter is a flag indicating if the ellipse is covered.

The optional parameter matname allows you to set the material name of the ellipse. The optional parameter name allows you to assign a name to the ellipse.

This method applies to all 3D applications: HFSS, Q3D, Icepak, Maxwell 3D, and Mechanical.

>>> from ansys.aedt.core import Hfss
>>> aedtapp = Hfss()
>>> ellipse = aedtapp.modeler.create_ellipse(orientation='Z', origin=[0,0,0],
...                                          major_radius=2, ratio=2, is_covered=True, name="myell",
...                                          material="vacuum")