Skip to main content

Documentation status PyPI version Downloads

wootils

A grab-bag of Python utilities for oceanographic/scientific data analysis: harmonic-model fitting, rolling-window filtering of unevenly spaced data, spectral analysis, geodesic/UTM coordinate conversion, time-coordinate helpers, and plotting convenience functions built on numpy, scipy, and xarray.

Please see the examples for a few worked snippets.

Documentation

Documentation is available on read the docs.

Installation

pip

pip install wootils

To install a local development version

pip install -e ./

To install latest from github

pip install git+https://github.com/williamedge/wootils.git

Features

  • Harmonic-model fitting: design-matrix construction and least-squares fit/predict for annual (and other) harmonics, in wootils.linalg.
  • Rolling-window filtering of unevenly spaced xarray data (boxcar, Gaussian-weighted, Savitzky-Golay), via the .ufilt accessor in wootils.ufilters.
  • Spectral analysis: Nyquist/fundamental frequency estimation, chunked/overlapped PSD estimation, and quadratic barotropic-component removal, in wootils.ofreqs/fft_utils.
  • Geodesic distance and lon/lat → UTM coordinate conversion, in wootils.spatial.
  • Time-coordinate helpers (regularity/gap checks, season labeling) in wootils.time_wutils.
  • Bivariate (u/v velocity) colormap plotting and other matplotlib convenience helpers, in wootils.plotcolours/plotnice/plottimeseries.

Quick Usage

import numpy as np
from wootils.linalg import fit_harmonic_model, predict_harmonic_model

# Fit the first two annual harmonics to a time series and evaluate the fit
params = fit_harmonic_model(time_sec, data, n_harmonics=2, mean=True)
fitted = predict_harmonic_model(time_sec, params, mean=True)

See the examples page for rolling filters, UTM conversion, and frequency estimation.

Download files

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

Source Distribution

wootils-0.0.4.tar.gz (66.5 kB view details)

Uploaded Source

Built Distribution

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

wootils-0.0.4-py3-none-any.whl (52.4 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for wootils-0.0.4.tar.gz
Algorithm Hash digest
SHA256 dad3f8c366190843a06d7a79213b644f2c958dc0d1e773842fc2f94ee1ff8238
MD5 e6a0a900aba6c84d9bd021d365909f44
BLAKE2b-256 fef87203c6af79e0d2bab08f88f40229f8e6494fd3ad9fd73f1681a760587d72

See more details on using hashes here.

Provenance

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

Publisher: publish.yml on williamedge/wootils

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

File details

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

File metadata

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

File hashes

Hashes for wootils-0.0.4-py3-none-any.whl
Algorithm Hash digest
SHA256 875855b9496c0fbc5481d4d4c08aeb7c956b64bf4c7011d46537eb4bcddc9be8
MD5 63cb4379763b64f0f30b39a13c8dbb7e
BLAKE2b-256 9fdc99b6860b784eccdd941004727961af20e27933ef3f5c69172f9497a7e592

See more details on using hashes here.

Provenance

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

Publisher: publish.yml on williamedge/wootils

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.3

2 files

0.0.1

1 file

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