Download this example

Download this example as a Jupyter Notebook or as a Python script.

---

Modeling: Surface bodies and trimmed surfaces

This example shows how to trim different surfaces, and how to use those surfaces to create surface bodies.

Create a surface

Create a sphere surface. This can be done without launching the modeler.

from ansys.geometry.core.shapes.surfaces import Sphere
from ansys.geometry.core.math import Point3D

surface = Sphere(origin=Point3D([0, 0, 0]), radius=1)

Now get information on how the surface is defined and parameterized.

surface.parameterization()

(Parameterization(form=ParamForm.PERIODIC, type=ParamType.CIRCULAR, interval=Interval(start=0, end=6.283185307179586)),
 Parameterization(form=ParamForm.CLOSED, type=ParamType.OTHER, interval=Interval(start=-1.5707963267948966, end=1.5707963267948966)))

Trim the surface

For a sphere, its parametization is (u: [0, 2*pi], v:[-pi/2, pi/2]), where u corresponds to longitude and v corresponds to latitude. You can trim a surface by providing new parameters.

from ansys.geometry.core.shapes.box_uv import BoxUV
from ansys.geometry.core.shapes.parameterization import Interval
import math

trimmed_surface = surface.trim(BoxUV(range_u=Interval(0, math.pi), range_v=Interval(0, math.pi/2)))

From a TrimmedSurface, you can always refer back to the underlying Surface if needed.

trimmed_surface.geometry

<ansys.geometry.core.shapes.surfaces.sphere.Sphere at 0x299963a6c00>

Create a surface body

Now create a surface body by launching the modeler session and providing the trimmed surface. Then plot the body to see how you created a quarter of a sphere as a surface body.

from ansys.geometry.core import launch_modeler

modeler = launch_modeler()
print(modeler)

Ansys Geometry Modeler (0x299a9f3d700)

Ansys Geometry Modeler Client (0x299a9ec03b0)
  Target:     localhost:700
  Connection: Healthy

design = modeler.create_design("SurfaceBodyExample")
body = design.create_body_from_surface("trimmed_sphere", trimmed_surface)
design.plot()

If the sphere was left untrimmed, it would create a solid body since the surface is fully closed. In this case, since the surface was open, it created a surface body.

This same process can be used with other surfaces including: - Cone - Cylinder - Plane - Torus

Each surface has its own unique parameterization, which must be understood before trying to trim it.

Close session

When you finish interacting with your modeling service, you should close the active server session. This frees resources wherever the service is running.

Close the server session.

modeler.close()

---

Download this example

Download this example as a Jupyter Notebook or as a Python script.