luminarycloud 0.15.3__py3-none-any.whl → 0.15.4__py3-none-any.whl

luminarycloud/enum/physics_ai_lifecycle_state.py

@@ -0,0 +1,30 @@
+# Copyright 2025 Luminary Cloud, Inc. All Rights Reserved.
+from enum import IntEnum
+from .._proto.api.v0.luminarycloud.physics_ai.physics_ai_pb2 import (
+    PhysicsAiLifecycleState as PhysicsAiLifecycleStatePb,
+)
+
+
+class PhysicsAiLifecycleState(IntEnum):
+    """
+    Represents the lifecycle state of a Physics AI resource (architecture or model version).
+
+    Attributes
+    ----------
+    UNSPECIFIED
+        Default value, should not be used in practice.
+    DEVELOPMENT
+        Not ready for general use.
+    ACTIVE
+        Available for new training jobs.
+    DEPRECATED
+        Can still serve inference, but not used for new training.
+    RETIRED
+        Archived; no training or inference support.
+    """
+
+    UNSPECIFIED = PhysicsAiLifecycleStatePb.LIFECYCLE_STATE_UNSPECIFIED
+    DEVELOPMENT = PhysicsAiLifecycleStatePb.LIFECYCLE_STATE_DEVELOPMENT
+    ACTIVE = PhysicsAiLifecycleStatePb.LIFECYCLE_STATE_ACTIVE
+    DEPRECATED = PhysicsAiLifecycleStatePb.LIFECYCLE_STATE_DEPRECATED
+    RETIRED = PhysicsAiLifecycleStatePb.LIFECYCLE_STATE_RETIRED

luminarycloud/enum/quantity_type.py

@@ -2,6 +2,7 @@
 from enum import IntEnum
 from .._proto.quantity import quantity_pb2 as quantitypb
 from .._proto.quantity import quantity_options_pb2 as quantityoptspb
+from luminarycloud.enum.vis_enums import VisQuantity
 
 
 class QuantityType(IntEnum):
@@ -130,6 +131,34 @@ class QuantityType(IntEnum):
     INNER_ITERATION_COUNT = quantitypb.INNER_ITERATION_COUNT
     MASS_FLOW = quantitypb.MASS_FLOW
 
+    # Quantities needed for visualization validation
+    ABSOLUTE_PRESSURE = quantitypb.ABSOLUTE_PRESSURE
+    Q_CRITERION = quantitypb.Q_CRITERION
+    WALL_SHEAR_STRESS = quantitypb.WALL_SHEAR_STRESS
+    EDDY_VISCOSITY = quantitypb.EDDY_VISCOSITY
+    VISCOSITY = quantitypb.VISCOSITY
+    SA_VARIABLE = quantitypb.SA_VARIABLE
+    TKE = quantitypb.TKE
+    OMEGA = quantitypb.OMEGA
+    GAMMA = quantitypb.GAMMA
+    RE_THETA = quantitypb.RE_THETA
+    N_TILDE = quantitypb.N_TILDE
+    RE_ROUGHNESS = quantitypb.RE_ROUGHNESS
+    MASS_FLUX = quantitypb.MASS_FLUX
+    HEAT_FLUX = quantitypb.HEAT_FLUX
+    HEAT_TRANSFER_COEFFICIENT = quantitypb.HEAT_TRANSFER_COEFFICIENT
+    GRID_VELOCITY = quantitypb.GRID_VELOCITY
+    RELATIVE_VELOCITY = quantitypb.RELATIVE_VELOCITY
+    RELATIVE_MACH = quantitypb.RELATIVE_MACH
+    PRESSURE_COEFFICIENT = quantitypb.PRESSURE_COEFFICIENT
+    TOTAL_PRESSURE_COEFFICIENT = quantitypb.TOTAL_PRESSURE_COEFFICIENT
+    SKIN_FRICTION_COEFFICIENT = quantitypb.SKIN_FRICTION_COEFFICIENT
+    ADJOINT_RE_THETA = quantitypb.ADJOINT_RE_THETA
+    ADJOINT_N_TILDE = quantitypb.ADJOINT_N_TILDE
+    SENSITIVITY = quantitypb.SENSITIVITY
+    NORMAL_SENSITIVITY = quantitypb.NORMAL_SENSITIVITY
+    SMOOTHED_NORMAL_SENSITIVITY = quantitypb.SMOOTHED_NORMAL_SENSITIVITY
+
     @classmethod
     def _is_average(cls, quantity: "QuantityType") -> bool:
         return quantity._has_tag(quantityoptspb.TAG_ANALYZER_AVERAGE)
