Skip to main content

Documentation status PyPI version Downloads

datide

Data assimilation routines for Gaussian process regression, built to connect with gptide and gpvecchia.

Please see the examples for particular use cases.

Documentation

Documentation is available on read the docs.

Installation

pip

pip install datide

To install a local development version

pip install -e ./

To install latest from github

pip install git+https://github.com/tide-itrh/datide.git

Features

  • Gaussian process regression posterior mean, marginal likelihood, posterior covariance and conditional sampling, given an observation operator H, prior covariance B and observation error covariance R.
  • Three solvers sharing the same interface: DAdense (dense linear algebra), DAsparse (dask + sparse, for much larger problems) and DAblock (batches many independent problems, e.g. one per harmonic constituent).
  • MultiscaleGP, for combining multiple additive latent-process scales (e.g. a large-scale and a small-scale field) into one Gaussian process posterior, with an optional Woodbury-identity fast path for low-rank scales.
  • Pluggable prior covariance representations in datide.scales (dense, sparse, low-rank, or delegated to an external Vecchia-approximation evaluator) consumed by both DAdense and MultiscaleGP.
  • datide.synthetic, for generating synthetic Gaussian random fields to test against a known truth.

Quick Usage

import numpy as np
from datide import DAdense

rng = np.random.default_rng(0)

n_obs, n_state = 20, 5
H = rng.normal(size=(n_obs, n_state))          # observation operator
B = np.eye(n_state)                             # prior state covariance
R = 0.1 * np.eye(n_obs)                         # observation error covariance

x_true = rng.normal(size=n_state)
y = H @ x_true + rng.normal(scale=0.1, size=n_obs)  # noisy observations

model = DAdense(H, B, R)
x_est = model(y)  # posterior mean estimate of x_true

See the examples for a worked multiscale interpolation use case.

Citing

If you use datide in your research, please cite it -- see CITATION.cff for citation metadata (also available via GitHub's "Cite this repository" button).

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

datide-0.0.4.tar.gz (441.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

datide-0.0.4-py3-none-any.whl (21.5 kB view details)

Uploaded Python 3

File details

Details for the file datide-0.0.4.tar.gz.

File metadata

  • Download URL: datide-0.0.4.tar.gz
  • Upload date:
  • Size: 441.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for datide-0.0.4.tar.gz
Algorithm Hash digest
SHA256 07df5b001ffe1646ac02c8550795783d7bdb05688c0f19690a2bea13def0badf
MD5 c93e15dfb0801e098ba0a7f4bfd613f1
BLAKE2b-256 f6dc9fc6af7e13a94150169c70d031e05ca035af78e6fafbc617a72cc6342e79

See more details on using hashes here.

Provenance

The following attestation bundles were made for datide-0.0.4.tar.gz:

Publisher: publish.yml on TIDE-ITRH/datide

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file datide-0.0.4-py3-none-any.whl.

File metadata

  • Download URL: datide-0.0.4-py3-none-any.whl
  • Upload date:
  • Size: 21.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for datide-0.0.4-py3-none-any.whl
Algorithm Hash digest
SHA256 ff328fd6d82dc14236721f7fcd13ea20813712334485f987c48cdf3473ff2a7a
MD5 3dc8a04316d3816a14fccf35bdb06373
BLAKE2b-256 e2e131b487013e967bbb9130b167f2acea082976bdea80edc54b668865171cae

See more details on using hashes here.

Provenance

The following attestation bundles were made for datide-0.0.4-py3-none-any.whl:

Publisher: publish.yml on TIDE-ITRH/datide

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

This release

0.0.4 This release

2 files

0.0.1

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page