VariogramCloud - new parameters and one test

Author: SimonMolinsky

CHANGELOG.rst

@@ -23,6 +23,7 @@ Changes - from version >= 1.x
 * [tests] Added basic tests for `ExperimentalVariogram()` class
 * [enhancement] `build_experimental_variogram()` function has the new parameters `values` and `geometries`, that might be provided instead of `ds` parameter
 * [tests] Added basic tests for `build_experimental_variogram()` function
+* [enhancement] `VariogramCloud()` class has the new parameters `values` and `geometries`, that might be provided instead of `ds` parameter
 
 
 2025-10-11

src/pyinterpolate/semivariogram/experimental/classes/variogram_cloud.py

@@ -1,11 +1,13 @@
 import copy
 from typing import Collection, Dict, Union
+from numpy.typing import ArrayLike
 
 import numpy as np
 import pandas as pd
 from prettytable import PrettyTable
 from scipy.stats import skew, kurtosis
 
+from pyinterpolate.core.data_models.points import VariogramPoints
 from pyinterpolate.semivariogram.experimental.classes.experimental_variogram import (
     ExperimentalVariogram)
 from pyinterpolate.transform.statistical import remove_outliers
@@ -89,6 +91,15 @@ class VariogramCloud:
     ds : numpy array
         ``[x, y, value]``
 
+    values : ArrayLike, optional
+        Observation in the i-th geometry (from ``geometries``). Optional
+        parameter, if not given then ``ds`` must be provided.
+
+    geometries : ArrayLike, optional
+        Array or similar structure with geometries. It must have the same
+        length as ``values``. Optional parameter, if not given then ``ds``
+        must be provided. Point type geometry.
+
     step_size : float
         The fixed distance between lags grouping point neighbors.
 
@@ -162,7 +173,9 @@ class VariogramCloud:
     """
 
     def __init__(self,
-                 ds: np.ndarray,
+                 ds: Union[ArrayLike, VariogramPoints] = None,
+                 values: ArrayLike = None,
+                 geometries: ArrayLike = None,
                  step_size: float = None,
                  max_range: float = None,
                  direction: float = None,
@@ -172,6 +185,8 @@ def __init__(self,
 
         self._experimental_variogram = ExperimentalVariogram(
             ds=ds,
+            values=values,
+            geometries=geometries,
             step_size=step_size,
             max_range=max_range,
             direction=direction,

tests/test_semivariogram/test_experimental_variogram_point_cloud.py

@@ -76,6 +76,19 @@ def test_variogram_cloud_class():
     assert isinstance(vc, VariogramCloud)
 
 
+def test_variogram_cloud_class_sep_geom():
+    vc = VariogramCloud(
+        values=REFERENCE_INPUT[:, -1],
+        geometries=REFERENCE_INPUT[:, :-1],
+        step_size=STEP_SIZE,
+        max_range=MAX_RANGE
+    )
+    stats = vc.describe()
+    assert stats[1]['count'] == 24
+    assert stats[2]['median'] == 9
+    assert isinstance(vc, VariogramCloud)
+
+
 def test_outliers_removal():
     vc1 = VariogramCloud(
         ds=REFERENCE_INPUT,