Fast-forward: convert a RDF ontology graph¶
Important
The main requirements for an ontology to be converted in the current version are:
The ontology graph contains NO CYCLES (navigating with the subclass/domain/range properties should not allow to come back to the same point)
All classes on which a property applies are EXPLICITLY listed in this property’s domain.
No class has both subclasses and properties (no class is both an object for subclassOf and domain predicates)
Using Docker¶
Once your docker image is installed (see the docker building section, your configuration is ready and the I/O folders are created and populated by optional instruction files:
$ ls /opt/production_tables
lookup_units.csv
# Run the converter in production mode
$ make up
# Or use $(make up-d) to avoid capturing the console
# Check the output
$ ls /opt/production_tables
MODIFIER_DIMENSION.csv CONCEPT_DIMENSION.csv
METADATA.csv TABLE_ACCESS.csv
lookup_units.csv (migrations_logs.csv)
# Check the I/O folders
$ ls /opt/verbose_tables
lookup_units.csv
# Run the converter in verbose mode
$ make verbose DEBUG_FOLDER=/opt/verbose_tables ONTOLOGY_LOCATION=/opt/ontology_rdf_graphs
# Check the output
$ ls /opt/verbose_tables
MODIFIER_DIMENSION_VERBOSE.csv CONCEPT_DIMENSION_VERBOSE.csv
METADATA.csv TABLE_ACCESS.csv
lookup_units.csv (migrations_logs.csv)
From the source files¶
Check the src/utils.py file points to the correct configuration files.
Then steps are here shown only for the verbose scenario (production one is the same, with DEBUG set to False in the configuration). Make sure your configuration files point to the correct folder (for this example, the /opt/verbose_tables/ folder) and have the correct value for the DEBUG variable (True for this example):
# Check the I/O folders
$ ls /opt/verbose_tables
lookup_units.csv
# Run the converter in verbose mode
$ cd RDF-i2b2-converter
$ python3 src/main_ontology.py
# Check the output
$ ls /opt/verbose_tables
MODIFIER_DIMENSION_VERBOSE.csv CONCEPT_DIMENSION_VERBOSE.csv
METADATA.csv TABLE_ACCESS.csv
lookup_units.csv (migrations_logs.csv)