Repository navigation
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.
-
3.9-3.13
-
- 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
- Linux
- which you can install manually) or through your system package manager:
-
- Although
tkinteris part of the Python3 standard library, it is not included in all pre-compiled python distributions. If you encounter errors related to importingtkinter, 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
- Although
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.1Installing 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.