FAIR data models

FAIR datasets can now be assigned a data model, this means that data owners can identify where there data uses a known data model (e.g. OMOP), and allows users to search and filter by these models. 

Adding a data model to a dataset

The data owner can assign a model to their data on the dataset administration tab.

At present there are three options:

• Custom
• OMOP
• SDTM

Custom:

This is the default option is assigned to any dataset that does not adhere to one of the other models. As this will cover a wide variety of catalogue entries, custom does not appear as an option when users wish to search or filter by data model, and is only visible to data owners. 

OMOP:

This should be assigned to any datasets that use the OMOP Common Data Model. Where the OMOP model is assigned an OMOP tag will be applied to the dataset on the dataset tab and on the catalogue tab:

Where this model has been assigned the data owner also has the option of validating their dictionary metadata against OMOP v5.4. Data owners can run this validation from the data validation tab, this will produce a report telling the data owner how closely their dataset adheres to the current standard. 

SDTM:

This should be assigned to any datasets that use the Study Data Tabulation Model (SDTM). Where the SDTM model is assigned an SDTM tag will be applied to the dataset on the dataset tab and on the catalogue tab:

Searching and filtering by data model:

Where at least one dataset has a non-custom data model assigned to it users are able to search and filter by data model.

Search:

A data model filter will appear in the search sidebar where one or more dataset has a data model applied:

Filter:

Similarly when browsing the catalogue users will be able to filter by data model:

 

 Managing data models

Data models can be managed the FAIR API, three new endpoints have been added for this purpose:

Endpoint	Description
GET /datamodels/	Returns available data models for the FAIR instance
GET /datamodels/{code}	Returns a specific data model
PATCH /datamodels/{code}	Allows administrators to enable and disable a specific data model