luminarycloud 0.16.1__py3-none-any.whl → 0.17.0__py3-none-any.whl

luminarycloud/feature_modification.py

@@ -150,7 +150,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 +159,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
@@ -177,9 +175,6 @@ def modify_import(
     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
-
     return gpb.Modification(
         mod_type=gpb.Modification.ModificationType.MODIFICATION_TYPE_UPDATE_FEATURE,
         feature=feature_copy,

luminarycloud/geometry.py

@@ -10,7 +10,6 @@ from typing import Union, Sequence
 from typing_extensions import TYPE_CHECKING
 
 import luminarycloud as lc
-from luminarycloud._helpers.warnings import experimental
 
 from ._client import get_default_client
 from ._helpers._timestamp_to_datetime import timestamp_to_datetime
@@ -112,13 +111,14 @@ class Geometry(ProtoWrapperBase):
             raise TypeError("volumes must be a list")
         return VolumeSelection(self, volumes)
 
-    @experimental
     def use_named_variable_set(self, named_variable_set: Union[NamedVariableSet, str]) -> None:
         """
         Set the current state of the named variable set for the geometry. The current state of the
         geometry will be recreated using this named variable set and all future modifications
         applied will use this named variable set as it was at the time of the call.
 
+        .. warning:: This feature is experimental and may change or be removed without notice.
+
         Parameters
         ----------
         named_variable_set : NamedVariableSet | str
@@ -276,6 +276,19 @@ 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 check(self) -> tuple[bool, list[str]]:
         """
         Check the geometry for any issues that may prevent meshing.

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/named_variable_set.py

@@ -4,7 +4,6 @@ from datetime import datetime
 from ._client import get_default_client
 from ._helpers._timestamp_to_datetime import timestamp_to_datetime
 from ._helpers.named_variables import _named_variables_from_proto, _named_variables_to_proto
-from ._helpers.warnings import experimental
 from ._proto.api.v0.luminarycloud.named_variable_set import (
     named_variable_set_pb2 as namedvariablepb,
 )
@@ -12,13 +11,12 @@ from ._wrapper import ProtoWrapper, ProtoWrapperBase
 from .types import ProjectID, NamedVariableSetID, LcFloat
 
 
-@experimental
 @ProtoWrapper(namedvariablepb.NamedVariableSet)
 class NamedVariableSet(ProtoWrapperBase):
     """
     Represents a named variable set object.
 
-    Note: This class is experimental and may change in the future.
+    .. warning:: This feature is experimental and may change or be removed without notice.
 
     Attributes
     ----------
@@ -119,11 +117,12 @@ class NamedVariableSet(ProtoWrapperBase):
         return self._named_variables
 
 
-@experimental
 def get_named_variable_set(id: NamedVariableSetID) -> NamedVariableSet:
     """
     Retrieve a specific named variable set by ID.
 
+    .. warning:: This feature is experimental and may change or be removed without notice.
+
     Parameters
     ----------
     id : str

luminarycloud/outputs/stopping_conditions.py

@@ -4,7 +4,6 @@ from .._client import get_default_client
 from .._proto.api.v0.luminarycloud.stopping_condition import stopping_condition_pb2 as stopcondpb
 from .._proto.output import output_pb2 as outputpb
 from dataclasses import dataclass
-from .._helpers.warnings import experimental
 
 
 @dataclass
@@ -155,7 +154,6 @@ def delete_stopping_condition(simulation_template_id: str, id: str) -> None:
     get_default_client().DeleteStoppingCondition(req)
 
 
-@experimental
 def get_general_stopping_conditions(simulation_template_id: str) -> GeneralStoppingConditions:
     """
     Get the general stopping conditions for a simulation template.
@@ -174,7 +172,6 @@ def get_general_stopping_conditions(simulation_template_id: str) -> GeneralStopp
     return GeneralStoppingConditions._from_proto(res.basic_stopping_conditions)
 
 
-@experimental
 def update_general_stopping_conditions(
     simulation_template_id: str,
     max_iterations: int | None = None,

luminarycloud/physics_ai/architectures.py

@@ -4,12 +4,10 @@ from typing import List, Optional
 from .._client import get_default_client
 from .._proto.api.v0.luminarycloud.physics_ai import physics_ai_pb2 as physaipb
 from .._wrapper import ProtoWrapper, ProtoWrapperBase
-from .._helpers.warnings import experimental
 from ..types.ids import PhysicsAiArchitectureID, PhysicsAiArchitectureVersionID
 from ..enum.physics_ai_lifecycle_state import PhysicsAiLifecycleState
 
 
-@experimental
 @ProtoWrapper(physaipb.PhysicsAiArchitectureVersion)
 class PhysicsAiArchitectureVersion(ProtoWrapperBase):
     """
@@ -25,7 +23,6 @@ class PhysicsAiArchitectureVersion(ProtoWrapperBase):
     _proto: physaipb.PhysicsAiArchitectureVersion
 
 
-@experimental
 @ProtoWrapper(physaipb.PhysicsAiArchitecture)
 class PhysicsAiArchitecture(ProtoWrapperBase):
     """
@@ -55,7 +52,6 @@ class PhysicsAiArchitecture(ProtoWrapperBase):
         return self.versions[0] if self.versions else None
 
 
-@experimental
 def list_architectures() -> List[PhysicsAiArchitecture]:
     """
     List available Physics AI architectures for model training.

luminarycloud/physics_ai/inference.py

@@ -14,7 +14,6 @@ from .._proto.api.v0.luminarycloud.inference import inference_pb2 as inferencepb
 from .._proto.inferenceservice import inferenceservice_pb2 as inferenceservicepb
 from .._wrapper import ProtoWrapper, ProtoWrapperBase
 from ..project import Project
-from .._helpers.warnings import experimental
 from ..project import Project
 from .._helpers import upload_file
 from .._proto.upload import upload_pb2 as uploadpb
@@ -48,7 +47,6 @@ class ExtAeroInferenceResult:
         self.pressure_surface = inference_result.get("pressure_surface", None)
 
 
-@experimental
 def external_aero_inference(
     project: Project, stl_file: str, checkpoint_file: str, config_name: str, stencil_size: int
 ) -> ExtAeroInferenceResult:
@@ -77,7 +75,6 @@ def external_aero_inference(
     return ExtAeroInferenceResult(result)
 
 
-@experimental
 def perform_inference(
     project: Project, stl_file: str, checkpoint_file: str, config_name: str, stencil_size: int
 ) -> dict[str, Any]:
@@ -144,7 +141,6 @@ def perform_inference(
     return currated
 
 
-@experimental
 def start_inference_job(
     project: Project,
     stl_url: str,

luminarycloud/physics_ai/models.py

@@ -4,12 +4,10 @@ from typing import List, Optional
 from .._client import get_default_client
 from .._proto.api.v0.luminarycloud.physics_ai import physics_ai_pb2 as physaipb
 from .._wrapper import ProtoWrapper, ProtoWrapperBase
-from .._helpers.warnings import experimental
 from ..types.ids import PhysicsAiModelID, PhysicsAiModelVersionID
 from ..enum.physics_ai_lifecycle_state import PhysicsAiLifecycleState
 
 
-@experimental
 @ProtoWrapper(physaipb.PhysicsAiModelVersion)
 class PhysicsAiModelVersion(ProtoWrapperBase):
     """
@@ -24,7 +22,6 @@ class PhysicsAiModelVersion(ProtoWrapperBase):
     _proto: physaipb.PhysicsAiModelVersion
 
 
-@experimental
 @ProtoWrapper(physaipb.PhysicsAiModel)
 class PhysicsAiModel(ProtoWrapperBase):
     """
@@ -54,7 +51,6 @@ class PhysicsAiModel(ProtoWrapperBase):
         return self.versions[0] if self.versions else None
 
 
-@experimental
 def list_pretrained_models() -> List[PhysicsAiModel]:
     """
     List available pretrained Physics AI models.

luminarycloud/physics_ai/solution.py

@@ -4,12 +4,10 @@ import tarfile
 from typing import List, Optional, BinaryIO, cast
 
 from .._client import get_default_client
-from .._helpers.warnings import experimental
 from .._helpers.download import download_solution_physics_ai as _download_solution_physics_ai
 from ..enum.quantity_type import QuantityType
 
 
-@experimental
 def _download_processed_solution_physics_ai(  # noqa: F841
     solution_id: str,
     exclude_surfaces: Optional[List[str]] = None,
@@ -25,6 +23,8 @@ def _download_processed_solution_physics_ai(  # noqa: F841
     Returns a compressed archive containing processed solution files including
     merged surfaces (VTP/STL) and optionally volume data (VTU).
 
+    .. warning:: This feature is experimental and may change or be removed without notice.
+
     Args:
         solution_id: ID of the solution to download
         exclude_surfaces: List of surface names to exclude from processing

luminarycloud/pipelines/__init__.py

@@ -1,6 +1,7 @@
 # Copyright 2025 Luminary Cloud, Inc. All Rights Reserved.
 from .core import (
     Pipeline as Pipeline,
+    PipelineParameter as PipelineParameter,
 )
 
 from .parameters import (
@@ -27,3 +28,8 @@ from .operators import (
     Simulate as Simulate,
     SimulateOutputs as SimulateOutputs,
 )
+
+from .arguments import (
+    PipelineArgs as PipelineArgs,
+    ArgNamedVariableSet as ArgNamedVariableSet,
+)

luminarycloud/pipelines/arguments.py

@@ -0,0 +1,105 @@
+# Copyright 2025 Luminary Cloud, Inc. All Rights Reserved.
+from typing import Any, Type
+
+from .core import PipelineParameter
+
+
+class _NVS(PipelineParameter):
+    @classmethod
+    def _represented_type(cls) -> Type:
+        return str
+
+    @classmethod
+    def _type_name(cls) -> str:
+        return "Named Variable Set"
+
+    def _validate(self) -> None:
+        if self.name != "$named-variable-set":
+            raise ValueError(
+                "The Named Variable Set PipelineParameter must be named '$named-variable-set'"
+            )
+
+    def _add_to_params(self, params: dict) -> None:
+        raise ValueError(
+            "The NamedVariableSet parameter cannot be used explicitly in a Pipeline. It can only be used in PipelineArgs."
+        )
+
+    def _is_valid_value(self, value: Any) -> bool:
+        return isinstance(value, str) and value.startswith("namedvarset-")
+
+
+ArgNamedVariableSet = _NVS("$named-variable-set")
+"""
+This can be used in a PipelineArgs params list to add a Named Variable Set column to the args table.
+There must be zero or one of these in a PipelineArgs params list.
+"""
+
+# The types that are allowed as PipelineArgs values. This is a union of all concrete
+# PipelineParameters' "represented types".
+PipelineArgValueType = str | int | float | bool
+
+
+class PipelineArgsRow:
+    def __init__(self, args: "PipelineArgs", row_values: list[PipelineArgValueType]):
+        self.args = args
+        self.row_values = row_values
+        self._validate()
+
+    def _validate(self) -> None:
+        if len(self.row_values) != len(self.args.params):
+            raise ValueError(
+                f"PipelineArgs row wrong size. Expected {len(self.args.params)}, got {len(self.row_values)}"
+            )
+        for i, v in enumerate(self.row_values):
+            param = self.args.params[i]
+            if not param._is_valid_value(v):
+                raise ValueError(f"PipelineArgs value {v} is invalid for parameter {param}")
+
+    def value_for(self, param_name: str) -> PipelineArgValueType:
+        return self.row_values[self.args.column_for(param_name)]
+
+    def has_column_for(self, param_name: str) -> bool:
+        return self.args.has_column_for(param_name)
+
+    def __str__(self) -> str:
+        s = "PipelineArgsRow("
+        for i, v in enumerate(self.row_values):
+            s += f"{self.args.params[i].name}={repr(v)}, "
+        s += ")"
+        return s
+
+
+class PipelineArgs:
+    def __init__(self, params: list[PipelineParameter], args: list[list[PipelineArgValueType]]):
+        self.params = params
+        self._param_index_by_name = {p.name: i for i, p in enumerate(params)}
+        self._validate_params()
+        self.rows = [PipelineArgsRow(self, arg) for arg in args]
+
+    def has_column_for(self, param_name: str) -> bool:
+        return param_name in self._param_index_by_name
+
+    def column_for(self, param_name: str) -> int:
+        if not self.has_column_for(param_name):
+            raise ValueError(f'Parameter "{param_name}" not found')
+        return self._param_index_by_name[param_name]
+
+    def _validate_params(self) -> None:
+        has_nvs = False
+        seen_param_names = set()
+        for p in self.params:
+            if isinstance(p, _NVS):
+                if has_nvs:
+                    raise ValueError(
+                        "There can be at most one Named Variable Set column in a PipelineArgs"
+                    )
+                has_nvs = True
+            else:
+                if p.name in seen_param_names:
+                    raise ValueError(f'There is more than one parameter named "{p.name}"')
+                seen_param_names.add(p.name)
+
+    def __str__(self) -> str:
+        return (
+            f"PipelineArgs(param_names={[p.name for p in self.params]}, row_count={len(self.rows)})"
+        )