canvod-readers 0.2.1

Collection of GNSS data readers for GNSS-Transmissometry

canvod-readers

GNSS data format readers for canVODpy.

Features

• RINEX v3.04 Support: Complete reader for RINEX v3 observation files
• Signal IDs: Unique identifiers for each GNSS signal (SV|BAND|CODE format)
• xarray Integration: Convert observations to xarray Datasets
• Automatic Validation: Header parsing and epoch completeness checking
• Memory Efficient: Lazy iteration through large files
• Flexible Filtering: Filter by GNSS system, frequency band, or code type

Installation

uv pip install canvod-readers

Quick Start

from pathlib import Path
from canvod.readers import Rnxv3Obs

# Load RINEX file
filepath = Path("path/to/rinex.25o")
reader = Rnxv3Obs(fpath=filepath)

# Convert to xarray Dataset
dataset = reader.to_ds(keep_rnx_data_vars=["SNR"])

# Filter GPS L1 signals
gps_l1 = dataset.where(
    (dataset.system == 'G') & (dataset.band == 'L1'),
    drop=True
)

Interactive Examples

View interactive examples using marimo notebooks:

# Edit mode (interactive development)
just marimo

# Presentation mode (read-only)
just marimo-present

Or directly:

uv run marimo edit docs/examples.py

Development

# Clone repository
git clone https://github.com/nfb2021/canvodpy.git
cd canvodpy/packages/canvod-readers

# Install dependencies
uv sync

# Run tests
just test

# Check code quality
just check

Documentation

• Interactive examples: docs/examples.py (marimo notebook)
• Centralized documentation

License

Apache License 2.0