How to open result (MS Windows OS only)#

This tutorial demonstrates how to open and review results using workflow method.

Prerequisites#

Perform imports#

[1]:
import os
from pathlib import Path

from ansys.speos.core import Project, Speos
from ansys.speos.core.simulation import SimulationDirect

Define constants#

Constants help ensure consistency and avoid repetition throughout the example.

[2]:
HOSTNAME = "localhost"
GRPC_PORT = 50098  # Be sure the Speos GRPC Server has been started on this port.
FILE_NAME = "LG_50M_Colorimetric_short.sv5"
RESULT_NAME = "ASSEMBLY1.DS (0).Dom Irradiance Sensor (0).xmp"
USE_DOCKER = True  # Set to False if you're running this example locally as a Notebook.
USE_GPU = False

Model Setup#

Load assets#

The assets used to run this example are available in the PySpeos repository on GitHub.

Note: Make sure you have downloaded simulation assets and set assets_data_path to point to the assets folder.

[3]:
if USE_DOCKER:  # Running on the remote server.
    assets_data_path = Path("/app") / "assets"
else:
    assets_data_path = Path("/path/to/your/download/assets/directory")

Connect to the RPC Server#

This Python client connects to a server where the Speos engine is running as a service. In this example, the server and client are the same machine.

[4]:
speos = Speos(host=HOSTNAME, port=GRPC_PORT)

Create project from a Speos file#

The Project class is instantiated by passing a Speos instance and the name of the Speos project file.

