|Stefano Costa e51cd27b9d||1 year ago|
|fig12||1 year ago|
|hmdp||1 year ago|
|LICENSE||2 years ago|
|Pipfile||1 year ago|
|README.md||1 year ago|
|setup.py||1 year ago|
This repository contains archaeological stratigraphic datasets in CSV
format, following the table schema developed by Thomas S. Dye for the
hm Lisp package,
together with a Python command-line tool that can check consistency of
data with the format.
Each dataset contains various tables and a data package descriptor
datapackage.json) that enables consistency checks and streamlined
data access with the Frictionless Data
tools and programming libraries.
I installed the Python
goodtables packages with
Pipenv. The repository contains a
Pipfile, so it should be enough to run:
Then install the hmdp package with:
pipenv run python setup.py install
This will make the
hmdp command available in the virtual
All source code is formatted with Black.
In the Frictionless Data glossary:
datapackage.json, that is-found in the top-level directory of a data package, and contains metadata about the entire data package (name, description, creation date, author names, references) together with the data package schema
In the Harris Matrix Data Package:
The two resources that MUST be present are:
Most often, excavation data will make use of three other resources:
Only in case there are radiocarbon dates or other absolute chronology available the two resources should be used:
Resource names are standardized so that the data descriptor can remain largely untouched, except for the specific metadata.
hmdpprogram from the command line
hmdp matrix datapackage.json will check stratigraphy data consistency
and output a
matrix.gv file for processing with Graphviz.
To create a graphical representation of the resulting matrix, the
default procedure is to use the
dot command, like this:
dot matrix.gv -Tpng -o matrix.png
In case something goes wrong, but also if you are experimenting with
the data format, the
check command is a useful shortcut to run all
possible automated checks.
hmdp check datapackage.json will perform three checks on the dataset:
datapackage validate datapackage.json
goodtables datapackage.json(but in case of errors the separate command will give more details)
If you use this software in your research, please provide a citation to the paper introducing it:
Costa, Stefano. “Una proposta di standard per l’archiviazione e la condivisione di dati stratigrafici.” Archeologia e Calcolatori, 30, 2019, pp. 459–62, DOI: https://doi.org/10.19282/ac.30.2019.29