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

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

Heritage Places fields with fields colored by categories: Assessment Summary, Resource Summary, Geometries, Geography, Archaeological Assessment, Condition Assessment, Environment Assessment, Access (original image: 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

 

ERD of the EAMENA Heritage Place Resource Model with fieldnames (nodes) colored according to the minimum data standard (MDS): Assessment Summary, Resource Summary, Geometries, Geography, Archaeological Assessment, Condition Assessment, Environment Assessment, Access (original image: https://eamena-project.github.io/eamena-arches-dev/dbs/database.eamena/data/reference_data/rm/hp/erd/EAMENA-erd.html)

 

Minimum data standards

 

Minimum data standards (MDS) are the mandatory fields that need to be completed for each heritage places recorded in the database.

 

Pie chart layout of the 98 Heritage Places fields, with the minimum data standard (MDS) fields highlighted with a thumbs-up emoji, colored by categories: Assessment Summary, Resource Summary, Geometries, Geography, Archaeological Assessment, Condition Assessment, Environment Assessment, Access (original image: https://eamena-project.github.io/eamena-arches-dev/dbs/database.eamena/data/reference_data/rm/hp/erd/EAMENA-erd.html)

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.

EAMENA geographical scope (Grid Squares perimeter, original image: https://eamena-project.github.io/eamena-arches-dev/data/grids/EAMENA_Grid_contour.html)
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).

  1. 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