@@ -138,6 +167,10 @@ class QuantityType(IntEnum):
     def _is_force(cls, quantity: "QuantityType") -> bool:
         return quantity._has_tag(quantityoptspb.TAG_ANALYZER_FORCES)
 
+    @classmethod
+    def _from_string(cls, quantity: str) -> "QuantityType":
+        return cls[quantity.upper()]
+
     def _has_tag(self, tag: int | str) -> bool:
         """
         Check if the QuantityType has a given QuantityTag.
@@ -169,3 +202,13 @@ def _get_quantity_metadata(quantity_type: QuantityType) -> quantityoptspb.Quanti
         .GetOptions()
         .Extensions[quantitypb.quantity]
     )
+
+
+def _is_vector(quantity: QuantityType | VisQuantity) -> bool:
+    """
+    Returns True if the quantity is a vector type, False otherwise.
+    """
+    # Vis quanititys are a subset of QuantityType, so we can cast it.
+    q_type = QuantityType(quantity.value)
+    meta = _get_quantity_metadata(q_type)
+    return meta.size == 3

luminarycloud/enum/vis_enums.py

@@ -90,8 +90,8 @@ class Representation(IntEnum):
 
 class FieldComponent(IntEnum):
     """
-    Specifies which component of a field is used for visualization.
-    When using scalars, the X component is the only valid component.
+    Specifies which component of a vector field is used for visualization.
+    When using scalars, the component is ignored.
 
     .. warning:: This feature is experimental and may change or be removed in the future.
 
@@ -192,6 +192,9 @@ class RenderStatusType(IntEnum):
     INVALID = vis_pb2.Invalid
 
 
+ExtractStatusType = RenderStatusType
+
+
 class EntityType(IntEnum):
     """
     An enum for specifying the source of an image. When listing extracts,
@@ -282,3 +285,4 @@ class SceneMode(str, Enum):
 
     INLINE = "inline"
     SIDE_PANEL = "side_panel"
+    FULLSCREEN = "fullscreen"

luminarycloud/geometry.py

@@ -5,11 +5,12 @@ from datetime import datetime
 import random
 from uuid import uuid4
 import time
-from typing import Sequence
+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
@@ -23,8 +24,9 @@ from .params.geometry import (
     Shape,
     shapes,
 )
-from .types import Vector3, GeometryFeatureID, ProjectID
+from .types import Vector3, GeometryFeatureID, ProjectID, NamedVariableSetID
 from .volume_selection import VolumeSelection
+from .named_variable_set import NamedVariableSet, get_named_variable_set
 
 if TYPE_CHECKING:
     from .project import Project
@@ -63,6 +65,23 @@ class Geometry(ProtoWrapperBase):
         """
         return lc.get_project(ProjectID(self._proto.project_id))
 
