ocf-data-sampler 0.3.1__py3-none-any.whl → 0.5.0__py3-none-any.whl

ocf_data_sampler/numpy_sample/__init__.py

@@ -1,9 +1,8 @@
 """Conversion from Xarray to NumpySample"""
 
-from .datetime_features import make_datetime_numpy_dict
+from .datetime_features import encode_datetimes
 from .gsp import convert_gsp_to_numpy_sample, GSPSampleKey
 from .nwp import convert_nwp_to_numpy_sample, NWPSampleKey
 from .satellite import convert_satellite_to_numpy_sample, SatelliteSampleKey
 from .sun_position import make_sun_position_numpy_sample
-from .site import convert_site_to_numpy_sample
-
+from .site import convert_site_to_numpy_sample, SiteSampleKey

ocf_data_sampler/numpy_sample/datetime_features.py

@@ -6,33 +6,24 @@ import pandas as pd
 from ocf_data_sampler.numpy_sample.common_types import NumpySample
 
 
-def _get_date_time_in_pi(dt: pd.DatetimeIndex) -> tuple[np.ndarray, np.ndarray]:
-    """Create positional embeddings for the datetimes in radians.
+def encode_datetimes(datetimes: pd.DatetimeIndex) -> NumpySample:
+    """Creates dictionary of sin and cos datetime embeddings.
 
     Args:
-        dt: DatetimeIndex to create radian embeddings for
+        datetimes: DatetimeIndex to create radian embeddings for
 
     Returns:
