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_FLOWrepresentation must setDisplayAttributes.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_reasonandFilterDataOutput.failure_reasonare now an empty string, notNone, when no failure reason is available.
Features¶
vis.Queryandvis.run_query()(experimental) compute named values from a solution. Add each value withQuery.add_output(name, program), where the program uses reductions such asintegrate_surface,mean_surface,max, andmax_location. A query reads blocks of the solution directly, selected by id or by tag, or the output of Slices and Clips added withQuery.add_input().run_queryreturns a dict from each output’s name to afloator aVector3. 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 withListedField.to_field().Fds.fds_low_diss_formulation,fds_low_diss_chi_rans,fds_low_diss_chi_les, andfds_low_diss_sensor_strengthexpose 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, withSpatialDiscretizationFluid.presetset toCUSTOM_SPATIAL_DISCRETIZATION_FLUID; any other preset resets the formulation to WINKLER when the template is saved.
Deprecations¶
vis.list_quantities()is deprecated and will be removed in a later release. Usevis.list_fields()instead.
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-toolsis 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