luminarycloud 0.16.2__py3-none-any.whl → 0.18.0__py3-none-any.whl

luminarycloud/enum/pipeline_job_status.py

@@ -0,0 +1,23 @@
+# Copyright 2025 Luminary Cloud, Inc. All Rights Reserved.
+from enum import IntEnum
+from .._proto.api.v0.luminarycloud.pipelines import pipelines_pb2 as pipelinespb
+
+
+class PipelineJobStatus(IntEnum):
+    """
+    Status of a pipeline job.
+
+    Attributes
+    ----------
+    PENDING
+    RUNNING
+    COMPLETED
+    FAILED
+    """
+
+    UNSPECIFIED = pipelinespb.PIPELINE_JOB_STATUS_UNSPECIFIED
+
+    PENDING = pipelinespb.PIPELINE_JOB_STATUS_PENDING
+    RUNNING = pipelinespb.PIPELINE_JOB_STATUS_RUNNING
+    COMPLETED = pipelinespb.PIPELINE_JOB_STATUS_COMPLETED
+    FAILED = pipelinespb.PIPELINE_JOB_STATUS_FAILED

luminarycloud/feature_modification.py

@@ -2,6 +2,8 @@
 from enum import Enum, auto
 from typing import Dict, Iterable, List, Optional, cast
 from copy import deepcopy
+
+from luminarycloud.types.adfloat import _to_ad_proto, _from_ad_proto
 from ._proto.geometry import geometry_pb2 as gpb
 from .types import Vector3Like
 from .types.vector3 import _to_vector3
@@ -150,7 +152,6 @@ def modify_import(
     feature: gpb.Feature,
     geometry_url: Optional[str] = None,
     scaling: Optional[float] = None,
-    force_discrete: Optional[bool] = None,
 ) -> gpb.Modification:
     """
     Modify an import feature with optional new values.
@@ -160,7 +161,6 @@ def modify_import(
         feature: A gpb.Feature object
         geometry_url: The new geometry URL
         scaling: New scaling factor
-        force_discrete: Whether to force discrete geometry
 
     Returns:
         A gpb.Modification object
@@ -175,10 +175,7 @@ def modify_import(
         feature_copy.import_geometry.geometry_url = geometry_url
 
     if scaling is not None:
-        feature_copy.import_geometry.scaling = scaling
-
-    if force_discrete is not None:
-        feature_copy.import_geometry.force_discrete = force_discrete
+        feature_copy.import_geometry.scaling.CopyFrom(_to_ad_proto(scaling))
 
     return gpb.Modification(
         mod_type=gpb.Modification.ModificationType.MODIFICATION_TYPE_UPDATE_FEATURE,

luminarycloud/geometry.py

@@ -29,6 +29,7 @@ from .named_variable_set import NamedVariableSet, get_named_variable_set
 
 if TYPE_CHECKING:
     from .project import Project
+    from .geometry_version import GeometryVersion
 
 
 @ProtoWrapper(geometrypb.Geometry)
@@ -276,6 +277,30 @@ class Geometry(ProtoWrapperBase):
             )
         )
 
+    def convert_colors_to_tags(self) -> None:
+        """
+        Convert colors to tags in the geometry.
+        If the imported geometry has surface or volume colors, this will create a tag per color
+        (formatted as "[RRR,GGG,BBB]") and assign the corresponding surfaces and volumes to that
+        tag.
+        """
+        self._modify(
+            modification=gpb.Modification(
+                mod_type=gpb.Modification.MODIFICATION_TYPE_CONVERT_COLORS_TO_TAGS,
+            )
+        )
+
+    def latest_version(self) -> GeometryVersion:
+        """
+        Get the latest version of the geometry.
+        """
+        from .geometry_version import get_geometry_version
+
+        req = geometrypb.GetGeometryRequest(geometry_id=self.id)
+        res_geo: geometrypb.GetGeometryResponse = get_default_client().GetGeometry(req)
+        geometry_version_id = res_geo.geometry.last_version_id
+        return get_geometry_version(geometry_version_id)
+
     def check(self) -> tuple[bool, list[str]]:
         """
         Check the geometry for any issues that may prevent meshing.

luminarycloud/geometry_version.py

@@ -87,6 +87,29 @@ class GeometryVersion(ProtoWrapperBase):
         ]
         return surfaces, volumes
 