+    def update(self, *, name: str | None = None) -> None:
+        """
+        Update the geometry.
+
+        Parameters
+        ----------
+        name : str, optional
+            A new name for the geometry. Will be left unchanged if not provided.
+        """
+        if name is not None:
+            req = geometrypb.UpdateGeometryRequest(
+                geometry_id=self.id,
+                name=name,
+            )
+            res = get_default_client().UpdateGeometry(req)
+            self._proto = res.geometry
+
     def copy(self, name: str = "") -> "Geometry":
         """
         Copy the geometry.
@@ -93,6 +112,31 @@ 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.
+
+        Parameters
+        ----------
+        named_variable_set : NamedVariableSet | str
+            The named variable set to use for the geometry. Can be a NamedVariableSet object or a
+            named variable set ID.
+        """
+        version_id = None
+        if isinstance(named_variable_set, str):
+            version_id = get_named_variable_set(NamedVariableSetID(named_variable_set))._version_id
+        else:
+            version_id = named_variable_set._version_id
+        self._modify(
+            modification=gpb.Modification(
+                mod_type=gpb.Modification.MODIFICATION_TYPE_UPDATE_NAMED_VARIABLE_SET,
+                update_named_variable_set_version_id=version_id,
+            )
+        )
+
     def add_farfield(self, shape: Shape, propagate_tool_tags: bool = True) -> None:
         """
         Create a farfield feature in the geometry.

luminarycloud/named_variable_set.py

@@ -9,7 +9,7 @@ from ._proto.api.v0.luminarycloud.named_variable_set import (
     named_variable_set_pb2 as namedvariablepb,
 )
 from ._wrapper import ProtoWrapper, ProtoWrapperBase
-from .types import ProjectID, NamedVariableSetID
+from .types import ProjectID, NamedVariableSetID, LcFloat
 
 
 @experimental
@@ -50,7 +50,7 @@ class NamedVariableSet(ProtoWrapperBase):
     "ID of the project containing this named variable set."
 
     _proto: namedvariablepb.NamedVariableSet
-    _named_variables: dict[str, float | str] | None
+    _named_variables: dict[str, LcFloat] | None
 
     @property
     def name(self) -> str:
@@ -69,6 +69,10 @@ class NamedVariableSet(ProtoWrapperBase):
     def update_time(self) -> datetime:
         return timestamp_to_datetime(self._proto.update_time)
 
+    @property
+    def _version_id(self) -> str:
+        return self._proto.version_id
+
     def save(self) -> None:
         """Save the named variable set."""
         req = namedvariablepb.UpdateNamedVariableSetRequest(
@@ -92,10 +96,10 @@ class NamedVariableSet(ProtoWrapperBase):
         req = namedvariablepb.DeleteNamedVariableSetRequest(id=self.id)
         get_default_client().DeleteNamedVariableSet(req)
 
-    def __getitem__(self, key: str) -> float | str:
+    def __getitem__(self, key: str) -> LcFloat:
         return self._get_named_variables()[key]
 
-    def __setitem__(self, key: str, value: float | str) -> None:
+    def __setitem__(self, key: str, value: LcFloat) -> None:
         self._get_named_variables()[key] = value
 
     def __delitem__(self, key: str) -> None:
@@ -107,7 +111,7 @@ class NamedVariableSet(ProtoWrapperBase):
     def __len__(self) -> int:
         return len(self._get_named_variables())
 
-    def _get_named_variables(self) -> dict[str, float | str]:
+    def _get_named_variables(self) -> dict[str, LcFloat]:
         if getattr(self, "_named_variables", None) is None:
             named_variables_dict = dict(self._proto.named_variables)
             self._named_variables = _named_variables_from_proto(named_variables_dict)
@@ -115,6 +119,7 @@ class NamedVariableSet(ProtoWrapperBase):
         return self._named_variables
 
 
+@experimental
 def get_named_variable_set(id: NamedVariableSetID) -> NamedVariableSet:
     """
     Retrieve a specific named variable set by ID.

luminarycloud/params/enum/_enum_wrappers.py

@@ -5,6 +5,30 @@ from enum import IntEnum as _IntEnum
 from luminarycloud._proto.client import simulation_pb2 as _clientpb
 
 
