| Name | polychron JSON |
| Version |
0.2.1
JSON |
| download |
| home_page | None |
| Summary | Analysis and archiving of archaeological dating evidence |
| upload_time | 2025-09-09 17:26:35 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | >=3.9 |
| license | None |
| keywords |
chronology
statistics
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# PolyChron
[](https://github.com/bryonymoody/PolyChron/actions/workflows/tests.yml)
[](https://github.com/bryonymoody/PolyChron/actions/workflows/docs.yml)
[](https://github.com/bryonymoody/PolyChron/actions/workflows/lint.yml)
[](https://github.com/bryonymoody/PolyChron/actions/workflows/format.yml)
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
For full documentation including a userguide and developer reference, please see [bryonymoody.github.io/PolyChron](https://bryonymoody.github.io/PolyChron).
## Installation
PolyChron is a GUI application written in `python` using `tkinter`.
If you are familiar with python, `polychron` can be installed using `pip`, and [Graphviz](https://graphviz.org/) must be installed on your system.
### Requirements
`polychron` is a [Python package](https://pypi.org/project/polychron/) which uses [Graphviz](https://graphviz.org/) 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](https://www.python.org/)
- `3.9` - `3.13`
- [Graphviz](https://www.graphviz.org/)
- which you can [install manually](https://graphviz.org/download/)) or through your system package manager:
- Linux
```sh
# debian, ubuntu, etc.
sudo apt install graphviz
# fedora, RHEL, Rocky, etc.
sudo dnf install graphviz
```
- macOS
```sh
# using brew (if installed)
brew install graphviz
```
- Windows
```pwsh
# using chocolatey (if installed)
choco install graphviz --no-progress -y
```
- [tkinter](https://docs.python.org/3/library/tkinter.html)
- 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
```bash
# e.g. for Ubuntu/Debian
apt-get install python3-tk
```
- macOS
```sh
# using brew (if python was installed with brew)
brew install python-tk
```
## Installing `polychron` from PyPI
`polychron` is a [Python package](https://pypi.org/project/polychron/) and released versions of `polychron` can be installed from PyPI using `pip`, ideally in a [virtual environment](https://packaging.python.org/en/latest/guides/installing-using-pip-and-virtual-environments/).
```bash
python3 -m pip install polychron
```
## Installing `polychron` from Source
It is recommended to use a [Python virtual environment]((https://packaging.python.org/en/latest/guides/installing-using-pip-and-virtual-environments/)) (`venv`) or similar for installations of `polychron` from source, for example:
```bash
# Create and activate a venv
python3 -m venv .venv
source .venv/bin/activate
```
`polychron` can be installed from source using `pip` and `git`, using the latest development version or specific releases.
```bash
# Install the current development version
python3 -m pip install git+https://github.com/bryonymoody/PolyChron.git
# Install a tagged release or branch, in this case v0.2.1
python3 -m pip install git+https://github.com/bryonymoody/PolyChron.git@v0.2.1
```
Or by cloning the `git` repository from [GitHub](https://github.com/bryonymoody/PolyChron) and installing into the current python environment.
```bash
git clone https://github.com/bryonymoody/PolyChron
cd PolyChron
python3 -m pip install .
```
> [!TIP]
> If you are installing PolyChron from source as a developer, consider using an editable installation (`-e` / `--editable`) and installing the `dev`, `doc` and `test` extras.
>
> ```bash
> python3 -m pip install -e .[dev,doc,test]
> ```
## Usage
With PolyChron installed in the current python environment, it can be launched using any of the following:
```bash
# via the executable script
polychron
# or by running the installed polychron module
python3 -m polychron
```
## License
PolyChron is released under the [GPLv3 license](LICENSE)
## Contributing
If you would like to contribute towards PolyChron, please see the [contributing guidelines](./CONTRIBUTING.md).
### Linting
Linting is handled using [`ruff`](https://github.com/astral-sh/ruff) which can be installed as part of the `dev` extras.
Ruff can then be invoked using:
```bash
python3 -m ruff check
# or
ruff check
```
### Formatting
Automatic code formatting is handled using [`ruff`](https://github.com/astral-sh/ruff) which can be installed as part of the `dev` extras.
Ruff can then be invoked using:
```bash
python3 -m ruff fromat
# or
ruff format
```
This can be automatically applied on commit through [pre-commit hooks](https://docs.astral.sh/ruff/integrations/#pre-commit)
### Testing
Tests are implemented using `pytest`, which can be installed as part of the `test` optional dependencies via:
```bash
python3 -m pip install .[test]
```
Once installed, unit tests can be executed via `pytest` from the root directory
```bash
python3 -m pytest
# or
pytest
```
### Building Documentation
Documentation is built using [mkdocs](https://github.com/mkdocs/mkdocs) and some extensions.
Documentation building dependencies are included in the `doc` optional dependencies group.
They can be installed into the current python environment along with `polychron` using `pip`:
```bash
python3 -m pip install -e .[doc]
```
Once installed, documentation can be generated and viewed via a local webserver using:
```bash
python3 -m mkdocs serve
# or just
mkdocs serve
```
Or a static html version can be built into `_site` using:
```bash
python3 -m mkdocs build
# pass --no-directory-urls if you wish to view local .html files without a web server
python3 -m mkdocs build --no-directory-urls
```
Raw data
{
"_id": null,
"home_page": null,
"name": "polychron",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": "Bryony Moody <bryony.moody@sheffield.ac.uk>",
"keywords": "chronology, statistics",
"author": null,
"author_email": "Bryony Moody <bryony.moody@sheffield.ac.uk>, Peter Heywood <p.heywood@sheffield.ac.uk>, Shreyan Ghosh <shreyanghosh27@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/90/45/96a8e1cc593249d6eaec9cce49637f55b3026ceb5cdf5184860602be4929/polychron-0.2.1.tar.gz",
"platform": null,
"description": "# PolyChron\n\n\n\n[](https://github.com/bryonymoody/PolyChron/actions/workflows/tests.yml)\n[](https://github.com/bryonymoody/PolyChron/actions/workflows/docs.yml)\n[](https://github.com/bryonymoody/PolyChron/actions/workflows/lint.yml)\n[](https://github.com/bryonymoody/PolyChron/actions/workflows/format.yml)\n\nPolyChron is a GUI application designed to facilitate the analysis and archiving of archaeological dating evidence. \nIt supports the management of both relative and absolute dating evidence, enabling users to build multiple chronological models within a Bayesian modelling framework.\n\nKey features include:\n\n- Graph-theoretic representations of stratigraphic sequences, which users can explore and edit via an intuitive point-and-click interface.\n\n- The ability to input prior knowledge, such as:\n\n - Groupings of archaeological contexts\n\n - Identification of residual or intrusive samples\n\n - Relationships between different groups\n\nUsing 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.\n\nAll outputs, including raw digital data (as input by the user), model representations, results, and supplementary notes are saved locally.\nThis ensures the full site archive is preserved for future use and long-term archiving with the Archaeology Data Service.\n\n## Documentation\n\nFor full documentation including a userguide and developer reference, please see [bryonymoody.github.io/PolyChron](https://bryonymoody.github.io/PolyChron).\n\n## Installation\n\nPolyChron is a GUI application written in `python` using `tkinter`.\nIf you are familiar with python, `polychron` can be installed using `pip`, and [Graphviz](https://graphviz.org/) must be installed on your system.\n\n### Requirements\n\n`polychron` is a [Python package](https://pypi.org/project/polychron/) which uses [Graphviz](https://graphviz.org/) for graph rendering.\n\nBefore you install polychron, you should ensure a compatible version of python is available (with `pip`, `tkinter` and ideally `venv`) and should install `graphviz`.\n\n- [Python](https://www.python.org/)\n - `3.9` - `3.13`\n\n- [Graphviz](https://www.graphviz.org/)\n - which you can [install manually](https://graphviz.org/download/)) or through your system package manager:\n - Linux\n ```sh\n # debian, ubuntu, etc.\n sudo apt install graphviz\n # fedora, RHEL, Rocky, etc.\n sudo dnf install graphviz\n ```\n - macOS\n ```sh\n # using brew (if installed)\n brew install graphviz\n ```\n - Windows\n ```pwsh\n # using chocolatey (if installed)\n choco install graphviz --no-progress -y\n ```\n\n- [tkinter](https://docs.python.org/3/library/tkinter.html)\n - 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.\n - linux\n ```bash\n # e.g. for Ubuntu/Debian\n apt-get install python3-tk\n ```\n - macOS\n ```sh\n # using brew (if python was installed with brew)\n brew install python-tk\n ```\n\n## Installing `polychron` from PyPI\n\n`polychron` is a [Python package](https://pypi.org/project/polychron/) and released versions of `polychron` can be installed from PyPI using `pip`, ideally in a [virtual environment](https://packaging.python.org/en/latest/guides/installing-using-pip-and-virtual-environments/).\n\n```bash\npython3 -m pip install polychron\n```\n\n\n## Installing `polychron` from Source\n\nIt is recommended to use a [Python virtual environment]((https://packaging.python.org/en/latest/guides/installing-using-pip-and-virtual-environments/)) (`venv`) or similar for installations of `polychron` from source, for example:\n\n```bash\n# Create and activate a venv\npython3 -m venv .venv\nsource .venv/bin/activate\n```\n\n`polychron` can be installed from source using `pip` and `git`, using the latest development version or specific releases.\n\n```bash\n# Install the current development version\npython3 -m pip install git+https://github.com/bryonymoody/PolyChron.git\n# Install a tagged release or branch, in this case v0.2.1\npython3 -m pip install git+https://github.com/bryonymoody/PolyChron.git@v0.2.1\n```\n\nOr by cloning the `git` repository from [GitHub](https://github.com/bryonymoody/PolyChron) and installing into the current python environment.\n\n```bash\ngit clone https://github.com/bryonymoody/PolyChron\ncd PolyChron\npython3 -m pip install .\n```\n\n> [!TIP]\n> If you are installing PolyChron from source as a developer, consider using an editable installation (`-e` / `--editable`) and installing the `dev`, `doc` and `test` extras.\n>\n> ```bash\n> python3 -m pip install -e .[dev,doc,test]\n> ```\n\n## Usage\n\nWith PolyChron installed in the current python environment, it can be launched using any of the following:\n\n```bash\n# via the executable script\npolychron\n# or by running the installed polychron module\npython3 -m polychron\n```\n\n## License\n\nPolyChron is released under the [GPLv3 license](LICENSE)\n\n\n## Contributing\n\nIf you would like to contribute towards PolyChron, please see the [contributing guidelines](./CONTRIBUTING.md).\n\n### Linting\n\nLinting is handled using [`ruff`](https://github.com/astral-sh/ruff) which can be installed as part of the `dev` extras.\n\nRuff can then be invoked using:\n\n```bash\npython3 -m ruff check\n# or\nruff check\n```\n\n### Formatting\n\nAutomatic code formatting is handled using [`ruff`](https://github.com/astral-sh/ruff) which can be installed as part of the `dev` extras.\n\nRuff can then be invoked using:\n\n```bash\npython3 -m ruff fromat\n# or\nruff format\n```\n\nThis can be automatically applied on commit through [pre-commit hooks](https://docs.astral.sh/ruff/integrations/#pre-commit)\n\n\n### Testing\n\nTests are implemented using `pytest`, which can be installed as part of the `test` optional dependencies via:\n\n```bash\npython3 -m pip install .[test]\n```\n\nOnce installed, unit tests can be executed via `pytest` from the root directory\n\n```bash\npython3 -m pytest\n# or\npytest\n```\n\n\n### Building Documentation\n\nDocumentation is built using [mkdocs](https://github.com/mkdocs/mkdocs) and some extensions.\n\nDocumentation building dependencies are included in the `doc` optional dependencies group.\nThey can be installed into the current python environment along with `polychron` using `pip`:\n\n```bash\npython3 -m pip install -e .[doc]\n```\n\nOnce installed, documentation can be generated and viewed via a local webserver using:\n\n```bash\npython3 -m mkdocs serve\n# or just\nmkdocs serve\n```\n\nOr a static html version can be built into `_site` using:\n\n```bash\npython3 -m mkdocs build\n# pass --no-directory-urls if you wish to view local .html files without a web server\npython3 -m mkdocs build --no-directory-urls\n```\n",
"bugtrack_url": null,
"license": null,
"summary": "Analysis and archiving of archaeological dating evidence",
"version": "0.2.1",
"project_urls": {
"Documentation": "https://bryonymoody.github.io/PolyChron",
"Issues": "https://github.com/bryonymoody/PolyChron/issues",
"Repository": "https://github.com/bryonymoody/PolyChron"
},
"split_keywords": [
"chronology",
" statistics"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "ef788b089ea8c5173a6ecbe81d5718c39b9f003984181b8d5825ab4571ea0b76",
"md5": "83c0984bcf2e57cde9ca9caf5d2d8a16",
"sha256": "52f2ba23478f5a241df21d98db3c11f4bce72bf1fb6739ad73b0fed4b43b1122"
},
"downloads": -1,
"filename": "polychron-0.2.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "83c0984bcf2e57cde9ca9caf5d2d8a16",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 1576712,
"upload_time": "2025-09-09T17:26:33",
"upload_time_iso_8601": "2025-09-09T17:26:33.791743Z",
"url": "https://files.pythonhosted.org/packages/ef/78/8b089ea8c5173a6ecbe81d5718c39b9f003984181b8d5825ab4571ea0b76/polychron-0.2.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "904596a8e1cc593249d6eaec9cce49637f55b3026ceb5cdf5184860602be4929",
"md5": "3c52c2c322d5d2bb614eb7f568369589",
"sha256": "68aa268cbcb2301acbc0a4a00b99ca2ad772712cd83b264c83c95115aa188d6f"
},
"downloads": -1,
"filename": "polychron-0.2.1.tar.gz",
"has_sig": false,
"md5_digest": "3c52c2c322d5d2bb614eb7f568369589",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 2834136,
"upload_time": "2025-09-09T17:26:35",
"upload_time_iso_8601": "2025-09-09T17:26:35.858513Z",
"url": "https://files.pythonhosted.org/packages/90/45/96a8e1cc593249d6eaec9cce49637f55b3026ceb5cdf5184860602be4929/polychron-0.2.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-09-09 17:26:35",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "bryonymoody",
"github_project": "PolyChron",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "polychron"
}
