create_circle#

Modeler3D.create_circle(orientation, origin, radius, num_sides=0, is_covered=True, name=None, material=None, non_model=False, **kwargs)#

Create a circle.

Parameters:
orientationstr or int

Coordinate system plane for orienting the circle. ansys.aedt.core.constants.PLANE Enumerator can be used as input.

originlist

List of [x, y, z] coordinates for the center point of the circle.

radiusfloat

Radius of the circle.

num_sidesint, optional

Number of sides. The default is 0, which is correct for a circle.

namestr, optional

Name of the circle. 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.

non_modelbool, optional

Either if create the new object as model or non-model. The default is False.

**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.CreateCircle

Examples

The following example shows how to create a circle in HFSS. The required parameters are cs_plane, position, radius, and num_sides. The cs_plane parameter provides the plane that the circle is designed on. The position parameter provides the origin of the circle. The radius and num_sides parameters provide the radius and number of discrete sides of the circle,

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

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

>>> from ansys.aedt.core import Hfss
>>> aedtapp = Hfss()
>>> circle_object = aedtapp.modeler.create_circle(orientation='Z', origin=[0,0,0],
...                                                   radius=2, num_sides=8, name="mycyl",
...                                                   material="vacuum")