+class HeatFluxConvention(_IntEnum):
+    """
+    Convention for the direction of positive heat flux.
+
+    Attributes
+    ----------
+    CONVENTION_HEAT_FLUX_OUT
+        Heat leaving the domain is positive.
+    CONVENTION_HEAT_FLUX_IN
+        Heat entering the domain is positive
+
+
+    Examples
+    --------
+    >>> from luminarycloud.params.enum import HeatFluxConvention
+    >>> HeatFluxConvention.CONVENTION_HEAT_FLUX_OUT
+    >>> HeatFluxConvention.CONVENTION_HEAT_FLUX_IN
+    """
+
+    INVALID = _clientpb.INVALID_HEAT_FLUX_CONVENTION
+    CONVENTION_HEAT_FLUX_OUT = _clientpb.CONVENTION_HEAT_FLUX_OUT
+    CONVENTION_HEAT_FLUX_IN = _clientpb.CONVENTION_HEAT_FLUX_IN
+
+
 class UnitSystem(_IntEnum):
     """
     Collection of units used for all quantities.
@@ -610,6 +634,26 @@ class FlowBehavior(_IntEnum):
     TRANSIENT = _clientpb.TRANSIENT
 
 
+class NonlinearControlMethod(_IntEnum):
+    """
+    The method used to determine 'input' such that 'output'('input') = 'target'.
+
+    Attributes
+    ----------
+    CONTROL_METHOD_SECANT
+        Use the secant method to solve the equations.
+
+
+    Examples
+    --------
+    >>> from luminarycloud.params.enum import NonlinearControlMethod
+    >>> NonlinearControlMethod.CONTROL_METHOD_SECANT
+    """
+
+    INVALID = _clientpb.INVALID_NONLINEAR_CONTROL_METHOD
+    CONTROL_METHOD_SECANT = _clientpb.CONTROL_METHOD_SECANT
+
+
 class TimeImplicitOrder(_IntEnum):
     """
     Temporal order of accuracy of the dual time stepping scheme for time-accurate integration.
@@ -751,6 +795,30 @@ class DebugOutputInteriorSurfaceData(_IntEnum):
     SOLN_DEBUG_OUTPUT_INT_SURF_DATA_ON = _clientpb.SOLN_DEBUG_OUTPUT_INT_SURF_DATA_ON
 
 
