montanaz0r/glosis_cicd_test

Table of contents

• Table of contents
• Info
• Documentation
• Tools
  • Transformer-tool
    • Installation
    • Usage
  • Version Updater
    • Requirements
    • Usage
• Contribution
• Citing

Info

This repository contains the Global Soil Information System (GloSIS) v1.0 ontology network, derived from the source UML data model, and modelled in line with best practices and methodologies, reusing existing standard models and ontologies.

Documentation

All modules in this web ontology are documented individually with HTML pages generated with the WiDoco tool. These pages can be accessed at https://rapw3k.github.io/glosis/docs/.

Configuration files for WiDoco are generated automatically with a bespoke tool. Documentation pages are maintained in the docs folder.

The documentation for each module can be accessed via the documentation entry page

Tools

Transformer-tool

Transformer-tool is a bi-directional tool that allows generating RDF representation using SPARQL query and list of codelist items in CSV file or another way around by generating a CSV list of items out of RDF representation.

Installation

One should perform the following steps before running the script:

1. pip install - r requirements.txt
2. git clone https://github.com/Montanaz0r/pytarql.git
3. cd into cloned repository and run pip install . to activate setup.py

Usage

Script can transform in two ways:

1. from csv -> rdf, python transform_to_rdf.py [path to input csv] [path to SPARQL query file] [output filename] [version]
2. from rdf -> csv python transform_to_csv.py [path to rdf file]

examples:
python transform_to_rdf.py data/test.csv data/myquery.rq output.ttl 1.1.1

python transform_to_csv.py input.ttl (this creates a csv file with corresponding filename in the location of TURTLE file)

read more about the transformer-tool HERE.

Version Updater

Version updater is a simple convenience script that updates and harmonizes versions across all ontology modules.

Requirements

python3

Usage

example:
python utils/version_updater/version_updater.py 3.0.1

Contribution

One can find the current list of code lists provided as CSV files under the csv_codelists directory. Those code lists can be used as input to modify the ontology using the Transformer-tool. CI/CD pipeline is taking care of maintaining the current version of code lists. That means one needs to push modifications onlt via TURTLE files and don't need to worry about updating CSV code lists alongside.

Citing

Cite as:

Palma R., Janiak B., Reznik T., Schleidt K., Kozel, J., De Sousa L., Egmond F., Mouazen A. M., Moshou, D. (2020) Global Soil Information System (GloSIS) Ontology. SIEUSOIL project. http://w3id.org/glosis/model

Shield:

This work is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 3.0 IGO.