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:697: 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": "ba7abee1-470a-4599-8b44-25201f2f06d4",
    "materials": [
        {
            "name": "Env_Simplified.Material.1",
            "metadata": {
                "UniqueId": "d30560ff-df0c-4931-9c6e-e67e822a4131"
            },
            "vop_guid": "b2c92463-96c6-40c9-9d77-060ce1911432",
            "geometries": {
                "geo_paths": [
                    "Env_Simplified/Solid:1195288205"
                ]
            },
            "sop_guid": "2c7095c0-6a57-4b80-ad6c-e781732c931a",
            "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": "5a03a98f-6cbc-4a3e-81d7-38ae90a85427"
            },
            "vop_guid": "b2c92463-96c6-40c9-9d77-060ce1911432",
            "geometries": {
                "geo_paths": [
                    "Env_Simplified/Sidewalk:530980414"
                ]
            },
            "sop_guid": "12011751-f00b-41b2-b6ca-28e58d71a5ef",
            "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": "6c51b9fd-cc91-4de5-a451-9814d92300f7"
            },
            "vop_guid": "b2c92463-96c6-40c9-9d77-060ce1911432",
            "geometries": {
                "geo_paths": [
                    "Env_Simplified/Sidewalk:895709635"
                ]
            },
            "sop_guid": "12011751-f00b-41b2-b6ca-28e58d71a5ef",
            "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": "5210ad56-0486-4252-87e9-b01823b6a52f"
            },
            "geometries": {
                "geo_paths": [
                    "Env_Simplified/Sidewalk:895709635/face.1:316406917",
                    "Env_Simplified/Sidewalk:895709635/face.1:1112941297"
                ]
            },
            "sop_guid": "ef2fa917-d2c5-4e65-b61e-07b47ddc5edd",
            "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": "e54f931e-24a8-4a73-9522-bfc055251303"
            },
            "vop_guid": "b2c92463-96c6-40c9-9d77-060ce1911432",
            "geometries": {
                "geo_paths": [
                    "Env_Simplified/Sidewalk:4000640054"
                ]
            },
            "sop_guid": "12011751-f00b-41b2-b6ca-28e58d71a5ef",
            "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": "0385de34-5b09-4c0f-a42b-ddc49c666840"
            },
            "geometries": {
                "geo_paths": [
                    "Env_Simplified/Sidewalk:4000640054/face.1:4194215934",
                    "Env_Simplified/Sidewalk:4000640054/face.1:1230904683"
                ]
            },
            "sop_guid": "ef2fa917-d2c5-4e65-b61e-07b47ddc5edd",
            "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": "7b5c1b56-6b9c-42a1-aaa6-f7b95bf0d219"
            },
            "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": "05ff70f3-3698-409a-bb00-3b1de851b71c",
            "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": "e877611b-4525-4a35-bf6c-5b645c810814"
            },
            "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": "dc718ce3-c030-46cf-814b-fd788f2d85bc",
            "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": "8e887173-a6bc-4c66-b51a-1bc5c39bfc3d"
            },
            "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": "cae6326b-3155-4889-b370-1f00fd63bb75",
            "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": "247afb00-058a-4e9c-931b-e54ac044902c"
            },
            "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": "a95c82bc-b74d-4536-bdad-e47b5a56de52",
            "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": "17f52b0b-3e55-4e44-8b9e-dc3987310b02"
            },
            "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": "43b6aa5b-7895-4a26-8156-5b689d38c8d3",
            "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 0x7faa1cb406d0>

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:213: UserWarning: The pySpeos feature : SourceLuminaire needs a Speos Version of 2025 R2 SP0 or higher.
  feature = SourceLuminaire(
[10]:
<ansys.speos.core.source.SourceLuminaire at 0x7faa1cb43be0>

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

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: "60609ddc-6184-44ac-bfa8-4afaa594b83b"
    file_name: "Camera.1.Irradiance.xmp"
    file_size: 10635769
  }
  upload_duration {
    nanos: 10553898
  }
}
, upload_response {
  info {
    uri: "11956ddb-80df-4c5d-8782-9fb6640f4ad3"
    file_name: "Camera.1.hdr"
    file_size: 518190
  }
  upload_duration {
    nanos: 1200251
  }
}
, upload_response {
  info {
    uri: "f80eacdb-e983-4194-ba3f-388ad307fd4b"
    file_name: "Camera.1.xmp"
    file_size: 1804417
  }
  upload_duration {
    nanos: 2681414
  }
}
, upload_response {
  info {
    uri: "e8b06b3d-76a3-4ac2-8c9e-8c0617c1206a"
    file_name: "Camera.1.png"
    file_size: 741163
  }
  upload_duration {
    nanos: 1207035
  }
}
, upload_response {
  info {
    uri: "97d4e12f-6579-4370-aec1-4c0f7c17f1be"
    file_name: "Inverse.1.html"
    file_size: 997399
  }
  upload_duration {
    nanos: 1468558
  }
}
]

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

Re-run simulation with the modified part position#

[15]:
run_sim()
[15]:
[upload_response {
  info {
    uri: "99de6edc-6655-4c24-8d5a-a3a688149707"
    file_name: "Camera.1.Irradiance.xmp"
    file_size: 10372503
  }
  upload_duration {
    nanos: 10496971
  }
}
, upload_response {
  info {
    uri: "7fbd284a-6085-433a-a6aa-2d822a73fed1"
    file_name: "Camera.1.hdr"
    file_size: 519633
  }
  upload_duration {
    nanos: 809272
  }
}
, upload_response {
  info {
    uri: "385f6ef1-f66d-4205-a229-182296ac5f6a"
    file_name: "Camera.1.xmp"
    file_size: 1762760
  }
  upload_duration {
    nanos: 2080517
  }
}
, upload_response {
  info {
    uri: "b1a4a990-d88f-421f-aa02-68ec36403719"
    file_name: "Camera.1.png"
    file_size: 727909
  }
  upload_duration {
    nanos: 926372
  }
}
, upload_response {
  info {
    uri: "e27ce34e-bd4e-4e0a-8048-521127eb53aa"
    file_name: "Inverse.1.html"
    file_size: 980796
  }
  upload_duration {
    nanos: 1158474
  }
}
]

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

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