`Project`#

class ansys.speos.core.project.Project(speos, path='')#

A project describes all Speos features.

This includes optical properties, sources, sensors, simulations that user can fill in. Project provides functions to create new feature, find a feature. It can be created from empty or loaded from a specific file.

Parameters:

speosansys.speos.core.speos.Speos: Speos session (connected to gRPC server).
pathstr: The project will be loaded from this speos file. By default, "", means create from empty.

Attributes:

scene_linkansys.speos.core.kernel.scene.SceneLink: Link object for the scene in database.

Parameters:

speos (ansys.speos.core.speos.Speos)
path (str)

Overview#

Methods

`create_optical_property`	Create a new Optical Property feature.
`create_source`	Create a new Source feature.
`create_simulation`	Create a new Simulation feature.
`create_sensor`	Create a new Sensor feature.
`create_root_part`	Create the project root part feature.
`find`	Find feature(s) by name (possibility to use regex) and by feature type.
`delete`	Delete project: erase scene data.
`get`	Get dictionary corresponding to the project - read only.
`find_key`	Get values corresponding to the key in project dictionary - read only.
`preview`	Preview cad bodies inside the project’s scene.

Attributes

`client`	Speos instance client.
`scene_link`	Link object for the scene in database.

Special methods

__str__

Return the string representation of the project’s scene.

Import detail#

from ansys.speos.core.project import Project

Attribute detail#

Project.client#: Speos instance client.

Project.scene_link#: Link object for the scene in database.

Method detail#

Project.create_optical_property(name, description='', metadata=None)#

Create a new Optical Property feature.

Parameters:

namestr: Name of the feature.
descriptionstr: Description of the feature. By default, "".
metadataOptional[Mapping[str, str]]: Metadata of the feature. By default, {}.

Returns:

ansys.speos.core.opt_prop.OptProp: OptProp feature.

Project.create_source(name, description='', feature_type=SourceSurface, metadata=None)#

Create a new Source feature.

Parameters:

namestr: Name of the feature.
descriptionstr: Description of the feature. By default, "".
feature_type: type: Source type to be created. By default, ansys.speos.core.source.SourceSurface. Allowed types: Union[ansys.speos.core.source.SourceSurface, ansys.speos.core.source.SourceRayFile, ansys.speos.core.source.SourceLuminaire].
metadataOptional[Mapping[str, str]]: Metadata of the feature. By default, {}.

Returns:

Union[ansys.speos.core.source.SourceSurface,ansys.speos.core.source.SourceRayFile, ansys.speos.core.source.SourceLuminaire]: Source class instance.

Project.create_simulation(name, description='', feature_type=SimulationDirect, metadata=None)#

Create a new Simulation feature.

Parameters:

namestr: Name of the feature.
descriptionstr: Description of the feature. By default, "".
feature_type: type: Simulation type to be created. By default, ansys.speos.core.simulation.SimulationDirect. Allowed types: Union[ansys.speos.core.simulation.SimulationDirect, ansys.speos.core.simulation.SimulationInteractive, ansys.speos.core.simulation.SimulationInverse].
metadataOptional[Mapping[str, str]]: Metadata of the feature. By default, {}.

Returns:

Union[ansys.speos.core.simulation.SimulationDirect, ansys.speos.core.simulation.SimulationInteractive, ansys.speos.core.simulation.SimulationInverse]: Simulation class instance

Project.create_sensor(name, description='', feature_type=SensorIrradiance, metadata=None)#

Create a new Sensor feature.

Parameters:

namestr: Name of the feature.
descriptionstr: Description of the feature. By default, "".
feature_type: type: Sensor type to be created. By default, ansys.speos.core.sensor.SensorIrradiance. Allowed types: Union[ansys.speos.core.sensor.SensorCamera, ansys.speos.core.sensor.SensorRadiance, ansys.speos.core.sensor.SensorIrradiance].
metadataOptional[Mapping[str, str]]: Metadata of the feature. By default, {}.

Returns:

