How to Access ECG Data in Linux Enclave VDI

Get Help

Posted on June 19, 2014

Updated on

November 22, 2024

This document is a step-by-step guide to accessing the ECG databases hosted in the Enclave Platform when using the Linux Enclave Virtual Desktop (VDI).

Prerequisites

You should have completed the submission of the Access Request Form, and received confirmation that access to this repository has been granted.
Access your Enclave Virtual Desktop as outlined in the following article: Get Started with Analytics Enclave

Instructions

Open the Files app
Click on Other Locations option at the bottom of the left panel/menu.
A new text bar will become available at the very bottom of the window, with the text “Enter Server Address…”
Type smb://<server_name>/ → i.e. smb://fs.analyticsenclave.org/ECGAdult
A new pop-up window will show up asking you to enter your credentials. Make sure you connect as Registered User and change the Domain from the default “WORKGROUP” to “PARTNERS”. If you want to keep the share mapped forever, you can click on “Remember forever”.

This will allow you to browse the ECG files using the “Files” app, which is just a file browser. If you need to open these files from R or Python, that’s a little trickier. Basically, once you’ve mapped the drive following the instructions above, the share will be mounted on this path.

/run/user/<userid>/gvfs/smb-share:server=<server_name>,share=<share_name>/

In the example below, the share with the name “99999999$” is mapped from the server “fs-t.analyticsenclave.org”. Here’s how you can access the files from outside the “files” desktop app.

You could also create a link if that makes things easier.

Limitation

At present, the steps described above are the recommended ways to access the EGC files from the Linux Enclave Virtual Desktop. In future, the process will be simplified by adding all the file shares to the AutoFS config.

Working With ECG Data

Currently, we provide ECG data but do not always have specific tooling for its use.
The MUSE file format is described in the Documentation section of the ECG Data Dashboard. XML can be parsed with tools like Excel and the Python XML library both of which are available in the Analytics Enclave.