Metadata-Version: 2.4
Name: gtrack
Version: 0.7.0
Summary: GPlates-based Tracking of Lithosphere and Kinematics
Author: S. Ghelichkhani
License: MIT
Project-URL: Homepage, https://github.com/g-adopt/gtrack
Project-URL: Documentation, https://gtrack.gadopt.org
Project-URL: Repository, https://github.com/g-adopt/gtrack
Keywords: plate tectonics,seafloor age,geodynamics,pygplates,lithosphere,kinematics
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Scientific/Engineering
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Requires-Dist: numpy>=1.20
Requires-Dist: scipy>=1.7
Requires-Dist: pygplates
Provides-Extra: visualization
Requires-Dist: matplotlib>=3.5; extra == "visualization"
Requires-Dist: cartopy>=0.21; extra == "visualization"
Provides-Extra: hdf5
Requires-Dist: h5py>=3.0; extra == "hdf5"
Provides-Extra: dev
Requires-Dist: pytest>=7.0; extra == "dev"
Requires-Dist: pytest-cov>=3.0; extra == "dev"
Requires-Dist: h5py>=3.0; extra == "dev"
Provides-Extra: docs
Requires-Dist: mkdocs>=1.5; extra == "docs"
Requires-Dist: mkdocs-material>=9.0; extra == "docs"
Requires-Dist: mkdocstrings[python]>=0.24; extra == "docs"
Requires-Dist: mkdocs-jupyter>=0.24; extra == "docs"
Provides-Extra: demos
Requires-Dist: jupytext>=1.15; extra == "demos"
Requires-Dist: nbconvert>=7.0; extra == "demos"
Requires-Dist: ipykernel>=6.0; extra == "demos"
Requires-Dist: matplotlib>=3.5; extra == "demos"
Requires-Dist: cartopy>=0.21; extra == "demos"
Requires-Dist: h5py>=3.0; extra == "demos"
Provides-Extra: all
Requires-Dist: gtrack[demos,dev,docs,visualization]; extra == "all"

# gtrack

**GPlates-based Tracking of Lithosphere and Kinematics**

A Python package for computing lithospheric structure through geological time using plate tectonic reconstructions.

## From plate reconstruction to model fields

Gtrack creates labelled source-point clouds through geological time. A
`LithosphereCloudSource` combines oceanic points from the seafloor-age tracker
with continental points reconstructed from their present-day positions. Each
point carries physical channels such as lithospheric thickness and material
age. G-ADOPT interpolates these channels onto its finite-element mesh and uses
them to construct indicator fields and geotherms.

Young oceanic lithosphere near spreading centres is thin, and its contribution
to a layer indicator can require a smooth lateral transition. To this end,
`OceanicLidWeight` maps oceanic thickness to a dimensionless `lateral_weight`
between zero and one. Continental source points retain a weight of one. In
G-ADOPT, `SourceLateralWeight` interpolates this channel and multiplies it by
the radial layer indicator.

Bounded regions use two separate channels. The `membership` channel describes
the lateral extent, while `masked_thickness` contains `membership * thickness`.
After interpolation, G-ADOPT divides the latter by nonzero membership to
recover physical thickness. This separation prevents the interpolation width
from changing a constant physical base depth across a region boundary.

## Installation

```bash
pip install gtrack
```

## Documentation

For full documentation, examples, and API reference, visit:

**[https://gtrack.gadopt.org](https://gtrack.gadopt.org)**

## License

MIT License
