MapToMethod

Tool to map content of JSON-LD douments (for example output of CSVtoCSVW to Entities in knowledge graphs by creating mapping rules with conditions in YARRRML format.

Demo online at here: http://maptomethod.matolab.org

additional information

The tools output is a yml file conform to YARRRML. The syntax lets u put down mapping rules that can be read by humans more easy then pure RML. To try the mapping you can use Matey. Paste your json-ld in the left tab and the yml output into the Input: YARRRML. You will habe to replace the url locations under sources with data.json, to point at the left Input: Data where u pastes the json-ld data. Now u can run the RML generation and also directly create RDF by clicking the the Generate LD Button afterwards.

how to use

docker

Just pull the docker container from the github container registry

docker pull ghcr.io/mat-o-lab/maptomethod:latest

docker-compose

Clone the repo with

git clone https://github.com/Mat-O-Lab/MapToMethod

cd into the cloned folder

cd MapToMethod

Build and start the container.

docker-compose up

jupyter notebook

1. Open the notebook in google colab or any other jupyter instance.
2. Run the first cell of the notebook. It will install the necesary python packages and definitions.
3. Run the second cell
4. Upload a csvw meta file in JSON-LD or paste in a url pointing at one in the provided widgets.
5. Select if the tables represented in the json-ld is for one experiment only (primary data) or has multiple lines represeting an experiment one each (secondary data - not supported in the moment).
6. Select the method graph u like to map against, the dropdown only options of files in the method folder of the MSEO Repository
7. Click the start mapping button, it will query all InformationLine and Column entities in the json-ld and creates widgets for all Information Content Entities in the selected method knowledge graph.
8. Map all Entities by selecting the suitable dropdown choices for the indevidual Information Content Entities, and hit the create mapping button when ready.
9. If successfull, a YARRRML file is returned wich u can download by clicking the download button.

install from source

requirements

This installation needs docker and docker-compose

steps

Clone this repo into a appropiate location with

git clone https://github.com/Mat-O-Lab/MapToMethod

cd into the cloned folder

cd MapToMethod

docker-compose will build the conatiner described in dockerfile. To run the service as demon hit:

docker-compose up -d

The service will be available at <your_server>:5005/

Acknowledgments

The authors would like to thank the Federal Government and the Heads of Government of the Länder for their funding and support within the framework of the Platform Material Digital consortium. Funded by the German Federal Ministry of Education and Research (BMBF) through the MaterialDigital Call in Project KupferDigital - project id 13XP5119.