Moving car example by combining Speos files#

This tutorial demonstrates how to run moving car workflow use case. ## Prerequisites

Perform imports#

[1]:
import os
from pathlib import Path

from ansys.speos.core import Part, Speos, launcher
from ansys.speos.core.kernel.client import (
    default_docker_channel,
)
from ansys.speos.core.sensor import SensorCamera
from ansys.speos.core.simulation import SimulationInverse
from ansys.speos.core.source import SourceLuminaire
from ansys.speos.core.workflow.combine_speos import SpeosFileInstance, combine_speos

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.
CAR_NAMES = ["BlueCar", "RedCar"]
ENVIRONMENT_NAME = "Env_Simplified"
USE_DOCKER = True  # Set to False if you're running this example locally as a Notebook.
USE_GPU = False

Coordinate systems#

Define the global coordinate systems for each of the assets.

[3]:
GLOBAL_CS = [
    0,  # Origin x
    0,  # Origin y
    0,  # Origin z
    1,  # x-direction x
    0,  # x-direction y
    0,  # x-direction z
    0,  # y-direction x
    1,  # y-direction y
    0,  # y-direction z
    0,  # z-direction x
    0,  # z-direction y
    1,  # z-direction z
]
CAR_CS = {
    "red": [-4000, 0, 48000, 1.0, 0.0, 0.0, 0.0, 0.0, -1.0, 0.0, 1.0, 0.0],
    "blue": [2000, 0, 35000, 0.0, 0.0, -1.0, -1.0, 0.0, 0.0, 0.0, 1.0, 0.0],
}

Load assets#

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.

[4]:
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")
[5]:
# ## Create connection with speos rpc server
if USE_DOCKER:
    speos = Speos(channel=default_docker_channel())
else:
    speos = launcher.launch_local_speos_rpc_server(port=GRPC_PORT)
/home/runner/work/pyspeos/pyspeos/.venv/lib/python3.10/site-packages/ansys/tools/common/cyberchannel.py:187: UserWarning: Starting gRPC client without TLS on localhost:50098. This is INSECURE. Consider using a secure connection.
  warn(f"Starting gRPC client without TLS on {target}. This is INSECURE. Consider using a secure connection.")

Combine several speos files into one project#

Here we are building a project with:

  • An environment which is a road

  • A blue car

  • A red car

[6]:
full_env_path = assets_data_path / f"{ENVIRONMENT_NAME}.speos" / f"{ENVIRONMENT_NAME}.speos"
car_paths = [assets_data_path / f"{car}.speos" / f"{car}.speos" for car in CAR_NAMES]
assets = [
    SpeosFileInstance(
        speos_file=str(full_env_path),
        axis_system=GLOBAL_CS,
    ),
    SpeosFileInstance(
        speos_file=str(car_paths[0]),
        axis_system=CAR_CS["red"],
    ),
    SpeosFileInstance(
        speos_file=str(car_paths[1]),
        axis_system=CAR_CS["blue"],
    ),
]
p = combine_speos(
    speos=speos,
    speos_to_combine=assets,
)
/home/runner/work/pyspeos/pyspeos/.venv/lib/python3.10/site-packages/ansys/speos/core/project.py:719: UserWarning: The pySpeos feature : FaceStub.read_batch needs a Speos Version of 2025 R2 SP0 or higher.
  f_data_list = face_db.read_batch(refs=f_links)
