luminarycloud 0.18.1__py3-none-any.whl → 0.19.1__py3-none-any.whl

luminarycloud/physics_ai/inference.py

@@ -51,8 +51,8 @@ def external_aero_inference(
     project: Project,
     stl_file: str,
     artifact_url: str,
-    parameters: Optional[Dict[str, Any]] = None,
-    stencil_size: int = 1,
+    conditions: Optional[Dict[str, Any]] = None,
+    settings: Optional[Dict[str, Any]] = None,
     write_visualization_data=False,
 ) -> ExtAeroInferenceResult:
     """Performs an inference job returning external aerodynamic results.
@@ -64,10 +64,10 @@ def external_aero_inference(
         Fullpath the STL file 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.
+    conditions : Dict[str, Any], optional
+        Dictionary of conditions to be passed to the inference service (e.g., alpha, beta, etc.).
+    settings : Dict[str, Any], optional
+        Dictionary of settings to be passed to inference service (e.g., stencil_size)
     write_visualization_data : bool, optional
         Whether to write LC visualization data for visualization by Luminary.
 
@@ -80,7 +80,7 @@ def external_aero_inference(
     """
 
     result = perform_inference(
-        project, stl_file, artifact_url, parameters, stencil_size, write_visualization_data
+        project, stl_file, artifact_url, conditions, settings, write_visualization_data
     )
     return ExtAeroInferenceResult(result)
 
@@ -89,8 +89,8 @@ def perform_inference(
     project: Project,
     stl_file: str,
     artifact_url: str,
-    parameters: Optional[Dict[str, Any]] = None,
-    stencil_size: int = 1,
+    conditions: Optional[Dict[str, Any]] = None,
+    settings: Optional[Dict[str, Any]] = None,
     write_visualization_data=False,
 ) -> dict[str, Any]:
     """Creates an inference service job.
@@ -102,10 +102,10 @@ def perform_inference(
         Fullpath the STL file 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.
+    conditions : Dict[str, Any], optional
+        Dictionary of conditions to be passed to the inference service (e.g., alpha, beta, etc.).
+    settings : Dict[str, Any], optional
+        Dictionary of settings to be passed to inference service (e.g., stencil_size)
     write_visualization_data : bool, optional
         Whether to write LC visualization data for visualization by Luminary.
 
@@ -142,7 +142,7 @@ def perform_inference(
     stl_url = upload_if_file(stl_file)
 
     raw = start_inference_job(
-        project, stl_url, artifact_url, parameters, stencil_size, write_visualization_data
+        project, stl_url, artifact_url, conditions, settings, write_visualization_data
     )
     currated: dict[str, Any] = {}
     for k, v in raw.items():
@@ -163,8 +163,8 @@ def start_inference_job(
     project: Project,
     stl_url: str,
     artifact_url: str,
-    parameters: Optional[Dict[str, Any]] = None,
-    stencil_size: int = 1,
+    conditions: Optional[Dict[str, Any]] = None,
+    settings: Optional[Dict[str, Any]] = None,
     write_visualization_data=False,
 ) -> dict[str, Any]:
     """Creates an inference service job.