-        Tuple of numpy arrays containing radian coordinates for date and time
+        Dictionary of datetime encodings
     """
-    day_of_year = dt.dayofyear
-    minute_of_day = dt.minute + dt.hour * 60
-
-    time_in_pi = (2 * np.pi) * (minute_of_day / (24 * 60))
-    date_in_pi = (2 * np.pi) * (day_of_year / 365)
-
-    return date_in_pi, time_in_pi
-
-
-def make_datetime_numpy_dict(datetimes: pd.DatetimeIndex, key_prefix: str = "wind") -> NumpySample:
-    """Creates dictionary of cyclical datetime features - encoded."""
-    date_in_pi, time_in_pi = _get_date_time_in_pi(datetimes)
-
-    time_numpy_sample = {}
-
-    time_numpy_sample[key_prefix + "_date_sin"] = np.sin(date_in_pi)
-    time_numpy_sample[key_prefix + "_date_cos"] = np.cos(date_in_pi)
-    time_numpy_sample[key_prefix + "_time_sin"] = np.sin(time_in_pi)
-    time_numpy_sample[key_prefix + "_time_cos"] = np.cos(time_in_pi)
-
-    return time_numpy_sample
+    day_of_year = datetimes.dayofyear
+    minute_of_day = datetimes.minute + datetimes.hour * 60
+
+    time_in_radians = (2 * np.pi) * (minute_of_day / (24 * 60))
+    date_in_radians = (2 * np.pi) * (day_of_year / 365)
+
+    return {
+        "date_sin": np.sin(date_in_radians),
+        "date_cos": np.cos(date_in_radians),
+        "time_sin": np.sin(time_in_radians),
+        "time_cos": np.cos(time_in_radians),
+    }

ocf_data_sampler/numpy_sample/site.py

@@ -13,10 +13,7 @@ class SiteSampleKey:
     time_utc = "site_time_utc"
     t0_idx = "site_t0_idx"
     id = "site_id"
-    date_sin = "site_date_sin"
-    date_cos = "site_date_cos"
-    time_sin = "site_time_sin"
-    time_cos = "site_time_cos"
+
 
 
 def convert_site_to_numpy_sample(da: xr.DataArray, t0_idx: int | None = None) -> NumpySample:
@@ -31,10 +28,6 @@ def convert_site_to_numpy_sample(da: xr.DataArray, t0_idx: int | None = None) ->
         SiteSampleKey.capacity_kwp: da.isel(time_utc=0)["capacity_kwp"].values,
         SiteSampleKey.time_utc: da["time_utc"].values.astype(float),
         SiteSampleKey.id: da["site_id"].values,
-        SiteSampleKey.date_sin: da["date_sin"].values,
-        SiteSampleKey.date_cos: da["date_cos"].values,
-        SiteSampleKey.time_sin: da["time_sin"].values,
-        SiteSampleKey.time_cos: da["time_cos"].values,
     }
 
     if t0_idx is not None:

ocf_data_sampler/torch_datasets/datasets/__init__.py

@@ -1,6 +1,2 @@
 from .pvnet_uk import PVNetUKRegionalDataset, PVNetUKConcurrentDataset
-
-from .site import (
-    convert_netcdf_to_numpy_sample,
-    SitesDataset
-)
+from .site import SitesDataset

ocf_data_sampler/torch_datasets/datasets/site.py

@@ -13,7 +13,7 @@ from ocf_data_sampler.numpy_sample import (
     convert_nwp_to_numpy_sample,
     convert_satellite_to_numpy_sample,
     convert_site_to_numpy_sample,
-    make_datetime_numpy_dict,
+    encode_datetimes,
     make_sun_position_numpy_sample,
 )
 from ocf_data_sampler.numpy_sample.collate import stack_np_samples_into_batch
@@ -58,6 +58,96 @@ def get_locations(site_xr: xr.Dataset) -> list[Location]:
 
     return locations
 
+def process_and_combine_datasets(
+    dataset_dict: dict,
+    config: Configuration,
+    t0: pd.Timestamp,
+) -> NumpySample:
+    """Normalise and convert data to numpy arrays.
+
+    Args:
+        dataset_dict: Dictionary of xarray datasets
+        config: Configuration object
+        t0: init-time for sample
+    """
+    numpy_modalities = []
+
+    if "nwp" in dataset_dict:
+        nwp_numpy_modalities = {}
+
+        for nwp_key, da_nwp in dataset_dict["nwp"].items():
+
+            # Standardise and convert to NumpyBatch
+
+            da_channel_means = channel_dict_to_dataarray(
+                config.input_data.nwp[nwp_key].channel_means,
+            )
+            da_channel_stds = channel_dict_to_dataarray(
+                config.input_data.nwp[nwp_key].channel_stds,
+            )
+
+            da_nwp = (da_nwp - da_channel_means) / da_channel_stds
+
+            nwp_numpy_modalities[nwp_key] = convert_nwp_to_numpy_sample(da_nwp)
+
+        # Combine the NWPs into NumpyBatch
+        numpy_modalities.append({NWPSampleKey.nwp: nwp_numpy_modalities})
+
+    if "sat" in dataset_dict:
+        da_sat = dataset_dict["sat"]
+
+        # Standardise and convert to NumpyBatch
+        da_channel_means = channel_dict_to_dataarray(config.input_data.satellite.channel_means)
+        da_channel_stds = channel_dict_to_dataarray(config.input_data.satellite.channel_stds)
+
+        da_sat = (da_sat - da_channel_means) / da_channel_stds
+
+        numpy_modalities.append(convert_satellite_to_numpy_sample(da_sat))
+
+    if "site" in dataset_dict:
+        da_sites = dataset_dict["site"]
+        da_sites = da_sites / da_sites.capacity_kwp
+
+        # Convert to NumpyBatch
+        numpy_modalities.append(
+            convert_site_to_numpy_sample(
+                da_sites,
+            ),
+        )
+
+        # add datetime features
+        datetimes = pd.DatetimeIndex(da_sites.time_utc.values)
+        datetime_features = encode_datetimes(datetimes=datetimes)
+
+        numpy_modalities.append(datetime_features)
+
+    # Only add solar position if explicitly configured
+    if config.input_data.solar_position is not None:
+        solar_config = config.input_data.solar_position
+
+        # Create datetime range for solar position calculation
+        datetimes = pd.date_range(
+            t0 + minutes(solar_config.interval_start_minutes),
+            t0 + minutes(solar_config.interval_end_minutes),
+            freq=minutes(solar_config.time_resolution_minutes),
+        )
+
+
+        # Calculate solar positions and add to modalities
+        numpy_modalities.append(
+            make_sun_position_numpy_sample(
+                datetimes,
+                da_sites.longitude.values,
+                da_sites.latitude.values,
+                ),
+            )
+
+    # Combine all the modalities and fill NaNs
+    combined_sample = merge_dicts(numpy_modalities)
+    combined_sample = fill_nans_in_arrays(combined_sample)
+
+    return combined_sample
+
 
 class SitesDataset(Dataset):
     """A torch Dataset for creating PVNet Site samples."""
@@ -181,8 +271,9 @@ class SitesDataset(Dataset):
         sample_dict = slice_datasets_by_space(self.datasets_dict, location, self.config)
         sample_dict = slice_datasets_by_time(sample_dict, t0, self.config)
 
-        sample = self.process_and_combine_site_sample_dict(sample_dict, t0)
-        return sample.compute()
+        sample_dict = compute(sample_dict)
+
+        return process_and_combine_datasets(sample_dict, self.config, t0)
 
     def get_sample(self, t0: pd.Timestamp, site_id: int) -> dict:
         """Generate a sample for a given site id and t0.
