v0.10.1

Release date: 2025-02-14

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 has no breaking changes, but customers must update to this release to remain compatible with the underlying API. Specifically, old SDK versions will only get the first 50 projects with lc.list_projects().

We recommend all customers upgrade to this release.

Breaking Changes

None.

Features

• Simulation now includes project_id.

• EXPERIMENTAL: set_surface_deformation() method added to Project.

  • This is an experimental feature which may be changed or removed without notice.

• project() method added to Geometry

• select_volumes() method added to Geometry

• add_farfield() method added to Geometry

• iterate_projects() method added to luminarycloud.

  • iterate_projects() returns an iterator that lazily loads projects from the server. It should be preferred over list_projects(), which is now deprecated.

Deprecations

• list_projects() is deprecated. Use iterate_projects() instead.

Bug Fixes / Improvements

• Reading and re-writing simulation params could erroneously modify certain list-type values, including boundary conditions and frame transforms. This is now fixed.

Migration Guide

Anywhere you’re using list_projects() to just iterate over the results one time, use iterate_projects() instead.

>>> for p in lc.iterate_projects():
...   print(f'{p.name}: {p.description}')

If you need a list of your projects, you can use a list comprehension or wrap the full result in a list.

>>> large_projects = [p for p in lc.iterate_projects() if p.storage_usage_bytes > 100e6]
    [Project(...), Project(...)]
>>> all_projects = list(lc.iterate_projects())
    [Project(...), Project(...)]