READme_MATLAB_functions
Author: Marco Orrù
Email: marco.orru96@unica.it
Date: April 2025
function VisualizeMapsARGO_GUI
VisualizeMapsARGO_GUI Visualize patient data with interactive controls VisualizeMapsARGO_GUI launches a GUI to visualize 3D anatomical maps of a patient's LV data from ARGO Dataset. The tool allows switching between Voltage Map and LAT (Local Activation Time) Map, and optionally display ablation points.
The GUI provides the following features:
- Load patient data from a folder containing required files.
- Switch between Voltage and LAT maps for visualization.
- Toggle the display of ablation points.
- Interactive 3D mesh rendering of the patient's ventricle data.
The following controls are available in the GUI:
- Load Patient Folder: Opens a dialog to select the folder containing patient data files.
- Show Ablation Sites: Checkbox to enable or disable the display of ablation points.
- Map Type: Dropdown menu to switch between Voltage and LAT maps.
The required patient data files include:
- ConnectivityList.txt: Contains mesh connectivity data.
- MESHcoloring.txt: Contains values for Voltage and LAT maps.
- XYZmesh.txt: Contains the 3D coordinates of the mesh points.
- AblationPoints.txt: Contains the coordinates of ablation points.
- All the required files must be located in the same folder
Example:
Launch the GUI and visualize patient data.
VisualizeMapsARGO_GUI;
After launching, select the patient's folder containing the required files and interact with the controls to visualize the 3D map and ablation points.
------
function VisualizeRecordingsARGO
VisualizeRecordingsARGO Visualize recording and annotations for a patient. VisualizeRecordingsARGO reads and displays synchronized electrophysiological signals and annotations from patient data from ARGO Dataset. This tool allows the user to select a specific patient and recording point, visualize the corresponding signals, and display annotations from multiple annotators.
The following features are provided:
- Load patient data from a .dat file for a specific point. Please mind that the folder containing the selected .dat file should be placed in the WFDB path or in the current directory, according to the rdsamp guidelines.
- Visualize unipolar and bipolar EGMs (Electrograms) along with 12 lead ECG.
- Display classification and delineation data from consensus and multiple annotators.
- Plot annotations with color coding for different annotators and consensus.
The required data files include:
- .dat file for the selected point containing signal data.
- Annotation files ('annotation_consensus', 'annotation_ann1', 'annotation_ann2', 'annotation_ann3') for different annotators.
- Header file (.hea) containing signal metadata such as lead names and sampling rate.
- All the required files must be located in the same folder
Example:
Launch the visualization tool and select a .dat file for a patient.
VisualizeRecordingsARGO;
After loading, the tool displays the signals along with annotations from multiple annotators and a consensus view. Pathological events are highlighted on the plot for easy identification.