`Design`#

class ansys.geometry.core.designer.design.Design(name: str, modeler: ansys.geometry.core.modeler.Modeler, read_existing_design: bool = False)#

Bases: ansys.geometry.core.designer.component.Component

Provides for organizing geometry assemblies.

This class synchronizes to a supporting Geometry service instance.

Parameters:

namestr: User-defined label for the design.
grpc_clientGrpcClient: Active supporting Geometry service instance for design modeling.
read_existing_designbool, default: False: Whether an existing design on the service should be read. This parameter is only valid when connecting to an existing service session. Otherwise, avoid using this optional parameter.

Overview#

Methods

`close`	Close the design.
`add_material`	Add a material to the design.
`save`	Save a design to disk on the active Geometry server instance.
`download`	Export and download the design from the server.
`export_to_scdocx`	Export the design to an scdocx file.
`export_to_parasolid_text`	Export the design to a Parasolid text file.
`export_to_parasolid_bin`	Export the design to a Parasolid binary file.
`export_to_fmd`	Export the design to an FMD file.
`export_to_step`	Export the design to a STEP file.
`export_to_iges`	Export the design to an IGES file.
`export_to_pmdb`	Export the design to a PMDB file.
`create_named_selection`	Create a named selection on the active Geometry server instance.
`delete_named_selection`	Delete a named selection on the active Geometry server instance.
`delete_component`	Delete a component (itself or its children).
`set_shared_topology`	Set the shared topology to apply to the component.
`add_beam_circular_profile`	Add a new beam circular profile under the design for creating beams.
`add_midsurface_thickness`	Add a mid-surface thickness to a list of bodies.
`add_midsurface_offset`	Add a mid-surface offset type to a list of bodies.
`delete_beam_profile`	Remove a beam profile on the active geometry server instance.
`insert_file`	Insert a file into the design.

Properties

`design_id`	The design’s object unique id.
`materials`	List of materials available for the design.
`named_selections`	List of named selections available for the design.
`beam_profiles`	List of beam profile available for the design.
`is_active`	Whether the design is currently active.
`is_closed`	Whether the design is closed.

Special methods

__repr__

Represent the Design as a string.

Import detail#

from ansys.geometry.core.designer.design import Design

Property detail#

property Design.design_id: str#: The design’s object unique id.

property Design.materials: list[ansys.geometry.core.materials.material.Material]#: List of materials available for the design.

property Design.named_selections: list[ansys.geometry.core.designer.selection.NamedSelection]#: List of named selections available for the design.

property Design.beam_profiles: list[ansys.geometry.core.designer.beam.BeamProfile]#: List of beam profile available for the design.

property Design.is_active: bool#: Whether the design is currently active.

property Design.is_closed: bool#: Whether the design is closed.

Method detail#

Design.close() → None#: Close the design.

Design.add_material(material: ansys.geometry.core.materials.material.Material) → None#

Add a material to the design.

Parameters:

materialMaterial: Material to add.

Design.save(file_location: pathlib.Path | str) → None#

Save a design to disk on the active Geometry server instance.

Parameters:

file_locationPath | str: Location on disk to save the file to.

Design.download(file_location: pathlib.Path | str, format: DesignFileFormat = DesignFileFormat.SCDOCX) → None#

Export and download the design from the server.

Parameters:

file_locationPath | str: Location on disk to save the file to.
formatDesignFileFormat, default: DesignFileFormat.SCDOCX: Format for the file to save to.

Design.export_to_scdocx(location: pathlib.Path | str | None = None) → pathlib.Path#

Export the design to an scdocx file.

Parameters:

locationPath | str, optional: Location on disk to save the file to. If None, the file will be saved in the current working directory.

Returns:

Path: The path to the saved file.

Design.export_to_parasolid_text(location: pathlib.Path | str | None = None) → pathlib.Path#

Export the design to a Parasolid text file.

Parameters:

locationPath | str, optional: Location on disk to save the file to. If None, the file will be saved in the current working directory.

Returns:

Path: The path to the saved file.

Design.export_to_parasolid_bin(location: pathlib.Path | str | None = None) → pathlib.Path#

Export the design to a Parasolid binary file.

Parameters:

locationPath | str, optional: Location on disk to save the file to. If None, the file will be saved in the current working directory.

Returns:

Path: The path to the saved file.

Design.export_to_fmd(location: pathlib.Path | str | None = None) → pathlib.Path#

Export the design to an FMD file.

Parameters:

locationPath | str, optional: Location on disk to save the file to. If None, the file will be saved in the current working directory.

Returns:

Path: The path to the saved file.

