Advanced use
Resources Models, Citation plugin
Resource Models
Resources Models (RM), or graphs, are the models of any kind of resources. Like molds, they are not perfect but allow copies to be shared. RMs are CIDOC-CRM-based, with nodes connected to other nodes through directed edges (entities and properties).
List
- Heritage Places
- Information Resources
- Grid Squares
- ...
All current EAMENA RMs are hosted here on GitHub
Heritage Places
Field description, Entity-Relationship Diagram, Minimum data standards
Fields
Heritage Places counts 98 fields, some of them are mandatory (see MDS). The table below offers a short description of them, colored according to their categories (see again the MDS chart color).
https://eamena-project.github.io/eamena-arches-dev/dbs/database.eamena/data/reference_data/rm/hp/mds/fields-description.html
- Structured data: Consist of controlled vocabularies, with possible values detailed in the Bulk Upload (BU) template.
- Free text: Includes both strings and numerical values.
- Dates: Follow the ISO 8601 format (YYYY-MM-DD) for precision and standardization.
- EDTF: Adheres to the ISO 8601-2:2019 format, which allows for both fuzzy dates (to express uncertainty) and very precise timestamps (including hours and minutes).
- Boolean: Values represent binary choices such as yes/no or presence/absence.
- Resource instances: Are unique identifiers of related instances derived from another resource model (such as Information Resources, Grid Squares, etc.).
- GeoJSON feature collections: Include geographical coordinates and geometry types, which may be numerous and varied.
Entity-Relationship Diagram
Entity-Relationship Diagram (ERD) is the graphical representation of Heritages fields (CIDOC-CRM entities) and their relationships (CIDOC-CRM properties) to each other, that is to say the Heritage Place resource model
Minimum data standards
Minimum data standards (MDS) are the mandatory fields that need to be completed for each heritage places recorded in the database.
Grid Squares
Grid Squares are 0.25 degrees in both longitude and latitude, covering the entire geographical scope of the EAMENA project, which spans the Middle East and North Africa (MENA) region from Afghanistan to Mauritania.
Fields
With the current GeoJSON specification (RFC 7946) to encode geographical data1, the unique EAMENA specific field is 'Grid ID', the reference and unique number of the Grid Square (ex: E61N30-32).
- By default, GeoJSON uses the World Geodetic System 1984 (WGS 84) coordinate reference system, and the coordinate reference system for GeoJSON is assumed to be WGS 84 unless specified otherwise.↩
Citation plugin
The citation plugin (or citation-generator plugin) is an Arches plugin that allows almost direct exporting of a dataset from the EAMENA database to Zenodo. The plugin calculates all the data and a large portion of the metadata directly from a GeoJSON URL, which is obtained from the Search URL in EAMENA. The plugin retrieves this data and generates a GeoJSON file. This data is then hosted on Zendo where it can be referenced by the EAMENA community Further documentation can be found on GitHub.
Tutorial
A step-by-step example showing how to publish data from the EAMENA training database (http://52.50.27.140/) to the Zenodo sandbox sandbox.zenodo.org.
HP report
Select one or many Heritage Places (ex: EAMENA-0186976)
GeoJSON URL export
Be sure that you limit your search to the Resource Type to 'Heritage Place' (the blue button on the left handside). Copy the GeoJSON URL under the 'Export Search Results' panel
Citation-generator GUI
Go to the citation generator webpage: http://52.50.27.140/citations/. Paste the GeoJSON URL in the box having the same name, chosse a title and a description. Clic on the Submit button.
Citation-generator success message
If the process worked well, this success message should appear. You should be able to see the uploaded dataset in https://sandbox.zenodo.org/records/50224
Output Zenodo sandbox record
The HP EAMENA-0186976 record (GeoJSON file) with the its metadata is now archived on https://sandbox.zenodo.org/records/50224