canvod-store 0.2.0__tar.gz

canvod_store-0.2.0/PKG-INFO

@@ -0,0 +1,72 @@
+Metadata-Version: 2.3
+Name: canvod-store
+Version: 0.2.0
+Summary: Icechunk storage for GNSS VOD data
+Keywords: GNSS,VOD,storage,icechunk,zarr
+Author: Nicolas François Bader
+Author-email: Nicolas François Bader <nicolas.bader@geo.tuwien.ac.at>
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.14
+Requires-Dist: canvod-grids>=0.1.0
+Requires-Dist: icechunk>=1.1.5
+Requires-Dist: zarr>=3.1.2
+Requires-Dist: xarray>=2023.12.0
+Requires-Dist: polars>=1.0.0
+Requires-Dist: numpy>=1.24.0
+Requires-Dist: networkx>=3.6.1
+Maintainer: Climate and Environmental Remote Sensing (CLIMERS)
+Maintainer-email: Climate and Environmental Remote Sensing (CLIMERS) <nicolas.bader@geo.tuwien.ac.at>
+Requires-Python: >=3.14
+Description-Content-Type: text/markdown
+
+# canvod-store
+
+Icechunk storage for GNSS VOD data.
+
+Part of the [canVODpy](https://github.com/nfb2021/canvodpy) ecosystem.
+
+## Overview
+
+This package provides versioned storage for GNSS data using Icechunk, managing:
+
+- **RINEX Store (Level 1)**: Augmented observations per receiver
+- **VOD Store (Level 2)**: Analysis products comparing receiver pairs
+
+## Installation
+
+```bash
+pip install canvod-store
+```
+
+## Quick Start
+
+```python
+from canvod.store import create_rinex_store, GnssResearchSite
+from pathlib import Path
+
+# Create stores
+rinex_store = create_rinex_store(Path("./rinex_store"))
+
+# Or use site manager
+site = GnssResearchSite(site_name="Rosalia")
+```
+
+## Features
+
+- Automatic repository creation/connection
+- Group management with validation
+- Session management with context managers
+- Integrated logging and metadata tracking
+- Configurable compression and chunking
+- Deduplication support
+
+## Documentation
+
+[Centralized documentation](../../docs/packages/store/overview.md)
+
+## License
+
+Apache License 2.0 - see LICENSE file

canvod_store-0.2.0/README.md

@@ -0,0 +1,48 @@
+# canvod-store
+
+Icechunk storage for GNSS VOD data.
+
+Part of the [canVODpy](https://github.com/nfb2021/canvodpy) ecosystem.
+
+## Overview
+
+This package provides versioned storage for GNSS data using Icechunk, managing:
+
+- **RINEX Store (Level 1)**: Augmented observations per receiver
+- **VOD Store (Level 2)**: Analysis products comparing receiver pairs
+
+## Installation
+
+```bash
+pip install canvod-store
+```
+
+## Quick Start
+
+```python
+from canvod.store import create_rinex_store, GnssResearchSite
+from pathlib import Path
+
+# Create stores
+rinex_store = create_rinex_store(Path("./rinex_store"))
+
+# Or use site manager
+site = GnssResearchSite(site_name="Rosalia")
+```
+
+## Features
+
+- Automatic repository creation/connection
+- Group management with validation
+- Session management with context managers
+- Integrated logging and metadata tracking
+- Configurable compression and chunking
+- Deduplication support
+
+## Documentation
+
+[Centralized documentation](../../docs/packages/store/overview.md)
+
+## License
+
+Apache License 2.0 - see LICENSE file

canvod_store-0.2.0/pyproject.toml

@@ -0,0 +1,72 @@
+[project]
+name = "canvod-store"
+version = "0.2.0"
+description = "Icechunk storage for GNSS VOD data"
+authors = [
+    {name = "Nicolas François Bader", email = "nicolas.bader@geo.tuwien.ac.at"},
+]
+maintainers = [
+    {name = "Climate and Environmental Remote Sensing (CLIMERS)", email = "nicolas.bader@geo.tuwien.ac.at"},
+]
+readme = "README.md"
+requires-python = ">=3.14"
+keywords = ["GNSS", "VOD", "storage", "icechunk", "zarr"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Science/Research",
+    "License :: OSI Approved :: Apache Software License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.14",
+]
+
+dependencies = [
+    "canvod-grids>=0.1.0",
+    "icechunk>=1.1.5",
+    "zarr>=3.1.2",
+    "xarray>=2023.12.0",
+    "polars>=1.0.0",
+    "numpy>=1.24.0",
+    "networkx>=3.6.1",
+]
+
+[dependency-groups]
+dev = [
+    "pytest>=8.0",
+    "pytest-cov>=5.0",
+    "ruff>=0.14",
+    "ty>=0.0.9",
+]
+
+[tool.uv.sources]
+canvod-grids = { workspace = true }
+
+[build-system]
+requires = ["uv_build>=0.9.17,<0.10.0"]
+build-backend = "uv_build"
+
+[tool.uv.build-backend]
+module-name = "canvod.store"
+
+[tool.ruff]
+line-length = 88
+target-version = "py314"
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "N", "W", "UP"]
+ignore = []
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+python_files = ["test_*.py"]
+python_classes = ["Test*"]
+python_functions = ["test_*"]
+addopts = [
+    "-v",
+    "--strict-markers",
+    "--tb=short",
+    "--disable-warnings",
+]
+markers = [
+    "slow: marks tests as slow (deselect with '-m \"not slow\"')",
+    "integration: marks tests as integration tests",
+]

canvod_store-0.2.0/src/canvod/store/__init__.py

@@ -0,0 +1,23 @@
+"""canvod-store: Icechunk storage for GNSS VOD data.
+
+This package provides versioned storage for GNSS VOD data using Icechunk.
+Manages both RINEX observation storage and VOD analysis results.
+"""
+
+from canvod.store.manager import GnssResearchSite
+from canvod.store.reader import IcechunkDataReader
+from canvod.store.store import (
+    MyIcechunkStore,
+    create_rinex_store,
+    create_vod_store,
+)
+
+__version__ = "0.1.0"
+
+__all__ = [
+    "GnssResearchSite",
+    "IcechunkDataReader",
+    "MyIcechunkStore",
+    "create_rinex_store",
+    "create_vod_store",
+]

canvod_store-0.2.0/src/canvod/store/file_registry.py

@@ -0,0 +1,35 @@
+"""File registry (ingest ledger) helpers for Icechunk-backed stores.
+
+This module manages the per-file tracking table stored at
+``{group}/metadata/table`` inside an Icechunk store. Each row records
+a single ingested file: its hash, temporal range, filename, path, etc.
+
+**Not to be confused with** ``canvod.store_metadata`` (the separate package),
+which manages store-level provenance: identity, creator, environment,
+software versions, STAC/DataCite/ACDD compliance, etc.
+
+Terminology
+-----------
+- **File registry** (this module): *which files* went into a store group.
+- **Store metadata** (``canvod.store_metadata``): *who/what/when/how* about
+  the store as a whole.
+"""
+
+from typing import Any
+
+from canvodpy.logging import get_logger
+
+
+class FileRegistryManager:
+    """Manage file registry table CRUD, backups, and deduplication for groups.
+
+    Parameters
+    ----------
+    logger : Any, optional
+        Logger-like object to use. Defaults to the configured context logger.
+    """
+
+    def __init__(self, logger: Any | None = None) -> None:
+        self._logger = logger or get_logger(__name__)
+
+    # TODO: Future refactor — extract metadata table methods from MyIcechunkStore.

canvod_store-0.2.0/src/canvod/store/grid_adapters/__init__.py

@@ -0,0 +1,9 @@
+"""Grid adapters for hemisphere grid storage in Icechunk."""
+
+# These will be enabled when canvod-grids is migrated
+# from canvod.store.grid_adapters.complete_grid_vod_workflow import (
+#     store_grid_to_vod_store,
+#     load_grid_from_vod_store,
+# )
+
+__all__ = []