Design.export_to_step(location: pathlib.Path | str | None = None) → pathlib.Path#

Export the design to a STEP file.

Parameters:

locationPath | str, optional: Location on disk to save the file to. If None, the file will be saved in the current working directory.

Returns:

Path: The path to the saved file.

Design.export_to_iges(location: pathlib.Path | str = None) → pathlib.Path#

Export the design to an IGES file.

Parameters:

locationPath | str, optional: Location on disk to save the file to. If None, the file will be saved in the current working directory.

Returns:

Path: The path to the saved file.

Design.export_to_pmdb(location: pathlib.Path | str | None = None) → pathlib.Path#

Export the design to a PMDB file.

Parameters:

locationPath | str, optional: Location on disk to save the file to. If None, the file will be saved in the current working directory.

Returns:

Path: The path to the saved file.

Design.create_named_selection(name: str, bodies: list[ansys.geometry.core.designer.body.Body] | None = None, faces: list[ansys.geometry.core.designer.face.Face] | None = None, edges: list[ansys.geometry.core.designer.edge.Edge] | None = None, beams: list[ansys.geometry.core.designer.beam.Beam] | None = None, design_points: list[ansys.geometry.core.designer.designpoint.DesignPoint] | None = None) → ansys.geometry.core.designer.selection.NamedSelection#

Create a named selection on the active Geometry server instance.

Parameters:

namestr: User-defined name for the named selection.
bodieslist[Body], default: None: All bodies to include in the named selection.
faceslist[Face], default: None: All faces to include in the named selection.
edgeslist[Edge], default: None: All edges to include in the named selection.
beamslist[Beam], default: None: All beams to include in the named selection.
design_pointslist[DesignPoint], default: None: All design points to include in the named selection.

Returns:

NamedSelection: Newly created named selection that maintains references to all target entities.

Design.delete_named_selection(named_selection: ansys.geometry.core.designer.selection.NamedSelection | str) → None#

Delete a named selection on the active Geometry server instance.

Parameters:

named_selectionNamedSelection | str: Name of the named selection or instance.

Design.delete_component(component: ansys.geometry.core.designer.component.Component | str) → None#

Delete a component (itself or its children).

Parameters:

idUnion[Component, str]: Name of the component or instance to delete.

Raises:

ValueError: The design itself cannot be deleted.

Notes

If the component is not this component (or its children), it is not deleted.

Design.set_shared_topology(share_type: ansys.geometry.core.designer.component.SharedTopologyType) → None#

Set the shared topology to apply to the component.

Parameters:

share_typeSharedTopologyType: Shared topology type to assign.

Raises:

ValueError: Shared topology does not apply to a design.

Add a new beam circular profile under the design for creating beams.

Parameters:

namestr: User-defined label for the new beam circular profile.
radiusQuantity | Distance: Radius of the beam circular profile.
centerndarray | RealSequence | Point3D: Center of the beam circular profile.
direction_xndarray | RealSequence | UnitVector3D | Vector3D: X-plane direction.
direction_yndarray | RealSequence | UnitVector3D | Vector3D: Y-plane direction.

Design.add_midsurface_thickness(thickness: pint.Quantity, bodies: list[ansys.geometry.core.designer.body.Body]) → None#

Add a mid-surface thickness to a list of bodies.

Parameters:

thicknessQuantity: Thickness to be assigned.
bodieslist[Body]: All bodies to include in the mid-surface thickness assignment.

Notes

Only surface bodies will be eligible for mid-surface thickness assignment.

Design.add_midsurface_offset(offset_type: ansys.geometry.core.designer.body.MidSurfaceOffsetType, bodies: list[ansys.geometry.core.designer.body.Body]) → None#

Add a mid-surface offset type to a list of bodies.

Parameters:

offset_typeMidSurfaceOffsetType: Surface offset to be assigned.
bodieslist[Body]: All bodies to include in the mid-surface offset assignment.

Notes

Only surface bodies will be eligible for mid-surface offset assignment.

Design.delete_beam_profile(beam_profile: ansys.geometry.core.designer.beam.BeamProfile | str) → None#

Remove a beam profile on the active geometry server instance.

Parameters:

beam_profileBeamProfile | str: A beam profile name or instance that should be deleted.

Design.insert_file(file_location: pathlib.Path | str) → ansys.geometry.core.designer.component.Component#

Insert a file into the design.

Parameters:

file_locationPath | str: Location on disk where the file is located.

Returns:

Component: The newly inserted component.

Design.__repr__() → str#: Represent the Design as a string.

Design#

Overview#

Import detail#

Property detail#

Method detail#

`Design`#