Skip to content

opengeospatial/ogc-na-tools

Folders and files

NameName
Last commit message
Last commit date

Latest commit

cc8e7eb · May 10, 2023
Apr 25, 2023
May 9, 2023
May 10, 2023
Apr 4, 2023
May 5, 2023
Dec 9, 2022
Oct 10, 2022
Feb 27, 2023
Nov 17, 2022
Apr 25, 2023
Jan 30, 2023
Oct 7, 2022

Repository files navigation

ogc-na-tools

Purpose

This repository contains tools used to maintain controlled vocabularies and knowledge assets managed by the OGC Naming Authority. Such tools may have wider general applicability and be refactored into tool specific repositories.

Scope

The tools here manage ETL processes for ingesting source data into a dynamic knowledge graph. Whilst this is quite a generic scope, this provides examples of how to use a range of resources that others may reuse to achieve similar results.

Highlights

  • JSON ingest and conversion to RDF using semantic annotations and conversions to a target model schema.
  • entailment and validation pipeline for RDF resources.
  • specific scripts to convert OGC source material into a form compatible with the OGC Linked Data environment
  • tutorial for docker deployment and testing of available tools.

Documentation and tools

The full documentation can be found here.

The following tools are currently available:

  • ingest_json: Performs JSON-to-JSON-LD semantic uplifts (read more)
  • update_vocabs: Allows defining RDF entailment + validation + upload pipelines (read more)
  • annotate_schema: Annotates JSON schemas by leveraging @modelReference links to JSON-LD contexts (read more)

Development

To install runtime and development dependencies, run:

pip install -e .[dev]

Building the documentation

mkdocs is used for generating documentation pages.

  • To build the documentation (will be written to the site/ directory): mkdocs build
  • To deploy to GitHub pages: mkdocs gh-deploy