[5]:
p = Project(
    speos=speos,
    path=str(assets_data_path / FILE_NAME / FILE_NAME),
)
print(p)
{
    "name": "LG_50M_Colorimetric_short",
    "description": "From /app/assets/LG_50M_Colorimetric_short.sv5/LG_50M_Colorimetric_short.sv5",
    "part_guid": "9d2c9c05-6901-4d06-84e8-545362f88949",
    "sources": [
        {
            "name": "Dom Source 2 (0) in SOURCE2",
            "metadata": {
                "UniqueId": "a564fe21-c3b5-48fe-bdf1-5d223dd4e3a3"
            },
            "source_guid": "57a871bb-70e5-4181-b21b-14634d63de70",
            "description": "",
            "source": {
                "name": "Dom Source 2 (0) in SOURCE2",
                "surface": {
                    "radiant_flux": {
                        "radiant_value": 6.590041607465698
                    },
                    "intensity_guid": "fbd7fbe4-cb02-409b-9d0e-2081db3e62db",
                    "exitance_constant": {
                        "geo_paths": [
                            {
                                "geo_path": "Solid Body in SOURCE2:2920204960/Face in SOURCE2:222",
                                "reverse_normal": false
                            }
                        ]
                    },
                    "spectrum_guid": "8c7a0322-6f53-4f04-a34d-319ec01272d1",
                    "intensity": {
                        "cos": {
                            "N": 1.0,
                            "total_angle": 180.0
                        },
                        "name": "",
                        "description": "",
                        "metadata": {}
                    },
                    "spectrum": {
                        "library": {
                            "file_uri": "/app/assets/LG_50M_Colorimetric_short.sv5/Red Spectrum.spectrum"
                        },
                        "name": "",
                        "description": "",
                        "metadata": {}
                    }
                },
                "description": "",
                "metadata": {}
            }
        },
        {
            "name": "Surface Source (0) in SOURCE1",
            "metadata": {
                "UniqueId": "6ce2f35d-6d29-4bed-9305-5e2b73873f36"
            },
            "source_guid": "fcb86a88-c4fb-4e00-9069-389cd35ae7d7",
            "description": "",
            "source": {
                "name": "Surface Source (0) in SOURCE1",
                "surface": {
                    "radiant_flux": {
                        "radiant_value": 9.290411220389682
                    },
                    "intensity_guid": "7f50465d-fb46-4922-b17c-0dd9bdbb7e6a",
                    "exitance_constant": {
                        "geo_paths": [
                            {
                                "geo_path": "Solid Body in SOURCE1:2494956811/Face in SOURCE1:187",
                                "reverse_normal": false
                            }
                        ]
                    },
                    "spectrum_guid": "725506f2-12a9-49ca-99fe-03802b57ea0e",
                    "intensity": {
                        "cos": {
                            "N": 1.0,
                            "total_angle": 180.0
                        },
                        "name": "",
                        "description": "",
                        "metadata": {}
                    },
                    "spectrum": {
                        "library": {
                            "file_uri": "/app/assets/LG_50M_Colorimetric_short.sv5/Blue Spectrum.spectrum"
                        },
                        "name": "",
                        "description": "",
                        "metadata": {}
                    }
                },
                "description": "",
                "metadata": {}
            }
        }
    ],
    "sensors": [
        {
            "name": "Dom Irradiance Sensor (0)",
            "metadata": {
                "UniqueId": "1806029f-2670-47cb-ae17-72b851034dc0"
            },
            "sensor_guid": "bee63e63-271a-4d7e-915b-66937619df94",
            "result_file_name": "ASSEMBLY1.DS (0).Dom Irradiance Sensor (0)",
            "description": "",
            "sensor": {
                "irradiance_sensor_template": {
                    "sensor_type_colorimetric": {
                        "wavelengths_range": {
                            "w_start": 400.0,
                            "w_end": 700.0,
                            "w_sampling": 25
                        }
                    },
                    "illuminance_type_planar": {},
                    "dimensions": {
                        "x_start": -20.0,
                        "x_end": 20.0,
                        "x_sampling": 500,
                        "y_start": -20.0,
                        "y_end": 20.0,
                        "y_sampling": 500
                    },
                    "axis_system": [
                        -42.0,
                        2.0,
                        5.0,
                        0.0,
                        1.0,
                        0.0,
                        0.0,
                        0.0,
                        -1.0,
                        -1.0,
                        0.0,
                        0.0
                    ],
                    "layer_type_source": {},
                    "integration_direction": [
                        1.0,
                        -0.0,
                        -0.0
                    ],
                    "ray_file_type": "RayFileNone"
                },
                "name": "Dom Irradiance Sensor (0)",
                "description": "",
                "metadata": {}
            }
        }
    ],
    "simulations": [
        {
            "name": "ASSEMBLY1.DS (0)",
            "metadata": {
                "UniqueId": "ae6de569-ed34-4981-96a9-faa27f14c593"
            },
            "simulation_guid": "beea6423-b3e8-4a56-8f4f-4a8756901d3f",
            "sensor_paths": [
                "Dom Irradiance Sensor (0)"
            ],
            "source_paths": [
                "Dom Source 2 (0) in SOURCE2",
                "Surface Source (0) in SOURCE1"
            ],
            "description": "",
            "simulation": {
                "direct_mc_simulation_template": {
                    "geom_distance_tolerance": 0.05,
                    "max_impact": 100,
                    "weight": {
                        "minimum_energy_percentage": 0.005
                    },
                    "dispersion": true,
                    "colorimetric_standard": "CIE_1931",
                    "fast_transmission_gathering": false,
                    "ambient_material_uri": ""
                },
                "name": "ASSEMBLY1.DS (0)",
                "metadata": {},
                "description": "",
                "scene_guid": "38265a55-e01b-4671-9d9c-2682c836bbad",
                "simulation_path": "ASSEMBLY1.DS (0)",
                "job_type": "CPU"
            }
        }
    ],
    "materials": [
        {
            "name": "Material.1",
            "metadata": {
                "UniqueId": "411e80d7-6259-4ba4-8d96-e3a7c02a0081"
            },
            "sop_guids": [
                "5f79f08f-ee7a-4abf-b32b-434c7380fe0f"
            ],
            "geometries": {
                "geo_paths": [
                    "Solid Body in GUIDE:1379760262/Face in GUIDE:169"
                ]
            },
            "description": "",
            "sops": [
                {
                    "mirror": {
                        "reflectance": 100.0
                    },
                    "name": "",
                    "description": "",
                    "metadata": {}
                }
            ]
        },
        {
            "name": "Material.2",
            "metadata": {
                "UniqueId": "0b65be57-8bb8-4c4c-b0ef-24461cd3869f"
            },
            "vop_guid": "b2574ad0-3a0d-4dd3-8681-a6b4a523bbb5",
            "sop_guids": [
                "f2ec8948-53de-42cb-88d3-fdc7d2c6995f"
            ],
            "geometries": {
                "geo_paths": [
                    "Solid Body in GUIDE:1379760262"
                ]
            },
            "description": "",
            "vop": {
                "optic": {
                    "index": 1.4,
                    "constringence": 60.0,
                    "absorption": 0.0
                },
                "name": "",
                "description": "",
                "metadata": {}
            },
            "sops": [
                {
                    "optical_polished": {},
                    "name": "",
                    "description": "",
                    "metadata": {}
                }
            ]
        },
        {
            "name": "Material.3",
            "metadata": {
                "UniqueId": "f59e7191-f912-489d-ba4f-5ac864494430"
            },
            "vop_guid": "e38a1f23-dcbc-4507-8def-19e6cb7176ff",
            "sop_guids": [
                "5f79f08f-ee7a-4abf-b32b-434c7380fe0f"
            ],
            "geometries": {
                "geo_paths": [
                    "Solid Body in SOURCE2:2920204960",
                    "Solid Body in SOURCE1:2494956811"
                ]
            },
            "description": "",
            "vop": {
                "opaque": {},
                "name": "",
                "description": "",
                "metadata": {}
            },
            "sops": [
                {
                    "mirror": {
                        "reflectance": 100.0
                    },
                    "name": "",
                    "description": "",
                    "metadata": {}
                }
            ]
        },
        {
            "name": "Material.4",
            "metadata": {
                "UniqueId": "017188f4-2966-4c61-baa9-34c73d6418a3"
            },
            "vop_guid": "63c6d186-ad26-4411-aa97-047e073c6ef3",
            "description": "",
            "sop_guids": [],
            "vop": {
                "optic": {
                    "index": 1.0,
                    "absorption": 0.0
                },
                "name": "",
                "description": "",
                "metadata": {}
            }
        }
    ],
    "metadata": {},
    "scenes": []
}
/home/runner/work/pyspeos/pyspeos/.venv/lib/python3.10/site-packages/ansys/speos/core/project.py:793: UserWarning: The pySpeos feature : SourceSurface needs a Speos Version of 2025 R2 SP0 or higher.
  src_feat = SourceSurface(
/home/runner/work/pyspeos/pyspeos/.venv/lib/python3.10/site-packages/ansys/speos/core/project.py:850: UserWarning: The pySpeos feature : SimulationDirect needs a Speos Version of 2025 R2 SP0 or higher.
  sim_feat = SimulationDirect(

Retrieve the simulation feature#

Use the method Project.find() to retrieve an instance of the SimulationDirect feature.

[6]:
sim = p.find(name=".*", name_regex=True, feature_type=SimulationDirect)[0]

Run simulation#

The simulation can be run using either the CPU or with GPU acceleration. The following cell shows how Python is used to assign the appropriate method to run_sim.

[7]:
run_sim = sim.compute_GPU if USE_GPU else sim.compute_CPU
results = run_sim()  # run the simulation
print(results)
[upload_response {
  info {
    uri: "2e751536-71eb-48e9-86c5-24cdcf9c8328"
    file_name: "ASSEMBLY1.DS (0).Dom Irradiance Sensor (0).xmp"
    file_size: 2160815
  }
  upload_duration {
    nanos: 2603272
  }
}
, upload_response {
  info {
    uri: "6a2fcf16-d242-4da1-bafa-c032dd418ac1"
    file_name: "ASSEMBLY1.DS (0).html"
    file_size: 646029
  }
  upload_duration {
    nanos: 902436
  }
}
]

Postprocessing#

Open the results (MS Windows OS only):#

Display one result as image.

A full path can be given, or the name of the result.

[8]:
if os.name == "nt":  # Are we running on Windows OS?
    from ansys.speos.core.workflow.open_result import open_result_image

    open_result_image(simulation_feature=sim, result_name=RESULT_NAME)

Display the image#

Display one result in a result viewer.

A full path can be given, or the name of the result.

[9]:
if os.name == "nt":
    from ansys.speos.core.workflow.open_result import open_result_in_viewer

    open_result_in_viewer(
        simulation_feature=sim,
        result_name=RESULT_NAME,
    )
speos.close()
[9]:
True