[7]:
print(p)
{
    "part_guid": "9f3b6318-da88-418b-819a-e22c68e07321",
    "materials": [
        {
            "name": "Env_Simplified.Material.1",
            "metadata": {
                "UniqueId": "dcf7c3e6-7b8f-4c79-85cd-40ddf7e3d38e"
            },
            "vop_guid": "0bf9e8d4-e4d6-4cb7-b27c-8ebc2f0d52c4",
            "geometries": {
                "geo_paths": [
                    "Env_Simplified/Sidewalk:530980414"
                ]
            },
            "sop_guid": "38294bb9-4342-4e38-b7fa-74dfba31378d",
            "description": "",
            "sop_guids": [],
            "vop": {
                "opaque": {},
                "name": "",
                "description": "",
                "metadata": {}
            },
            "sop": {
                "library": {
                    "sop_file_uri": "/app/assets/Env_Simplified.speos/Side Walk_33b4-3fff-6c8d-7671..scattering"
                },
                "name": "",
                "description": "",
                "metadata": {}
            }
        },
        {
            "name": "Env_Simplified.Material.2",
            "metadata": {
                "UniqueId": "c49a32fa-9ab5-4022-a538-6d06afce0668"
            },
            "vop_guid": "0bf9e8d4-e4d6-4cb7-b27c-8ebc2f0d52c4",
            "geometries": {
                "geo_paths": [
                    "Env_Simplified/Solid:1195288205"
                ]
            },
            "sop_guid": "ea666f07-53e3-4afb-90d8-d8389de523d5",
            "description": "",
            "sop_guids": [],
            "vop": {
                "opaque": {},
                "name": "",
                "description": "",
                "metadata": {}
            },
            "sop": {
                "library": {
                    "sop_file_uri": "/app/assets/Env_Simplified.speos/RL_Road_107_6c27-753a-e5eb-38d0..anisotropicbsdf"
                },
                "name": "",
                "description": "",
                "metadata": {}
            }
        },
        {
            "name": "Env_Simplified.Material.3",
            "metadata": {
                "UniqueId": "7d1aefc1-0716-4781-bf31-7562632280a5"
            },
            "vop_guid": "0bf9e8d4-e4d6-4cb7-b27c-8ebc2f0d52c4",
            "geometries": {
                "geo_paths": [
                    "Env_Simplified/Sidewalk:895709635"
                ]
            },
            "sop_guid": "38294bb9-4342-4e38-b7fa-74dfba31378d",
            "description": "",
            "sop_guids": [],
            "vop": {
                "opaque": {},
                "name": "",
                "description": "",
                "metadata": {}
            },
            "sop": {
                "library": {
                    "sop_file_uri": "/app/assets/Env_Simplified.speos/Side Walk_33b4-3fff-6c8d-7671..scattering"
                },
                "name": "",
                "description": "",
                "metadata": {}
            }
        },
        {
            "name": "Env_Simplified.Material.4",
            "metadata": {
                "UniqueId": "afb50d00-396b-4a09-a8fa-fad31e7392fe"
            },
            "geometries": {
                "geo_paths": [
                    "Env_Simplified/Sidewalk:895709635/face.1:316406917",
                    "Env_Simplified/Sidewalk:895709635/face.1:1112941297"
                ]
            },
            "sop_guid": "b3d2f33d-933c-489c-b109-6bc73a096d66",
            "description": "",
            "sop_guids": [],
            "sop": {
                "library": {
                    "sop_file_uri": "/app/assets/Env_Simplified.speos/Grey Diffuse Paint_3635-3935-3d63-16d6..scattering"
                },
                "name": "",
                "description": "",
                "metadata": {}
            }
        },
        {
            "name": "Env_Simplified.Material.5",
            "metadata": {
                "UniqueId": "d5c61705-0ca6-407a-b648-575bc7f7c98a"
            },
            "vop_guid": "0bf9e8d4-e4d6-4cb7-b27c-8ebc2f0d52c4",
            "geometries": {
                "geo_paths": [
                    "Env_Simplified/Sidewalk:4000640054"
                ]
            },
            "sop_guid": "38294bb9-4342-4e38-b7fa-74dfba31378d",
            "description": "",
            "sop_guids": [],
            "vop": {
                "opaque": {},
                "name": "",
                "description": "",
                "metadata": {}
            },
            "sop": {
                "library": {
                    "sop_file_uri": "/app/assets/Env_Simplified.speos/Side Walk_33b4-3fff-6c8d-7671..scattering"
                },
                "name": "",
                "description": "",
                "metadata": {}
            }
        },
        {
            "name": "Env_Simplified.Material.6",
            "metadata": {
                "UniqueId": "079fe2cd-d7aa-47e1-813a-3b7860cc9f63"
            },
            "geometries": {
                "geo_paths": [
                    "Env_Simplified/Sidewalk:4000640054/face.1:4194215934",
                    "Env_Simplified/Sidewalk:4000640054/face.1:1230904683"
                ]
            },
            "sop_guid": "b3d2f33d-933c-489c-b109-6bc73a096d66",
            "description": "",
            "sop_guids": [],
            "sop": {
                "library": {
                    "sop_file_uri": "/app/assets/Env_Simplified.speos/Grey Diffuse Paint_3635-3935-3d63-16d6..scattering"
                },
                "name": "",
                "description": "",
                "metadata": {}
            }
        },
        {
            "name": "BlueCar.Material.1",
            "metadata": {
                "UniqueId": "17e0705a-af41-4ce7-9900-eaae450d16d9"
            },
            "geometries": {
                "geo_paths": [
                    "BlueCar/Solid:401601473/face.1:864256700",
                    "BlueCar/Solid:401601473/face.1:674884460",
                    "BlueCar/Solid:401601473/face.1:3652159984",
                    "BlueCar/Solid:401601473/face.1:4231287330",
                    "BlueCar/Solid:401601473/face.1:471414467",
                    "BlueCar/Solid:401601473/face.1:2300729220",
                    "BlueCar/Solid:401601473/face.1:574129345",
                    "BlueCar/Solid:401601473/face.1:452256235",
                    "BlueCar/Solid:401601473/face.1:302409131",
                    "BlueCar/Solid:401601473/face.1:2287208135",
                    "BlueCar/Solid:401601473/face.1:1496437263",
                    "BlueCar/Solid:401601473/face.1:1811732616",
                    "BlueCar/Solid:401601473/face.1:3482257894",
                    "BlueCar/Solid:401601473/face.1:3927233076",
                    "BlueCar/Solid:401601473/face.1:171554517",
                    "BlueCar/Solid:401601473/face.1:3342649904",
                    "BlueCar/Solid:401601473/face.1:1923399684",
                    "BlueCar/Solid:401601473/face.1:965965728",
                    "BlueCar/Solid:401601473/face.1:498577886",
                    "BlueCar/Solid:401601473/face.1:2290929817",
                    "BlueCar/Solid:401601473/face.1:1755427960",
                    "BlueCar/Solid:401601473/face.1:597033948",
                    "BlueCar/Solid:401601473/face.1:2378553484",
                    "BlueCar/Solid:401601473/face.1:395820000",
                    "BlueCar/Solid:401601473/face.1:3337776936",
                    "BlueCar/Solid:401601473/face.1:3915963223",
                    "BlueCar/Solid:401601473/face.1:2277816097",
                    "BlueCar/Solid:401601473/face.1:2625560305",
                    "BlueCar/Solid:401601473/face.1:103595421",
                    "BlueCar/Solid:401601473/face.1:3611912533",
                    "BlueCar/Solid:401601473/face.1:1347204289",
                    "BlueCar/Solid:401601473/face.1:2931020918",
                    "BlueCar/Solid:401601473/face.1:887207706",
                    "BlueCar/Solid:401601473/face.1:3850658770",
                    "BlueCar/Solid:401601473/face.1:4157302709",
                    "BlueCar/Solid:401601473/face.1:2618254917",
                    "BlueCar/Solid:401601473/face.1:2855086790",
                    "BlueCar/Solid:401601473/face.1:2772707565",
                    "BlueCar/Solid:401601473/face.1:2304452156",
                    "BlueCar/Solid:401601473/face.1:2745827269",
                    "BlueCar/Solid:401601473/face.1:2987588024",
                    "BlueCar/Solid:401601473/face.1:45237037",
                    "BlueCar/Solid:401601473/face.1:1887340406",
                    "BlueCar/Solid:401601473/face.1:994652370",
                    "BlueCar/Solid:401601473/face.1:552818946",
                    "BlueCar/Solid:401601473/face.1:1808068262",
                    "BlueCar/Solid:401601473/face.1:3774898119",
                    "BlueCar/Solid:401601473/face.1:3421668926",
                    "BlueCar/Solid:401601473/face.1:3662250051",
                    "BlueCar/Solid:401601473/face.1:3575677544",
                    "BlueCar/Solid:401601473/face.1:4181691577"
                ]
            },
            "sop_guid": "09a18bc0-1459-4de6-90da-2dab1ff32d0c",
            "description": "",
            "sop_guids": [],
            "sop": {
                "library": {
                    "sop_file_uri": "/app/assets/BlueCar.speos/Car_Paint_Material_Blue_365b-9ed1-1e57-eedd..brdf"
                },
                "name": "",
                "description": "",
                "metadata": {}
            }
        },
        {
            "name": "BlueCar.Material.2",
            "metadata": {
                "UniqueId": "c601162d-86b0-4557-a734-bf98d1918f79"
            },
            "geometries": {
                "geo_paths": [
                    "BlueCar/Solid:3252217597/face.1:1645799713",
                    "BlueCar/Solid:3252217597/face.1:3709259256",
                    "BlueCar/Solid:3252217597/face.1:3245061952",
                    "BlueCar/Solid:3252217597/face.1:1740077551",
                    "BlueCar/Solid:516754967/face.1:1903508963",
                    "BlueCar/Solid:516754967/face.1:3464173882",
                    "BlueCar/Solid:516754967/face.1:3523634050",
                    "BlueCar/Solid:516754967/face.1:1960488237",
                    "BlueCar/Solid:2263335813/face.1:4106343688",
                    "BlueCar/Solid:2263335813/face.1:1271919057",
                    "BlueCar/Solid:2263335813/face.1:1471318889",
                    "BlueCar/Solid:2263335813/face.1:4050535878",
                    "BlueCar/Solid:1920065013/face.1:2151688549",
                    "BlueCar/Solid:1920065013/face.1:1062079932",
                    "BlueCar/Solid:1920065013/face.1:590575364",
                    "BlueCar/Solid:1920065013/face.1:2247080363"
                ]
            },
            "sop_guid": "fe0b49b8-a7ea-4071-aac5-904f7ddfcc4e",
            "description": "",
            "sop_guids": [],
            "sop": {
                "library": {
                    "sop_file_uri": "/app/assets/BlueCar.speos/TireDiffusor_06ab-e65b-b541-c3ab..simplescattering"
                },
                "name": "",
                "description": "",
                "metadata": {}
            }
        },
        {
            "name": "BlueCar.Material.3",
            "metadata": {
                "UniqueId": "6b553931-60fa-49be-a037-415626c9effb"
            },
            "geometries": {
                "geo_paths": [
                    "BlueCar/Solid1:1003010499/face.1:3959360578",
                    "BlueCar/Solid1:1003010499/face.1:198338723",
                    "BlueCar/Solid1:1003010499/face.1:58624004",
                    "BlueCar/Solid1:1003010499/face.1:494376775",
                    "BlueCar/Solid1:1003010499/face.1:80289655",
                    "BlueCar/Solid1:1003010499/face.1:2640544264",
                    "BlueCar/Solid1:1003010499/face.1:979555788",
                    "BlueCar/Solid1:1003010499/face.1:1422834106",
                    "BlueCar/Solid1:1003010499/face.1:1333055594",
                    "BlueCar/Solid1:1003010499/face.1:3576083206",
                    "BlueCar/Solid1:1003010499/face.1:71526350",
                    "BlueCar/Solid1:1003010499/face.1:2202450522",
                    "BlueCar/Solid1:1003010499/face.1:2799526280",
                    "BlueCar/Solid1:1003010499/face.1:1190135145",
                    "BlueCar/Solid1:1003010499/face.1:3553322030",
                    "BlueCar/Solid1:1003010499/face.1:870711503",
                    "BlueCar/Solid1:1003010499/face.1:377346845",
                    "BlueCar/Solid1:1003010499/face.1:2109332205",
                    "BlueCar/Solid1:1003010499/face.1:3890985345",
                    "BlueCar/Solid1:1003010499/face.1:915303753",
                    "BlueCar/Solid1:1003010499/face.1:2466102311",
                    "BlueCar/Solid1:1003010499/face.1:3076941813",
                    "BlueCar/Solid1:1003010499/face.1:1464533780",
                    "BlueCar/Solid1:1003010499/face.1:2588835825",
                    "BlueCar/Solid1:1003010499/face.1:2053315344",
                    "BlueCar/Solid:2710379468/face.1:1829196173",
                    "BlueCar/Solid:2710379468/face.1:3160573253",
                    "BlueCar/Solid:2710379468/face.1:996628689",
                    "BlueCar/Solid:2710379468/face.1:577740154",
                    "BlueCar/Solid:2710379468/face.1:3259169179",
                    "BlueCar/Solid:2710379468/face.1:3889766985",
                    "BlueCar/Solid:2710379468/face.1:2306166335",
                    "BlueCar/Solid:2710379468/face.1:2463049711",
                    "BlueCar/Solid:2710379468/face.1:144524419",
                    "BlueCar/Solid:2710379468/face.1:3656945739",
                    "BlueCar/Solid:2169288061/face.1:3296663008",
                    "BlueCar/Solid:2169288061/face.1:354074920",
                    "BlueCar/Solid:2169288061/face.1:2451512508",
                    "BlueCar/Solid:2169288061/face.1:2333595927",
                    "BlueCar/Solid:2169288061/face.1:1799011830",
                    "BlueCar/Solid:2169288061/face.1:1319200292",
                    "BlueCar/Solid:2169288061/face.1:537725522",
                    "BlueCar/Solid:2169288061/face.1:1001874306",
                    "BlueCar/Solid:2169288061/face.1:2716139758",
                    "BlueCar/Solid:2169288061/face.1:1887491110"
                ]
            },
            "sop_guid": "49ffc0cb-13b7-491f-b712-3c515897b1fb",
            "description": "",
            "sop_guids": [],
            "sop": {
                "library": {
                    "sop_file_uri": "/app/assets/BlueCar.speos/Grey Diffuse Paint_5d78-9f5b-6612-4c7a..scattering"
                },
                "name": "",
                "description": "",
                "metadata": {}
            }
        },
        {
            "name": "RedCar.Material.1",
            "metadata": {
                "UniqueId": "0b24adcf-346d-4e86-b34b-a65082c55110"
            },
            "geometries": {
                "geo_paths": [
                    "RedCar/Solid:3635120264/face.1:1613122768",
                    "RedCar/Solid:3635120264/face.1:3094519244",
                    "RedCar/Solid:3635120264/face.1:3580074009",
                    "RedCar/Solid:3635120264/face.1:927409569",
                    "RedCar/Solid:2051257771/face.1:210648018",
                    "RedCar/Solid:2051257771/face.1:1637826055",
                    "RedCar/Solid:2051257771/face.1:66842235",
                    "RedCar/Solid:2051257771/face.1:2878201919",
                    "RedCar/Solid:739836401/face.1:3889611434",
                    "RedCar/Solid:739836401/face.1:1581167125",
                    "RedCar/Solid:739836401/face.1:4131961937",
                    "RedCar/Solid:739836401/face.1:3950733020",
                    "RedCar/Solid:635282113/face.1:3094435495",
                    "RedCar/Solid:635282113/face.1:268916963",
                    "RedCar/Solid:635282113/face.1:221545070",
                    "RedCar/Solid:635282113/face.1:3346128909"
                ]
            },
            "sop_guid": "fea87254-c2c5-4682-82c5-758a5ddf2ae2",
            "description": "",
            "sop_guids": [],
            "sop": {
                "library": {
                    "sop_file_uri": "/app/assets/RedCar.speos/TireDiffusor_a5c2-fa68-db22-4ccb..simplescattering"
                },
                "name": "",
                "description": "",
                "metadata": {}
            }
        },
        {
            "name": "RedCar.Material.2",
            "metadata": {
                "UniqueId": "719902fb-a02d-4c02-88e8-bb4f029d9d5c"
            },
            "geometries": {
                "geo_paths": [
                    "RedCar/Solid:39455731/face.1:1896962477",
                    "RedCar/Solid:39455731/face.1:3993234924",
                    "RedCar/Solid:39455731/face.1:669232533",
                    "RedCar/Solid:39455731/face.1:1809034615",
                    "RedCar/Solid:39455731/face.1:3571969486",
                    "RedCar/Solid:39455731/face.1:1185658288",
                    "RedCar/Solid:39455731/face.1:3291192008",
                    "RedCar/Solid:39455731/face.1:1891688472",
                    "RedCar/Solid:39455731/face.1:3563865060",
                    "RedCar/Solid:39455731/face.1:205034232",
                    "RedCar/Solid:39455731/face.1:1630115629"
                ]
            },
            "sop_guid": "a831e9c4-cad6-4ea7-b573-75ba61d07836",
            "description": "",
            "sop_guids": [],
            "sop": {
                "library": {
                    "sop_file_uri": "/app/assets/RedCar.speos/Red Diffuse Paint_c594-8c92-c39c-e0b0..scattering"
                },
                "name": "",
                "description": "",
                "metadata": {}
            }
        }
    ],
    "name": "",
    "description": "",
    "metadata": {},
    "sources": [],
    "sensors": [],
    "simulations": [],
    "scenes": []
}

