Skip to main content

A tool for automated stratigraphic log visualisation

Project description

stratapy Logo

A Tool for Automated Stratigraphic Log Visualisation

A Python-based framework for automated visualisation of creating standardised, reproducible, and digitally integrated stratigraphic logs.

PyPI DOI Docs Open In Colab

Key Features

  • Simple Input Format: Use CSV, Excel or similar files to structure your data with a range of supported column types (lithology, grain size, features, lenses, contacts, etc.) and let stratapy handle the visualisation

  • Vast Customisation: Tailor every aspect of your logs, from layout and styling to colours and symbology, with a simple parameter-based interface

  • Standardised Symbology: Access a curated library of geological symbols and patterns, including USGS standard lithology patterns

  • Multi-Figure Functionality: Create complex, multi-panel figures with ease, enabling comprehensive visualisation of stratigraphic data

  • Publication-Quality Output: Generate high-resolution figures suitable for academic publication and professional presentations

  • Accessible for Non-Programmers: Designed with user-friendliness in mind, enabling geoscientists of all programming skill levels to create stunning visualisations

Making logs with stratapy

For more examples, see the documentation or try it out online with this Google Colab tutorial notebook.

Quick Start

Installation

pip install stratapy

Basic Usage

import stratapy as sp

# Load and plot a log
log = sp.load_log('path/to/file.csv')
log.plot()
log.save('output.png')

Multi-Panel Figures

import stratapy as sp

# Automatically plot multiple logs in a single figure
files = ['log1.csv', 'log2.csv', 'log3.csv']
panel = sp.multi_fig(files)
panel.save('output.png')

Use Online - No Installation Required

Try out stratapy immediately without any installation using this Google Colab tutorial notebook.

See the Online Platforms section of the documentation for more details.

Documentation

For full API reference and tutorials, visit our ReadTheDocs page.

Citation

If you use this software in your research or otherwise, please cite it as follows:

Smith, J. L., Antoniou, C., & Alexander, R. (2026). stratapy: A Tool for Automated Stratigraphic Log Visualisation (v0.9.2). Zenodo. https://doi.org/10.5281/zenodo.19320013

For detailed citation metadata, see CITATION.cff or use the following BibTeX entry:

@software{smith_stratapy_2026,
  author       = {Smith, Jack Lee and Antoniou, Christina and Alexander, Ruaridh},
  title        = {stratapy: A Tool for Automated Stratigraphic Log Visualisation},
  month        = mar,
  year         = 2026,
  publisher    = {Zenodo},
  version      = {v0.9.2},
  doi          = {10.5281/zenodo.19320013},
  url          = {https://doi.org/10.5281/zenodo.19320013},
}

License

Distributed under the BSD 3-Clause License. See LICENSE for more information.

Project details


Download files

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

Source Distribution

stratapy-0.9.2.tar.gz (17.6 MB view details)

Uploaded Source

Built Distribution

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

stratapy-0.9.2-py3-none-any.whl (17.6 MB view details)

Uploaded Python 3

File details

Details for the file stratapy-0.9.2.tar.gz.

File metadata

  • Download URL: stratapy-0.9.2.tar.gz
  • Upload date:
  • Size: 17.6 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.11

File hashes

Hashes for stratapy-0.9.2.tar.gz
Algorithm Hash digest
SHA256 61dbe5d3ee4d0d57f90d74b9b1b37a64d8fb1c456363b30ad439933de6df24bf
MD5 a1f52b7020305cfe60d1d8e09b79ccf9
BLAKE2b-256 a4d5d3ffa1ba6e2c9fd0f54a6c86a6498711537f5c850977081401c430d4564e

See more details on using hashes here.

File details

Details for the file stratapy-0.9.2-py3-none-any.whl.

File metadata

  • Download URL: stratapy-0.9.2-py3-none-any.whl
  • Upload date:
  • Size: 17.6 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.11

File hashes

Hashes for stratapy-0.9.2-py3-none-any.whl
Algorithm Hash digest
SHA256 8fb61baf98c9cc81cdf209261a23c7c4a1372b8eef53527e71f014fa023164fe
MD5 5461c177739096736b7f6eeb4259961a
BLAKE2b-256 54c2fe1a4090c5489c783471769ce99d1dd6c19c5c3faa977c98fb3ef35b3582

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page