Skip to main content

"IOSACal is a radiocarbon (14C) calibration program"

Project description

A radiocarbon calibration software

Codeberg CI DOI Documentation Status

IOSACal is the open source radiocarbon calibration software of the IOSA project. IOSACal includes a simple command-line program but it's best used as a toolkit in interactive and literate programming.

IOSACal is written in the Python programming language and it can run natively on any platform where the Python interpreter is available, including all Linux distributions, MacOS X and other UNIX operating systems, and Microsoft Windows.

Source code is made available under the terms of the GNU General Public License.

The documentation is online at http://c14.iosa.it/ thanks to Read the Docs.

image

Why another 14C calibration software ?

Most available programs for radiocarbon calibration, like OxCal, CALIB and others, are freeware. You don't have to pay for them, but on the other side you're not free to modify them as you need, nor to access and study the source code.

This is the main motivation behind IOSACal: creating a free-as-in-freedom radiocarbon calibration software, with a clean programming library, that enables experiments and integration in existing archaeological information systems.

Furthermore, writing this software from scratch is an alternative way of learning how 14C calibration works, not only in strict mathematical terms, but also from a practical point of view.

Features

IOSACal takes a radiocarbon determination and outputs a calibrated age as a set of probability intervals. A radiocarbon date is represented by a date in years BP (before present, that is before 1950 AD) and a standard deviation, like 2430±170. The combination of these two values is a numerical representation of a laboratory measure performed on the original organic material.

The main task of the calibration process is to convert this measure into a set of calendar dates by means of a calibration curve. Users can choose whether they want results as a plot, a short textual summary or both (the plot includes the summary).

IOSACal reads calibration curves in the common .14c format used also by other programs. Should you have calibration data in another format, it would be easy to either convert them to that format or modify the source code of IOSACal to adapt it to your needs.

IOSACal is based on current calibration methods, like those described in the 2008 paper by C. Bronk Ramsey, Radiocarbon dating: revolutions in understanding, Archaeometry 50,2 (2008) pp. 249–275 http://dx.doi.org/10.1111/j.1475-4754.2008.00394.x.

Can I use IOSACal for my research?

Yes, IOSACal has been used in research projects with large numbers of radiocarbon dates like Antarctica Marine Radiocarbon and the IPHES PALEODEM project.

Using IOSACal with Jupyter Notebooks is ideal for reproducible research that can be easily shared.

Furthermore, it takes little effort to customize and adapt the existing code to your specific needs.

IOSACal is reasonably fast, especially for batch processing.

If you make use of IOSACal in your work, please cite it with the IOSACal Zenodo DOI record: https://doi.org/10.5281/zenodo.630455.

This helps us get some recognition for creating and maintaining this software free for everyone.

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

iosacal-0.6.0.tar.gz (2.6 MB view details)

Uploaded Source

Built Distribution

iosacal-0.6.0-py3-none-any.whl (536.5 kB view details)

Uploaded Python 3

File details

Details for the file iosacal-0.6.0.tar.gz.

File metadata

  • Download URL: iosacal-0.6.0.tar.gz
  • Upload date:
  • Size: 2.6 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.1 CPython/3.10.7

File hashes

Hashes for iosacal-0.6.0.tar.gz
Algorithm Hash digest
SHA256 cd25dc95f5f5d6a0e0db05b2e8c21a7e0ff3505cd94f7876032a252c3f70e609
MD5 5c10ab2fa8237d515b187b03efffc0c7
BLAKE2b-256 165e41ad6c88ece5d0ea589417a712d9853b2dc90df26389c684523675608279

See more details on using hashes here.

File details

Details for the file iosacal-0.6.0-py3-none-any.whl.

File metadata

  • Download URL: iosacal-0.6.0-py3-none-any.whl
  • Upload date:
  • Size: 536.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.1 CPython/3.10.7

File hashes

Hashes for iosacal-0.6.0-py3-none-any.whl
Algorithm Hash digest
SHA256 6e6350d940e308877be03037d8e934f1bd126aff020c16b9750925495b96daaf
MD5 5cc5baab7d2d3a999571b61a5383f925
BLAKE2b-256 6f37bb5f3c1d308895d9e9e7c8fa9ffb4b6c1d0342b1b301f6e76a172b3402f9

See more details on using hashes here.

Supported by

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