sempyro 2.2.0

SeMPyRO (for Semantic Models Python Pydantic RDF Ontology) is a Pydantic models representing classes of DCAT-AP v3 data model.

SeMPyRO Data Models

SeMPyRO (for Semantic Models Python/Pydantic RDF Ontology) is a Python package containing Pydantic models representing classes of the DCAT-AP v3 data model. It is designed to streamline data validation, conversion to RDF, and schema generation processes.

Key Features

• Data Validation: Easily validate data against schemas, ensuring its correctness, integrity and DCAT-AP compatibility.
• RDF Graph Conversion: Convert data into RDF graphs effortlessly, enabling integration with RDF-based systems and applications.
• Schema Generation: Generate JSON/YAML schemas compatible with the DCAT-AP v3 profile, facilitating interoperability and compliance with standards.
• Pydantic Integration: Built upon the robust Pydantic library, leveraging its powerful validation capabilities and extending them for RDF handling.

Models

The table below shows the version of the models to which SeMPyRO adheres to.

Model	Version	URL
Health-RI	v2.0.2	health-ri-metadata
DCAT-AP	3.0.0	DCAT-AP
Health-DCAT-AP	6.0.0	Health-DCAT-AP

Note: The Health-DCAT-AP implementation currently includes the minimal subset of fields needed to support the GDI use case.

Background

DCAT

DCAT is an RDF vocabulary designed to facilitate interoperability between data catalogs published on the Web.

DCAT enables a publisher to describe datasets and data services in a catalog using a standard model and vocabulary that facilitates the consumption and aggregation of metadata from multiple catalogs. This can increase the discoverability of datasets and data services. It also makes it possible to have a decentralized approach to publishing data catalogs and makes federated search for datasets across catalogs in multiple sites possible using the same query mechanism and structure. Aggregated DCAT metadata can serve as a manifest file as part of the digital preservation process.

Official DCAT v3 specification

DCAT-AP

DCAT-AP is a DCAT profile for sharing information about Catalogues containing Datasets and Data Services descriptions in Europe, under maintenance by the SEMIC action, Interoperable Europe. This Application Profile provides a minimal common basis within Europe to share Datasets and Data Services cross-border and cross-domain.

Official DCAT-AP v3 specification

Health-RI core data model

Health-RI is a no profit organization in the Netherlands dedicated to improving the reuse of health data for policy, research, and innovation to achieve a learning healthcare system. We have published a Core Metadata Model based on DCAT-AP specification for the sharing of Dutch healthcare-related datasets. Current package includes Pydantic classes for the Health-RI Core model.

Installation

To install the package run

pip install sempyro

Documentation folder contains usage examples executable in Jupiter Notebook. If you want to explore them follow official Jupyter installation guid. Additionally you may need to install pandas and/or erdantic.

Licence

Apache-2.0

Documentation

For more information on package content and usage see:

• Intro: An introduction to RDF, DCAT and DCAT-AP and using them in SeMPyRO.
• Models: An overview of the models defined in SeMPyRO.
• Defining a model of your own and extending models: An instruction on how to define your own model and extending existing models.
• Preparing and uploading data to Fair Data Point with SeMPyRO and Preparing and uploading data to Fair Data Point with SeMPyRO using Health-RI Core v2 for an interactive introduction to the functionality.

To push metadata manually to a FAIR Data Point, you can use this Juypter notebook: Pushing metadata to an FDP.

Known issues

Method .get_fields_types() from the ModelAnnotationUtil object returned by RDFModel.annotate_model() returns an AttributeError when run under Python 3.9. This method does work in Python 3.10 and up. See issue #43.