earthsciencekit 0.2.0__tar.gz

earthsciencekit-0.2.0/CHANGELOG.md

@@ -0,0 +1,75 @@
+# Changelog
+
+## [0.2.0] - 2026-10-17
+
+- First release on PyPI, with the git history on GitHub, CI, tag-driven
+  releases (`release.yml`), docs hosted on GitHub Pages (`docs.yml`), a mypy
+  step in CI, JupyterLite buttons on the gallery and a Colab quickstart
+  notebook (ROADMAP item 1).
+- New `geophysics` domain (ROADMAP item 6): gravity anomalies and reductions,
+  normal gravity, Clairaut's theorem and the flattening, satellite J2, Stokes's
+  geoid kernel, the axial dipole and zonal Gauss coefficients, field elements,
+  virtual geomagnetic poles, magnetic anomalies of reversed blocks, the dynamo
+  scales, Love numbers and GRACE equivalent water: 30 algebraic models and the
+  dynamic `simulate_rikitake_dynamo`. Its history is a dated chronology of 16
+  breakthroughs, from Gilbert's magnetic Earth (1600) to GRACE (2002), each with
+  its own executed example.
+- New units `m/s^2`, `mGal`, `T` and `nT`.
+- New `volcanology` domain (ROADMAP item 7): radioactive decay and the age
+  equation, radiocarbon, Pb-Pb ages, the U-Pb concordia and the isochron,
+  Rayleigh fractionation and delta values, fractional and equilibrium
+  crystallization, lattice-strain partitioning, the oxygen-isotope
+  thermometer, Arrhenius and Shaw viscosity, water solubility, dike ascent,
+  the Mogi source, plume and eruption-column heights and the VEI: 23
+  algebraic models and the dynamic `simulate_eruption_column`. Its history is
+  a dated chronology of 17 breakthroughs, from Rayleigh's fractional
+  distillation (1896) to the Volcanic Explosivity Index (1982), each with its
+  own executed example.
+- New units `kyr`, `Ma`, `Ga` and `GPa`; new constants `AVOGADRO`,
+  `LAMBDA_U238`, `LAMBDA_U235`, `U238_U235` and `LIBBY_MEAN_LIFE`.
+- Family layout: each domain is a package of `systems/<topic>.py` modules with
+  `core/`, `visualizers/` and `tests/`; `constants` and `units` are packages and
+  the cross-cutting tests moved from `tests/` to `earthsciencekit/tests/`. Every
+  public import path, such as `from earthsciencekit.climate import simulate_one_box`,
+  is unchanged.
+- `plate_tectonics` history is a dated chronology of 16 breakthroughs, from Euler's
+  rotation theorem (1776) to NUVEL-1 (1990), each with its own executed example;
+  the three shared plate_tectonics gallery scripts are removed.
+- New `plate_tectonics` models: `mantle_rayleigh_number`, `flexural_deflection`,
+  `hotspot_age`, `ocean_depth` and `compose_euler_vectors`.
+- `seismology` history is a dated chronology of 16 breakthroughs, from Poisson's
+  two elastic waves (1829) to PREM (1981), each with its own executed example;
+  the three shared seismology gallery scripts are removed.
+- New `seismology` models: `rayleigh_wave_speed`, `head_wave_travel_time`,
+  `crossover_distance`, `love_wave_angular_frequency`, `ray_parameter`,
+  `local_magnitude` and `vertical_travel_time`.
+- `atmosphere` history is a dated chronology of 16 breakthroughs, from Torricelli's
+  barometer (1643) to the ENIAC forecast (1950), each with its own executed example;
+  the three shared atmosphere gallery scripts are removed.
+- New `atmosphere` models: `barometer_column_height`, `two_layer_temperature`,
+  `richardson_number`, `surface_pressure_tendency`, `rossby_wave_speed` and the
+  dynamic `simulate_barotropic_vorticity`.
+- `climate` history is a dated chronology of 16 breakthroughs, from Fourier's
+  greenhouse (1824) to the sea-level budget (2005), each with its own executed
+  example; the three shared climate gallery scripts are removed.
+- New `climate` models: `greenhouse_surface_temperature`, `daily_insolation`,
+  `radiative_convective_temperature`, `equilibrium_solar_constant`,
+  `red_noise_spectrum`, `methane_forcing`, `nitrous_oxide_forcing` and
+  `gregory_regression`.
+- `oceanography` history is a dated chronology of 16 breakthroughs, from Newton's
+  equilibrium tide (1687) to TEOS-10 (2010), each with its own executed example;
+  the three shared oceanography gallery scripts are removed.
+- New `oceanography` models: `gerstner_orbit_radius`, `ekman_spiral_velocity`,
+  `sverdrup_transport`, `stommel_streamfunction`, `thermohaline_forcing`,
+  `abyssal_temperature`, `simplified_seawater_density` and the dynamic
+  `simulate_thermohaline_boxes`.
+
+## [0.1.0] - 2026-10-04
+
+Initial educational release.
+
+- Five domains: plate_tectonics, seismology, atmosphere, climate, oceanography.
+- 77 validated algebraic models and five sampled dynamical models.
+- Shared integration, immutable results, explicit units, labeled plots and animations.
+- MathematicsKit-style Sphinx hubs, histories, guides and 15 executed examples.
+- Independent reference, conservation, limit and invalid-input tests; coverage gate.