@@ -197,159 +288,6 @@ class SitesDataset(Dataset):
 
         return self._get_sample(t0, location)
 
-    def process_and_combine_site_sample_dict(
-        self,
-        dataset_dict: dict,
-        t0: pd.Timestamp,
-    ) -> xr.Dataset:
-        """Normalize and combine data into a single xr Dataset.
-
-        Args:
-            dataset_dict: dict containing sliced xr DataArrays
-            t0: The initial timestamp of the sample
-
-        Returns:
-            xr.Dataset: A merged Dataset with nans filled in.
-        """
-        data_arrays = []
-
-        if "nwp" in dataset_dict:
-            for nwp_key, da_nwp in dataset_dict["nwp"].items():
-                provider = self.config.input_data.nwp[nwp_key].provider
-
-                da_channel_means = channel_dict_to_dataarray(
-                    self.config.input_data.nwp[nwp_key].channel_means,
-                )
-                da_channel_stds = channel_dict_to_dataarray(
-                    self.config.input_data.nwp[nwp_key].channel_stds,
-                )
-
-                da_nwp = (da_nwp - da_channel_means) / da_channel_stds
-                data_arrays.append((f"nwp-{provider}", da_nwp))
-
-        if "sat" in dataset_dict:
-            da_sat = dataset_dict["sat"]
-
-            da_channel_means = channel_dict_to_dataarray(
-                self.config.input_data.satellite.channel_means,
-            )
-            da_channel_stds = channel_dict_to_dataarray(
-                self.config.input_data.satellite.channel_stds,
-            )
-
-            da_sat = (da_sat - da_channel_means) / da_channel_stds
-            data_arrays.append(("satellite", da_sat))
-
-        if "site" in dataset_dict:
-            da_sites = dataset_dict["site"]
-            da_sites = da_sites / da_sites.capacity_kwp
-            data_arrays.append(("site", da_sites))
-
-        combined_sample_dataset = self.merge_data_arrays(data_arrays)
-
-        # add datetime features
-        datetimes = pd.DatetimeIndex(combined_sample_dataset.site__time_utc.values)
-        datetime_features = make_datetime_numpy_dict(datetimes=datetimes, key_prefix="site_")
-        combined_sample_dataset = combined_sample_dataset.assign_coords(
-            {k: ("site__time_utc", v) for k, v in datetime_features.items()},
-        )
-
-        # Only add solar position if explicitly configured
-        has_solar_config = (
-            hasattr(self.config.input_data, "solar_position")
-            and self.config.input_data.solar_position is not None
-        )
-
-        if has_solar_config:
-            solar_config = self.config.input_data.solar_position
-
-            # Datetime range - solar config params
-            solar_datetimes = pd.date_range(
-                t0 + minutes(solar_config.interval_start_minutes),
-                t0 + minutes(solar_config.interval_end_minutes),
-                freq=minutes(solar_config.time_resolution_minutes),
-            )
-
-            # Calculate sun position features
-            sun_position_features = make_sun_position_numpy_sample(
-                datetimes=solar_datetimes,
-                lon=combined_sample_dataset.site__longitude.values,
-                lat=combined_sample_dataset.site__latitude.values,
-            )
-
-            # Use existing dimension for solar positions
-            # TODO decouple this as a separate data varaible
-            solar_dim_name = "site__time_utc"
-
-            # Assign solar position values
-            for key, values in sun_position_features.items():
-                combined_sample_dataset = combined_sample_dataset.assign_coords(
-                    {key: (solar_dim_name, values)},
-                )
-
-        # TODO include t0_index in xr dataset?
-
-        # Fill any nan values
-        return combined_sample_dataset.fillna(0.0)
-
-    def merge_data_arrays(
-        self,
-        normalised_data_arrays: list[tuple[str, xr.DataArray]],
-    ) -> xr.Dataset:
-        """Combine a list of DataArrays into a single Dataset with unique naming conventions.
-
-        Args:
-            normalised_data_arrays: List of tuples where each tuple contains:
-                - A string (key name).
-                - An xarray.DataArray.
-
-        Returns:
-            xr.Dataset: A merged Dataset with uniquely named variables, coordinates, and dimensions.
-        """
-        datasets = []
-
-        for key, data_array in normalised_data_arrays:
-            # Ensure all attributes are strings for consistency
-            data_array = data_array.assign_attrs(
-                {attr_key: str(attr_value) for attr_key, attr_value in data_array.attrs.items()},
-            )
-
-            # Convert DataArray to Dataset with the variable name as the key
-            dataset = data_array.to_dataset(name=key)
-
-            # Prepend key name to all dimension and coordinate names for uniqueness
-            dataset = dataset.rename(
-                {dim: f"{key}__{dim}" for dim in dataset.dims if dim not in dataset.coords},
-            )
-            dataset = dataset.rename(
-                {coord: f"{key}__{coord}" for coord in dataset.coords},
-            )
-
-            # Handle concatenation dimension if applicable
-            concat_dim = (
-                f"{key}__target_time_utc"
-                if f"{key}__target_time_utc" in dataset.coords
-                else f"{key}__time_utc"
-            )
-
-            if f"{key}__init_time_utc" in dataset.coords:
-                init_coord = f"{key}__init_time_utc"
-                if dataset[init_coord].ndim == 0:  # Check if scalar
-                    expanded_init_times = [dataset[init_coord].values] * len(dataset[concat_dim])
-                    dataset = dataset.assign_coords({init_coord: (concat_dim, expanded_init_times)})
-
-            datasets.append(dataset)
-
-        # Ensure all datasets are valid xarray.Dataset objects
-        for ds in datasets:
-            if not isinstance(ds, xr.Dataset):
-                raise ValueError(f"Object is not an xr.Dataset: {type(ds)}")
-
-        # Merge all prepared datasets
-        combined_dataset = xr.merge(datasets)
-
-        return combined_dataset
-
 
 class SitesDatasetConcurrent(Dataset):
     """A torch Dataset for creating PVNet Site batches with samples for all sites."""
