Skip to content

0.1.0rc1 release notes — not published

First public alpha / early scientific software release. Not yet published. This is the first release candidate, intended for outside-user acceptance testing. The package version is actually 0.1.0rc1; it is not a relabeled 0.1.0 wheel. No GitHub Release, PyPI upload, DOI, or source promotion has occurred in this preparation task.

Installation and acceptance testing

Current state: not published. Install only a maintainer-supplied tested wheel with its SHA256, or wait for public assets. After GitHub publication:

python -m pip install "https://github.com/CU-ESIIL/cubedynamics/releases/download/v0.1.0rc1/cubedynamics-0.1.0rc1-py3-none-any.whl"

That URL is future/post-publication, not currently available. After separate PyPI publication, use python -m pip install cubedynamics==0.1.0rc1. See installation for fresh environments, checksums, and the distinction from a future final release. The quickstart needs no source checkout.

Please report problems in GitHub Issues with the wheel SHA256, Python/platform, pip check, package version/import path, minimal code and full traceback. Do not include credentials. A failed public install is a release blocker, not permission to substitute a clone.

Ready for documented use

  • A composable pipe grammar over labeled spatiotemporal objects, with ordinary callable/custom-verb support and explicit result boundaries.
  • Maintained vocabulary for transformation, reduction, states/events and comparisons, with factory/direct-call distinctions in reference pages.
  • Eight documented catalog nouns backed by gridMET, PRISM and Sentinel-2; explicit source/statistic selection and preserved provenance.
  • Twelve supported offline notebooks with reviewed external observations, figures and interpretation. Fixtures belong to the checkout, not the wheel.
  • Source schema, QA, revision and certification architecture that separates endpoint availability from scientific suitability.
  • Wheel/sdist inspection, an isolated installed-wheel smoke and README test, and a release notebook mode that verifies exact wheel identity in each kernel.

The 0.1 API contract names the stable subset. This is not a promise that every exported callable or metadata report is permanently frozen.

Usable candidates, not promoted sources

3DEP elevation, Overture/OSM roads, and USGS streamflow are installed candidate adapters with explicit source-specific imports, bounded acquisition and real offline lessons. They have no production serving revision and remain outside catalog discovery. Successful import or notebook execution is not promotion.

Project-specific vocabulary

Fire VASE, synchrony, biology and tubes remain in the distribution for current 0.x compatibility. Their methods and assumptions are separate from the core grammar. Fire plotting still uses Plotly; the general cube viewer is the custom HTML/CSS/JavaScript renderer. No research outputs were deleted or major modules extracted during this release pass.

Known limitations

  • Remote services can be unavailable. Offline QA does not establish new live source PASS results or guarantee throughput for large requests.
  • Shared nouns do not harmonize temperature units/statistics, grids, masks, vertical datums, source revisions or native road classes. Overture includes OSM; comparisons are not independent ground truth. USGS observations may be provisional and revised later.
  • Daymet remains BLOCKED, outside implemented discovery, with its existing authentication/access review incomplete. See Daymet status.
  • Some paths need optional decoders/backends; the base install remains broad. See the dependency audit.
  • Coaching/report schemas and early APIs can evolve before 1.0. v.correlation_cube and v.fit_model remain reserved, not implemented.
  • climate_cube_math remains a warning-emitting compatibility namespace.
  • No release DOI exists yet. Add only a genuinely assigned archival DOI after a separately authorized release, keeping both citation records synchronized.

Release evidence

The curated candidate record lives in manifests/releases/ in the repository; large logs and executed notebooks remain under ignored artifacts/release-0.1.0rc1/. Records distinguish the base commit from uncommitted release-hardening changes, actual Python versions exercised from configured CI targets, and fixture checks from live certification. Rebuild after release-relevant changes; old hashes do not validate a new artifact.