Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/oeg-upm/yatter
Translate YARRRML into easy-to-read [R2]RML mappings
https://github.com/oeg-upm/yatter
mapping-languages rml yarrrml
Last synced: about 1 month ago
JSON representation
Translate YARRRML into easy-to-read [R2]RML mappings
- Host: GitHub
- URL: https://github.com/oeg-upm/yatter
- Owner: oeg-upm
- License: apache-2.0
- Created: 2021-03-19T16:08:16.000Z (almost 4 years ago)
- Default Branch: main
- Last Pushed: 2024-10-29T12:22:08.000Z (about 2 months ago)
- Last Synced: 2024-10-29T12:43:05.429Z (about 2 months ago)
- Topics: mapping-languages, rml, yarrrml
- Language: Python
- Homepage: https://doi.org/10.5281/zenodo.7024500
- Size: 793 KB
- Stars: 22
- Watchers: 10
- Forks: 7
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Citation: CITATION.cff
Awesome Lists containing this project
- awesome-kgc-tools - YATTER - Python engine, translating from YARRRML/RML/R2RML to YARRRML/RML/R2RML with support for RML-star and easy-to-read outputs (Mapping Translators / Previous RML version (and extensions))
README
# YATTER
[](https://doi.org/10.5281/zenodo.7024501)
[](https://pypi.org/project/yatter)
[](https://codecov.io/gh/oeg-upm/yatter)
The tool translates mapping rules from YARRRML in a turtle-based serialization of RML or R2RML.
## Installation:
```
pip install yatter
```
## Execution from CLI
To execute from command line run the following:
- From YARRRML to \[R2\]RML
```bash
python3 -m yatter -i path_to_input_yarrrml.yml -o path_to_rdf_mapping.ttl [-f R2RML]
```
- From \[R2\]RML to YARRRML
```bash
python3 -m yatter -i path_to_input_rdf_mapping.ttl -o path_to_output_yarrrml.yml [-f R2RML]
```
`-f R2RML` is an optional parameter for translating input YARRRML to R2RML (and inverse)
## Execution as a library
If you want to include the module in your implementation:
- for translating **YARRRML mapping** to **RML mappings** (and inverse):
```python
import yatter
from ruamel.yaml import YAML
# YARRRML to RML
yaml = YAML(typ='safe', pure=True)
rml_content = yatter.translate(yaml.load(open("path-to-yarrrml")))
# RML to YARRRML
yarrrml_content = yatter.inverse_translate("rdf_mapping_content")
```
- for translating **YARRRML mappings** to **R2RML mappings** (and inverse):
```python
import yatter
from ruamel.yaml import YAML
R2RML_URI = 'http://www.w3.org/ns/r2rml#'
# YARRRML to R2RML
yaml = YAML(typ='safe', pure=True)
rml_content = yatter.translate(yaml.load(open("path-to-yarrrml")), mapping_format=R2RML_URI)
# R2RML to YARRRML
yarrrml_content = yatter.inverse_translate("rdf_mapping_content", mapping_format=R2RML_URI)
```
- for merging TriplesMap based on id:
```python
import yatter
list_yarrrml_mappings = ["content_mapping_yarrrml1", "content_mapping_yarrrml1"]
yarrrml_content = yatter.merge_mappings(list_yarrrml_mappings)
```
## Specifications conformant:
These are the following specifications used by the translation process:
- YARRRML: https://w3id.org/kg-construct/yarrrml
- R2RML: https://www.w3.org/TR/r2rml/
- RML: https://rml.io/spec
- RML-star: https://w3id.org/rml/star/spec
- RML-IO: https://w3id.org/rml/io/spec
- RML-FNML: https://w3id.org/rml/fnml/spec
To be implemented soon:
- RML-core: https://w3id.org/rml/core/spec
- RML-CC: https://w3id.org/rml/cc/spec
## Cite this work:
If you used Yatter in your work, please cite the [ICWE2023](https://icwe2023.webengineering.org/program/) [paper](http://davidchavesfraga.com/outcomes/papers/2023/iglesias2023yatter.pdf):
```bib
@inproceedings{iglesias2023human,
title={Human-Friendly RDF Graph Construction: Which One Do You Chose?},
author={Iglesias-Molina, Ana and Chaves-Fraga, David and Dasoulas, Ioannis and Dimou, Anastasia},
booktitle={International Conference on Web Engineering},
pages={262--277},
year={2023},
doi={10.1007/978-3-031-34444-2_19},
organization={Springer}
}
```
## Authors
Ontology Engineering Group:
- [David Chaves-Fraga](mailto:[email protected])
- Marino González García (Final bachelor thesis - Systematic Testing)
- Luis López Piñero (Final bachelor thesis - v0.1)