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
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")

Create connection with speos rpc server#

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

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:698: 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": "d5bd6369-2af5-418f-8def-22a26fc9e253",
    "materials": [
        {
            "name": "Env_Simplified.Material.1",
            "metadata": {
                "UniqueId": "778c03ca-c327-4736-96a6-3fadeeb3a9b8"
            },
            "vop_guid": "ef2ddffc-c6c6-483f-9a38-116a3cdea0d8",
            "geometries": {
                "geo_paths": [
                    "Env_Simplified/Solid:1195288205"
                ]
            },
            "sop_guid": "2780cbed-ad8b-4903-a2cf-f24f56404ac1",
            "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.2",
            "metadata": {
                "UniqueId": "d8240fd1-560d-4139-86f6-387c2969c626"
            },
            "vop_guid": "ef2ddffc-c6c6-483f-9a38-116a3cdea0d8",
            "geometries": {
                "geo_paths": [
                    "Env_Simplified/Sidewalk:530980414"
                ]
            },
            "sop_guid": "7f374584-afae-407b-ab38-e42c2406f1b3",
            "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.3",
            "metadata": {
                "UniqueId": "d8fac4d5-553b-4b4a-a186-50dae8510023"
            },
            "vop_guid": "ef2ddffc-c6c6-483f-9a38-116a3cdea0d8",
            "geometries": {
                "geo_paths": [
                    "Env_Simplified/Sidewalk:895709635"
                ]
            },
            "sop_guid": "7f374584-afae-407b-ab38-e42c2406f1b3",
            "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": "f771d805-e64f-4c7b-9122-134caf2ba26c"
            },
            "geometries": {
                "geo_paths": [
                    "Env_Simplified/Sidewalk:895709635/face.1:316406917",
                    "Env_Simplified/Sidewalk:895709635/face.1:1112941297"
                ]
            },
            "sop_guid": "cace8e5f-3321-485e-b8ae-97400512579c",
            "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": "ee1cab97-26f2-4de7-983a-fa9ee3df84ee"
            },
            "vop_guid": "ef2ddffc-c6c6-483f-9a38-116a3cdea0d8",
            "geometries": {
                "geo_paths": [
                    "Env_Simplified/Sidewalk:4000640054"
                ]
            },
            "sop_guid": "7f374584-afae-407b-ab38-e42c2406f1b3",
            "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": "11666795-64ed-4aa0-ae31-7a60dd4c4176"
            },
            "geometries": {
                "geo_paths": [
                    "Env_Simplified/Sidewalk:4000640054/face.1:4194215934",
                    "Env_Simplified/Sidewalk:4000640054/face.1:1230904683"
                ]
            },
            "sop_guid": "cace8e5f-3321-485e-b8ae-97400512579c",
            "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": "4a7400b6-95cc-4dae-a1cf-64b1d39b0132"
            },
            "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": "381db18e-1dbd-40a1-86c6-0dc8c13827af",
            "description": "",
            "sop_guids": [],
            "sop": {
                "library": {
                    "sop_file_uri": "/app/assets/BlueCar.speos/Grey Diffuse Paint_5d78-9f5b-6612-4c7a..scattering"
                },
                "name": "",
                "description": "",
                "metadata": {}
            }
        },
        {
            "name": "BlueCar.Material.2",
            "metadata": {
                "UniqueId": "f3dd68d1-3027-48f6-9d2c-8e805e6f08a0"
            },
            "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": "48ac7315-bd4b-4b33-ba76-82f5075bb6bf",
            "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": "ef7b764a-ad92-41b6-b3da-20e327534148"
            },
            "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": "cc2e45fa-d30c-4493-84cd-83ead4ad2181",
            "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": "RedCar.Material.1",
            "metadata": {
                "UniqueId": "70ce27ed-2648-4c91-8c1a-6a78bd675b73"
            },
            "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": "3fd4a299-f405-4eca-a889-ae43e81ad5a2",
            "description": "",
            "sop_guids": [],
            "sop": {
                "library": {
                    "sop_file_uri": "/app/assets/RedCar.speos/Red Diffuse Paint_c594-8c92-c39c-e0b0..scattering"
                },
                "name": "",
                "description": "",
                "metadata": {}
            }
        },
        {
            "name": "RedCar.Material.2",
            "metadata": {
                "UniqueId": "1da23ecc-9f9e-4cd3-b31d-f7b0f5b1054a"
            },
            "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": "18a7beb0-cc87-4e6f-8d34-eca158005738",
            "description": "",
            "sop_guids": [],
            "sop": {
                "library": {
                    "sop_file_uri": "/app/assets/RedCar.speos/TireDiffusor_a5c2-fa68-db22-4ccb..simplescattering"
                },
                "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 0x7fc594254580>

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 0x7fc5942566b0>

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:287: UserWarning: The pySpeos feature : SimulationInverse needs a Speos Version of 2025 R2 SP0 or higher.
  feature = SimulationInverse(
[11]:
<ansys.speos.core.simulation.SimulationInverse at 0x7fc594256c20>

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: "32f6c902-22a1-41ff-9988-0f95fa0a1084"
    file_name: "Camera.1.Irradiance.xmp"
    file_size: 10637516
  }
  upload_duration {
    nanos: 10108002
  }
}
, upload_response {
  info {
    uri: "cd5c1274-be80-47c9-932a-39936a3e821a"
    file_name: "Camera.1.hdr"
    file_size: 518940
  }
  upload_duration {
    nanos: 835389
  }
}
, upload_response {
  info {
    uri: "685202aa-c379-4a80-88b1-fb232d694471"
    file_name: "Camera.1.xmp"
    file_size: 1804291
  }
  upload_duration {
    nanos: 2024027
  }
}
, upload_response {
  info {
    uri: "f7548bcb-2430-4dc9-84c6-5427914d9fda"
    file_name: "Camera.1.png"
    file_size: 741578
  }
  upload_duration {
    nanos: 912440
  }
}
, upload_response {
  info {
    uri: "df845a26-8bbb-4b52-bcc4-3bc808acb2bf"
    file_name: "Inverse.1.html"
    file_size: 997817
  }
  upload_duration {
    nanos: 1186654
  }
}
]

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 0x7fc59aecf760>

Re-run simulation with the modified part position#

[15]:
run_sim()
[15]:
[upload_response {
  info {
    uri: "81662cd0-bfbd-4bb0-bc2d-9dc85ec11e78"
    file_name: "Camera.1.Irradiance.xmp"
    file_size: 10368579
  }
  upload_duration {
    nanos: 10571708
  }
}
, upload_response {
  info {
    uri: "58987f2e-6ff7-4386-ac45-6a4468372240"
    file_name: "Camera.1.hdr"
    file_size: 519529
  }
  upload_duration {
    nanos: 763555
  }
}
, upload_response {
  info {
    uri: "04b63f32-b0f9-4542-b61b-3c903fad82bb"
    file_name: "Camera.1.xmp"
    file_size: 1761229
  }
  upload_duration {
    nanos: 2148038
  }
}
, upload_response {
  info {
    uri: "6b7e4220-de17-4426-b417-5c3d0d0756ff"
    file_name: "Camera.1.png"
    file_size: 727569
  }
  upload_duration {
    nanos: 962599
  }
}
, upload_response {
  info {
    uri: "570b0286-c87d-4e97-982a-56c1e2739fbe"
    file_name: "Inverse.1.html"
    file_size: 980408
  }
  upload_duration {
    nanos: 1139218
  }
}
]

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 0x7fc594254580>

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