What's new in 0.2.5

Added

• Functionality for visualizing multiple experiments
• Home page, consists of the experiment directories found in the input path
• Navbar, includes a link to the home page, settings, GitHub, and Docs
• Settings, includes a theme changer that enables users to modify the application theme to their liking

Changed

• The start function now expects a directory path as input, where each subdirectory represents an experiment and contains the corresponding JSON files for visualization
• favicon

Neuroimaging Results Visualization

Neuroimaging Results Visualization (NeRV) is a web interface developed in Python using Plotly Dash, Dash Bootstrap Components, and pandas for visualization of neuroimaging results obtained from continuous testing of neuroimaging data across software pipelines.

• Getting Started
  • Installation
  • Example usage
• Deployment
• License

Getting Started

Installation

Install NeRV using pip:

pip install nerv

Example usage

In order for NeRV to generate and populate plots the underlying app requires access to the directory that houses subdirectories, which in turn contain the JSON files to be visualized. The path to directory can be passed to the app as input to the start function.

from nerv import app

app.start("path-to-data-directory")

After executing the file containing the above code snippet, a local server is started at port 8050 (by default). You can access the running NeRV application using a browser through the URL localhost:8050.

Deployment

To deploy your NeRV app, you can utilize Gunicorn. Simply follow the instructions outlined in the Dash documentation here, making the necessary adjustment in the app.py module content:

app.py

from nerv import app

server = app.start("path-to-data-directory", False)

Note that when the local parameter of the start function is set to False, it will return the app.server object. This object represents the underlying Flask server that drives the Dash application. You can utilize the app.server object to customize and extend the NeRV application, going beyond the default functionality offered. For more details, refer to the Flask documentation.

License

This project is licensed under the terms of MIT License.