+class ReferenceType(_IntEnum):
+    """
+    Method of specification for the reference values used in force and moment computations.
+
+    Attributes
+    ----------
+    PRESCRIBE_VALUES
+        User-defined force reference values.
+    REFERENCE_FARFIELD_VALUES
+        Force reference values from the farfield conditions.
+
+
+    Examples
+    --------
+    >>> from luminarycloud.params.enum import ReferenceType
+    >>> ReferenceType.PRESCRIBE_VALUES
+    >>> ReferenceType.REFERENCE_FARFIELD_VALUES
+    """
+
+    INVALID = _clientpb.INVALID_REFERENCE_TYPE
+    PRESCRIBE_VALUES = _clientpb.PRESCRIBE_VALUES
+    REFERENCE_FARFIELD_VALUES = _clientpb.REFERENCE_FARFIELD_VALUES
+
+
 class MeshingMethod(_IntEnum):
     """
     The method to generate the computational mesh.

luminarycloud/params/simulation/_lib.py

@@ -6,7 +6,7 @@ from typing import Any, TypeVar, Generic, Type
 from uuid import uuid4
 
 from luminarycloud.tables import RectilinearTable, _param_name_to_table_type
-from luminarycloud.types import Vector3
+from luminarycloud.types import Vector3, LcFloat
 from luminarycloud._proto.client import simulation_pb2 as clientpb
 from luminarycloud._proto.client.entity_pb2 import EntityIdentifier
 import luminarycloud.params.enum._enum_wrappers as enum

luminarycloud/params/simulation/adaptive_mesh_refinement/boundary_layer_profile_.py

@@ -5,12 +5,11 @@ from dataclasses import dataclass, field
 from typing import Any
 from uuid import uuid4
 
-from luminarycloud.tables import RectilinearTable, _param_name_to_table_type
 from google.protobuf.message import Message as _Message
-
-from luminarycloud.tables import RectilinearTable
-from luminarycloud.types import Vector3
+from luminarycloud.tables import RectilinearTable, _param_name_to_table_type
+from luminarycloud.types import Vector3, LcFloat
 from luminarycloud.types.adfloat import _to_ad_proto, _from_ad_proto
+from luminarycloud._helpers._entity_identifier import _create_entity_identifier
 from luminarycloud._proto.client import simulation_pb2 as clientpb
 from luminarycloud._proto.client.entity_pb2 import EntityIdentifier
 from luminarycloud._helpers import CodeRepr
@@ -25,9 +24,9 @@ class BoundaryLayerProfile(CodeRepr, ParamGroupWrapper[clientpb.BoundaryLayerPro
 
     n_layers: int = 40
     "Maximum number of prism layers within a boundary layer mesh."
-    initial_size: float = 1e-06
+    initial_size: LcFloat = 1e-06
     "Size of the mesh layer nearest the boundary surface in meters."
-    growth_rate: float = 1.2
+    growth_rate: LcFloat = 1.2
     "Ratio of size between 2 successive boundary mesh layers."
     surfaces: list[str] = field(default_factory=list)
     ""

luminarycloud/params/simulation/adaptive_mesh_refinement_.py

@@ -5,12 +5,11 @@ from dataclasses import dataclass, field
 from typing import Any
 from uuid import uuid4
 
-from luminarycloud.tables import RectilinearTable, _param_name_to_table_type
 from google.protobuf.message import Message as _Message
-
-from luminarycloud.tables import RectilinearTable
-from luminarycloud.types import Vector3
+from luminarycloud.tables import RectilinearTable, _param_name_to_table_type
+from luminarycloud.types import Vector3, LcFloat
 from luminarycloud.types.adfloat import _to_ad_proto, _from_ad_proto
+from luminarycloud._helpers._entity_identifier import _create_entity_identifier
 from luminarycloud._proto.client import simulation_pb2 as clientpb
 from luminarycloud._proto.client.entity_pb2 import EntityIdentifier
 from luminarycloud._helpers import CodeRepr
@@ -34,15 +33,15 @@ class AdaptiveMeshRefinement(CodeRepr, ParamGroupWrapper[clientpb.AdaptiveMeshRe
     "Number of solver iterations to perform before dispatching refinement."
     max_refinement_interval: int = 0
     "Maximum number of solver iterations to perform before waiting for refinement to complete."
-    initial_target_complexity: float = 0
+    initial_target_complexity: LcFloat = 0
     "Target Complexity on the first refinement iteration."
-    final_target_complexity: float = 0
+    final_target_complexity: LcFloat = 0
     "Target Complexity on the final refinement iteration."
     meshing_method: enum.MeshingMethod = enum.MeshingMethod.MESH_METHOD_MANUAL
     "The method to generate the computational mesh."
     target_cv_millions: int = 10
     "User-requested mesh size in millions of control volumes."
-    user_scaling: float = 1.0
+    user_scaling: LcFloat = 1.0
     "Scale factor between the geometry and the mesh."
     boundary_layer_profile: list[BoundaryLayerProfile] = field(default_factory=list)
     ""

luminarycloud/params/simulation/adjoint_.py

@@ -5,12 +5,11 @@ from dataclasses import dataclass, field
 from typing import Any
 from uuid import uuid4
 
-from luminarycloud.tables import RectilinearTable, _param_name_to_table_type
 from google.protobuf.message import Message as _Message
-
-from luminarycloud.tables import RectilinearTable
-from luminarycloud.types import Vector3
+from luminarycloud.tables import RectilinearTable, _param_name_to_table_type
+from luminarycloud.types import Vector3, LcFloat
 from luminarycloud.types.adfloat import _to_ad_proto, _from_ad_proto
+from luminarycloud._helpers._entity_identifier import _create_entity_identifier
 from luminarycloud._proto.client import simulation_pb2 as clientpb
 from luminarycloud._proto.client.entity_pb2 import EntityIdentifier
 from luminarycloud._helpers import CodeRepr

luminarycloud/params/simulation/basic/gravity/gravity_off_.py

@@ -5,12 +5,11 @@ from dataclasses import dataclass, field
 from typing import Any
 from uuid import uuid4
 
-from luminarycloud.tables import RectilinearTable, _param_name_to_table_type
 from google.protobuf.message import Message as _Message
-
-from luminarycloud.tables import RectilinearTable
-from luminarycloud.types import Vector3
+from luminarycloud.tables import RectilinearTable, _param_name_to_table_type
+from luminarycloud.types import Vector3, LcFloat
 from luminarycloud.types.adfloat import _to_ad_proto, _from_ad_proto
+from luminarycloud._helpers._entity_identifier import _create_entity_identifier
 from luminarycloud._proto.client import simulation_pb2 as clientpb
 from luminarycloud._proto.client.entity_pb2 import EntityIdentifier
 from luminarycloud._helpers import CodeRepr

luminarycloud/params/simulation/basic/gravity/gravity_on_.py

@@ -5,12 +5,11 @@ from dataclasses import dataclass, field
 from typing import Any
 from uuid import uuid4
 
-from luminarycloud.tables import RectilinearTable, _param_name_to_table_type
 from google.protobuf.message import Message as _Message
-
-from luminarycloud.tables import RectilinearTable
-from luminarycloud.types import Vector3
+from luminarycloud.tables import RectilinearTable, _param_name_to_table_type
+from luminarycloud.types import Vector3, LcFloat
 from luminarycloud.types.adfloat import _to_ad_proto, _from_ad_proto
+from luminarycloud._helpers._entity_identifier import _create_entity_identifier
 from luminarycloud._proto.client import simulation_pb2 as clientpb
 from luminarycloud._proto.client.entity_pb2 import EntityIdentifier
 from luminarycloud._helpers import CodeRepr

luminarycloud/params/simulation/basic/gravity_.py

@@ -5,12 +5,11 @@ from dataclasses import dataclass, field
 from typing import Any
 from uuid import uuid4
 
-from luminarycloud.tables import RectilinearTable, _param_name_to_table_type
 from google.protobuf.message import Message as _Message
-
-from luminarycloud.tables import RectilinearTable
-from luminarycloud.types import Vector3
+from luminarycloud.tables import RectilinearTable, _param_name_to_table_type
+from luminarycloud.types import Vector3, LcFloat
 from luminarycloud.types.adfloat import _to_ad_proto, _from_ad_proto
+from luminarycloud._helpers._entity_identifier import _create_entity_identifier
 from luminarycloud._proto.client import simulation_pb2 as clientpb
 from luminarycloud._proto.client.entity_pb2 import EntityIdentifier
 from luminarycloud._helpers import CodeRepr

luminarycloud/params/simulation/body_frame_.py

@@ -5,12 +5,11 @@ from dataclasses import dataclass, field
 from typing import Any
 from uuid import uuid4
 
-from luminarycloud.tables import RectilinearTable, _param_name_to_table_type
 from google.protobuf.message import Message as _Message
-
-from luminarycloud.tables import RectilinearTable
-from luminarycloud.types import Vector3
+from luminarycloud.tables import RectilinearTable, _param_name_to_table_type
+from luminarycloud.types import Vector3, LcFloat
 from luminarycloud.types.adfloat import _to_ad_proto, _from_ad_proto
+from luminarycloud._helpers._entity_identifier import _create_entity_identifier
 from luminarycloud._proto.client import simulation_pb2 as clientpb
 from luminarycloud._proto.client.entity_pb2 import EntityIdentifier
 from luminarycloud._helpers import CodeRepr

luminarycloud/params/simulation/entity_relationships/volume_material_relationship_.py

@@ -5,12 +5,11 @@ from dataclasses import dataclass, field
 from typing import Any
 from uuid import uuid4
 
-from luminarycloud.tables import RectilinearTable, _param_name_to_table_type
 from google.protobuf.message import Message as _Message
-
-from luminarycloud.tables import RectilinearTable
-from luminarycloud.types import Vector3
+from luminarycloud.tables import RectilinearTable, _param_name_to_table_type
+from luminarycloud.types import Vector3, LcFloat
 from luminarycloud.types.adfloat import _to_ad_proto, _from_ad_proto
+from luminarycloud._helpers._entity_identifier import _create_entity_identifier
 from luminarycloud._proto.client import simulation_pb2 as clientpb
 from luminarycloud._proto.client.entity_pb2 import EntityIdentifier
 from luminarycloud._helpers import CodeRepr
@@ -23,9 +22,13 @@ from luminarycloud.params.simulation._lib import ParamGroupWrapper, create_uniqu
 class VolumeMaterialRelationship(CodeRepr, ParamGroupWrapper[clientpb.VolumeMaterialRelationship]):
     """Tracks volume entity(1) -> material entity(1) relationship."""
 
-    volume_identifier: EntityIdentifier | None = None
+    volume_identifier: EntityIdentifier = field(
+        default_factory=_create_entity_identifier, init=True
+    )
     "Unique identifier for a volume entity."
-    material_identifier: EntityIdentifier | None = None
+    material_identifier: EntityIdentifier = field(
+        default_factory=_create_entity_identifier, init=True
+    )
     "Unique identifier for a material entity."
 
     def _to_proto(self) -> clientpb.VolumeMaterialRelationship:

luminarycloud/params/simulation/entity_relationships/volume_physics_relationship_.py

@@ -5,12 +5,11 @@ from dataclasses import dataclass, field
 from typing import Any
 from uuid import uuid4
 
-from luminarycloud.tables import RectilinearTable, _param_name_to_table_type
 from google.protobuf.message import Message as _Message
-
-from luminarycloud.tables import RectilinearTable
-from luminarycloud.types import Vector3
+from luminarycloud.tables import RectilinearTable, _param_name_to_table_type
+from luminarycloud.types import Vector3, LcFloat
 from luminarycloud.types.adfloat import _to_ad_proto, _from_ad_proto
+from luminarycloud._helpers._entity_identifier import _create_entity_identifier
 from luminarycloud._proto.client import simulation_pb2 as clientpb
 from luminarycloud._proto.client.entity_pb2 import EntityIdentifier
 from luminarycloud._helpers import CodeRepr
@@ -23,9 +22,13 @@ from luminarycloud.params.simulation._lib import ParamGroupWrapper, create_uniqu
 class VolumePhysicsRelationship(CodeRepr, ParamGroupWrapper[clientpb.VolumePhysicsRelationship]):
     """Tracks volume entity(1) -> physics entity(1) relationship."""
 
-    volume_identifier: EntityIdentifier | None = None
+    volume_identifier: EntityIdentifier = field(
+        default_factory=_create_entity_identifier, init=True
+    )
     "Unique identifier for a volume entity."
-    physics_identifier: EntityIdentifier | None = None
+    physics_identifier: EntityIdentifier = field(
+        default_factory=_create_entity_identifier, init=True
+    )
     "Unique identifier for a physics entity."
 
     def _to_proto(self) -> clientpb.VolumePhysicsRelationship:

luminarycloud/params/simulation/entity_relationships_.py

@@ -5,12 +5,11 @@ from dataclasses import dataclass, field
 from typing import Any
 from uuid import uuid4
 
-from luminarycloud.tables import RectilinearTable, _param_name_to_table_type
 from google.protobuf.message import Message as _Message
-
-from luminarycloud.tables import RectilinearTable
-from luminarycloud.types import Vector3
+from luminarycloud.tables import RectilinearTable, _param_name_to_table_type
+from luminarycloud.types import Vector3, LcFloat
 from luminarycloud.types.adfloat import _to_ad_proto, _from_ad_proto
+from luminarycloud._helpers._entity_identifier import _create_entity_identifier
 from luminarycloud._proto.client import simulation_pb2 as clientpb
 from luminarycloud._proto.client.entity_pb2 import EntityIdentifier
 from luminarycloud._helpers import CodeRepr

luminarycloud/params/simulation/general_.py

@@ -5,12 +5,11 @@ from dataclasses import dataclass, field
 from typing import Any
 from uuid import uuid4
 
-from luminarycloud.tables import RectilinearTable, _param_name_to_table_type
 from google.protobuf.message import Message as _Message
-
-from luminarycloud.tables import RectilinearTable
-from luminarycloud.types import Vector3
+from luminarycloud.tables import RectilinearTable, _param_name_to_table_type
+from luminarycloud.types import Vector3, LcFloat
 from luminarycloud.types.adfloat import _to_ad_proto, _from_ad_proto
+from luminarycloud._helpers._entity_identifier import _create_entity_identifier
 from luminarycloud._proto.client import simulation_pb2 as clientpb
 from luminarycloud._proto.client.entity_pb2 import EntityIdentifier
 from luminarycloud._helpers import CodeRepr

luminarycloud/params/simulation/material/fluid/boussinesq_approximation/boussinesq_off_.py

@@ -5,12 +5,11 @@ from dataclasses import dataclass, field
 from typing import Any
 from uuid import uuid4
 
-from luminarycloud.tables import RectilinearTable, _param_name_to_table_type
 from google.protobuf.message import Message as _Message
-
-from luminarycloud.tables import RectilinearTable
-from luminarycloud.types import Vector3
+from luminarycloud.tables import RectilinearTable, _param_name_to_table_type
+from luminarycloud.types import Vector3, LcFloat
 from luminarycloud.types.adfloat import _to_ad_proto, _from_ad_proto
+from luminarycloud._helpers._entity_identifier import _create_entity_identifier
 from luminarycloud._proto.client import simulation_pb2 as clientpb
 from luminarycloud._proto.client.entity_pb2 import EntityIdentifier
 from luminarycloud._helpers import CodeRepr

luminarycloud/params/simulation/material/fluid/boussinesq_approximation/boussinesq_on_.py

@@ -5,12 +5,11 @@ from dataclasses import dataclass, field
 from typing import Any
 from uuid import uuid4
 
-from luminarycloud.tables import RectilinearTable, _param_name_to_table_type
 from google.protobuf.message import Message as _Message
-
-from luminarycloud.tables import RectilinearTable
-from luminarycloud.types import Vector3
+from luminarycloud.tables import RectilinearTable, _param_name_to_table_type
+from luminarycloud.types import Vector3, LcFloat
 from luminarycloud.types.adfloat import _to_ad_proto, _from_ad_proto
+from luminarycloud._helpers._entity_identifier import _create_entity_identifier
 from luminarycloud._proto.client import simulation_pb2 as clientpb
 from luminarycloud._proto.client.entity_pb2 import EntityIdentifier
 from luminarycloud._helpers import CodeRepr
@@ -28,7 +27,7 @@ from luminarycloud.params.simulation.material.fluid.boussinesq_approximation_ im
 class BoussinesqOn(BoussinesqApproximation):
     """Enable Boussinesq approximation."""
 
-    reference_temperature: float = 288.15
+    reference_temperature: LcFloat = 288.15
     "Temperature at which there is no effect from the Boussinesq approximation (i.e. no change in density)."
-    thermal_expansion_coefficient: float = 0.0035
+    thermal_expansion_coefficient: LcFloat = 0.0035
     "Volumetric expansion due to temperature."