Starting today, you can install iosacal with conda. This adds to the existing installation procedure with pip. Conda is a good fit for complex projects and has better tooling for reproducibility.
Installing iosacal can be achieved by adding conda-forge to your channels with:
Google Colab is a popular notebook service that you can run directly from your browser. Python is natively supported and it’s fairly easy to run a Jupyter notebook, even with custom dependencies like Numpy and Matplotlib.
I’m happy to announce that IOSACal version 0.6 was released on October 1st, 2022.
IOSACal 0.6 brings new features for simulating radiocarbon dates and obtaining quantiles, added respectively by Hythem Sidky and Roger Creel, who both contributed to IOSACal for the first time. I want to thank both for their efforts to share improvements to the IOSACal source code by sticking to the code of conduct and contribution rules of the project.
The documentation at https://iosacal.readthedocs.io/ has been updated substantially, and some pages are now generated directly from Jupyter notebooks. You can download those notebooks and quickly start working on your own research notebooks.
You can get this update as usual with pip install iosacal or by updating your requirements.txt to this version:
iosacal==0.6.0
IOSACal 0.6 brings several improvements to the development process, most notably continuous integration (CI) thanks to Codeberg CI. All pull requests are automatically run through iosacal’s own test suite (coverage is not yet complete but it is improving). The detailed list of all changes is at https://iosacal.readthedocs.io/en/stable/whatsnew.html
The demo web application was discontinued, and usage with MyBinder or Google Colab is now encouraged.
As before, the preferred installation method is with pip in a virtual environment. The documentation is at https://iosacal.readthedocs.io/
This release brings the new IntCal20 calibration data and several improvements for different use cases, plus one important bug fix. Apart from myself, there were two contributors to this release, I’m grateful to Karl Håkansson and Wesley Weatherbee for their work.
These are the highlights from the release notes:
the project has moved to Codeberg for source code hosting and issue tracking. The new Git repository is at https://codeberg.org/steko/iosacal with a default branch name of main
there is an official Code of Conduct that all contributors (including the maintainter) will need to follow, based on Contributor Covenant
the documentation has seen some improvements, in particular in the Contributing section. Overall, making contributions easier from both expert and novice users is a major theme in this release.
interactive use in Jupyter notebooks is made easier with CalibrationCurve that can be created in many ways (such as loading from an arbitrary file, or from a standard calibration curve called by shorthand)
fixed a bug that made plots with AD/CE setting incorrect (contributed by Karl Håkansson)
fixed a bug that caused a wrong plot density function for dates 80 BP to 0 BP (contributed by Karl Håkansson)
add IntCal20 calibration data (contributed by Wesley Weatherbee)
On the technical side:
the command line interface is now based on the Click library
most code is now covered by tests, based on pytest
Python 3.6 or above required
requires Numpy 1.18 and Matplotlib 3.0
I don’t have big plans for the next release. I would like to add more tests, modernize the code and make it easier to adapt / tinker with. The only major achievement I’m looking forward to is to submit an article about IOSACal to the Journal of Open Source Software.