@@ -394,93 +332,6 @@ class SitesDatasetConcurrent(Dataset):
         # Assign coords and indices to self
         self.valid_t0s = valid_t0s
 
-    @staticmethod
-    def process_and_combine_datasets(
-        dataset_dict: dict,
-        config: Configuration,
-        t0: pd.Timestamp,
-    ) -> NumpySample:
-        """Normalise and convert data to numpy arrays.
-
-        Args:
-            dataset_dict: Dictionary of xarray datasets
-            config: Configuration object
-            t0: init-time for sample
-        """
-        numpy_modalities = []
-
-        if "nwp" in dataset_dict:
-            nwp_numpy_modalities = {}
-
-            for nwp_key, da_nwp in dataset_dict["nwp"].items():
-                # Standardise and convert to NumpyBatch
-
-                da_channel_means = channel_dict_to_dataarray(
-                    config.input_data.nwp[nwp_key].channel_means,
-                )
-                da_channel_stds = channel_dict_to_dataarray(
-                    config.input_data.nwp[nwp_key].channel_stds,
-                )
-
-                da_nwp = (da_nwp - da_channel_means) / da_channel_stds
-
-                nwp_numpy_modalities[nwp_key] = convert_nwp_to_numpy_sample(da_nwp)
-
-            # Combine the NWPs into NumpyBatch
-            numpy_modalities.append({NWPSampleKey.nwp: nwp_numpy_modalities})
-
-        if "sat" in dataset_dict:
-            da_sat = dataset_dict["sat"]
-
-            # Standardise and convert to NumpyBatch
-            da_channel_means = channel_dict_to_dataarray(config.input_data.satellite.channel_means)
-            da_channel_stds = channel_dict_to_dataarray(config.input_data.satellite.channel_stds)
-
-            da_sat = (da_sat - da_channel_means) / da_channel_stds
-
-            numpy_modalities.append(convert_satellite_to_numpy_sample(da_sat))
-
-        if "site" in dataset_dict:
-            da_sites = dataset_dict["site"]
-            da_sites = da_sites / da_sites.capacity_kwp
-
-            # Convert to NumpyBatch
-            numpy_modalities.append(
-                convert_site_to_numpy_sample(
-                    da_sites,
-                ),
-            )
-
-        # Only add solar position if explicitly configured
-        has_solar_config = (
-            hasattr(config.input_data, "solar_position")
-            and config.input_data.solar_position is not None
-        )
-
-        if has_solar_config:
-            solar_config = config.input_data.solar_position
-
-            # Create datetime range for solar position calculation
-            datetimes = pd.date_range(
-                t0 + minutes(solar_config.interval_start_minutes),
-                t0 + minutes(solar_config.interval_end_minutes),
-                freq=minutes(solar_config.time_resolution_minutes),
-            )
-
-            # Calculate solar positions and add to modalities
-            numpy_modalities.append(
-                make_sun_position_numpy_sample(
-                    datetimes, da_sites.longitude.values, da_sites.latitude.values,
-                ),
-            )
-
-        # Combine all the modalities and fill NaNs
-        combined_sample = merge_dicts(numpy_modalities)
-        combined_sample = fill_nans_in_arrays(combined_sample)
-
-        return combined_sample
-
-
     def find_valid_t0s(
         self,
         datasets_dict: dict,
@@ -551,7 +402,7 @@ class SitesDatasetConcurrent(Dataset):
 
         for location in self.locations:
             site_sample_dict = slice_datasets_by_space(sample_dict, location, self.config)
-            site_numpy_sample = self.process_and_combine_datasets(
+            site_numpy_sample = process_and_combine_datasets(
                 site_sample_dict,
                 self.config,
                 t0,
@@ -561,128 +412,6 @@ class SitesDatasetConcurrent(Dataset):
         return stack_np_samples_into_batch(site_samples)
 
 
-# ----- functions to load presaved samples ------
-
-
-def convert_netcdf_to_numpy_sample(ds: xr.Dataset) -> dict:
-    """Convert a netcdf dataset to a numpy sample.
-
-    Args:
-        ds: xarray Dataset
-    """
-    # convert the single dataset to a dict of arrays
-    sample_dict = convert_from_dataset_to_dict_datasets(ds)
-
-    if "satellite" in sample_dict:
-        # rename satellite to sat # TODO this could be improved
-        sample_dict["sat"] = sample_dict.pop("satellite")
-
-    # process and combine the datasets
-    sample = convert_to_numpy_and_combine(
-        dataset_dict=sample_dict,
-    )
-
-    # Extraction of solar position coords
-    solar_keys = ["solar_azimuth", "solar_elevation"]
-    for key in solar_keys:
-        if key in ds.coords:
-            sample[key] = ds.coords[key].values
-
-    # TODO think about normalization:
-    # * maybe its done not in sample creation, maybe its done afterwards,
-    #   to allow it to be flexible
-
-    return sample
-
-
-def convert_from_dataset_to_dict_datasets(combined_dataset: xr.Dataset) -> dict[str, xr.DataArray]:
-    """Convert a combined sample dataset to a dict of datasets for each input.
-
-    Args:
-        combined_dataset: The combined NetCDF dataset
-
-    Returns:
-        The uncombined datasets as a dict of xr.Datasets
-    """
-    # Split into datasets by splitting by the prefix added in combine_to_netcdf
-    datasets: dict[str, xr.DataArray] = {}
-
-    # Go through each data variable and split it into a dataset
-    for key, dataset in combined_dataset.items():
-        # If 'key__' doesn't exist in a dim or coordinate, remove it
-        for dim in list(dataset.coords):
-            if f"{key}__" not in dim:
-                dataset = dataset.drop_vars(dim)
-        dataset = dataset.rename(
-            {dim: dim.split(f"{key}__")[1] for dim in dataset.dims if dim not in dataset.coords},
-        )
-        dataset = dataset.rename(
-            {coord: coord.split(f"{key}__")[1] for coord in dataset.coords},
-        )
-        # Split the dataset by the prefix
-        datasets[key] = dataset
-
-    # Unflatten any NWP data
-    return nest_nwp_source_dict(datasets, sep="-")
-
-
-def nest_nwp_source_dict(
-    dataset_dict: dict[xr.Dataset],
-    sep: str = "-",
-) -> dict[str, xr.Dataset | dict[xr.Dataset]]:
-    """Re-nest a dictionary where the NWP values are nested under keys 'nwp-<key>'.
-
-    Args:
-        dataset_dict: Dictionary of datasets
-        sep: Separator to use to nest NWP keys
-    """
-    nwp_prefix = f"nwp{sep}"
-    new_dict = {k: v for k, v in dataset_dict.items() if not k.startswith(nwp_prefix)}
-    nwp_keys = [k for k in dataset_dict if k.startswith(nwp_prefix)]
-    if len(nwp_keys) > 0:
-        nwp_subdict = {k.removeprefix(nwp_prefix): dataset_dict[k] for k in nwp_keys}
-        new_dict["nwp"] = nwp_subdict
-    return new_dict
-
-
-def convert_to_numpy_and_combine(dataset_dict: dict[xr.Dataset]) -> NumpySample:
-    """Convert input data in a dict to numpy arrays.
-
-    Args:
-        dataset_dict: Dictionary of xarray Datasets
-    """
-    numpy_modalities = []
-
-    if "nwp" in dataset_dict:
-        nwp_numpy_modalities = {}
-        for nwp_key, da_nwp in dataset_dict["nwp"].items():
-            # Convert to NumpySample
-            nwp_numpy_modalities[nwp_key] = convert_nwp_to_numpy_sample(da_nwp)
-
-        # Combine the NWPs into NumpySample
-        numpy_modalities.append({NWPSampleKey.nwp: nwp_numpy_modalities})
-
-    if "sat" in dataset_dict:
-        # Satellite is already in the range [0-1] so no need to standardise
-        da_sat = dataset_dict["sat"]
-
-        # Convert to NumpySample
-        numpy_modalities.append(convert_satellite_to_numpy_sample(da_sat))
-
-    if "site" in dataset_dict:
-        da_sites = dataset_dict["site"]
-
-        numpy_modalities.append(
-            convert_site_to_numpy_sample(
-                da_sites,
-            ),
-        )
-
-    # Combine all the modalities and fill NaNs
-    combined_sample = merge_dicts(numpy_modalities)
-    return fill_nans_in_arrays(combined_sample)
-
-
 def coarsen_data(xr_data: xr.Dataset, coarsen_to_deg: float = 0.1) -> xr.Dataset:
     """Coarsen the data to a specified resolution in degrees.
 

ocf_data_sampler/torch_datasets/sample/site.py

@@ -1,37 +1,46 @@
 """PVNet Site sample implementation for netCDF data handling and conversion."""
 
-import xarray as xr
+import torch
 from typing_extensions import override
 
 from ocf_data_sampler.numpy_sample.common_types import NumpySample
-from ocf_data_sampler.torch_datasets.datasets.site import convert_netcdf_to_numpy_sample
 
 from .base import SampleBase
 
 
+# TODO this is now similar to the UKRegionalSample
+# We should consider just having one Sample class for all datasets
 class SiteSample(SampleBase):
-    """Handles PVNet site specific netCDF operations."""
+    """Handles SiteSample specific operations."""
 
-    def __init__(self, data: xr.Dataset) -> None:
-        """Initializes the SiteSample object with the given xarray Dataset."""
-        if not isinstance(data, xr.Dataset):
-            raise TypeError(f"Data must be xarray Dataset - Found type {type(data)}")
+    def __init__(self, data: NumpySample) -> None:
+        """Initializes the SiteSample object with the given NumpySample."""
         self._data = data
 
     @override
     def to_numpy(self) -> NumpySample:
-        return convert_netcdf_to_numpy_sample(self._data)
+        return self._data
 
     @override
     def save(self, path: str) -> None:
-        # Saves as NetCDF
-        self._data.to_netcdf(path, mode="w", engine="h5netcdf")
+        """Saves sample to the specified path in pickle format."""
+        # Saves to pickle format
+        torch.save(self._data, path)
 
     @classmethod
     @override
     def load(cls, path: str) -> "SiteSample":
-        # Loads from NetCDF
-        return cls(xr.open_dataset(path, decode_timedelta=False))
+        """Loads sample from the specified path.
+
+        Args:
+            path: Path to the saved sample file.
+
+        Returns:
+            A SiteSample instance with the loaded data.
+        """
+        # Loads from .pt format
+        # TODO: We should move away from using torch.load(..., weights_only=False)
+        return cls(torch.load(path, weights_only=False))
 
     @override
     def plot(self) -> None:

{ocf_data_sampler-0.3.1.dist-info → ocf_data_sampler-0.5.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ocf-data-sampler
-Version: 0.3.1
+Version: 0.5.0
 Author: James Fulton, Peter Dudfield
 Author-email: Open Climate Fix team <info@openclimatefix.org>
 License: MIT License
@@ -49,7 +49,7 @@ Requires-Dist: xarray-tensorstore==0.1.5
 # ocf-data-sampler
  
 <!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section -->
-[![All Contributors](https://img.shields.io/badge/all_contributors-13-orange.svg?style=flat-square)](#contributors-)
+[![All Contributors](https://img.shields.io/badge/all_contributors-14-orange.svg?style=flat-square)](#contributors-)
 <!-- ALL-CONTRIBUTORS-BADGE:END -->
 
 [![tags badge](https://img.shields.io/github/v/tag/openclimatefix/ocf-data-sampler?include_prereleases&sort=semver&color=FFAC5F)](https://github.com/openclimatefix/ocf-data-sampler/tags)
@@ -128,6 +128,7 @@ Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/d
       <td align="center" valign="top" width="14.28%"><a href="http://siddharth7113.github.io"><img src="https://avatars.githubusercontent.com/u/114160268?v=4?s=100" width="100px;" alt="Siddharth"/><br /><sub><b>Siddharth</b></sub></a><br /><a href="https://github.com/openclimatefix/ocf-data-sampler/commits?author=siddharth7113" title="Code">💻</a></td>
       <td align="center" valign="top" width="14.28%"><a href="https://github.com/Sachin-G13"><img src="https://avatars.githubusercontent.com/u/190184500?v=4?s=100" width="100px;" alt="Sachin-G13"/><br /><sub><b>Sachin-G13</b></sub></a><br /><a href="https://github.com/openclimatefix/ocf-data-sampler/commits?author=Sachin-G13" title="Code">💻</a></td>
       <td align="center" valign="top" width="14.28%"><a href="https://drona-gyawali.github.io/"><img src="https://avatars.githubusercontent.com/u/170401554?v=4?s=100" width="100px;" alt="Dorna Raj Gyawali"/><br /><sub><b>Dorna Raj Gyawali</b></sub></a><br /><a href="https://github.com/openclimatefix/ocf-data-sampler/commits?author=drona-gyawali" title="Code">💻</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/adnanhashmi25"><img src="https://avatars.githubusercontent.com/u/55550094?v=4?s=100" width="100px;" alt="Adnan Hashmi"/><br /><sub><b>Adnan Hashmi</b></sub></a><br /><a href="https://github.com/openclimatefix/ocf-data-sampler/commits?author=adnanhashmi25" title="Code">💻</a></td>
     </tr>
   </tbody>
 </table>

{ocf_data_sampler-0.3.1.dist-info → ocf_data_sampler-0.5.0.dist-info}/RECORD

@@ -22,14 +22,14 @@ ocf_data_sampler/load/nwp/providers/gfs.py,sha256=h6vm-Rfz1JGOE4P_fP1_XQJ3bugNbe
 ocf_data_sampler/load/nwp/providers/icon.py,sha256=iVZwLKRr_D74_kAu5MHir6pRKEfbTmIxFRZAxzmiYdI,1257
 ocf_data_sampler/load/nwp/providers/ukv.py,sha256=2i32VM9gnmWUpbL0qBSp_AKzuyKucXZPS8yklbcGlbc,1039
 ocf_data_sampler/load/nwp/providers/utils.py,sha256=cVwCiC8FqNpkZFSUGv1CRqIQlKdjx1sIsb2SIUlvWV8,2333
-ocf_data_sampler/numpy_sample/__init__.py,sha256=nY5C6CcuxiWZ_jrXRzWtN7WyKXhJImSiVTIG6Rz4B_4,401
+ocf_data_sampler/numpy_sample/__init__.py,sha256=5bdpzM8hMAEe0XRSZ9AZFQdqEeBsEPhaF79Y8bDx3GQ,407
 ocf_data_sampler/numpy_sample/collate.py,sha256=hoxIc5SoHoIs3Nx37aRZzWChpswjy9lHUgaKgHIoo80,2039
 ocf_data_sampler/numpy_sample/common_types.py,sha256=9CjYHkUTx0ObduWh43fhsybZCTXvexql7qC2ptMDoek,377
-ocf_data_sampler/numpy_sample/datetime_features.py,sha256=qoUOQzHZebnc5JiXCwm258kPLwNRNJgE5JcVHKI9b70,1278
+ocf_data_sampler/numpy_sample/datetime_features.py,sha256=ObHM42VnZB7_daQ5a42GeftoDWYtVMT-wDP8kRtY_84,857
 ocf_data_sampler/numpy_sample/gsp.py,sha256=aUHDIUSu2LMsVmR7TsTriZxVfv495QNL-scaxyJFHgQ,1149
 ocf_data_sampler/numpy_sample/nwp.py,sha256=lXqE2Il0xX5hzz76HHkiYmfDsXWWhmaA_6bSnmwbAXU,1078
 ocf_data_sampler/numpy_sample/satellite.py,sha256=RaYzYIcB1AmDrKeiqSpn4QVfBH-QMe26F1P5t1az2Jg,1111
-ocf_data_sampler/numpy_sample/site.py,sha256=zfYBjK3CJrIaKH1QdKXU7gwOxTqONt527y3nJ9TRnwc,1325
+ocf_data_sampler/numpy_sample/site.py,sha256=4S19bzCN5lswVUrmWRfwpVsBPUE7bi0OIdxsD9wgvhU,982
 ocf_data_sampler/numpy_sample/sun_position.py,sha256=5tt-zNm6aRuZMsxZPaAxyg7HeikswfZCeHWXTHuO2K0,1555
 ocf_data_sampler/select/__init__.py,sha256=mK7Wu_-j9IXGTYrOuDf5yDDuU5a306b0iGKTAooNg_s,210
 ocf_data_sampler/select/dropout.py,sha256=BYpv8L771faPOyN7SdIJ5cwkpDve-ohClj95jjsHmjg,1973
@@ -39,12 +39,12 @@ ocf_data_sampler/select/geospatial.py,sha256=CDExkl36eZOKmdJPzUr_K0Wn3axHqv5nYo-
 ocf_data_sampler/select/location.py,sha256=AZvGR8y62opiW7zACGXjoOtBEWRfSLOZIA73O5Deu0c,1037
 ocf_data_sampler/select/select_spatial_slice.py,sha256=Hd4jGRUfIZRoWCirOQZeoLpaUnStB6KyFSTPX69wZLw,8790
 ocf_data_sampler/select/select_time_slice.py,sha256=HeHbwZ0CP03x0-LaJtpbSdtpLufwVTR73p6wH6O_PS8,5513
-ocf_data_sampler/torch_datasets/datasets/__init__.py,sha256=jfJSFcR0eO1AqeH7S3KnGjsBqVZT5w3oyi784PUR6Q0,146
+ocf_data_sampler/torch_datasets/datasets/__init__.py,sha256=o0SsEXXZ6k9iL__5_RN1Sf60lw_eqK91P3UFEHAD2k0,102
 ocf_data_sampler/torch_datasets/datasets/pvnet_uk.py,sha256=v63goKEMI6UgBPnQCnIbxhFFdwuP_sxgcPYY6iNfGkc,12257
-ocf_data_sampler/torch_datasets/datasets/site.py,sha256=R9sYZz3e1zr8NAtlYQp8_DgI3wIfC7Zvaeo_73TyiA8,24936
+ocf_data_sampler/torch_datasets/datasets/site.py,sha256=_0A2kRq8B5WL5zWjKxNY9snAl_GwptohUt7c6DDa2AA,14812
 ocf_data_sampler/torch_datasets/sample/__init__.py,sha256=GL84vdZl_SjHDGVyh9Uekx2XhPYuZ0dnO3l6f6KXnHI,100
 ocf_data_sampler/torch_datasets/sample/base.py,sha256=cQ1oIyhdmlotejZK8B3Cw6MNvpdnBPD8G_o2h7Ye4Vc,2206
-ocf_data_sampler/torch_datasets/sample/site.py,sha256=Pq-QjAg88kWXzFR4ci5ATaTWA864eifU7wrJSpmqK4s,1292
+ocf_data_sampler/torch_datasets/sample/site.py,sha256=40NwNTqjL1WVhPdwe02zDHHfDLG2u_bvCfRCtGAtFc0,1466
 ocf_data_sampler/torch_datasets/sample/uk_regional.py,sha256=Xx5cBYUyaM6PGUWQ76MHT9hwj6IJ7WAOxbpmYFbJGhc,10483
 ocf_data_sampler/torch_datasets/utils/__init__.py,sha256=N7i_hHtWUDiJqsiJoDx4T_QuiYOuvIyulPrn6xEA4TY,309
 ocf_data_sampler/torch_datasets/utils/channel_dict_to_dataarray.py,sha256=un2IiyoAmTDIymdeMiPU899_86iCDMD-oIifjHlNyqw,555
@@ -56,7 +56,7 @@ ocf_data_sampler/torch_datasets/utils/validation_utils.py,sha256=YqmT-lExWlI8_ul
 scripts/download_gsp_location_data.py,sha256=rRDXMoqX-RYY4jPdxhdlxJGhWdl6r245F5UARgKV6P4,3121
 scripts/refactor_site.py,sha256=skzvsPP0Cn9yTKndzkilyNcGz4DZ88ctvCJ0XrBdc2A,3135
 utils/compute_icon_mean_stddev.py,sha256=a1oWMRMnny39rV-dvu8rcx85sb4bXzPFrR1gkUr4Jpg,2296
-ocf_data_sampler-0.3.1.dist-info/METADATA,sha256=pQpPqmpTlUiZnPY1Q_xZr1Z-GrKSATG_P77YYHpWm6Y,12224
-ocf_data_sampler-0.3.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-ocf_data_sampler-0.3.1.dist-info/top_level.txt,sha256=LEFU4Uk-PEo72QGLAfnVZIUEm37Q8mKuMeg_Xk-p33g,31
-ocf_data_sampler-0.3.1.dist-info/RECORD,,
+ocf_data_sampler-0.5.0.dist-info/METADATA,sha256=DUHmN65X_SR-1E8bTNfsCShFPJKIEvR9DWfAQoNyAt4,12588
+ocf_data_sampler-0.5.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+ocf_data_sampler-0.5.0.dist-info/top_level.txt,sha256=LEFU4Uk-PEo72QGLAfnVZIUEm37Q8mKuMeg_Xk-p33g,31
+ocf_data_sampler-0.5.0.dist-info/RECORD,,