Skip to main content

pyrolite

pyrolite Logo

pyrolite Documentation pyOpenSci DOI License: CSIRO Modified BSD/MIT License Try pyrolite on Binder Chat on Gitter

pyrolite is a set of tools for making the most of your geochemical data.

The python package includes functions to work with compositional data, to transform geochemical variables (e.g. elements to oxides), functions for common plotting tasks (e.g. spiderplots, ternary diagrams, bivariate and ternary density diagrams), and numerous auxiliary utilities.

pyrolite is principally developed for use in geochemical research, but is also well suited to being incorporated into university-level geochemistry and petrology classes which wish to include a little Python. The documentation is continually evolving, and more examples and tutorials will gradually be added (feel free to request features or examples; see Contributing below).

Install

PyPI Compatible Python Versions pyrolite downloads

pip install pyrolite

If you want the most up to date development version, you can instead install directly from the GitHub repo. Note that breaking changes occur on this branch, and is not guaranteed to remain stable (check the Development and Build Status below). If you still want to try out the most recent bugfixes and yet-to-be-released features, you can setup an enviroinment using uv with:

git clone git://github.com/morganjwilliams/pyrolite.git@develop
git checkout develop
uv sync --extra dev

For more information, see the documentation's installation page, and the Getting Started Guide.

Examples

Check out the documentation for galleries of examples and tutorials. The corresponding sources of these examples exist as marked-up .py files in this repository (which get converted to Jupyter notebooks on ReadTheDocs); you can find them under the folders docs/source/gallery/examples and docs/source/gallery/tutorials.

Contributing

The long-term aim of this project is to be designed, built and supported by (and for) the geochemistry community. The project welcomes feature requests, bug reports and contributions to the code base, documentation and test suite. We're happy to help onboard new contributors and walk you through the process. Check out the Issues Board to get an idea of some of the some of the currently identified bugs and things we're looking to work on. For more information, see the documentation, particularly the Contributing page and Code of Conduct.

For a list of people who have helped build and improve pyrolite, check out the Contributors page.

If you'd like an idea of where the project might be heading in the near future, have a look at the current roadmap.

Citation

DOI Archive

If you use pyrolite extensively for your research, citation of the software would be particularly appreciated. It helps quantify the impact of the project (assisting those contributing through paid and volunteer work), and is one way to get the message out and help build the pyrolite community. For information on citing pyrolite, see the relevant docs page. A CITATION.cff file is also provided for reference.

Development & Build Status

Formatted with Ruff Code Quality

main develop
Unit Tests on main Unit Tests on Develop
Coverage Status Coverage Status

Maintainer: Morgan Williams (morgan.williams at csiro.au)

Release files for pyrolite 0.3.7

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for pyrolite 0.3.7
File Size Uploaded
pyrolite-0.3.7.tar.gz 5.9 MB Details

Built distribution (wheel)

Table of built distributions (wheels) for pyrolite 0.3.7
File Interpreter ABI Platform
pyrolite-0.3.7-py3-none-any.whl Python 3 none any Details

Total release size: 11.9 MB

Release files / pyrolite-0.3.7.tar.gz

Download URL pyrolite-0.3.7.tar.gz
Size 5.9 MB
Tags Source
SHA-256 checksum
How to use checksums
bc257792a611b2c5c8540537e6a8545b58704c7d5c81f19d4e4b3362ec9a1ad4
BLAKE2b-256 checksum
How to use checksums
b42a8cebd2179b25d85a36ce90f733de63b038d39f1efc13e572929c78563a74
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.13.7

Release files / pyrolite-0.3.7-py3-none-any.whl

Download URL pyrolite-0.3.7-py3-none-any.whl
Size 6.1 MB
Tags Python 3
SHA-256 checksum
How to use checksums
1bf1aed4b6f58947c36bd3ceb117595abd70109538e48e09364baaf15111cf62
BLAKE2b-256 checksum
How to use checksums
95813dfbdcaab33fd9e33ce3876898313c1d036b9e5b125d6f1d16eeebd29d21
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.13.7

Release history Release notifications | RSS feed

This release

0.3.7 This release

2 release files

0.3.6

2 release files

0.3.5

2 release files

0.3.4

2 release files

0.3.3

2 release files

0.3.2

2 release files

0.3.1

2 release files

0.3.0

2 release files

0.2.8

2 release files

0.2.7

2 release files

0.2.6

2 release files

0.2.5

2 release files

0.2.4

2 release files

0.2.3

2 release files

0.2.2

2 release files

0.2.1

2 release files

0.2.0

2 release files

0.1.21

2 release files

0.1.18

2 release files

0.1.17

2 release files

0.1.16

2 release files

0.1.9

2 release files

0.1.8

2 release files

0.1.7

2 release files

0.1.5

2 release files

0.1.4

2 release files

0.1.2

2 release files

0.1.1

2 release files

0.1.0

2 release files

0.0.16

2 release files

0.0.15

2 release files

0.0.14

1 release file

0.0.13

2 release files

0.0.12

1 release file

0.0.11

1 release file

0.0.10

1 release file

0.0.9

1 release file

0.0.8

1 release file

0.0.7

1 release file

0.0.6

2 release files

0.0.5

1 release file

0.0.4

2 release 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