Skip to content

cloudmrhub/mroptimum-webgui

Repository files navigation

MR Optimum Frontend: Web-Based Graphical User Interface (WebGUI)

MR Optimum is an advanced tool for computing, and analyzing MRI signal-to-noise ratio (SNR) across various reconstruction methods. This repository contains the source code for the web-based graphical user interface (WebGUI)

Table of Contents

  1. Overview
  2. Features
  3. Technologies
  4. Setup Instructions
  5. Usage
  6. License

Overview

The WebGUI is designed for researchers and clinicians to:

  • Configure and run SNR calculations.
  • Upload and manage datasets.
  • Visualize and analyze results.

Features

Settings Tab

  • Select SNR calculation methods:
    • Array Combining (AC)
    • Multiple Replicas
    • Pseudo Multiple Replicas
    • Pseudo multiple Replicas Wien version
  • Seleect reconstruciton methods:
    • Root Sum of Squares (RSS)
    • B1
    • SENSE
    • GRAPPA

Results Tab

  • Monitor queued job statuses.
  • Access previously computed results.
  • Visualize and analyze results:
    • ROI selection.
    • Histogram visualizzation.
    • Exporting figures and data.

Interactive Visualizations

  • Draw regions of interest (ROIs).
  • Extract and export pixel-wise SNR values and statistics.

Technologies

The frontend is built with:

  • React.js: Core framework for UI development.
  • Material-UI: For modern, responsive components.
  • Redux: State management for seamless user interaction.
  • Axios: For API communication with the backend (Managing System).

Additional dependencies are included to support interactive plots and file uploads.


Setup Instructions

Prerequisites

  • Node.js: Version 16+
  • yarn: For managing dependencies

Installation

  1. Clone the repository:
    git clone https://github.com/your-organization/mr-optimum-frontend.git
    cd mr-optimum-frontend
  2. Install dependencies
    yarn install
  3. Run
    yarn start

Runs the app in the development mode.
Open http://localhost:3000 to view it in the browser.

Usage

Running Jobs

  1. Log in with your credentials.
  2. Navigate to the Settings tab.
  3. Configure the desired SNR calculation method and upload data.
  4. Submit the job to the queue.

Viewing Results

  1. Go to the Results tab.
  2. Check the status of ongoing computations.
  3. Load completed jobs for visualization and analysis.

License

This project is licensed under the MIT License.

For detailed information on the theory behind MR Optimum and its computation methods, see:

  1. Montin E., Lattanzi R. "Seeking a Widely Adoptable Practical Standard to Estimate Signal-to-Noise Ratio in Magnetic Resonance Imaging for Multiple-Coil Reconstructions". Journal of Magnetic Resonance Imaging, 2021.
  2. ISMRM 27th Annual Meeting & Exhibition, 11-16 May 2019 Palais des congrès de Montréal, 1001 Place Jean-Paul-Riopelle, Montréal, QC, Canada
    Abstract #4617 MR Optimum – A web-based application for signal-to-noise ratio evaluation.

[Dr. Eros Montin, PhD]
(http://me.biodimensional.com)\ 46&2 just ahead of me!

About

frontend MR Optimum

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published