Preview the project#

User can review the created/loaded project using preview method.

[8]:
p.preview()

Complete the project with sensor/source/simulation#

We are adding a camera sensor to have output results, a luminaire to have a light source.

And, we gather the source and the sensor into a simulation (we will compute it just after).

Create a sensor#

[9]:
ssr = p.create_sensor(name="Camera.1", feature_type=SensorCamera)
ssr.set_distortion_file_uri(
    uri=str(assets_data_path / "CameraInputFiles" / "CameraDistortion_190deg.OPTDistortion")
).set_mode_photometric().set_transmittance_file_uri(
    uri=str(assets_data_path / "CameraInputFiles" / "CameraTransmittance.spectrum")
).set_mode_color().set_red_spectrum_file_uri(
    uri=str(assets_data_path / "CameraInputFiles" / "CameraSensitivityRed.spectrum")
).set_blue_spectrum_file_uri(
    uri=str(assets_data_path / "CameraInputFiles" / "CameraSensitivityBlue.spectrum")
).set_green_spectrum_file_uri(
    uri=str(assets_data_path / "CameraInputFiles" / "CameraSensitivityGreen.spectrum")
)
ssr.set_axis_system([-2000, 1500, 11000, -1, 0, 0, 0, 1, 0, 0, 0, -1])
ssr.commit()
[9]:
<ansys.speos.core.sensor.SensorCamera at 0x7f4830918b20>

