User Guide#

Installation#

To use CEMENTO, first install it with pip:

(.venv) $ pip install cemento

Ideally, you can create a python environment where CEMENTO will reside. This command will automatically install CEMENTO dependencies.

Scripting#

Converting draw.io to ttl#

cemento.rdf.drawio_to_turtle.convert_drawio_to_ttl(input_path: str | Path, output_path: str | Path, onto_ref_folder: str | Path, defaults_folder: str | Path, prefixes_path: str | Path, log_substitution_path: str | Path = None) None#

Convert an input draw.io diagram file of an ontology into RDF triples in the turtle format.

Parameters:
  • input_path (str | Path) – The path to the draw.io file input.

  • output_path (str | Path) – The desired file path for saving the RDF triples in the turtle format.

  • onto_ref_folder (str | Path) – The path to the folder containing the reference ontologies.

  • defaults_folder (str | Path) – The path to the folder containing the turtle files of the default namespaces.

  • prefixes_path (str | Path) – The path to the json file containing prefixes.

  • log_substitution_path (str | Path, optional) – The path to a csv file containing substitution results from term matching. Defaults to None.

Returns:

None

cemento.rdf.turtle_to_drawio.convert_ttl_to_drawio(input_path: str | Path, output_path: str | Path, horizontal_tree: bool = False, classes_only: bool = False, onto_ref_folder: str | Path = None, defaults_folder: str | Path = None, prefixes_path: str | Path = None, set_unique_literals: bool = True) None#

Convert RDF triples in the turtle format as an ontology diagram in a draw.io file.

Parameters:
  • input_path (str | Path) – The path to the turtle input file.

  • output_path (str | Path) – The desired file path for saving an ontology diagram as a draw.io file.

  • horizontal_tree (bool, optional) – Whether to make the tree horizontal or stay with the default vertical layout. Defaults to False.

  • classes_only (bool, optional) – Whether to just display classes and instances (taxonomy tree). Defaults to False.

  • onto_ref_folder (str | Path, optional) – The path to the folder containing the reference ontologies. Defaults to None.

  • defaults_folder (str | Path, optional) – The path to the folder containing the turtle files of the default namespaces. Defaults to None.

  • prefixes_path (str | Path, optional) – The path to the json file containing prefixes. Defaults to None.

  • log_substitution_path (str | Path, optional) – The path to a csv file containing substitution results from term matching. Defaults to None.

Returns:

None

In this page add: - how to install with a conda environment - installation prerequisites (Python version etc.) - how to download the source code - instructions on CLI with details at the same degree as README - instructions on scripting directly taken from README - information about the files in README (adding references, changing defaults) - information about flags, considerations when making diagrams - drawing guide with interactive image visual