+    def copy_to_new_geometry(self, name: str = "") -> Geometry:
+        """
+        Copy this GeometryVersion and create a new Geometry containing only that newly copied version.
+
+        Parameters
+        ----------
+        name : str, optional
+            The name of the new Geometry. If not provided, a default name will be used.
+
+        Returns
+        -------
+        Geometry
+            The new Geometry containing only the newly copied GeometryVersion.
+        """
+        req = geometrypb.CopyGeometryFromVersionRequest(
+            geometry_version_id=self.id,
+            name=name,
+        )
+        res: geometrypb.CopyGeometryFromVersionResponse = (
+            get_default_client().CopyGeometryFromVersion(req)
+        )
+        return Geometry(res.geometry)
+
     def _list_features(
         self,
     ) -> list[gpb.Feature]:

luminarycloud/mesh.py

@@ -136,6 +136,22 @@ class Mesh(ProtoWrapperBase):
         """
         return get_mesh_metadata(self.id)
 
+    def to_code(self) -> str:
+        """
+        Returns the Python code that recreates this mesh.
+
+        Examples:
+        --------
+        >>> mesh = lc.get_mesh("mesh-123")
+        >>> python_code = mesh.to_code()
+        >>> print(python_code)
+        """
+        req = meshpb.GetMeshGenerationSdkCodeRequest(id=self.id)
+        res: meshpb.GetMeshGenerationSdkCodeResponse = (
+            get_default_client().GetMeshGenerationSdkCode(req)
+        )
+        return res.sdk_code
+
 
 def get_mesh(id: MeshID) -> Mesh:
     """

luminarycloud/params/enum/_enum_wrappers.py

@@ -1776,6 +1776,9 @@ class DirectionSpecification(_IntEnum):
         Impose a flow direction normal to the inlet boundary toward the interior of the domain.
     DIRECTION_VECTOR
         Specify a vector for the inlet flow direction.
+    CYLINDRICAL_DIRECTIONS
+        Specify the inlet flow direction in a cylindrical coordinate system whose main axis
+                        is defined by the z axis of the inlet frame.
 
 
     Examples
@@ -1783,11 +1786,37 @@ class DirectionSpecification(_IntEnum):
     >>> from luminarycloud.params.enum import DirectionSpecification
     >>> DirectionSpecification.NORMAL_TO_BOUNDARY
     >>> DirectionSpecification.DIRECTION_VECTOR