earthsciencekit-0.2.0/CITATION.cff

@@ -0,0 +1,11 @@
+cff-version: 1.2.0
+message: "Please cite EarthScienceKit when using its educational models."
+title: "EarthScienceKit: inspectable Earth-system computations"
+authors:
+  - family-names: Poli
+    given-names: Charles
+version: 0.2.0
+date-released: 2026-10-17
+license: MIT
+repository-code: "https://github.com/cpoli/earthsciencekit"
+url: "https://cpoli.github.io/earthsciencekit/"

earthsciencekit-0.2.0/CONTRIBUTING.md

@@ -0,0 +1,16 @@
+# Contributing
+
+Install `python -m pip install -e '.[dev]'`. Use Python 3.10 or newer.
+
+For every public model, document the governing expression, every input/output
+unit, physical conventions and applicability limits. Validate mathematical bounds
+and finite real inputs. Test independent known values and at least one meaningful
+identity or limit. Add a runnable example and update the guide/history when the
+model extends a scientific concept. Avoid runtime formula evaluation or hidden
+network requests.
+
+Run pytest with production coverage, Ruff lint/format and Sphinx warnings-as-errors
+before proposing a change. CI enforces 100% statement coverage; this is a release
+check, not proof of scientific accuracy. Keep version changes explicit and update
+CHANGELOG.md. Releases are cut by pushing a `vX.Y.Z` tag (see
+`.github/workflows/release.yml`).

earthsciencekit-0.2.0/LICENSE

@@ -0,0 +1,15 @@
+MIT License
+
+Copyright (c) 2026 Charles Poli
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

earthsciencekit-0.2.0/MANIFEST.in

@@ -0,0 +1,3 @@
+include README.md LICENSE CHANGELOG.md CITATION.cff
+recursive-include earthsciencekit *.py py.typed
+include CONTRIBUTING.md

earthsciencekit-0.2.0/PKG-INFO

