era-data-mappings

RML mappings to generate the ERA Knowledge Graph. The mappings are defined using the YARRRML syntax. See the latest changes in CHANGELOG.md.

Execute mappings

The mappings can be run in two different ways:

Run WITH Docker

This application have been dockerized to facilitate its execution. Follow the next steps:

1. Make sure to have a recent version of Docker installed.

2. Set the environment variables in the conf.env file.

3. Build the docker image:

   docker build -t era-data-mappings ./

4. Run the mapping process:

   docker run --volume=/path/to/output/folder:/opt/era-data-mappings/knowledge-graph --env-file=conf.env era-data-mappings

   Replace /path/to/output/folder in the --volume parameter for the path of the folder where you expect to store the resulting Knowledge Graph.

Run WITHOUT Docker

To directly execute these mappings you need to install first:

• Node.js at least v12.
• Java JRE at least v11.

Then follow the next steps:

1. Replace the DB connection parameters for RINF and ERATV in each of the YARRRML mapping files that needs them. For example in operational-points.yml only the connection parameters for RINF are needed:

   connection: 
       access: &host ${RINF_HOST} # e.g. //127.0.0.1:1434
         username: ${RINF_USER} # e.g. SA
         password: ${RINF_PWD} # e.g. your_password

2. Once all the mapping files have been properly configured, you can start the mapping process with the following command:

   ./map-turtle.sh x.x.x

   Replace x.x.x for the version number of your Knowledge Graph

3. The resulting Linked Data files will be stored in the local knowledge-graph/ folder and will be merged and compressed into a single file, but individual Turtle files per mapping file will also be available.

See also

1. ERA vocabulary which provides the formal definitions for the concepts, entities and properties used in the Knowledge Graph. The vocabulary is defined as an RDF ontology following the W3C standards and recommendations.
2. ERA Reference Data that includes SKOS-based taxonomies related to the railway domain.
3. SPARQL query interface for the ERA Knowledge Graph. ERA's triples are contained within the named graph https://linked.ec-dataplatform.eu/era.

Issues

We welcome issues and enhancement requests that follow these guidelines:

1. Issues opened in this repository should concern the ERA Knowledge Graph data. For issues related to the ERA vocabulary, please refer to the vocabulary repository.
2. Please label your issues using the corresponding version tag. For example, using the label v0.9.0.

Contributing

For contributions we follow the "fork-and-pull" Git workflow:

1. Fork this repository on GitHub.
2. Clone the project in your local machine.
3. Commit the changes to your own branch.
4. Push your changes back up to your own fork.
5. Submit a Pull request to the dev branch so we can review your changes.

NOTE: Make sure to merge the latest "upstream" version before submitting a pull request.