+    >>> DirectionSpecification.CYLINDRICAL_DIRECTIONS
     """
 
     INVALID = _clientpb.INVALID_DIRECTION_SPECIFICATION
     NORMAL_TO_BOUNDARY = _clientpb.NORMAL_TO_BOUNDARY
     DIRECTION_VECTOR = _clientpb.DIRECTION_VECTOR
+    CYLINDRICAL_DIRECTIONS = _clientpb.CYLINDRICAL_DIRECTIONS
+
+
+class DirectionFrame(_IntEnum):
+    """
+    Frame used to define the flow direction.
+
+    Attributes
+    ----------
+    DIRECTION_FRAME_GLOBAL
+        The direction vectors are defined by the global frame.
+    DIRECTION_FRAME_BOUNDARY
+        The direction vectors are defined by the frame to which the boundary surfaces are attached.
+
+
+    Examples
+    --------
+    >>> from luminarycloud.params.enum import DirectionFrame
+    >>> DirectionFrame.DIRECTION_FRAME_GLOBAL
+    >>> DirectionFrame.DIRECTION_FRAME_BOUNDARY
+    """
+
+    INVALID = _clientpb.INVALID_DIRECTION_FRAME
+    DIRECTION_FRAME_GLOBAL = _clientpb.DIRECTION_FRAME_GLOBAL
+    DIRECTION_FRAME_BOUNDARY = _clientpb.DIRECTION_FRAME_BOUNDARY
 
 
 class OutletPressureConstraint(_IntEnum):

luminarycloud/params/simulation/physics/fluid/boundary_conditions/inlet/fan_curve_inlet_.py

@@ -32,7 +32,7 @@ class FanCurveInlet(Inlet):
     )
     "Method of defining the flow direction at the inlet."
     direction: Vector3 = field(default_factory=lambda: Vector3(1.0, 0.0, 0.0))
-    "Vector (x,y,z) defining the flow direction. Automatically scaled to a unit vector internally."
+    "Vector (x,y,z) or (ρ,φ,z) defining the flow direction. Automatically scaled to a unit vector internally."
     fan_curve_table: RectilinearTable | None = None
     "Correlation between fan pressure rise and volume flow rate."
     head_loss_coefficient: LcFloat = 0.0

luminarycloud/params/simulation/physics/fluid/boundary_conditions/inlet/mach_inlet_.py

@@ -33,8 +33,10 @@ class MachInlet(Inlet):
         enum.DirectionSpecification.NORMAL_TO_BOUNDARY
     )
     "Method of defining the flow direction at the inlet."
+    direction_frame: enum.DirectionFrame = enum.DirectionFrame.DIRECTION_FRAME_GLOBAL
+    "Frame used to define the flow direction."
     direction: Vector3 = field(default_factory=lambda: Vector3(1.0, 0.0, 0.0))
-    "Vector (x,y,z) defining the flow direction. Automatically scaled to a unit vector internally."
+    "Vector (x,y,z) or (ρ,φ,z) defining the flow direction. Automatically scaled to a unit vector internally."
 
     def _to_proto(self) -> clientpb.BoundaryConditionsFluid:
         _proto = super()._to_proto()
@@ -42,6 +44,7 @@ class MachInlet(Inlet):
         _proto.farfield_mach_number.CopyFrom(_to_ad_proto(self.mach_number))
         _proto.farfield_pressure.CopyFrom(_to_ad_proto(self.pressure))
         _proto.direction_specification = self.direction_specification.value
+        _proto.direction_frame = self.direction_frame.value
         _proto.flow_direction.CopyFrom(self.direction._to_ad_proto())
         return _proto
 
@@ -51,5 +54,6 @@ class MachInlet(Inlet):
         self.mach_number = _from_ad_proto(proto.farfield_mach_number)
         self.pressure = _from_ad_proto(proto.farfield_pressure)
         self.direction_specification = enum.DirectionSpecification(proto.direction_specification)
+        self.direction_frame = enum.DirectionFrame(proto.direction_frame)
         self.direction._from_ad_proto(proto.flow_direction)
         return None

luminarycloud/params/simulation/physics/fluid/boundary_conditions/inlet/mass_flow_inlet_.py

@@ -31,14 +31,17 @@ class MassFlowInlet(Inlet):
         enum.DirectionSpecification.NORMAL_TO_BOUNDARY
     )
     "Method of defining the flow direction at the inlet."
+    direction_frame: enum.DirectionFrame = enum.DirectionFrame.DIRECTION_FRAME_GLOBAL
+    "Frame used to define the flow direction."
     direction: Vector3 = field(default_factory=lambda: Vector3(1.0, 0.0, 0.0))
-    "Vector (x,y,z) defining the flow direction. Automatically scaled to a unit vector internally."
+    "Vector (x,y,z) or (ρ,φ,z) defining the flow direction. Automatically scaled to a unit vector internally."
 
     def _to_proto(self) -> clientpb.BoundaryConditionsFluid:
         _proto = super()._to_proto()
         _proto.inlet_momentum = clientpb.InletMomentum.MASS_FLOW_INLET
         _proto.mass_flow_rate.CopyFrom(_to_ad_proto(self.mass_flow_rate))
         _proto.direction_specification = self.direction_specification.value
+        _proto.direction_frame = self.direction_frame.value
         _proto.flow_direction.CopyFrom(self.direction._to_ad_proto())
         return _proto
 
@@ -47,5 +50,6 @@ class MassFlowInlet(Inlet):
         assert proto.inlet_momentum == clientpb.InletMomentum.MASS_FLOW_INLET
         self.mass_flow_rate = _from_ad_proto(proto.mass_flow_rate)
         self.direction_specification = enum.DirectionSpecification(proto.direction_specification)
+        self.direction_frame = enum.DirectionFrame(proto.direction_frame)
         self.direction._from_ad_proto(proto.flow_direction)
         return None

luminarycloud/params/simulation/physics/fluid/boundary_conditions/inlet/total_pressure_inlet_.py

@@ -33,8 +33,10 @@ class TotalPressureInlet(Inlet):
         enum.DirectionSpecification.NORMAL_TO_BOUNDARY
     )
     "Method of defining the flow direction at the inlet."
+    direction_frame: enum.DirectionFrame = enum.DirectionFrame.DIRECTION_FRAME_GLOBAL
+    "Frame used to define the flow direction."
     direction: Vector3 = field(default_factory=lambda: Vector3(1.0, 0.0, 0.0))
-    "Vector (x,y,z) defining the flow direction. Automatically scaled to a unit vector internally."
+    "Vector (x,y,z) or (ρ,φ,z) defining the flow direction. Automatically scaled to a unit vector internally."
 
     def _to_proto(self) -> clientpb.BoundaryConditionsFluid:
         _proto = super()._to_proto()
@@ -42,6 +44,7 @@ class TotalPressureInlet(Inlet):
         _proto.total_pressure.CopyFrom(_to_ad_proto(self.total_pressure))
         _proto.total_pressure_col.value = self.total_pressure_column_index
         _proto.direction_specification = self.direction_specification.value
+        _proto.direction_frame = self.direction_frame.value
         _proto.flow_direction.CopyFrom(self.direction._to_ad_proto())
         return _proto
 
@@ -51,5 +54,6 @@ class TotalPressureInlet(Inlet):
         self.total_pressure = _from_ad_proto(proto.total_pressure)
         self.total_pressure_column_index = proto.total_pressure_col.value
         self.direction_specification = enum.DirectionSpecification(proto.direction_specification)
+        self.direction_frame = enum.DirectionFrame(proto.direction_frame)
         self.direction._from_ad_proto(proto.flow_direction)
         return None

luminarycloud/params/simulation/physics/fluid/boundary_conditions/inlet/velocity_magnitude_inlet_.py

@@ -33,8 +33,10 @@ class VelocityMagnitudeInlet(Inlet):
         enum.DirectionSpecification.NORMAL_TO_BOUNDARY
     )
     "Method of defining the flow direction at the inlet."
+    direction_frame: enum.DirectionFrame = enum.DirectionFrame.DIRECTION_FRAME_GLOBAL
+    "Frame used to define the flow direction."
     direction: Vector3 = field(default_factory=lambda: Vector3(1.0, 0.0, 0.0))
-    "Vector (x,y,z) defining the flow direction. Automatically scaled to a unit vector internally."
+    "Vector (x,y,z) or (ρ,φ,z) defining the flow direction. Automatically scaled to a unit vector internally."
     pressure: LcFloat = 101325
     "Static pressure at the boundary relative to the material reference pressure."
 
@@ -44,6 +46,7 @@ class VelocityMagnitudeInlet(Inlet):
         _proto.inlet_velocity_magnitude.CopyFrom(_to_ad_proto(self.velocity))
         _proto.inlet_velocity_magnitude_col.value = self.velocity_column_index
         _proto.direction_specification = self.direction_specification.value
+        _proto.direction_frame = self.direction_frame.value
         _proto.flow_direction.CopyFrom(self.direction._to_ad_proto())
         _proto.farfield_pressure.CopyFrom(_to_ad_proto(self.pressure))
         return _proto
@@ -54,6 +57,7 @@ class VelocityMagnitudeInlet(Inlet):
         self.velocity = _from_ad_proto(proto.inlet_velocity_magnitude)
         self.velocity_column_index = proto.inlet_velocity_magnitude_col.value
         self.direction_specification = enum.DirectionSpecification(proto.direction_specification)
+        self.direction_frame = enum.DirectionFrame(proto.direction_frame)
         self.direction._from_ad_proto(proto.flow_direction)
         self.pressure = _from_ad_proto(proto.farfield_pressure)
         return None

luminarycloud/physics_ai/inference.py

@@ -1,8 +1,8 @@
 # File: python/sdk/luminarycloud/inference/inference.py
 # Copyright 2025 Luminary Cloud, Inc. All Rights Reserved.
 from datetime import datetime
-from typing import Any, Callable
-from json import loads as json_loads
+from typing import Any, Callable, Dict, Optional
+from json import loads as json_loads, dumps as json_dumps
 from dataclasses import dataclass
 import base64
 import os
@@ -48,7 +48,11 @@ class ExtAeroInferenceResult:
 
 
 def external_aero_inference(
-    project: Project, stl_file: str, checkpoint_file: str, config_name: str, stencil_size: int
+    project: Project,
+    stl_file: str,
+    artifact_url: str,
+    parameters: Optional[Dict[str, Any]] = None,
+    stencil_size: int = 1,
 ) -> ExtAeroInferenceResult:
     """Performs an inference job returning external aerodynamic results.
     Parameters