@@ -176,10 +176,10 @@ def start_inference_job(
         URL of the STL file 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.
+    conditions : Dict[str, Any], optional
+        Dictionary of conditions to be passed to the inference service (e.g., alpha, beta, etc.).
+    settings : Dict[str, Any], optional
+        Dictionary of settings to be passed to inference service (e.g., stencil_size)
     write_visualization_data : bool, optional
         Whether to write LC visualization data for visualization by Luminary.
 
@@ -191,16 +191,21 @@ def start_inference_job(
     warning:: This feature is experimental and may change or be removed without notice.
     """
 
+    # Embed settings and store as bytes
+    settings_bytes = b""
+    if settings is not None:
+        settings_bytes = json_dumps(settings).encode("utf-8")
+
     # Convert parameters dict to bytes if provided
-    parameters_bytes = b""
-    if parameters is not None:
-        parameters_bytes = json_dumps(parameters).encode("utf-8")
+    conditions_bytes = b""
+    if conditions is not None:
+        conditions_bytes = json_dumps(conditions).encode("utf-8")
 
     req = inferencepb.CreateInferenceServiceJobRequest(
         stl_url=stl_url,
         artifact_url=artifact_url,
-        parameters=parameters_bytes,
-        stencil_size=stencil_size,
+        conditions=conditions_bytes,
+        settings=settings_bytes,
         project_id=project.id,
         write_visualization_data=write_visualization_data,
     )

luminarycloud/physics_ai/training_jobs.py

@@ -0,0 +1,37 @@
+# Copyright 2025 Luminary Cloud, Inc. All Rights Reserved.
+from typing import List, Optional
+from datetime import datetime
+
+from .._client import get_default_client
+from .._proto.api.v0.luminarycloud.physics_ai import physics_ai_pb2 as physaipb
+from .._proto.base import base_pb2 as basepb
+from .._wrapper import ProtoWrapper, ProtoWrapperBase
+from ..types.ids import PhysicsAiArchitectureVersionID
+
+
+@ProtoWrapper(physaipb.PhysicsAiTrainingJob)
+class PhysicsAiTrainingJob(ProtoWrapperBase):
+    """
+    Represents a Physics AI training job.
+
+    .. warning:: This feature is experimental and may change or be removed without notice.
+    """
+
+    id: str
+    architecture_version_id: PhysicsAiArchitectureVersionID
+    user_id: str
+    training_config: str
+    training_data_source_type: physaipb.TrainingDataSourceType
+    training_description: str
+    external_dataset_uri: str
+    initialization_type: physaipb.ModelInitializationType
+    base_model_version_id: str
+    status: basepb.JobStatus
+    error_message: str
+    output_model_version_id: str
+    creation_time: datetime
+    update_time: datetime
+    _proto: physaipb.PhysicsAiTrainingJob
+
+    def get_status(self) -> str:
+        return basepb.JobStatusType.Name(self.status.typ)

luminarycloud/pipelines/api.py

@@ -1,14 +1,11 @@
 # Copyright 2023-2024 Luminary Cloud, Inc. All Rights Reserved.
+from typing import Literal
 from dataclasses import dataclass
 
 from datetime import datetime
 
-from luminarycloud._helpers import timestamp_to_datetime
-
-from ..enum.pipeline_job_status import PipelineJobStatus
 from ..pipelines import Pipeline, PipelineArgs
 from .._client import get_default_client
-from .._proto.api.v0.luminarycloud.pipelines import pipelines_pb2 as pipelinespb
 
 
 @dataclass
@@ -17,21 +14,21 @@ class PipelineRecord:
     name: str
     description: str | None
     definition_yaml: str
-    create_time: datetime
-    update_time: datetime
+    created_at: datetime
+    updated_at: datetime
 
     def pipeline(self) -> Pipeline:
         return Pipeline._from_yaml(self.definition_yaml)
 
     @classmethod
-    def from_proto(cls, proto: pipelinespb.Pipeline) -> "PipelineRecord":
+    def from_json(cls, json: dict) -> "PipelineRecord":
         return cls(
-            id=proto.id,
-            name=proto.name,
-            description=proto.description,
-            definition_yaml=proto.definition_yaml,
-            create_time=timestamp_to_datetime(proto.created_at),
-            update_time=timestamp_to_datetime(proto.updated_at),
+            id=json["id"],
+            name=json["name"],
+            description=json["description"],
+            definition_yaml=json["definition_yaml"],
+            created_at=datetime.fromisoformat(json["created_at"]),
+            updated_at=datetime.fromisoformat(json["updated_at"]),
         )
 
 
@@ -42,30 +39,26 @@ class PipelineJobRecord:
     project_id: str
     name: str
     description: str | None
-    status: PipelineJobStatus
-    create_time: datetime
-    update_time: datetime
+    status: Literal["pending", "running", "completed", "failed", "cancelled"]
+    created_at: datetime
+    updated_at: datetime
     started_at: datetime | None
     completed_at: datetime | None
 
     @classmethod
-    def from_proto(cls, proto: pipelinespb.PipelineJob) -> "PipelineJobRecord":
+    def from_json(cls, json: dict) -> "PipelineJobRecord":
         return cls(
-            id=proto.id,
-            pipeline_id=proto.pipeline_id,
-            project_id=proto.project_id,
-            name=proto.name,
-            description=proto.description,
-            status=PipelineJobStatus(proto.status),
-            create_time=timestamp_to_datetime(proto.created_at),
-            update_time=timestamp_to_datetime(proto.updated_at),
-            started_at=(
-                timestamp_to_datetime(proto.started_at) if proto.HasField("started_at") else None
-            ),
+            id=json["id"],
+            pipeline_id=json["pipeline_id"],
+            project_id=json["project_id"],
+            name=json["name"],
+            description=json["description"],
+            status=json["status"],
+            created_at=datetime.fromisoformat(json["created_at"]),
+            updated_at=datetime.fromisoformat(json["updated_at"]),
+            started_at=datetime.fromisoformat(json["started_at"]) if json["started_at"] else None,
             completed_at=(
-                timestamp_to_datetime(proto.completed_at)
-                if proto.HasField("completed_at")
-                else None
+                datetime.fromisoformat(json["completed_at"]) if json["completed_at"] else None
             ),
         )
 
@@ -89,20 +82,21 @@ def create_pipeline(
         definition_yaml = pipeline.to_yaml()
     else:
         definition_yaml = pipeline
-    req = pipelinespb.CreatePipelineRequest(
-        name=name, definition_yaml=definition_yaml, description=description
-    )
-    res: pipelinespb.CreatePipelineResponse = get_default_client().CreatePipeline(req)
-    return PipelineRecord.from_proto(res.pipeline)
+    body = {
+        "name": name,
+        "definition_yaml": definition_yaml,
+        "description": description,
+    }
+    res = get_default_client().http.post("/rest/v0/pipelines", body)
+    return PipelineRecord.from_json(res["data"])
 
 
 def list_pipelines() -> list[PipelineRecord]:
     """
     List all pipelines.
     """
-    req = pipelinespb.ListPipelinesRequest()
-    res: pipelinespb.ListPipelinesResponse = get_default_client().ListPipelines(req)
-    return [PipelineRecord.from_proto(p) for p in res.pipelines]
+    res = get_default_client().http.get("/rest/v0/pipelines")
+    return [PipelineRecord.from_json(p) for p in res["data"]]
 
 
 def get_pipeline(id: str) -> PipelineRecord:
@@ -114,9 +108,8 @@ def get_pipeline(id: str) -> PipelineRecord:
     id : str
         ID of the pipeline to fetch.
     """
-    req = pipelinespb.GetPipelineRequest(id=id)
-    res: pipelinespb.GetPipelineResponse = get_default_client().GetPipeline(req)
-    return PipelineRecord.from_proto(res.pipeline)
+    res = get_default_client().http.get(f"/rest/v0/pipelines/{id}")
+    return PipelineRecord.from_json(res["data"])
 
 
 def create_pipeline_job(
@@ -139,75 +132,30 @@ def create_pipeline_job(
         Description of the pipeline job.
     """
 
-    col_values = [[] for _ in args.params]
-    for row in args.rows:
-        for i, v in enumerate(row.row_values):
-            col_values[i].append(v)
-
-    cols = []
-
-    for i, param in enumerate(args.params):
-        if param._represented_type() == str:
-            cols.append(
-                pipelinespb.PipelineJobArgsColumn(
-                    string_column=pipelinespb.PipelineJobArgsColumn.StringColumn(
-                        name=param.name,
-                        values=col_values[i],
-                    )
-                )
-            )
-        elif param._represented_type() == int:
-            cols.append(
-                pipelinespb.PipelineJobArgsColumn(
-                    int_column=pipelinespb.PipelineJobArgsColumn.IntColumn(
-                        name=param.name,
-                        values=col_values[i],
-                    )
-                )
-            )
-        elif param._represented_type() == float:
-            cols.append(
-                pipelinespb.PipelineJobArgsColumn(
-                    double_column=pipelinespb.PipelineJobArgsColumn.DoubleColumn(
-                        name=param.name,
-                        values=col_values[i],
-                    )
-                )
-            )
-        elif param._represented_type() == bool:
-            cols.append(
-                pipelinespb.PipelineJobArgsColumn(
-                    bool_column=pipelinespb.PipelineJobArgsColumn.BoolColumn(
-                        name=param.name,
-                        values=col_values[i],
-                    )
-                )
-            )
-
-    req = pipelinespb.CreatePipelineJobRequest(
-        pipeline_id=pipeline_id,
-        args_columns=cols,
-        name=name,
-        description=description,
-        project_id=project_id,
-    )
-    res: pipelinespb.CreatePipelineJobResponse = get_default_client().CreatePipelineJob(req)
-    return PipelineJobRecord.from_proto(res.pipeline_job)
+    arg_rows = [row.row_values for row in args.rows]
+    body = {
+        "name": name,
+        "description": description,
+        "project_id": project_id,
+        "argument_names": [p.name for p in args.params],
+        "argument_rows": arg_rows,
+    }
+
+    res = get_default_client().http.post(f"/rest/v0/pipelines/{pipeline_id}/pipeline_jobs", body)
+    return PipelineJobRecord.from_json(res["data"])
 
 
 def get_pipeline_job(id: str) -> PipelineJobRecord:
     """
     Get a pipeline job by ID.
     """
-    req = pipelinespb.GetPipelineJobRequest(id=id)
-    res: pipelinespb.GetPipelineJobResponse = get_default_client().GetPipelineJob(req)
-    return PipelineJobRecord.from_proto(res.pipeline_job)
+    res = get_default_client().http.get(f"/rest/v0/pipeline_jobs/{id}")
+    return PipelineJobRecord.from_json(res["data"])
 
 
 def list_pipeline_jobs() -> list[PipelineJobRecord]:
     """
     List all pipeline jobs.
     """
-    req = pipelinespb.ListPipelineJobsRequest()
-    res: pipelinespb.ListPipelineJobsResponse = get_default_client().ListPipelineJobs(req)
-    return [PipelineJobRecord.from_proto(p) for p in res.pipeline_jobs]
+    res = get_default_client().http.get("/rest/v0/pipeline_jobs")
+    return [PipelineJobRecord.from_json(p) for p in res["data"]]

luminarycloud/project.py

@@ -10,8 +10,6 @@ from typing import TYPE_CHECKING, Any, Dict, List, Optional, Union, Literal
 
 import concurrent
 
-import grpc
-
 import luminarycloud as lc
 from luminarycloud._helpers.named_variables import _named_variables_to_proto
 from luminarycloud.params.simulation.adjoint_ import Adjoint
@@ -258,19 +256,16 @@ class Project(ProtoWrapperBase):
         )
         return lc.Mesh(_mesh)
 
-    @deprecated("Use create_or_get_mesh() instead", "0.10.0")
-    def create_mesh(
+    def create_or_get_mesh(
         self,
         params: MeshAdaptationParams | MeshGenerationParams,
         *,
         name: str,
+        request_id: Optional[str] = None,
     ) -> "Mesh":
         """
-        Create a new mesh in the project.
-
-        .. deprecated:: 0.10.0
-            `create_mesh()` will be removed in v0.11.0, it is replaced by
-            `create_or_get_mesh()`.
+        Create a new mesh in the project, or return an existing mesh with the same request_id
+        if it already exists.
 
         Parameters
         ----------
@@ -279,14 +274,24 @@ class Project(ProtoWrapperBase):
             existing geometry, use MeshGenerationParams. If adapting a mesh from an existing,
             solution use MeshAdaptationParams.
         name : str
-            (Optional) Mesh name. Max 256 characters.
+            Mesh name. Max 256 characters.
+        request_id : str, optional
+            Can be useful as an idempotency key. If there's an existing Mesh with the given
+            request_id, that Mesh will be returned. If there's no existing Mesh with the given
+            request_id, then a Mesh will be created and associated with that request_id. If not
+            provided, a random request_id will be generated for the Mesh, effectively preventing it
+            from being retrieved by a future `create_or_get_mesh` request. Max 256 characters.
         """
 
+        if request_id is None:
+            request_id = str(uuid.uuid4())
+
         client = get_default_client()
 
         req = meshpb.CreateMeshRequest(
             project_id=self.id,
             name=name,
+            request_id=request_id,
         )
 
         if isinstance(params, meshpb.MeshGenerationParams):
@@ -314,39 +319,6 @@ class Project(ProtoWrapperBase):
         res: meshpb.CreateMeshResponse = client.CreateMesh(req)
         return lc.Mesh(res.mesh)
 
-    def create_or_get_mesh(
-        self,
-        params: MeshAdaptationParams | MeshGenerationParams,
-        *,
-        name: str,
-    ) -> "Mesh":
-        """
-        Create a new mesh in the project, or return an existing mesh with the same parameters
-        if it already exists.
-
-        Parameters
-        ----------
-        params : MeshGenerationParams | MeshAdaptationParams
-            The parameters to use to create the mesh. If generating a new mesh from an
-            existing geometry, use MeshGenerationParams. If adapting a mesh from an existing,
-            solution use MeshAdaptationParams.
-        name : str
-            Mesh name. Max 256 characters.
-        """
-
-        try:
-            return self.create_mesh(params, name=name)
-        except grpc.RpcError as e:
-            if e.code() == grpc.StatusCode.ALREADY_EXISTS:
-                message = e.details()
-                match = re.search(r"mesh-[a-f0-9-]+$", message)
-                if match:
-                    existing_mesh_id = match.group(0)
-                    req = meshpb.GetMeshRequest(id=existing_mesh_id)
-                    res = get_default_client().GetMesh(req)
-                    return lc.Mesh(res.mesh)
-            raise
-
     def _create_hex_mesh(
         self,
         names_to_file_paths: Dict[str, Union[PathLike[Any], str]],

luminarycloud/simulation.py

@@ -57,6 +57,8 @@ class Simulation(ProtoWrapperBase):
     "ID of the simulation mesh."
     project_id: ProjectID
     "ID of the project containing this simulation."
+    doe_name: str
+    "Name of the design of experiments that created this simulation."
 
     _proto: simulationpb.Simulation
 

luminarycloud/simulation_template.py

@@ -490,7 +490,8 @@ class SimulationTemplate(ProtoWrapperBase):
         code += "\n\n\n"
         code += '# Create a new simulation template or modify the one that is synced with the UI "Setup" tab.\n'
         code += f'project = luminarycloud.get_project("{self.project_id}")\n'
-        code += f"template = project.create_simulation_template(name={self.name})\n"
+        escaped_name = self.name.replace('\\','\\\\').replace('"','\\"')
+        code += f'template = project.create_simulation_template(name="{escaped_name}")\n'
         code += '# TODO(USER): To modify the "Setup" template, uncomment the line below and comment out the line above.\n'
         code += "# template = project.list_simulation_templates()[0] # Setup template\n\n"
 

luminarycloud/tables.py

@@ -10,7 +10,6 @@ from typing import Union
 from .enum import TableType, QuantityType
 from ._helpers import CodeRepr
 from ._proto.table import table_pb2 as tablepb
-from ._proto.quantity import quantity_pb2 as quantitypb
 
 
 def create_rectilinear_table(
@@ -37,30 +36,30 @@ def create_rectilinear_table(
     def lc_defined_header(table_type: TableType) -> list[Union[int, str]]:
         """Returns the required header (if any) for a type of table."""
         if table_type == TableType.MONITOR_POINTS:
-            return [quantitypb.LENGTH, quantitypb.LENGTH, quantitypb.LENGTH, "name", "id"]
+            return [QuantityType.LENGTH, QuantityType.LENGTH, QuantityType.LENGTH, "name", "id"]
         elif table_type == TableType.RADIAL_DISTRIBUTION:
             return [
-                quantitypb.RELATIVE_RADIUS,
-                quantitypb.THRUST_PROFILE,
-                quantitypb.TORQUE_PROFILE,
-                quantitypb.RADIAL_FORCE_PROFILE,
+                QuantityType.RELATIVE_RADIUS,
+                QuantityType.THRUST_PROFILE,
+                QuantityType.TORQUE_PROFILE,
+                QuantityType.RADIAL_FORCE_PROFILE,
             ]
         elif table_type == TableType.BLADE_GEOMETRY:
             return [
-                quantitypb.RELATIVE_RADIUS,
-                quantitypb.TWIST_ANGLE,
-                quantitypb.SWEEP_ANGLE,
-                quantitypb.ANHEDRAL_ANGLE,
-                quantitypb.RELATIVE_CHORD,
+                QuantityType.RELATIVE_RADIUS,
+                QuantityType.TWIST_ANGLE,
+                QuantityType.SWEEP_ANGLE,
+                QuantityType.ANHEDRAL_ANGLE,
+                QuantityType.RELATIVE_CHORD,
             ]
         elif table_type == TableType.PROFILE_BC:
             return []
         elif table_type == TableType.FAN_CURVE:
-            return [quantitypb.VOLUME_FLOW_RATE, quantitypb.PRESSURE_RISE]
+            return [QuantityType.VOLUME_FLOW_RATE, QuantityType.PRESSURE_RISE]
         elif table_type == TableType.CUSTOM_SAMPLE_DOE:
             return []
         elif table_type == TableType.TEMP_VARYING:
-            return [quantitypb.TEMPERATURE, "quantity"]
+            return [QuantityType.TEMPERATURE, "quantity"]
         else:
             raise RuntimeError("Unknown type of table.")
 
@@ -113,7 +112,7 @@ def create_rectilinear_table(
         if isinstance(first_header, str):
             table.header.axis_label[-1].name = first_header
         else:
-            table.header.axis_label[-1].quantity = QuantityType(first_header).value
+            table.header.axis_label[-1].quantity = first_header.value
         table.axis.append(tablepb.Axis())
 
     for label in header[has_axis(table_type) :]:
@@ -121,7 +120,7 @@ def create_rectilinear_table(
         if isinstance(label, str):
             table.header.record_label[-1].name = label
         else:
-            table.header.record_label[-1].quantity = QuantityType(label).value
+            table.header.record_label[-1].quantity = label.value
 
     types = data_types(table_type, len(header))
 

luminarycloud/vis/visualization.py

@@ -14,7 +14,6 @@ from luminarycloud.types import Vector3, Vector3Like
 from .._client import get_default_client
 from .._helpers._get_project_id import _get_project_id
 from .._helpers._code_representation import CodeRepr
-from .._proto.quantity import quantity_pb2 as quantitypb
 from .._proto.api.v0.luminarycloud.vis import vis_pb2
 from ..types import SimulationID, MeshID
 from luminarycloud.enum import (
@@ -24,6 +23,7 @@ from luminarycloud.enum import (
     EntityType,
     SceneMode,
     VisQuantity,
+    QuantityType,
 )
 from ..exceptions import NotFoundError
 from ..geometry import Geometry, get_geometry
@@ -657,7 +657,7 @@ class Scene(CodeRepr):
             attrs = vis_pb2.DisplayAttributes()
             attrs.visible = visible
             attrs.field.component = vis_pb2.Field.COMPONENT_X
-            attrs.field.quantity_typ = quantitypb.INVALID_QUANTITY_TYPE
+            attrs.field.quantity_typ = QuantityType.UNSPECIFIED.value
             req.spec.display_attributes[id].CopyFrom(attrs)
 
         self._validate_filter_connections()

{luminarycloud-0.18.1.dist-info → luminarycloud-0.19.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: luminarycloud
-Version: 0.18.1
+Version: 0.19.1
 Summary: Luminary Cloud SDK
 Project-URL: Homepage, https://www.luminarycloud.com/
 Project-URL: Documentation, https://app.luminarycloud.com/docs/api/