Skip to content

PolyChron v0.2.1

Latest

Choose a tag to compare

@ptheywood ptheywood released this 10 Sep 10:53
· 5 commits to main since this release

PolyChron v0.2.1

PolyChron v0.2.1 is the first release of PolyChron available via PyPI.


PolyChron is a GUI application designed to facilitate the analysis and archiving of archaeological dating evidence.
It supports the management of both relative and absolute dating evidence, enabling users to build multiple chronological models within a Bayesian modelling framework.

Key features include:

  • Graph-theoretic representations of stratigraphic sequences, which users can explore and edit via an intuitive point-and-click interface.

  • The ability to input prior knowledge, such as:

    • Groupings of archaeological contexts

    • Identification of residual or intrusive samples

    • Relationships between different groups

Using this information, PolyChron constructs a hierarchical Bayesian model and uses an MCMC (Markov Chain Monte Carlo) algorithm to estimate the posterior calendar ages of samples.

All outputs, including raw digital data (as input by the user), model representations, results, and supplementary notes are saved locally.
This ensures the full site archive is preserved for future use and long-term archiving with the Archaeology Data Service.

Documentation and Support

Installing PolyChron

polychron is a Python package which uses Graphviz for graph rendering.

Before you install polychron, you should ensure a compatible version of python is available (with pip, tkinter and ideally venv) and should install graphviz.

  • Python

    • 3.9 - 3.13
  • Graphviz

    • which you can install manually) or through your system package manager:
      • Linux
        # debian, ubuntu, etc.
        sudo apt install graphviz
        # fedora, RHEL, Rocky, etc.
        sudo dnf install graphviz
      • macOS
        # using brew (if installed)
        brew install graphviz
      • Windows
        # using chocolatey (if installed)
        choco install graphviz --no-progress -y
  • tkinter

    • Although tkinter is part of the Python3 standard library, it is not included in all pre-compiled python distributions. If you encounter errors related to importing tkinter, you may need to install it.
    • linux
      # e.g. for Ubuntu/Debian
      apt-get install python3-tk
    • macOS
      # using brew (if python was installed with brew)
      brew install python-tk

Installing polychron from PyPI

polychron is a Python package and released versions of polychron can be installed from PyPI using pip, ideally in a virtual environment.

python3 -m pip install polychron==v0.2.1

Installing polychron from source

If you wish to install PolyChron from source, please see the Readme.

Known Issues

For a full list of known issues, please see the GitHub Issues.

Notably, uv managed installations of python are not currently usable with polychron. See bryonymoody/PolyChron#104 for more information.