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

luminarycloud/_proto/upload/upload_pb2.py

@@ -16,7 +16,7 @@ _sym_db = _symbol_database.Default()
 from luminarycloud._proto.file import file_pb2 as proto_dot_file_dot_file__pb2
 
 
-DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n\x19proto/upload/upload.proto\x12\x15luminary.proto.upload\x1a\x15proto/file/file.proto\"\x13\n\x11UnspecifiedMethod\"\x0e\n\x0cSimpleMethod\"\xae\x01\n\x12GCSResumableMethod\x12\x12\n\nsigned_url\x18\x01 \x01(\t\x12P\n\x0chttp_headers\x18\x02 \x03(\x0b\x32:.luminary.proto.upload.GCSResumableMethod.HttpHeadersEntry\x1a\x32\n\x10HttpHeadersEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\"\xda\x01\n\x06Upload\x12\n\n\x02id\x18\x01 \x01(\t\x12?\n\x0bunspecified\x18\x02 \x01(\x0b\x32(.luminary.proto.upload.UnspecifiedMethodH\x00\x12\x35\n\x06simple\x18\x03 \x01(\x0b\x32#.luminary.proto.upload.SimpleMethodH\x00\x12\x42\n\rgcs_resumable\x18\x04 \x01(\x0b\x32).luminary.proto.upload.GCSResumableMethodH\x00\x42\x08\n\x06method\"\x9c\x01\n\nMeshParams\x12\x0f\n\x07scaling\x18\x01 \x01(\x01\x12\x12\n\ndisconnect\x18\x02 \x01(\x08\x12\x32\n\tmesh_type\x18\x03 \x01(\x0e\x32\x1f.luminary.proto.upload.MeshType\x12\"\n\x1a\x64o_not_read_zones_openfoam\x18\x04 \x01(\x08\x12\x11\n\tmesh_name\x18\x05 \x01(\t\"\x10\n\x0eGeometryParams\"\x0b\n\tC81Params\"\x12\n\x10SurfDeformParams\"\x95\x02\n\x0eResourceParams\x12\x38\n\x0bmesh_params\x18\x01 \x01(\x0b\x32!.luminary.proto.upload.MeshParamsH\x00\x12@\n\x0fgeometry_params\x18\x02 \x01(\x0b\x32%.luminary.proto.upload.GeometryParamsH\x00\x12\x36\n\nc81_params\x18\x03 \x01(\x0b\x32 .luminary.proto.upload.C81ParamsH\x00\x12\x45\n\x12surf_deform_params\x18\x04 \x01(\x0b\x32\'.luminary.proto.upload.SurfDeformParamsH\x00\x42\x08\n\x06params\"\x9f\x01\n\x13\x43reateUploadRequest\x12\x12\n\nproject_id\x18\x01 \x01(\t\x12\x34\n\tfile_meta\x18\x02 \x01(\x0b\x32!.luminary.proto.file.FileMetadata\x12>\n\x0fresource_params\x18\x03 \x01(\x0b\x32%.luminary.proto.upload.ResourceParams\"B\n\x11\x43reateUploadReply\x12-\n\x06upload\x18\x01 \x01(\x0b\x32\x1d.luminary.proto.upload.Upload\"V\n\x12StartUploadRequest\x12\x11\n\tupload_id\x18\x01 \x01(\t\x12-\n\x06method\x18\x02 \x01(\x0e\x32\x1d.luminary.proto.upload.Method\"A\n\x10StartUploadReply\x12-\n\x06upload\x18\x01 \x01(\x0b\x32\x1d.luminary.proto.upload.Upload\"D\n\x11UploadDataRequest\x12\x11\n\tupload_id\x18\x01 \x01(\t\x12\x0e\n\x06offset\x18\x02 \x01(\x04\x12\x0c\n\x04\x64\x61ta\x18\x03 \x01(\x0c\"9\n\x0fUploadDataReply\x12\x14\n\x0climit_offset\x18\x01 \x01(\x04\x12\x10\n\x08\x63omplete\x18\x02 \x01(\x08\"(\n\x13\x46inishUploadRequest\x12\x11\n\tupload_id\x18\x01 \x01(\t\"r\n\x11\x46inishUploadReply\x12\x0b\n\x03url\x18\x01 \x01(\t\x12?\n\nconversion\x18\x02 \x01(\x0e\x32+.luminary.proto.upload.MeshConversionStatus\x12\x0f\n\x07mesh_id\x18\x03 \x01(\t*M\n\x06Method\x12\x16\n\x12METHOD_UNSPECIFIED\x10\x00\x12\x11\n\rMETHOD_SIMPLE\x10\x01\x12\x18\n\x14METHOD_GCS_RESUMABLE\x10\x02*f\n\x08MeshType\x12\x19\n\x15MESH_TYPE_UNSPECIFIED\x10\x00\x12\x13\n\x0fMESH_TYPE_ANSYS\x10\x01\x12\x12\n\x0eMESH_TYPE_CGNS\x10\x02\x12\x16\n\x12MESH_TYPE_OPENFOAM\x10\x03*S\n\x14MeshConversionStatus\x12\x10\n\x0cNOT_REQUIRED\x10\x00\x12\x0f\n\x0bIN_PROGRESS\x10\x02\x12\x0c\n\x08\x43OMPLETE\x10\x03\x12\n\n\x06\x46\x41ILED\x10\x04\x42%Z#luminarycloud.com/core/proto/uploadb\x06proto3')
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n\x19proto/upload/upload.proto\x12\x15luminary.proto.upload\x1a\x15proto/file/file.proto\"\x13\n\x11UnspecifiedMethod\"\x0e\n\x0cSimpleMethod\"\xae\x01\n\x12GCSResumableMethod\x12\x12\n\nsigned_url\x18\x01 \x01(\t\x12P\n\x0chttp_headers\x18\x02 \x03(\x0b\x32:.luminary.proto.upload.GCSResumableMethod.HttpHeadersEntry\x1a\x32\n\x10HttpHeadersEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\"\xda\x01\n\x06Upload\x12\n\n\x02id\x18\x01 \x01(\t\x12?\n\x0bunspecified\x18\x02 \x01(\x0b\x32(.luminary.proto.upload.UnspecifiedMethodH\x00\x12\x35\n\x06simple\x18\x03 \x01(\x0b\x32#.luminary.proto.upload.SimpleMethodH\x00\x12\x42\n\rgcs_resumable\x18\x04 \x01(\x0b\x32).luminary.proto.upload.GCSResumableMethodH\x00\x42\x08\n\x06method\"\x9c\x01\n\nMeshParams\x12\x0f\n\x07scaling\x18\x01 \x01(\x01\x12\x12\n\ndisconnect\x18\x02 \x01(\x08\x12\x32\n\tmesh_type\x18\x03 \x01(\x0e\x32\x1f.luminary.proto.upload.MeshType\x12\"\n\x1a\x64o_not_read_zones_openfoam\x18\x04 \x01(\x08\x12\x11\n\tmesh_name\x18\x05 \x01(\t\"\x10\n\x0eGeometryParams\"\x0b\n\tC81Params\"\x12\n\x10SurfDeformParams\"\x95\x02\n\x0eResourceParams\x12\x38\n\x0bmesh_params\x18\x01 \x01(\x0b\x32!.luminary.proto.upload.MeshParamsH\x00\x12@\n\x0fgeometry_params\x18\x02 \x01(\x0b\x32%.luminary.proto.upload.GeometryParamsH\x00\x12\x36\n\nc81_params\x18\x03 \x01(\x0b\x32 .luminary.proto.upload.C81ParamsH\x00\x12\x45\n\x12surf_deform_params\x18\x04 \x01(\x0b\x32\'.luminary.proto.upload.SurfDeformParamsH\x00\x42\x08\n\x06params\"\x9f\x01\n\x13\x43reateUploadRequest\x12\x12\n\nproject_id\x18\x01 \x01(\t\x12\x34\n\tfile_meta\x18\x02 \x01(\x0b\x32!.luminary.proto.file.FileMetadata\x12>\n\x0fresource_params\x18\x03 \x01(\x0b\x32%.luminary.proto.upload.ResourceParams\"B\n\x11\x43reateUploadReply\x12-\n\x06upload\x18\x01 \x01(\x0b\x32\x1d.luminary.proto.upload.Upload\"V\n\x12StartUploadRequest\x12\x11\n\tupload_id\x18\x01 \x01(\t\x12-\n\x06method\x18\x02 \x01(\x0e\x32\x1d.luminary.proto.upload.Method\"A\n\x10StartUploadReply\x12-\n\x06upload\x18\x01 \x01(\x0b\x32\x1d.luminary.proto.upload.Upload\"D\n\x11UploadDataRequest\x12\x11\n\tupload_id\x18\x01 \x01(\t\x12\x0e\n\x06offset\x18\x02 \x01(\x04\x12\x0c\n\x04\x64\x61ta\x18\x03 \x01(\x0c\"9\n\x0fUploadDataReply\x12\x14\n\x0climit_offset\x18\x01 \x01(\x04\x12\x10\n\x08\x63omplete\x18\x02 \x01(\x08\"(\n\x13\x46inishUploadRequest\x12\x11\n\tupload_id\x18\x01 \x01(\t\"r\n\x11\x46inishUploadReply\x12\x0b\n\x03url\x18\x01 \x01(\t\x12?\n\nconversion\x18\x02 \x01(\x0e\x32+.luminary.proto.upload.MeshConversionStatus\x12\x0f\n\x07mesh_id\x18\x03 \x01(\t\";\n\x18UploadWebGeometryRequest\x12\x12\n\nproject_id\x18\x01 \x01(\t\x12\x0b\n\x03url\x18\x02 \x01(\t\"1\n\x16UploadWebGeometryReply\x12\x17\n\x0fweb_geometry_id\x18\x01 \x01(\t*M\n\x06Method\x12\x16\n\x12METHOD_UNSPECIFIED\x10\x00\x12\x11\n\rMETHOD_SIMPLE\x10\x01\x12\x18\n\x14METHOD_GCS_RESUMABLE\x10\x02*f\n\x08MeshType\x12\x19\n\x15MESH_TYPE_UNSPECIFIED\x10\x00\x12\x13\n\x0fMESH_TYPE_ANSYS\x10\x01\x12\x12\n\x0eMESH_TYPE_CGNS\x10\x02\x12\x16\n\x12MESH_TYPE_OPENFOAM\x10\x03*S\n\x14MeshConversionStatus\x12\x10\n\x0cNOT_REQUIRED\x10\x00\x12\x0f\n\x0bIN_PROGRESS\x10\x02\x12\x0c\n\x08\x43OMPLETE\x10\x03\x12\n\n\x06\x46\x41ILED\x10\x04\x42%Z#luminarycloud.com/core/proto/uploadb\x06proto3')
 
 _METHOD = DESCRIPTOR.enum_types_by_name['Method']
 Method = enum_type_wrapper.EnumTypeWrapper(_METHOD)