@@ -57,12 +61,12 @@ def external_aero_inference(
         The project to which the inference files will be added.
     stl_file : str
         Fullpath the STL file to be used for inference.
-    checkpoint_file : str
-        Fullpath of the model to be used for inference.
-    config_name :str
-        Name of the configuration to be used for inference.
-    stencil_size :int
-        Size of the stencil to be used for inference.
+    artifact_url : str
+        Fullpath of the model artifact directory to be used for inference.
+    parameters : Dict[str, Any], optional
+        Dictionary of parameters to be passed to the inference service (e.g., alpha, beta, etc.).
+    stencil_size : int, optional
+        Size of the stencil to be used for inference. Defaults to 1.
 
     Returns
     ExtAeroInferenceResult
@@ -71,12 +75,16 @@ def external_aero_inference(
     warning:: This feature is experimental and may change or be removed without notice.
     """
 
-    result = perform_inference(project, stl_file, checkpoint_file, config_name, stencil_size)
+    result = perform_inference(project, stl_file, artifact_url, parameters, stencil_size)
     return ExtAeroInferenceResult(result)
 
 
 def perform_inference(
-    project: Project, stl_file: str, checkpoint_file: str, config_name: str, stencil_size: int
+    project: Project,
+    stl_file: str,
+    artifact_url: str,
+    parameters: Optional[Dict[str, Any]] = None,
+    stencil_size: int = 1,
 ) -> dict[str, Any]:
     """Creates an inference service job.
     Parameters
@@ -85,12 +93,12 @@ def perform_inference(
         The project to which the inference files will be added.
     stl_file : str
         Fullpath the STL file to be used for inference.
-    checkpoint_file : str
-        Fullpath of the model to be used for inference.
-    config_name :str
-        Name of the configuration to be used for inference.
-    stencil_size :int
-        Size of the stencil to be used for inference.
+    artifact_url : str
+        Fullpath of the model artifact directory to be used for inference.
+    parameters : Dict[str, Any], optional
+        Dictionary of parameters to be passed to the inference service (e.g., alpha, beta, etc.).
+    stencil_size : int, optional
+        Size of the stencil to be used for inference. Defaults to 1.
 
 
     Returns
@@ -123,9 +131,8 @@ def perform_inference(
         return download_file
 
     stl_url = upload_if_file(stl_file)
-    check_url = upload_if_file(checkpoint_file)
 
-    raw = start_inference_job(project, stl_url, check_url, config_name, stencil_size)
+    raw = start_inference_job(project, stl_url, artifact_url, parameters, stencil_size)
     currated: dict[str, Any] = {}
     for k, v in raw.items():
         if isinstance(v, str) and v.startswith("https://"):
@@ -144,9 +151,10 @@ def perform_inference(
 def start_inference_job(
     project: Project,
     stl_url: str,
-    checkpoint_url: str,
-    config_name: str,
-    stencil_size: int,
+    artifact_url: str,
+    parameters: Optional[Dict[str, Any]] = None,
+    stencil_size: int = 1,
+    write_visualization_data=False,
 ) -> dict[str, Any]:
     """Creates an inference service job.
     Parameters
@@ -155,12 +163,14 @@ def start_inference_job(
         Reference to a project.
     stl_url : str
         URL of the STL file to be used for inference.
-    checkpoint_url : str
-        URL of the model to be used for inference.
-    config_name :str
-        Name of the configuration to be used for inference.
-    stencil_size :int
-        Size of the stencil to be used for inference.
+    artifact_url : str
+        URL of the model artifact directory to be used for inference.
+    parameters : Dict[str, Any], optional
+        Dictionary of parameters to be passed to the inference service (e.g., alpha, beta, etc.).
+    stencil_size : int, optional
+        Size of the stencil to be used for inference. Defaults to 1.
+    write_visualization_data : bool, optional
+        Whether to write LC render data for visualization by Luminary.
 
 
     Returns
@@ -170,12 +180,18 @@ def start_inference_job(
     warning:: This feature is experimental and may change or be removed without notice.
     """
 
+    # Convert parameters dict to bytes if provided
+    parameters_bytes = b""
+    if parameters is not None:
+        parameters_bytes = json_dumps(parameters).encode("utf-8")
+
     req = inferencepb.CreateInferenceServiceJobRequest(
         stl_url=stl_url,
-        checkpoint_url=checkpoint_url,
-        config_name=config_name,
+        artifact_url=artifact_url,
+        parameters=parameters_bytes,
         stencil_size=stencil_size,
         project_id=project.id,
+        write_visualization_data=write_visualization_data,
     )
 
     res: inferencepb.CreateInferenceServiceJobResponse = (

luminarycloud/pipelines/__init__.py

@@ -33,3 +33,10 @@ from .arguments import (
     PipelineArgs as PipelineArgs,
     ArgNamedVariableSet as ArgNamedVariableSet,
 )
+
+from .api import (
+    create_pipeline as create_pipeline,
+    list_pipelines as list_pipelines,
+    get_pipeline as get_pipeline,
+    create_pipeline_job as create_pipeline_job,
+)