Union[ansys.speos.core.sensor.SensorCamera, ansys.speos.core.sensor.SensorRadiance, ansys.speos.core.sensor.SensorIrradiance]: Sensor class instance.

Project.create_root_part(description='', metadata=None)#

Create the project root part feature.

If a root part is already created in the project, it is returned.

Parameters:

descriptionstr: Description of the feature. By default, "".
metadataOptional[Mapping[str, str]]: Metadata of the feature. By default, {}.

Returns:

ansys.speos.core.part.Part: Part feature.

Project.find(name, name_regex=False, feature_type=None)#

Find feature(s) by name (possibility to use regex) and by feature type.

Parameters:

namestr: Name of the feature.
name_regexbool: Allows to use regex for name parameter. By default, False, means that regex is not used for name parameter.
feature_typetype: Type of the wanted features. Mandatory to fill for geometry features. By default, None, means that all features will be considered (except geometry features).

Returns:

List[Union[ansys.speos.core.opt_prop.OptProp, ansys.speos.core.source.Surface, ansys.speos.core.source.RayFile, ansys.speos.core.source.Luminaire, ansys.speos.core.sensor.Camera, ansys.speos.core.sensor.Radiance, ansys.speos.core.sensor.Irradiance, ansys.speos.core.simulation.Direct, ansys.speos.core.simulation.Interactive, ansys.speos.core.simulation.Inverse, ansys.speos.core.part.Part, ansys.speos.core.body.Body, ansys.speos.core.face.Face, ansys.speos.core.part.Part.SubPart]]: Found features.

Examples

>>> # From name only
>>> find(name="Camera.1")
>>> # Specify feature type
>>> find(name="Camera.1", feature_type=ansys.speos.core.sensor.SensorCamera)
>>> # Using regex
>>> find(
>>>     name="Camera.*",
>>>     name_regex=True,
>>>     feature_type=ansys.speos.core.sensor.SensorCamera,
>>> )
Here some examples when looking for a geometry feature:
(always precise feature_type)

>>> # Root part
>>> find(name="", feature_type=ansys.speos.core.part.Part)
>>> # Body in root part
>>> find(name="BodyName", feature_type=ansys.speos.core.body.Body)
>>> # Face from body in root part
>>> find(name="BodyName/FaceName", feature_type=ansys.speos.core.face.Face)
>>> # Sub part in root part
>>> find(name="SubPartName", feature_type=ansys.speos.core.part.Part.SubPart)
>>> # Face in a body from sub part in root part :
>>> find(name="SubPartName/BodyName/FaceName", feature_type=ansys.speos.core.face.Face)
>>> # Regex can be use at each level separated by "/"
>>> find(name="Body.*/Face.*", name_regex=True, feature_type=ansys.speos.core.face.Face)
>>> # All faces of a specific body
>>> find(name="BodyName/.*", name_regex=True, feature_type=ansys.speos.core.face.Face)
>>> # All geometry features at first level (whatever their type: body, face, sub part)
>>> find(name=".*", name_regex=True, feature_type=ansys.speos.core.part.Part)

Project.delete()#

Delete project: erase scene data.

Delete all features contained in the project.

Returns:

ansys.speos.core.project.Project: Project feature.

Project.get()#: Get dictionary corresponding to the project - read only.

Project.find_key(key)#

Get values corresponding to the key in project dictionary - read only.

Parameters:

keystr: Key to search in the project dictionary.

Returns:

List[tuple[str, dict]]: List of matching objects containing for each its x_path and its value.

Project.__str__()#: Return the string representation of the project’s scene.

Project.preview(viz_args=None)#

Preview cad bodies inside the project’s scene.

Parameters:

viz_argsdict: contains arguments in dict format passed to add mesh function e.g. - {‘style’: ‘wireframe’}, - {‘style’: ‘surface’, ‘color’:’white’}, - {‘opacity’: 0.7, ‘color’:’white’, ‘show_edges’: False},

Project#

Overview#

Import detail#

Attribute detail#

Method detail#

`Project`#