@@ -55,6 +55,8 @@ _UPLOADDATAREQUEST = DESCRIPTOR.message_types_by_name['UploadDataRequest']
 _UPLOADDATAREPLY = DESCRIPTOR.message_types_by_name['UploadDataReply']
 _FINISHUPLOADREQUEST = DESCRIPTOR.message_types_by_name['FinishUploadRequest']
 _FINISHUPLOADREPLY = DESCRIPTOR.message_types_by_name['FinishUploadReply']
+_UPLOADWEBGEOMETRYREQUEST = DESCRIPTOR.message_types_by_name['UploadWebGeometryRequest']
+_UPLOADWEBGEOMETRYREPLY = DESCRIPTOR.message_types_by_name['UploadWebGeometryReply']
 UnspecifiedMethod = _reflection.GeneratedProtocolMessageType('UnspecifiedMethod', (_message.Message,), {
   'DESCRIPTOR' : _UNSPECIFIEDMETHOD,
   '__module__' : 'proto.upload.upload_pb2'
@@ -182,18 +184,32 @@ FinishUploadReply = _reflection.GeneratedProtocolMessageType('FinishUploadReply'
   })
 _sym_db.RegisterMessage(FinishUploadReply)
 
+UploadWebGeometryRequest = _reflection.GeneratedProtocolMessageType('UploadWebGeometryRequest', (_message.Message,), {
+  'DESCRIPTOR' : _UPLOADWEBGEOMETRYREQUEST,
+  '__module__' : 'proto.upload.upload_pb2'
+  # @@protoc_insertion_point(class_scope:luminary.proto.upload.UploadWebGeometryRequest)
+  })
+_sym_db.RegisterMessage(UploadWebGeometryRequest)
+
+UploadWebGeometryReply = _reflection.GeneratedProtocolMessageType('UploadWebGeometryReply', (_message.Message,), {
+  'DESCRIPTOR' : _UPLOADWEBGEOMETRYREPLY,
+  '__module__' : 'proto.upload.upload_pb2'
+  # @@protoc_insertion_point(class_scope:luminary.proto.upload.UploadWebGeometryReply)
+  })
+_sym_db.RegisterMessage(UploadWebGeometryReply)
+
 if _descriptor._USE_C_DESCRIPTORS == False:
 
   DESCRIPTOR._options = None
   DESCRIPTOR._serialized_options = b'Z#luminarycloud.com/core/proto/upload'
   _GCSRESUMABLEMETHOD_HTTPHEADERSENTRY._options = None
   _GCSRESUMABLEMETHOD_HTTPHEADERSENTRY._serialized_options = b'8\001'
-  _METHOD._serialized_start=1672
-  _METHOD._serialized_end=1749
-  _MESHTYPE._serialized_start=1751
-  _MESHTYPE._serialized_end=1853
-  _MESHCONVERSIONSTATUS._serialized_start=1855
-  _MESHCONVERSIONSTATUS._serialized_end=1938
+  _METHOD._serialized_start=1784
+  _METHOD._serialized_end=1861
+  _MESHTYPE._serialized_start=1863
+  _MESHTYPE._serialized_end=1965
+  _MESHCONVERSIONSTATUS._serialized_start=1967
+  _MESHCONVERSIONSTATUS._serialized_end=2050
   _UNSPECIFIEDMETHOD._serialized_start=75
   _UNSPECIFIEDMETHOD._serialized_end=94
   _SIMPLEMETHOD._serialized_start=96
@@ -230,4 +246,8 @@ if _descriptor._USE_C_DESCRIPTORS == False:
   _FINISHUPLOADREQUEST._serialized_end=1554
   _FINISHUPLOADREPLY._serialized_start=1556
   _FINISHUPLOADREPLY._serialized_end=1670
+  _UPLOADWEBGEOMETRYREQUEST._serialized_start=1672
+  _UPLOADWEBGEOMETRYREQUEST._serialized_end=1731
+  _UPLOADWEBGEOMETRYREPLY._serialized_start=1733
+  _UPLOADWEBGEOMETRYREPLY._serialized_end=1782
 # @@protoc_insertion_point(module_scope)

luminarycloud/_proto/upload/upload_pb2.pyi

@@ -452,3 +452,34 @@ class FinishUploadReply(google.protobuf.message.Message):
     def ClearField(self, field_name: typing_extensions.Literal["conversion", b"conversion", "mesh_id", b"mesh_id", "url", b"url"]) -> None: ...
 
 global___FinishUploadReply = FinishUploadReply
+
+class UploadWebGeometryRequest(google.protobuf.message.Message):
+    DESCRIPTOR: google.protobuf.descriptor.Descriptor
+
+    PROJECT_ID_FIELD_NUMBER: builtins.int
+    URL_FIELD_NUMBER: builtins.int
+    project_id: builtins.str
+    url: builtins.str
+    def __init__(
+        self,
+        *,
+        project_id: builtins.str = ...,
+        url: builtins.str = ...,
+    ) -> None: ...
+    def ClearField(self, field_name: typing_extensions.Literal["project_id", b"project_id", "url", b"url"]) -> None: ...
+
+global___UploadWebGeometryRequest = UploadWebGeometryRequest
+
+class UploadWebGeometryReply(google.protobuf.message.Message):
+    DESCRIPTOR: google.protobuf.descriptor.Descriptor
+
+    WEB_GEOMETRY_ID_FIELD_NUMBER: builtins.int
+    web_geometry_id: builtins.str
+    def __init__(
+        self,
+        *,
+        web_geometry_id: builtins.str = ...,
+    ) -> None: ...
+    def ClearField(self, field_name: typing_extensions.Literal["web_geometry_id", b"web_geometry_id"]) -> None: ...
+
+global___UploadWebGeometryReply = UploadWebGeometryReply

luminarycloud/_wrapper.py

@@ -125,6 +125,7 @@ class ProtoWrapper(Generic[P]):
 
         # Create getters that access the attributes of the underlying proto.
         type_hints = get_type_hints(cls)
+
         for field in decorator.proto_type.DESCRIPTOR.fields:
             _type = type_hints.get(field.name, None)
             if _type:
@@ -133,17 +134,35 @@ class ProtoWrapper(Generic[P]):
                 _origin_type = get_origin(_type)
                 if _origin_type is list:
                     _listed_type = get_args(_type)[0]
-                    if issubclass(_listed_type, Enum) or issubclass(_listed_type, ProtoWrapperBase):
-                        fget = list_wrapped_getter(field.name, _listed_type)
-                        fset = None
+                    try:
+                        if issubclass(_listed_type, Enum) or issubclass(
+                            _listed_type, ProtoWrapperBase
+                        ):
+                            fget = list_wrapped_getter(field.name, _listed_type)
+                            fset = None
+                    except TypeError:
+                        # _listed_type is not a class (e.g., forward reference that couldn't be resolved)
+                        # Fall back to basic getter
+                        pass
                 elif isinstance(_type, NewType):
                     pass
-                elif issubclass(_type, Enum) or issubclass(_type, ProtoWrapperBase):
-                    fget = wrapped_getter(field.name, _type)
-                    fset = wrapped_setter(field.name, _type)
+                else:
+                    try:
+                        if issubclass(_type, Enum) or issubclass(_type, ProtoWrapperBase):
+                            fget = wrapped_getter(field.name, _type)
+                            fset = wrapped_setter(field.name, _type)
+                    except TypeError:
+                        # _type is not a class (e.g., forward reference that couldn't be resolved)
+                        # Fall back to basic getter
+                        pass
                 setattr(_W, field.name, property(fget=fget, fset=fset))
 
-        W = type(cls.__name__, (_W,), {})
+        # Preserve the original class annotations in the new class
+        class_dict = {}
+        if hasattr(cls, "__annotations__"):
+            class_dict["__annotations__"] = cls.__annotations__
+
+        W = type(cls.__name__, (_W,), class_dict)
         return cast(type[C], W)
 
 

luminarycloud/enum/__init__.py

@@ -8,6 +8,7 @@ from .mesh_status import MeshStatus
 from .mesh_type import MeshType
 from .output_definition_includes import OutputDefinitionIncludes
 from .output_node_includes import OutputNodeIncludes
+from .physics_ai_lifecycle_state import PhysicsAiLifecycleState
 from .quantity_type import QuantityType
 from .reference_values_type import ReferenceValuesType
 from .residual_normalization import ResidualNormalization
@@ -23,6 +24,7 @@ from .vis_enums import (
     EntityType,
     FieldComponent,
     RenderStatusType,
+    ExtractStatusType,
     Representation,
     VisQuantity,
     SceneMode,

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