Thermal imaging mode

Warning

This feature is experimental and may not work as expected. Please share your feedback with us!

Enable thermal imaging visualization to simulate infrared camera effects, including thermal conductivity of assets, thermal profiles of water bodies, and atmospheric thermal gradients.

Enable thermal imaging mode
world.camera.enable_thermal_mode(True)
Effect of enabling thermal mode

The thermal imaging mode applies several effects:

  • Distance-based gradient blending of sky temperatures

  • Material-based thermal conductivity simulation for assets

  • Thermal profile visualization of ocean and water bodies

To render and save thermal images as part of your synthset, use the following command:

Render thermal images
scenario.render(params=RenderParams.RgbWithThermal())

When downloading the synthset, thermal images will be included in the resultant ZIP file with the prefix Thermal_.

Thermal Shader Parameters

The thermal shader provides several parameters to customize the thermal visualization. All parameters accept values between 0 and 1, with default values set to 0.5 unless otherwise specified.

Sky Parameters

set_sky_transition_point(value: float)

Controls the vertical position where the sky transitions from visible to dark.

  • Default: 0.5

  • 0: Sky is completely visible

  • 1: Sky blends into horizon with complete darkness

set_sky_temperature(value: float)

Controls the thermal state of the sky.

  • Default: 0.5

  • 0: Coldest thermal state of the sky

  • 1: Warmest thermal state of the sky

Ocean Parameters

set_ocean_min_temperature(value: float)

Sets the minimum thermal state of the ocean.

  • Default: 0.3

  • 0: Coldest thermal state of the ocean

  • 1: Warmest thermal state of the ocean

set_ocean_max_temperature(value: float)

Sets the maximum thermal state of the ocean.

  • Default: 0.7

  • 0: Coldest thermal state of the ocean

  • 1: Warmest thermal state of the ocean

set_ocean_brightness(value: float)

Controls the brightness of the ocean in thermal view.

  • Default: 0.5

  • 0: Coldest thermal state of the ocean

  • 1: Warmest thermal state of the ocean

Asset Parameters

set_asset_min_temperature(value: float)

Sets the minimum thermal state of assets.

  • Default: 0.3

  • 0: Coldest thermal state of assets

  • 1: Warmest thermal state of assets

set_asset_max_temperature(value: float)

Sets the maximum thermal state of assets.

  • Default: 0.7

  • 0: Coldest thermal state of assets

  • 1: Warmest thermal state of assets

set_asset_brightness(value: float)

Controls the brightness of assets in thermal view.

  • Default: 0.5

  • 0: Coldest thermal state of assets

  • 1: Warmest thermal state of assets

set_asset_reflectivity(value: float)

Controls how reflective assets appear in thermal view.

  • Default: 0.5

  • 0: Least reflective state

  • 1: Most reflective state

Global Parameters

set_contrast(value: float)

Controls the overall contrast of the thermal view.

  • Default: 0.5

  • 0: Minimum contrast

  • 1: Maximum contrast

set_brightness(value: float)

Controls the overall brightness of the thermal view.

  • Default: 0.5

  • 0: Darkest state

  • 1: Brightest state