@@ -0,0 +1,127 @@
+Metadata-Version: 2.4
+Name: earthsciencekit
+Version: 0.2.0
+Summary: Inspectable Earth-system models for learning and teaching.
+Author-email: Charles Poli <cpoli374@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/cpoli/earthsciencekit
+Project-URL: Documentation, https://cpoli.github.io/earthsciencekit/
+Project-URL: Issues, https://github.com/cpoli/earthsciencekit/issues
+Project-URL: Changelog, https://github.com/cpoli/earthsciencekit/blob/main/CHANGELOG.md
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: numpy>=1.24
+Requires-Dist: scipy>=1.10
+Requires-Dist: matplotlib>=3.6
+Provides-Extra: test
+Requires-Dist: pytest>=7; extra == "test"
+Requires-Dist: pytest-cov; extra == "test"
+Provides-Extra: docs
+Requires-Dist: sphinx-design>=0.6; extra == "docs"
+Requires-Dist: sphinx-gallery>=0.19; extra == "docs"
+Requires-Dist: sphinx-autodoc-typehints>=2; extra == "docs"
+Requires-Dist: sphinx>=7; extra == "docs"
+Requires-Dist: pydata-sphinx-theme>=0.15; extra == "docs"
+Requires-Dist: sphinx-sitemap>=2.6; extra == "docs"
+Requires-Dist: sphinxext-opengraph>=0.9; extra == "docs"
+Requires-Dist: jupyterlite-sphinx>=0.17; extra == "docs"
+Requires-Dist: jupyterlite-pyodide-kernel>=0.4; extra == "docs"
+Provides-Extra: dev
+Requires-Dist: sphinx-design>=0.6; extra == "dev"
+Requires-Dist: sphinx-sitemap>=2.6; extra == "dev"
+Requires-Dist: sphinxext-opengraph>=0.9; extra == "dev"
+Requires-Dist: sphinx-gallery>=0.19; extra == "dev"
+Requires-Dist: sphinx-autodoc-typehints>=2; extra == "dev"
+Requires-Dist: pytest>=7; extra == "dev"
+Requires-Dist: pytest-cov; extra == "dev"
+Requires-Dist: sphinx>=7; extra == "dev"
+Requires-Dist: pydata-sphinx-theme>=0.15; extra == "dev"
+Requires-Dist: jupyterlite-sphinx>=0.17; extra == "dev"
+Requires-Dist: jupyterlite-pyodide-kernel>=0.4; extra == "dev"
+Requires-Dist: ruff>=0.6; extra == "dev"
+Requires-Dist: mypy>=1.10; extra == "dev"
+Requires-Dist: build>=1.2; extra == "dev"
+Requires-Dist: twine>=5; extra == "dev"
+Dynamic: license-file
+
+# EarthScienceKit
+
+Inspectable Earth-system computations for learning and teaching.
+
+[![PyPI](https://img.shields.io/pypi/v/earthsciencekit)](https://pypi.org/project/earthsciencekit/)
+[![CI](https://github.com/cpoli/earthsciencekit/actions/workflows/ci.yml/badge.svg)](https://github.com/cpoli/earthsciencekit/actions/workflows/ci.yml)
+[![Docs](https://img.shields.io/badge/docs-cpoli.github.io-blue)](https://cpoli.github.io/earthsciencekit/)
+[![Open in Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/cpoli/earthsciencekit/blob/main/notebooks/quickstart.ipynb)
+[![JupyterLite](https://jupyterlite.rtfd.io/en/latest/_static/badge.svg)](https://cpoli.github.io/earthsciencekit/lite/lab/)
+
+EarthScienceKit **0.2.0** follows the MathematicsKit family structure with seven
+subpackages and 171 domain models: 162 algebraic equations and nine sampled
+dynamic models. Every model documents its units, input bounds and applicability.
+NumPy and SciPy supply mature numerical foundations.
+
+| Subpackage | Models | Focus |
+| --- | ---: | --- |
+| `plate_tectonics` | 23 | Euler rotation, spreading, subduction, isostasy, flexure, convection, hotspots, cooling |
+| `seismology` | 23 | Elastic, surface and head waves, rays, interfaces, magnitudes, pulses, rebound |
+| `atmosphere` | 22 | Hydrostatics, dry thermodynamics, humidity, stratification, rotation, Rossby waves, barotropic vorticity |
+| `climate` | 24 | Radiation, greenhouse layers, insolation, forcing, feedback, ice-albedo hysteresis, red noise, heat storage, carbon and sea level |
+| `oceanography` | 24 | Tides, trochoidal and dispersive waves, density and TEOS-10 cabbeling, dynamic method, Ekman spiral, gyres, two-box overturning, abyssal mixing |
+| `geophysics` | 31 | Gravity anomalies, normal gravity and flattening, satellite J2, Stokes's geoid, dipole and Gauss coefficients, paleomagnetic poles, reversal anomalies, Love numbers, GRACE water, Rikitake dynamo |
+| `volcanology` | 24 | Decay and radiometric ages, radiocarbon, Pb-Pb, concordia and isochron dating, Rayleigh and crystal fractionation, lattice strain, isotope thermometry, magma viscosity and ascent, Mogi inflation, plume and column heights, VEI |
+
+## Install and explore
+
+```bash
+python -m pip install earthsciencekit
+# Or from a checkout:
+python -m pip install -e '.[dev]'
+```
+
+```python
+import numpy as np
+from earthsciencekit.climate import simulate_one_box
+from earthsciencekit.units import convert
+
+time = convert(np.linspace(0, 100, 201), "year", "s")
+result = simulate_one_box(4, 1.2, 2e8, time)
+print(result.summary())
+figure, axes = result.plot()
+animation = result.animate(interval=40)
+```
+
+SI units apply unless an argument explicitly states otherwise. Latitude and
+angles use radians. Algebraic functions accept scalars and broadcast arrays;
+finite real quantities and physical bounds are validated. Unit conversions are
+explicit. Sampled histories copy their arrays, retain labels and support plots
+and animation export.
+
+## Documentation and validation
+
+The Sphinx site has Subpackages, History, Examples and API entry points,
+MathematicsKit-style cards/hubs and cross-links. Seven history pages connect
+at least fifteen dated breakthroughs each to the APIs; seven guides explain equations,
+conventions and independent checks. One executed gallery script per breakthrough
+provides figures and Python/notebook downloads.
+
+```bash
+MPLBACKEND=Agg python -m pytest --cov=earthsciencekit --cov-report=term-missing
+python -m ruff check .
+python -m ruff format --check .
+MPLBACKEND=Agg python -m sphinx -E -W --keep-going -b html docs/source docs/_build/html
+python -m build
+```
+
+Coverage enforces 100% of production statements, including validators and
+visualization; test files alone are omitted. This metric does not establish
+physical applicability. Tests include independent analytic solutions,
+conservation balances, limiting cases and invalid-input contracts. Exact release
+results are in VERIFICATION.md; model limits are in docs/source/limitations.rst.
+The documentation is hosted at https://cpoli.github.io/earthsciencekit/, and
+`notebooks/quickstart.ipynb` runs in Colab from the badge above.
+
+## Contribute
+
+See CONTRIBUTING.md. Educational models should have explicit equations, units,
+assumptions, independent benchmarks and an executable example. The MIT license
+is in LICENSE. Please cite this software using CITATION.cff.

earthsciencekit-0.2.0/README.md

@@ -0,0 +1,80 @@
+# EarthScienceKit
+
+Inspectable Earth-system computations for learning and teaching.
+
+[![PyPI](https://img.shields.io/pypi/v/earthsciencekit)](https://pypi.org/project/earthsciencekit/)
+[![CI](https://github.com/cpoli/earthsciencekit/actions/workflows/ci.yml/badge.svg)](https://github.com/cpoli/earthsciencekit/actions/workflows/ci.yml)
+[![Docs](https://img.shields.io/badge/docs-cpoli.github.io-blue)](https://cpoli.github.io/earthsciencekit/)
+[![Open in Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/cpoli/earthsciencekit/blob/main/notebooks/quickstart.ipynb)
+[![JupyterLite](https://jupyterlite.rtfd.io/en/latest/_static/badge.svg)](https://cpoli.github.io/earthsciencekit/lite/lab/)
+
+EarthScienceKit **0.2.0** follows the MathematicsKit family structure with seven
+subpackages and 171 domain models: 162 algebraic equations and nine sampled
+dynamic models. Every model documents its units, input bounds and applicability.
+NumPy and SciPy supply mature numerical foundations.
+
+| Subpackage | Models | Focus |
+| --- | ---: | --- |
+| `plate_tectonics` | 23 | Euler rotation, spreading, subduction, isostasy, flexure, convection, hotspots, cooling |
+| `seismology` | 23 | Elastic, surface and head waves, rays, interfaces, magnitudes, pulses, rebound |
+| `atmosphere` | 22 | Hydrostatics, dry thermodynamics, humidity, stratification, rotation, Rossby waves, barotropic vorticity |
+| `climate` | 24 | Radiation, greenhouse layers, insolation, forcing, feedback, ice-albedo hysteresis, red noise, heat storage, carbon and sea level |
+| `oceanography` | 24 | Tides, trochoidal and dispersive waves, density and TEOS-10 cabbeling, dynamic method, Ekman spiral, gyres, two-box overturning, abyssal mixing |
+| `geophysics` | 31 | Gravity anomalies, normal gravity and flattening, satellite J2, Stokes's geoid, dipole and Gauss coefficients, paleomagnetic poles, reversal anomalies, Love numbers, GRACE water, Rikitake dynamo |
+| `volcanology` | 24 | Decay and radiometric ages, radiocarbon, Pb-Pb, concordia and isochron dating, Rayleigh and crystal fractionation, lattice strain, isotope thermometry, magma viscosity and ascent, Mogi inflation, plume and column heights, VEI |
+
+## Install and explore
+
+```bash
+python -m pip install earthsciencekit
+# Or from a checkout:
+python -m pip install -e '.[dev]'
+```
+
+```python
+import numpy as np
+from earthsciencekit.climate import simulate_one_box
+from earthsciencekit.units import convert
+
+time = convert(np.linspace(0, 100, 201), "year", "s")
+result = simulate_one_box(4, 1.2, 2e8, time)
+print(result.summary())
+figure, axes = result.plot()
+animation = result.animate(interval=40)
+```
+
+SI units apply unless an argument explicitly states otherwise. Latitude and
+angles use radians. Algebraic functions accept scalars and broadcast arrays;
+finite real quantities and physical bounds are validated. Unit conversions are
+explicit. Sampled histories copy their arrays, retain labels and support plots
+and animation export.
+
+## Documentation and validation
+
+The Sphinx site has Subpackages, History, Examples and API entry points,
+MathematicsKit-style cards/hubs and cross-links. Seven history pages connect
+at least fifteen dated breakthroughs each to the APIs; seven guides explain equations,
+conventions and independent checks. One executed gallery script per breakthrough
+provides figures and Python/notebook downloads.
+
+```bash
+MPLBACKEND=Agg python -m pytest --cov=earthsciencekit --cov-report=term-missing
+python -m ruff check .
+python -m ruff format --check .
+MPLBACKEND=Agg python -m sphinx -E -W --keep-going -b html docs/source docs/_build/html
+python -m build
+```
+
+Coverage enforces 100% of production statements, including validators and
+visualization; test files alone are omitted. This metric does not establish
+physical applicability. Tests include independent analytic solutions,
+conservation balances, limiting cases and invalid-input contracts. Exact release
+results are in VERIFICATION.md; model limits are in docs/source/limitations.rst.
+The documentation is hosted at https://cpoli.github.io/earthsciencekit/, and
+`notebooks/quickstart.ipynb` runs in Colab from the badge above.
+
+## Contribute
+
+See CONTRIBUTING.md. Educational models should have explicit equations, units,
+assumptions, independent benchmarks and an executable example. The MIT license
+is in LICENSE. Please cite this software using CITATION.cff.

earthsciencekit-0.2.0/earthsciencekit/__init__.py

@@ -0,0 +1,6 @@
+"""Educational Earth-system computations with explicit units and model limits."""
+
+from . import atmosphere, climate, geophysics, oceanography, plate_tectonics, seismology, volcanology
+
+__version__ = "0.2.0"
+__all__ = ["plate_tectonics", "seismology", "atmosphere", "climate", "oceanography", "volcanology", "geophysics"]

earthsciencekit-0.2.0/earthsciencekit/_validation.py

@@ -0,0 +1,62 @@
+"""Central contracts for real, finite, nonempty numerical quantities."""
+
+from functools import wraps
+
+import numpy as np
+
+
+def quantity(name, value, *, lower=None, upper=None, strict_lower=False, strict_upper=False):
+    """Return a floating NumPy quantity after validating physical bounds."""
+    array = np.asarray(value)
+    if array.dtype.kind not in "iuf" or not array.size or not np.all(np.isfinite(array)):
+        raise ValueError(f"{name} must contain finite real numbers, excluding booleans")
+    array = array.astype(float)
+    if lower is not None:
+        require(array > lower if strict_lower else array >= lower, f"{name} violates its lower bound")
+    if upper is not None:
+        require(array < upper if strict_upper else array <= upper, f"{name} violates its upper bound")
+    return array
+
+
+def require(condition, message):
+    """Reject any violated relation, including array-valued physical constraints."""
+    if not np.all(condition):
+        raise ValueError(message)
+
+
+def model(function):
+    """Preserve signatures and turn arithmetic singularities into ValueError."""
+
+    @wraps(function)
+    def wrapped(*args, **kwargs):
+        try:
+            with np.errstate(over="raise", divide="raise", invalid="raise"):
+                result = function(*args, **kwargs)
+        except FloatingPointError as error:
+            raise ValueError(f"{function.__name__}: singular or overflowing arithmetic") from error
+        require(np.all(np.isfinite(result)), f"{function.__name__}: nonfinite result")
+        return result
+
+    return wrapped
+
+
+def time_grid(value):
+    """Validate a nonnegative strictly increasing vector of sampled seconds."""
+    time = quantity("time", value, lower=0)
+    require(time.ndim == 1 and time.size >= 2, "time must be a vector with at least two samples")
+    require(np.all(np.diff(time) > 0), "time must strictly increase")
+    return time
+
+
+def safe_arithmetic(function):
+    """Translate floating arithmetic failures in structured numerical models."""
+
+    @wraps(function)
+    def wrapped(*args, **kwargs):
+        try:
+            with np.errstate(over="raise", divide="raise", invalid="raise"):
+                return function(*args, **kwargs)
+        except FloatingPointError as error:
+            raise ValueError(f"{function.__name__}: singular or overflowing arithmetic") from error
+
+    return wrapped

earthsciencekit-0.2.0/earthsciencekit/atmosphere/__init__.py

@@ -0,0 +1,57 @@
+"""Inspectable atmosphere models; SI units unless stated otherwise."""
+
+from earthsciencekit.atmosphere.systems.dynamics import (
+    coriolis_parameter,
+    geostrophic_speed,
+    rossby_number,
+    rossby_wave_speed,
+    simulate_barotropic_vorticity,
+)
+from earthsciencekit.atmosphere.systems.hydrostatics import (
+    barometer_column_height,
+    barometric_pressure,
+    dry_air_density,
+    scale_height,
+    surface_pressure_tendency,
+    two_layer_temperature,
+)
+from earthsciencekit.atmosphere.systems.moisture import (
+    mixing_ratio,
+    relative_humidity,
+    saturation_vapor_pressure,
+    specific_humidity,
+    virtual_temperature,
+)
+from earthsciencekit.atmosphere.systems.thermodynamics import (
+    brunt_vaisala_squared,
+    dry_adiabatic_lapse_rate,
+    potential_temperature,
+    richardson_number,
+    simulate_dry_ascent,
+    temperature_from_potential,
+)
+
+__all__ = [
+    "dry_air_density",
+    "scale_height",
+    "barometric_pressure",
+    "potential_temperature",
+    "temperature_from_potential",
+    "dry_adiabatic_lapse_rate",
+    "saturation_vapor_pressure",
+    "mixing_ratio",
+    "specific_humidity",
+    "virtual_temperature",
+    "relative_humidity",
+    "coriolis_parameter",
+    "brunt_vaisala_squared",
+    "geostrophic_speed",
+    "rossby_number",
+    "barometer_column_height",
+    "two_layer_temperature",
+    "richardson_number",
+    "surface_pressure_tendency",
+    "rossby_wave_speed",
+    "simulate_dry_ascent",
+    "simulate_barotropic_vorticity",
+]

earthsciencekit-0.2.0/earthsciencekit/atmosphere/core/__init__.py

@@ -0,0 +1,5 @@
+"""Result containers for earthsciencekit.atmosphere."""
+
+from earthsciencekit.atmosphere.core.base import TimeSeries
+
+__all__ = ["TimeSeries"]

earthsciencekit-0.2.0/earthsciencekit/atmosphere/core/base.py

@@ -0,0 +1,10 @@
+"""Result containers for earthsciencekit.atmosphere.
+
+Algebraic models return NumPy scalars or arrays. The sampled dynamic models
+return the package-wide immutable :class:`~earthsciencekit.results.TimeSeries`,
+which is re-exported here as this domain's result type.
+"""
+
+from earthsciencekit.results import TimeSeries
+
+__all__ = ["TimeSeries"]

earthsciencekit-0.2.0/earthsciencekit/atmosphere/systems/__init__.py

@@ -0,0 +1 @@
+"""Models of earthsciencekit.atmosphere, grouped by topic."""