Quick start

Introduction

In this tutorial, we will see how to:

  • import data
  • import a project
  • launch this project

At the end of this tutorial, you will have a dashboard that allows you to visualize data from 100 patients.


Do you need programming knowledge to follow this tutorial?


No need for advanced programming knowledge to complete this tutorial!

The only line of code you’ll need to run is the one you see below.

However, you will need to install RStudio.

To do this, you can refer to the tutorials on the analyse-R website:


RStudio installed? Let's go, let's launch LinkR!


After installing LinkR, launch the app with this code.

linkr::linkr(language = "fr", app_folder = "/home/user_name")

A tab should open in your browser, showing the LinkR home page.

Go back to the installation page for more information on the arguments that the function can take.

Now, let’s see how to import data.

Import data

We will import data from the content catalog.

From the homepage or the menu at the top of the page, go to the “Content Catalog” page.

Find Saint-Malo on the map and select InterHop.

On the right side of the screen, you will see the homepage of InterHop’s shared content: plugins and datasets are among the offerings.

To access the details of this shared content, click the “Show content” button at the bottom of the page.

We want to download the data for the “MIMIC-IV demo set”.

So, click on the “Datasets” tab at the top right of the screen, then click on the widget corresponding to our dataset.

All that remains is to click on “Install”, and there you have it, the dataset (or at least its code) is installed!


Does this catalog allow data sharing?


No, no data is downloaded during the installation of a dataset.

Health data, which is sensitive data, must be handled within a specific regulatory framework.

Here, we have downloaded the code that allows access to the data, not the data itself.

In this case, the data is anonymized, and therefore not subject to GDPR. That’s why this code can, without any authentication, download data from the 100-patient MIMIC-IV test database.

You can read this article for more information about the MIMIC database.

Let’s now see how to import a project.


Import a project

We will proceed in the same way to import a project.

Go to the “Content Catalog” page, and this time select the DOMASIA laboratory in Rennes.

Click on “Show content”, you should arrive at the “Projects” tab, and you should see the “Dashboard quality indicators” project.

When I click on the project, I see its description appear: this project creates a dashboard presenting the quality indicators of patient care.

Click on “Install”.


The project is installed. We can now launch it.



Launch the project

To launch our project, we need to link the project and the dataset.

To do this, go to the “Projects” page, using the first icon from the left at the top of the screen or from the homepage (which you can access by clicking on the LinkR icon at the top left of the screen).

Then click on the “Configure the project” icon, this allows you to configure the project without loading the data and widgets.

Click on the “Dataset” tab, then select the dataset we previously installed: “MIMIC-IV demo set”.


We have linked the dataset to the project: this data will be loaded when the project starts.


You can now click on one of the data pages (the icons with the characters).

Several things happen.

  • The dataset code, being run for the first time, downloads the CSV files from the database, which may take a few minutes. Loading the following times will be faster, as the files will be stored locally and will not need to be downloaded again.

  • A subset including all patients will be created.

  • The widgets will load and display the data.

Finally, click on the “Aggregated data” icon (the one with multiple characters), and you will see the dashboard appear!

The data in this set (MIMIC-IV) is anonymized, so the dates have been altered (from 2110 to 2202), which is why the admission over time figure, at the top right, does not render correctly.

The table at the bottom right should display the ICD-10 diagnoses. Here it shows numbers because we did not import the ICD-10 terminology: the correspondence with the names corresponding to the ICD-10 codes cannot be made. Go here to learn how to import terminologies!

Conclusion

In this tutorial, we have seen how to import data and import a project from the content catalog.


How can I create a project with my own data?


To import your data, follow this tutorial.

To create a project from scratch, follow this tutorial.

Last modified 2024.10.15: Update CDW article (b9647e4)