# --- # jupyter: # jupytext: # default_lexer: ipython3 # text_representation: # extension: .py # format_name: percent # format_version: '1.3' # jupytext_version: 1.19.4 # --- # %% [markdown] # # Modeling: Boolean operations # # This example shows how to use Boolean operations for geometry manipulation. # %% [markdown] # ## Perform required imports # # Perform the required imports. # %% from ansys.geometry.core import launch_modeler from ansys.geometry.core.designer import Body from ansys.geometry.core.math import Point2D from ansys.geometry.core.misc import UNITS from ansys.geometry.core.plotting import GeometryPlotter from ansys.geometry.core.sketch import Sketch # %% [markdown] # ## Launch local modeler # # Launch the local modeler. If you are not familiar with how to launch the local # modeler, see the "Launch a modeling service" section in the # [PyAnsys Geometry 101: Modeling](../01_getting_started/04_modeling.mystnb) example. # %% modeler = launch_modeler() print(modeler) # %% [markdown] # ## Define bodies # # This section defines the bodies to use the Boolean operations on. First you create sketches # of a box and a circle, and then you extrude these sketches to create 3D objects. # # ### Create sketches # # Create sketches of a box and a circle that serve as the basis for your bodies. # %% # Create a sketch of a box sketch_box = Sketch().box(Point2D([0, 0], unit=UNITS.m), width=30 * UNITS.m, height=40 * UNITS.m) # Create a sketch of a circle (overlapping the box slightly) sketch_circle = Sketch().circle(Point2D([20, 0], unit=UNITS.m), radius=10 * UNITS.m) # %% [markdown] # ### Extrude sketches # # After the sketches are created, extrude them to create 3D objects. # %% # Create a design design = modeler.create_design("example_design") # Extrude both sketches to get a prism and a cylinder prism = design.extrude_sketch("Prism", sketch_box, 50 * UNITS.m) cylin = design.extrude_sketch("Cylinder", sketch_circle, 50 * UNITS.m) # %% [markdown] # You must extrude the sketches each time that you perform an example operation. # This is because performing a Boolean operation modifies the underlying # design permanently. Thus, you no longer have two bodies. As shown in the Boolean # operations themselves, whenever you pass in a body, it is consumed, and so it no # longer exists. The remaining body (with the performed Boolean operation) is the one # that performed the call to the method. # %% [markdown] # ## Select bodies # # You can optionally select bodies in the plotter as described in the "Select objects # interactively" section in the [PyAnsys Geometry 101: Plotter](../01_getting_started/05_plotter_picker.mystnb) # example. As shown in this example, the plotter preserves the picking order, meaning that the # output list is sorted according to the picking order. # # ```python # pl = GeometryPlotter(allow_picking=True) # pl.plot(design.bodies) # pl.show() # bodies: list[Body] = GeometryPlotter(allow_picking=True).show(design.bodies) # ``` # # Otherwise, you can select bodies from the design directly. # %% bodies = [design.bodies[0], design.bodies[1]] # %% [markdown] # ## Perform Boolean operations # # This section performs Boolean operations on the defined bodies using the PyAnsys Geometry # library. It explores intersection, union, and subtraction operations. # # ### Perform an intersection operation # # To perform an intersection operation on the bodies, first # set up the bodies. # %% # Create a design design = modeler.create_design("intersection_design") # Extrude both sketches to get a prism and a cylinder prism = design.extrude_sketch("Prism", sketch_box, 50 * UNITS.m) cylin = design.extrude_sketch("Cylinder", sketch_circle, 50 * UNITS.m) # %% [markdown] # Perform the intersection and plot the results. # %% prism.intersect(cylin) _ = GeometryPlotter().show(design.bodies) # %% [markdown] # The final remaining body is the ``prism`` body because # the ``cylin`` body has been consumed. # %% print(design.bodies) # %% [markdown] # ### Perform a union operation # # To carry out a union operation on the bodies, first # set up the bodies. # %% # Create a design design = modeler.create_design("union_design") # Extrude both sketches to get a prism and a cylinder prism = design.extrude_sketch("Prism", sketch_box, 50 * UNITS.m) cylin = design.extrude_sketch("Cylinder", sketch_circle, 50 * UNITS.m) # %% [markdown] # Perform the union and plot the results. # %% prism.unite(cylin) _ = GeometryPlotter().show(design.bodies) # %% [markdown] # The final remaining body is the ``prism`` body because # the ``cylin`` body has been consumed. # %% print(design.bodies) # %% [markdown] # ### Perform a subtraction operation # # To perform a subtraction operation on the bodies, first # set up the bodies. # %% # Create a design design = modeler.create_design("subtraction_design") # Extrude both sketches to get a prism and a cylinder prism = design.extrude_sketch("Prism", sketch_box, 50 * UNITS.m) cylin = design.extrude_sketch("Cylinder", sketch_circle, 50 * UNITS.m) # %% [markdown] # Perform the subtraction and plot the results. # %% prism.subtract(cylin) _ = GeometryPlotter().show(design.bodies) # %% [markdown] # The final remaining body is the ``prism`` body because # the ``cylin`` body has been consumed. # %% print(design.bodies) # %% [markdown] # If you perform this action inverting the order of the bodies (that is, # ``cylin.subtract(prism)``, you can see the difference in the resulting # shape of the body. # %% # Create a design design = modeler.create_design("subtraction_design_inverted") # Extrude both sketches to get a prism and a cylinder prism = design.extrude_sketch("Prism", sketch_box, 50 * UNITS.m) cylin = design.extrude_sketch("Cylinder", sketch_circle, 50 * UNITS.m) # Invert subtraction cylin.subtract(prism) _ = GeometryPlotter().show(design.bodies) # %% [markdown] # In this case, the final remaining body is the ``cylin`` body because # the ``prism`` body has been consumed. # %% print(design.bodies) # %% [markdown] # ### Close the modeler # # Close the modeler to release the resources. # %% modeler.close() # %% [markdown] # ## Summary # # These Boolean operations provide powerful tools for creating complex geometries # and combining or modifying existing shapes in meaningful ways. # # Feel free to experiment with different shapes, sizes, and arrangements to further # enhance your understanding of Boolean operations in PyAnsys Geometry and their applications.