DataTools4Heart Docs

Comprehensive documentation for DataTools4Heart community software

View the Project on GitHub DataTools4Heart/documentation-hub

Metadata Catalogue

The open-access Metadata Catalogue aims to enable clinicians, researchers, and AI data scientists to structure and navigate existing and new DataTools4Heart EHR-extract datasets. It provides a comprehensive web-based interface with advanced search, filtering, and visualization capabilities, allowing users to explore metadata in a structured manner.

Access

The Metadata Catalogue can be found here: https://catalogue.datatools4heart.bsc.es

Table of contents

  1. Homepage
  2. Browsing Studies
  3. Search Functionality
  4. Data Access Process (Public View)
  5. Tips for Navigation
  6. Troubleshooting & FAQ (Public Access)
  7. Glossary (Relevant Terms)

1. Homepage

The DataTools4Heart Catalogue is an AI-ready cardiology dataset discovery portal based on the Mica (OBiBa) platform.
It provides public access to study metadata, dataset descriptions, variables, and access request procedures. It does not host raw individual-level data; rather, it provides metadata, summary statistics and information on how to gain access

This manual explains how to navigate the public-facing sections of the catalogue.

When you access the website, the homepage introduces the catalogue and provides the main navigation menu.

Metadata Catalogue - Welcome

The landing page shows a top navigation menu with:

Also a brief description of the catalogue content with some statistics, like the number of variables or datasets.

The top navigation bar usually contains links such as:


2. Browing Studies

The Repository serves as the entry point to studies, datasets, and variables. You can explore metadata in read-only mode without logging in.

2.1 Individual Studies

Clicking on Individual Studies displays a list of cardiology-related studies. For example, “Study 1”, related to DT4H ‘Use Case 1’.

Each study entry usually shows:

You can click on any study to see more details.

Metadata Catalogue - Study detail

A public study page typically includes:

![Study Example](images/study_example.png)


2.2 Datasets

Under Collected Datasets, you can view a public list of available dataset descriptions.

![Datasets List](images/datasets_list.png)

DT4H includes two type of Datasets depending on the type of information they contain:


2.2 Variables

The Variables section allows public browsing of AI-ready features extracted as extracted from the FHIR-based common data model of DataTools4Heart.

![Variables List](images/variables_list.png)

Users can typically see:


3. Search Functionality

The catalogue includes a global search bar or a dedicated search page. You can search studies, datasets, or variables by keywords.

![Search Page](images/search_page.png)


4. Data Access Process (Public View)

A dedicated page explains:

![Data Access Process](images/data_access_process.png)

As a public user, you can read the procedures before any account-based actions.

Some catalogues display a public list of projects that have already obtained data access.

![Approved Projects](images/approved_projects.png)

This section may include:


5. Tips for Navigation


6. Troubleshooting & FAQ (Public Access)

Issue Explanation Suggested Action
Limited metadata visibility Public mode hides detailed fields Consider contacting catalogue administrators
No download option Public view does not include direct access Refer to the Data Access Process page
Broken links or missing info Under maintenance or restricted Wait or report to support contacts

7. Glossary (Relevant Terms)