evo-objects 0.6.3__tar.gz → 0.6.5__tar.gz

{evo_objects-0.6.3 → evo_objects-0.6.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: evo-objects
-Version: 0.6.3
+Version: 0.6.5
 Summary: Python SDK for using the Seequent Evo Geoscience Object API
 Project-URL: Source, https://github.com/SeequentEvo/evo-python-sdk
 Project-URL: Tracker, https://github.com/SeequentEvo/evo-python-sdk/issues
@@ -9,7 +9,7 @@ Project-URL: Documentation, https://developer.seequent.com/
 Author-email: Seequent <support@seequent.com>
 License-File: LICENSE.md
 Requires-Python: >=3.10
-Requires-Dist: evo-sdk-common[jmespath]>=0.5.26
+Requires-Dist: evo-sdk-common[jmespath]>=0.5.28
 Requires-Dist: pydantic<3,>=2
 Provides-Extra: aiohttp
 Requires-Dist: evo-sdk-common[aiohttp]; extra == 'aiohttp'

{evo_objects-0.6.3 → evo_objects-0.6.5}/pyproject.toml

@@ -1,7 +1,7 @@
 [project]
 name = "evo-objects"
 description = "Python SDK for using the Seequent Evo Geoscience Object API"
-version = "0.6.3"
+version = "0.6.5"
 requires-python = ">=3.10"
 license-files = ["LICENSE.md"]
 dynamic = ["readme"]
@@ -10,7 +10,7 @@ authors = [
 ]
 
 dependencies = [
-    "evo-sdk-common[jmespath]>=0.5.26",
+    "evo-sdk-common[jmespath]>=0.5.28",
     "pydantic>=2,<3",
 ]
 

{evo_objects-0.6.3 → evo_objects-0.6.5}/src/evo/objects/data.py

@@ -91,7 +91,8 @@ class ObjectReference(str):
         inst = str.__new__(cls, value)
 
         parsed = urlparse(value)
-        if parsed.scheme != "https":
+        if not parsed.scheme:
+            # Valid hub URLs are always HTTPS, but it is sometimes useful to pass HTTP ones for testing, so these are allowed here too.
             raise ValueError("Reference must be a valid HTTPS URL")
 
         inst.hub_url = f"{parsed.scheme}://{parsed.netloc}/"

{evo_objects-0.6.3 → evo_objects-0.6.5}/src/evo/objects/typed/_grid.py

@@ -22,6 +22,7 @@ import pandas as pd
 from pydantic import AliasChoices, Field
 
 from evo.common import IFeedback
+from evo.common.typed import FloatArrayLike3, IntArrayLike3
 from evo.common.utils import NoFeedback
 
 from ._model import DataLocation, SchemaLocation, SchemaModel
@@ -46,23 +47,35 @@ class Base3DGridData(BaseSpatialObjectData):
     """Base class for all 3D grid data.
 
     Contains the common properties shared by all grid types: origin, size, rotation, and cell_data.
+    Origin and size accept their named types or three values in a list, tuple, or 1D array.
+    All inputs, including named types, are validated and normalized.
     """
 
-    origin: Point3
-    size: Size3i
+    origin: Point3 | FloatArrayLike3
+    size: Size3i | IntArrayLike3
     cell_data: pd.DataFrame | None = None
     rotation: Rotation | None = None
 
+    def __post_init__(self) -> None:
+        object.__setattr__(self, "origin", Point3.from_array_like(self.origin))
+        object.__setattr__(self, "size", Size3i.from_array_like(self.size))
+
 
 @dataclass(kw_only=True, frozen=True)
 class BaseRegular3DGridData(Base3DGridData):
     """Base class for regular 3D grid data (both masked and non-masked).
 
     Contains the common properties shared by Regular3DGridData and RegularMasked3DGridData.
-    Adds cell_size to the base grid properties.
+    Adds cell_size to the base grid properties; it accepts a Size3d or three
+    values in a list, tuple, or 1D array.
+    All inputs, including Size3d instances, are validated and normalized.
     """
 
-    cell_size: Size3d
+    cell_size: Size3d | FloatArrayLike3
+
+    def __post_init__(self) -> None:
+        super().__post_init__()
+        object.__setattr__(self, "cell_size", Size3d.from_array_like(self.cell_size))
 
     def compute_bounding_box(self) -> BoundingBox:
         return BoundingBox.from_regular_grid(self.origin, self.size, self.cell_size, self.rotation)
@@ -223,15 +236,20 @@ class RegularBlockModelData:
     """
 
     name: str
-    origin: Point3
-    n_blocks: Size3i
-    block_size: Size3d
+    origin: Point3 | FloatArrayLike3
+    n_blocks: Size3i | IntArrayLike3
+    block_size: Size3d | FloatArrayLike3
     cell_data: pd.DataFrame | None = None
     description: str | None = None
     coordinate_reference_system: str | None = None
     size_unit_id: str | None = None
     units: dict[str, str] = field(default_factory=dict)
 
+    def __post_init__(self) -> None:
+        object.__setattr__(self, "origin", Point3.from_array_like(self.origin))
+        object.__setattr__(self, "n_blocks", Size3i.from_array_like(self.n_blocks))
+        object.__setattr__(self, "block_size", Size3d.from_array_like(self.block_size))
+
 
 @dataclass(frozen=True, kw_only=True)
 class BlockModelData(BaseSpatialObjectData):

{evo_objects-0.6.3 → evo_objects-0.6.5}/src/evo/objects/typed/base.py

@@ -362,12 +362,18 @@ class _BaseObject(SchemaModel):
 
         :return: A new instance with refreshed data.
 
-        Example:
+        Example::
+
             >>> # After a remote operation modifies the object...
             >>> obj = await obj.refresh()
             >>> obj.attributes  # Now shows the latest attributes
         """
-        return await self.from_reference(self._api_context, self.metadata.url)
+        # metadata.url pins the current version_id, which would just re-download the same version.
+        latest_reference = ObjectReference.new(
+            environment=self.metadata.environment,
+            object_id=self.metadata.id,
+        )
+        return await self.from_reference(self._api_context, latest_reference)
 
     def search(self, expression: str) -> Any:
         """Search the object metadata using a JMESPath expression.

{evo_objects-0.6.3 → evo_objects-0.6.5}/src/evo/objects/typed/block_model_ref.py

@@ -192,7 +192,8 @@ class BlockModel(BaseSpatialObject):
             :param fb: Optional feedback interface for progress reporting.
             :return: DataFrame containing the block model data with user-friendly column names.
 
-            Example:
+            Example::
+
                 >>> df = await block_model.to_dataframe()
                 >>> df.head()
             """
@@ -207,7 +208,8 @@ class BlockModel(BaseSpatialObject):
 
             :return: A new BlockModel instance with refreshed data.
 
-            Example:
+            Example::
+
                 >>> # After running kriging that adds attributes...
                 >>> block_model = await block_model.refresh()
                 >>> block_model.attributes  # Now shows the new attributes
@@ -335,7 +337,8 @@ class BlockModel(BaseSpatialObject):
             :param fb: Optional feedback interface for progress reporting.
             :return: The updated BlockModel instance (refreshed from server).
 
-            Example:
+            Example::
+
                 >>> from evo.blockmodels import Units
                 >>> block_model = await block_model.set_attribute_units({
                 ...     "Au": Units.GRAMS_PER_TONNE,
@@ -361,7 +364,8 @@ class BlockModel(BaseSpatialObject):
             :param fb: Optional feedback interface for progress reporting.
             :return: A Report instance representing the created report.
 
-            Example:
+            Example::
+
                 >>> from evo.blockmodels.typed import ReportSpecificationData, ReportColumnSpec, ReportCategorySpec
                 >>> report = await block_model.create_report(ReportSpecificationData(
                 ...     name="Gold Resource Report",

{evo_objects-0.6.3 → evo_objects-0.6.5}/src/evo/objects/typed/regular_grid.py

@@ -36,6 +36,7 @@ class Regular3DGridData(BaseRegular3DGridData):
     vertex_data: pd.DataFrame | None = None
 
     def __post_init__(self):
+        super().__post_init__()
         if self.cell_data is not None and self.cell_data.shape[0] != self.size.total_size:
             raise ObjectValidationError(
                 f"The number of rows in the cell_data dataframe ({self.cell_data.shape[0]}) does not match the number of cells in the grid ({self.size.nx * self.size.ny * self.size.nz})."

{evo_objects-0.6.3 → evo_objects-0.6.5}/src/evo/objects/typed/regular_masked_grid.py

@@ -43,6 +43,7 @@ class RegularMasked3DGridData(BaseRegular3DGridData):
     mask: np.ndarray
 
     def __post_init__(self):
+        super().__post_init__()
         if self.mask.shape[0] != self.size.total_size:
             raise ObjectValidationError(
                 f"The number of rows in the mask ({self.mask.shape[0]}) does not match the number of cells in the grid ({self.size.nx * self.size.ny * self.size.nz})."

{evo_objects-0.6.3 → evo_objects-0.6.5}/src/evo/objects/typed/tensor_grid.py

@@ -69,6 +69,7 @@ class Tensor3DGridData(Base3DGridData):
     vertex_data: pd.DataFrame | None = None
 
     def __post_init__(self):
+        super().__post_init__()
         # Validate cell size array lengths
         if self.cell_sizes_x.shape[0] != self.size.nx:
             raise ObjectValidationError(

{evo_objects-0.6.3 → evo_objects-0.6.5}/src/evo/objects/typed/types.py

@@ -12,6 +12,7 @@
 from __future__ import annotations
 
 from dataclasses import dataclass
+from numbers import Real
 from typing import Annotated, Any, overload
 
 import numpy as np
@@ -20,7 +21,7 @@ import pydantic
 
 # Import basic geometry types from evo.common and re-export
 from evo.common.crs import EpsgCode, parse_crs
-from evo.common.typed import Point3, Size3d, Size3i
+from evo.common.typed import FloatArrayLike3, Point3, Size3d, Size3i, _validate_array_like
 
 __all__ = [
     "BoundingBox",
@@ -204,12 +205,26 @@ class BoundingBox:
 
 @dataclass(frozen=True)
 class Rotation:
-    """A rotation defined by dip azimuth, dip, and pitch angles."""
+    """A clockwise intrinsic ZXZ Euler rotation in degrees.
+
+    Dip azimuth [0, 360], dip [0, 180], and pitch [0, 360] rotate about
+    successive local Z, X, and Z axes, respectively. For column vectors,
+    the rotation matrix is Rz(dip azimuth) @ Rx(dip) @ Rz(pitch).
+    """
 
     dip_azimuth: float
     dip: float
     pitch: float
 
+    def __post_init__(self) -> None:
+        for name, value, lower, upper in (
+            ("dip_azimuth", self.dip_azimuth, 0, 360),
+            ("dip", self.dip, 0, 180),
+            ("pitch", self.pitch, 0, 360),
+        ):
+            if not isinstance(value, Real) or isinstance(value, bool) or not lower <= value <= upper:
+                raise ValueError(f"{name} must be a finite angle between {lower} and {upper} degrees (inclusive)")
+
     def as_rotation_matrix(self) -> np.ndarray:
         """Convert the rotation to a rotation matrix.
 
@@ -246,6 +261,12 @@ class Rotation:
         # Combined intrinsic rotations: dip_azimuth -> dip -> pitch
         return dip_azimuth_rotation_matrix @ dip_rotation_matrix @ pitch_rotation_matrix
 
+    @classmethod
+    def from_array_like(cls, value: Rotation | FloatArrayLike3) -> Rotation:
+        if isinstance(value, Rotation):
+            value = (value.dip_azimuth, value.dip, value.pitch)
+        return cls(*_validate_array_like(value, kind=Real, positive=False))
+
 
 @dataclass
 class EllipsoidRanges:
@@ -256,9 +277,9 @@ class EllipsoidRanges:
     minor: float
 
     def __init__(self, major: float, semi_major: float, minor: float):
-        self.major = major
-        self.semi_major = semi_major
-        self.minor = minor
+        self.major, self.semi_major, self.minor = _validate_array_like(
+            (major, semi_major, minor), kind=Real, positive=True
+        )
 
     def to_dict(self) -> dict[str, Any]:
         return {"major": self.major, "semi_major": self.semi_major, "minor": self.minor}
@@ -270,17 +291,37 @@ class EllipsoidRanges:
             minor=self.minor * factor,
         )
 
+    @classmethod
+    def from_array_like(cls, value: EllipsoidRanges | FloatArrayLike3) -> EllipsoidRanges:
+        if isinstance(value, EllipsoidRanges):
+            value = (value.major, value.semi_major, value.minor)
+        return cls(*_validate_array_like(value, kind=Real, positive=True))
+
 
 @dataclass
 class Ellipsoid:
-    """An ellipsoid defining a spatial region."""
+    """An ellipsoid defining a spatial region.
+
+    Ranges are ordered major, semi-major, minor. Rotation angles are in
+    degrees and ordered dip azimuth [0, 360], dip [0, 180], pitch [0, 360].
+    They specify clockwise intrinsic rotations about the successive Z, X,
+    and Z axes, respectively.
+
+    Ranges accept an EllipsoidRanges instance or a three-value list, tuple,
+    or 1D NumPy array. Rotation accepts a Rotation instance or the same
+    three-value sequence forms; omitting it applies no rotation.
+    """
 
     ranges: EllipsoidRanges
     _rotation: Rotation | None = None
 
-    def __init__(self, ranges: EllipsoidRanges, rotation: Rotation | None = None):
-        self.ranges = ranges
-        self._rotation = rotation
+    def __init__(
+        self,
+        ranges: EllipsoidRanges | FloatArrayLike3,
+        rotation: Rotation | FloatArrayLike3 | None = None,
+    ):
+        self.ranges = EllipsoidRanges.from_array_like(ranges)
+        self._rotation = Rotation.from_array_like(rotation) if rotation is not None else None
 
     @property
     def rotation(self) -> Rotation:

{evo_objects-0.6.3 → evo_objects-0.6.5}/src/evo/objects/typed/variogram.py

@@ -70,7 +70,8 @@ class VariogramStructure:
         - Creating search ellipsoids via scaled()
         - Kriging search neighborhoods
 
-        Example:
+        Example::
+
             >>> # Get ellipsoid from variogram structure
             >>> var_ell = variogram.structures[0].to_ellipsoid()
             >>>
@@ -277,7 +278,8 @@ class VariogramData(BaseObjectData):
         - `modelling_space`: Set to "data" for original units or "normalscore" for gaussian space
         - `data_variance`: Should match the sill value for non-normalized data
 
-    Example using typed structures (recommended):
+    Example using typed structures (recommended)::
+
         >>> data = VariogramData(
         ...     name="My Variogram",
         ...     sill=1.0,
@@ -407,7 +409,8 @@ class Variogram(BaseObject):
         Returns:
             Ellipsoid configured with the structure's anisotropy ranges and rotation.
 
-        Example:
+        Example::
+
             >>> # Get ellipsoid from structure with largest range (default)
             >>> var_ell = variogram.get_ellipsoid()
             >>>
@@ -475,7 +478,8 @@ class Variogram(BaseObject):
         Returns:
             Tuple of (major_curve, semi_major_curve, minor_curve) as VariogramCurveData.
 
-        Example with Plotly:
+        Example with Plotly::
+
             >>> major, semi_maj, minor = variogram.get_principal_directions()
             >>> import plotly.graph_objects as go
             >>> fig = go.Figure()
@@ -549,7 +553,8 @@ class Variogram(BaseObject):
         Returns:
             Tuple of (distance, semivariance) as numpy arrays, suitable for plotting.
 
-        Example with Plotly:
+        Example with Plotly::
+
             >>> distance, semivariance = variogram.get_direction(azimuth=45, dip=30)
             >>> import plotly.graph_objects as go
             >>> fig = go.Figure()
@@ -557,7 +562,8 @@ class Variogram(BaseObject):
             >>> fig.update_layout(xaxis_title='Distance', yaxis_title='Semivariance')
             >>> fig.show()
 
-        Example with Matplotlib:
+        Example with Matplotlib::
+
             >>> distance, semivariance = variogram.get_direction(azimuth=0, dip=0)
             >>> import matplotlib.pyplot as plt
             >>> plt.plot(distance, semivariance)