SimulationInverse

class ansys.speos.core.simulation.SimulationInverse(project, name, description='', metadata=None, simulation_instance=None, default_parameters=None)

Bases: BaseSimulation

Type of simulation : Inverse.

By default, geometry distance tolerance is set to 0.01, maximum number of impacts is set to 100, colorimetric standard is set to CIE 1931, dispersion is set to False, splitting is set to False, number of gathering rays per source is set to 1, maximum gathering error is set to 0, fast transmission gathering is set to False, ambient material URI is empty, and weight’s minimum energy percentage is set to 0.005. By default, the simulation will stop after 5 passes, with an automatic save frequency of 1800s.

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_parametersansys.speos.core.generic.parameters.InverseSimulationParameters, optional

If defined the values in the inverse simulation instance will be overwritten by the values of the data class.

Parameters:

• project (SimulationInverse.__init__.project)

• name (str)

• description (str)

• metadata (Optional[Mapping[str, str]])

• simulation_instance (Optional[ansys.speos.core.kernel.scene.ProtoScene.SimulationInstance])

• default_parameters (Optional[ansys.speos.core.generic.parameters.InverseSimulationParameters])

Overview

Methods

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.
commit	Save feature: send the local data to the speos server database.

Properties

dispersion	Activate/Deactivate the dispersion calculation.
splitting	Activate/Deactivate the splitting.
number_of_gathering_rays_per_source	The number of gathering rays per source.
maximum_gathering_error	The maximum gathering error.
ambient_material_file_uri	The ambient material file URI.
stop_condition_passes_number	To stop the simulation after a certain number of passes.
stop_condition_duration	The duration to stop the simulation.
automatic_save_frequency	The automatic save frequency.
light_expert	Whether light expert is enabled.

Import detail

from ansys.speos.core.simulation import SimulationInverse

Property detail

property SimulationInverse.dispersion: bool

Activate/Deactivate the dispersion calculation.

Returns:

bool

True if dispersion is activated.

property SimulationInverse.splitting: bool

Activate/Deactivate the splitting.

To split each propagated ray into several paths at their first impact after leaving the observer point.

Parameters:

valuebool

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

Returns:

ansys.speos.core.simulation.SimulationInverse

Inverse simulation

property SimulationInverse.number_of_gathering_rays_per_source: int

The number of gathering rays per source.

Returns:

int

The number of gathering rays per source.

property SimulationInverse.maximum_gathering_error: int

The maximum gathering error.

Returns:

int

The maximum gathering error.

property SimulationInverse.ambient_material_file_uri: str

The ambient material file URI.

Returns:

str

The ambient material file URI.

property SimulationInverse.stop_condition_passes_number: int

To stop the simulation after a certain number of passes.

Set None as value to have no condition about passes.

Parameters:

valueint, optional

The number of passes requested. Or None if no condition about passes. By default, 5.

Returns:

int

property SimulationInverse.stop_condition_duration: int | None

The duration to stop the simulation.

Returns:

Optional[int]

The duration in seconds, or None if no condition.

property SimulationInverse.automatic_save_frequency: int

The automatic save frequency.

This option is useful when computing long simulations. But a reduced number of save operations naturally increases the simulation performance.

Returns:

int

The save frequency in seconds.

property SimulationInverse.light_expert: bool

Whether light expert is enabled.

Returns:

bool

True if light expert is enabled.

Method detail

SimulationInverse.set_weight()

Activate weight. Highly recommended to fill.

Returns:

ansys.speos.core.simulation.BaseSimulation.Weight

Weight

SimulationInverse.set_weight_none()

Deactivate weight.

Returns:

ansys.speos.core.simulation.SimulationInverse

Inverse simulation

SimulationInverse.set_colorimetric_standard_CIE_1931()

Set the colorimetric standard to CIE 1931.

2 degrees CIE Standard Colorimetric Observer Data.

Returns:

ansys.speos.core.simulation.SimulationInverse

Inverse simulation

SimulationInverse.set_colorimetric_standard_CIE_1964()

Set the colorimetric standard to CIE 1964.

10 degrees CIE Standard Colorimetric Observer Data.

Returns:

ansys.speos.core.simulation.SimulationInverse

Inverse simulation

SimulationInverse.commit()

Save feature: send the local data to the speos server database.

Returns:

ansys.speos.core.simulation.SimulationInverse

Simulation feature.

Classes

SourceSampling

Disabled - Setting source sampling is not available for this simulation type.