v0.30.0

Release date: 2026-11-20

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 adds vis queries for computing named values from a solution, field listing for solutions, the Roe low-dissipation settings as simulation parameters, and support for Python 3.14.

Breaking Changes

  • A scene with the SURFACE_FLOW representation must set DisplayAttributes.surface_flow_quantity; without it the render fails. It used to fall back to wall shear stress on the geometry and velocity on filters. This is a server change and applies to all SDK versions.

  • Coloring by a field that isn’t in the data now fails the render instead of drawing a solid color. This is a server change and applies to all SDK versions.

  • RenderOutput.failure_reason and FilterDataOutput.failure_reason are now an empty string, not None, when no failure reason is available.

Features

  • vis.Query and vis.run_query() (experimental) compute named values from a solution. Add each value with Query.add_output(name, program), where the program uses reductions such as integrate_surface, mean_surface, max, and max_location. A query reads blocks of the solution directly, selected by id or by tag, or the output of Slices and Clips added with Query.add_input(). run_query returns a dict from each output’s name to a float or a Vector3. See the vis queries guide.

  • vis.list_fields() lists a solution’s fields with their names, quantities, and number of components. Pick one for a scene with ListedField.to_field().

  • Fds.fds_low_diss_formulation, fds_low_diss_chi_rans, fds_low_diss_chi_les, and fds_low_diss_sensor_strength expose the low-dissipation settings of the ROE scheme for DES and LES. The formulation defaults to WINKLER. Select HYBRID to use the chi and sensor settings, with SpatialDiscretizationFluid.preset set to CUSTOM_SPATIAL_DISCRETIZATION_FLUID; any other preset resets the formulation to WINKLER when the template is saved.

Deprecations

Bug Fixes / Improvements

  • Geometry.bind_import_to_named_variable_set() now binds the parameters of every import feature, not just the first, into one named variable set, and leaves bool and string parameters unbound instead of raising.

  • Fixed an issue where a scene that named a scalar field with different components got a separate color map for each, which the server rejected.

  • Detailed error messages are available in more cases for failed geometry and visualization jobs.

  • The SDK is now tested on Python 3.14. grpcio-tools is no longer a dependency.

Migration Guide

Surface Flow needs its field set

Set surface_flow_quantity on any scene that uses the SURFACE_FLOW representation:

display = vis.DisplayAttributes()
display.representation = vis.Representation.SURFACE_FLOW
display.surface_flow_quantity = vis.VisQuantity.WALL_SHEAR_STRESS

failure_reason is an empty string when unavailable

Code that checks output.failure_reason is None should check for a falsy value instead (if not output.failure_reason:).