v0.20.0

Release date: 2025-09-09

Early Access

The Luminary Cloud API and Python SDK are Early Access features that are still under development. View the Luminary Cloud Early Access Terms. The interface may change, and you may need to migrate or discard scripts and configuration files multiple times before v1.0.0 is released. In the future, migrations may also be necessary when upgrading to new major versions of the SDK (e.g. v2.0.0).

Release Notes

This release includes a small breaking change, plus some new features and a bug fix.

Breaking Changes

• When Mesh.wait() is called with a timeout_seconds and that timeout is exceeded before the mesh becomes ready, an exception is raised. That exception used to be a TimeoutError, which is a Python system error and is therefore ambiguous. Now there’s a luminarycloud.exceptions.Timeout exception which is raised instead.

• Similar to the above, Simulation.wait() will now raise a luminarycloud.exceptions.Timeout instead of TimeoutError.

Features

• Geometry now has a project_id property.

• Saved cameras from the UI can now be retrieved in the SDK. See vis.list_cameras and vis.get_cameras

Deprecations

None.

Bug Fixes / Improvements

• The maximum message size that the python SDK client can receive has been increased from 4MiB to 32MiB, which fixes some bugs one might encouter when trying to download large surface output datasets.

Migration Guide

• If you have code that explicitly handles Mesh.wait() timeout exceptions, you must now catch luminarycloud.exceptions.Timeout instead of TimeoutError.

• If you have code that explicitly handles Simulation.wait() timeout exceptions, you must now catch luminarycloud.exceptions.Timeout instead of TimeoutError.