|
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 datapackage
and goodtables
packages with
Pipenv. The repository contains a
Pipfile, so it should be enough to run:
pipenv install
Then install the hmdp package with:
pipenv run python setup.py install
This will make the hmdp
command available in the virtual
environment.
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
schemaIn 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.
hmdp
program from the command linehmdp 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