Create a source#

In this example, a luminaire source is created with an IES file.

More details on creating/editing source examples can be found in core examples.

[10]:
src = p.create_source(name="Luminaire.1", feature_type=SourceLuminaire)
src.set_intensity_file_uri(
    uri=str(assets_data_path / "IES_C_DETECTOR.ies")
).set_spectrum().set_daylightfluorescent()
src.set_axis_system([0, 10000, 50000, 1, 0, 0, 0, 1, 0, 0, 0, 1])

src.commit()
/home/runner/work/pyspeos/pyspeos/.venv/lib/python3.10/site-packages/ansys/speos/core/project.py:214: UserWarning: The pySpeos feature : SourceLuminaire needs a Speos Version of 2025 R2 SP0 or higher.
  feature = SourceLuminaire(
[10]:
<ansys.speos.core.source.SourceLuminaire at 0x7f483091bbe0>

Create a simulation#

More details on creating/editing simulation examples can be found in core examples.

[11]:
sim = p.create_simulation(name="Inverse.1", feature_type=SimulationInverse)
sim.set_sensor_paths(["Camera.1"]).set_source_paths(["Luminaire.1"])
sim.commit()
/home/runner/work/pyspeos/pyspeos/.venv/lib/python3.10/site-packages/ansys/speos/core/project.py:289: UserWarning: The pySpeos feature : SimulationInverse needs a Speos Version of 2025 R2 SP0 or higher.
  feature = SimulationInverse(
[11]:
<ansys.speos.core.simulation.SimulationInverse at 0x7f483091ad10>

Run the simulation#

Simulation can be run using CPU via compute_CPU method or using GPU via compute_GPU method.

[12]:
run_sim = sim.compute_GPU if USE_GPU else sim.compute_CPU
run_sim()  # Run the simulation
[12]:
[upload_response {
  info {
    uri: "348c6244-2d51-4ec5-a0d7-06a29881077e"
    file_name: "Camera.1.Irradiance.xmp"
    file_size: 10631039
  }
  upload_duration {
    nanos: 10399803
  }
}
, upload_response {
  info {
    uri: "f0545ce9-5145-4832-871f-9b5bbbfe0f74"
    file_name: "Camera.1.hdr"
    file_size: 518383
  }
  upload_duration {
    nanos: 998947
  }
}
, upload_response {
  info {
    uri: "53aebbd0-2d95-45b6-95a8-7436619e8d25"
    file_name: "Camera.1.xmp"
    file_size: 1793400
  }
  upload_duration {
    nanos: 2049405
  }
}
, upload_response {
  info {
    uri: "6632f98b-a876-407f-8a79-72b2d8d312ae"
    file_name: "Camera.1.png"
    file_size: 741655
  }
  upload_duration {
    nanos: 957229
  }
}
, upload_response {
  info {
    uri: "aa1486ea-1b83-431a-96f0-87b6adc76f3a"
    file_name: "Inverse.1.html"
    file_size: 998427
  }
  upload_duration {
    nanos: 1524782
  }
}
]

Check and review result#

Open result (only windows)

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

    open_result_image(simulation_feature=sim, result_name="Camera.1.png")

Modify part#

Move the part via changing the axis_system of a part.

axis_system is a list of 12 float values: x, y, z, x_vect_x, x_vect_y, x_vect_z, y_vect_x, y_vect_y, y_vect_z, z_vect_x, z_vect_y, z_vect_z.

[14]:
blue_car_sub_part = p.find(name="BlueCar", feature_type=Part.SubPart)[0]
blue_car_sub_part.set_axis_system([2000, 0.0, 20000, 0.0, 0.0, -1.0, -1.0, 0.0, 0.0, 0.0, 1.0, 0.0])
blue_car_sub_part.commit()
[14]:
<ansys.speos.core.part.Part.SubPart at 0x7f483db9e950>

Re-run simulation with the modified part position#

[15]:
run_sim()
[15]:
[upload_response {
  info {
    uri: "d45f88d5-21cd-4892-ac1e-be130c8c3e5e"
    file_name: "Camera.1.Irradiance.xmp"
    file_size: 10380528
  }
  upload_duration {
    nanos: 10496424
  }
}
, upload_response {
  info {
    uri: "06601f97-30c5-4bfc-b9e6-13e671c21beb"
    file_name: "Camera.1.hdr"
    file_size: 520329
  }
  upload_duration {
    nanos: 851606
  }
}
, upload_response {
  info {
    uri: "9cbd6270-4876-4377-ae55-f92e401f9e40"
    file_name: "Camera.1.xmp"
    file_size: 1763510
  }
  upload_duration {
    nanos: 2937831
  }
}
, upload_response {
  info {
    uri: "c561e04e-b020-414b-93c2-f23674e7ec06"
    file_name: "Camera.1.png"
    file_size: 729124
  }
  upload_duration {
    nanos: 1191241
  }
}
, upload_response {
  info {
    uri: "7ae0c1c7-887a-482e-a7d0-7610cb80bc64"
    file_name: "Inverse.1.html"
    file_size: 982214
  }
  upload_duration {
    nanos: 1176874
  }
}
]

Review result:

[16]:
if os.name == "nt":
    open_result_image(simulation_feature=sim, result_name="Camera.1.png")

Modify camera property#

Modify the camera, e.g. focal length to 10

[17]:
cam1 = p.find(name="Camera.1", feature_type=SensorCamera)[0]
cam1.set_focal_length(value=10)
cam1.commit()
[17]:
<ansys.speos.core.sensor.SensorCamera at 0x7f4830918b20>

Re-run the simulation and review result

[18]:
run_sim()
if os.name == "nt":
    open_result_image(simulation_feature=sim, result_name="Camera.1.png")
[19]:
speos.close()
[19]:
True