`SimulationInteractive`#

class ansys.speos.core.simulation.SimulationInteractive(project, name, description='', metadata=None, simulation_instance=None, default_values=True)#

Bases: BaseSimulation

Type of simulation : Interactive.

By default, geometry distance tolerance is set to 0.01, maximum number of impacts is set to 100, a colorimetric standard is set to CIE 1931, ambient material URI is empty, and weight’s minimum energy percentage is set to 0.005. By default, each source will send 100 rays. By default, the simulation deactivates both light expert and impact report.

Parameters:

projectansys.speos.core.project.Project: Project in which simulation shall be created.
namestr: Name of the simulation.
descriptionstr: Description of the Simulation. By default, "".
metadataOptional[Mapping[str, str]]: Metadata of the feature. By default, {}.
simulation_instanceansys.api.speos.scene.v2.scene_pb2.Scene.SimulationInstance, optional: Simulation instance to provide if the feature does not have to be created from scratch By default, None, means that the feature is created from scratch by default.
default_valuesbool: Uses default values when True.

Parameters:

project (SimulationInteractive.__init__.project)
name (str)
description (str)
metadata (Optional[Mapping[str, str]])
simulation_instance (Optional[ansys.speos.core.kernel.scene.ProtoScene.SimulationInstance])
default_values (bool)

Overview#

Methods

`set_geom_distance_tolerance`	Set the geometry distance tolerance.
`set_max_impact`	Define a value to determine the maximum number of ray impacts during propagation.
`set_weight`	Activate weight. Highly recommended to fill.
`set_weight_none`	Deactivate weight.
`set_colorimetric_standard_CIE_1931`	Set the colorimetric standard to CIE 1931.
`set_colorimetric_standard_CIE_1964`	Set the colorimetric standard to CIE 1964.
`set_ambient_material_file_uri`	To define the environment in which the light will propagate (water, fog, smoke etc.).
`set_rays_number_per_sources`	Select the number of rays emitted for each source.
`set_light_expert`	Activate/Deactivate the generation of light expert file.
`set_impact_report`	Activate/Deactivate the details in the HTML simulation report.

Import detail#

from ansys.speos.core.simulation import SimulationInteractive

Method detail#

SimulationInteractive.set_geom_distance_tolerance(value=0.01)#

Set the geometry distance tolerance.

Parameters:

valuefloat: Maximum distance in mm to consider two faces as tangent. By default, 0.01

Returns:

ansys.speos.core.simulation.SimulationInteractive: Interactive simulation

SimulationInteractive.set_max_impact(value=100)#

Define a value to determine the maximum number of ray impacts during propagation.

When a ray has interacted N times with the geometry, the propagation of the ray stops.

Parameters:

valueint: The maximum number of impacts. By default, 100.

Returns:

ansys.speos.core.simulation.SimulationInteractive: Interactive simulation

SimulationInteractive.set_weight()#

Activate weight. Highly recommended to fill.

Returns:

ansys.speos.core.simulation.BaseSimulation.Weight: Simulation.Weight

SimulationInteractive.set_weight_none()#

Deactivate weight.

Returns:

ansys.speos.core.simulation.SimulationInteractive: Interactive simulation

SimulationInteractive.set_colorimetric_standard_CIE_1931()#

Set the colorimetric standard to CIE 1931.

2 degrees CIE Standard Colorimetric Observer Data.

Returns:

ansys.speos.core.simulation.SimulationInteractive: Interactive simulation

SimulationInteractive.set_colorimetric_standard_CIE_1964()#

Set the colorimetric standard to CIE 1964.

10 degrees CIE Standard Colorimetric Observer Data.

Returns:

ansys.speos.core.simulation.SimulationInteractive: Interactive simulation

SimulationInteractive.set_ambient_material_file_uri(uri='')#

To define the environment in which the light will propagate (water, fog, smoke etc.).

Parameters:

uristr: The ambient material, expressed in a .material file. By default, "", means air as ambient material.

Returns:

ansys.speos.core.simulation.SimulationInteractive: Interactive simulation

SimulationInteractive.set_rays_number_per_sources(values)#

Select the number of rays emitted for each source.

If a source is present in the simulation but not referenced here, it will send by default 100 rays.

Parameters:

valuesList[ansys.speos.core.simulation.SimulationInteractive.RaysNumberPerSource]: List of rays number emitted by source.

Returns:

ansys.speos.core.simulation.SimulationInteractive: Interactive simulation

SimulationInteractive.set_light_expert(value=False)#

Activate/Deactivate the generation of light expert file.

Parameters:

valuebool: Activate/Deactivate. By default, False, means deactivate.

Returns:

ansys.speos.core.simulation.SimulationInteractive: Interactive simulation

SimulationInteractive.set_impact_report(value=False)#

Activate/Deactivate the details in the HTML simulation report.

e.g: number of impacts, position and surface state

Parameters:

valuebool: Activate/Deactivate. By default, False, means deactivate.

Returns:

ansys.speos.core.simulation.SimulationInteractive: Interactive simulation

Classes#

RaysNumberPerSource

Structure to describe the number of rays requested for a specific source.

SimulationInteractive#

Overview#

Import detail#

Method detail#

Classes#

`SimulationInteractive`#