Welcome to resomapper

Welcome to the documentation of Resomapper, a pipeline for processing quantitative MRI and generating parametric maps.

This tool is designed and developed by the Preclinical NeuroImaging Lab (PILab) at the Instituto de Investigaciones Biomédicas Sols-Morreale (CSIC-UAM), and aims to collect a series of MR image processing tools written in Python under a friendly user interface for the lab needs. It is designed to streamline the processing of images, starting from raw adquisition files (we use Bruker study folders) to end up with parametric maps such as T1, T2 or T2* maps, as well as diffusion metric maps derived from DTI analysis.

Note

Resomapper is a tool under active development, with new features and improvements still on the way. It is used in-house for preclinical MRI data, mainly for mouse brain imaging, but can be used for different types of MRI data. Any suggestions are welcome!

Overview: how to install and use Resomapper

To install Resomapper, follow these steps:

  1. Make sure that you have Python installed on your system. Versions supported are 3.10 and above (more info here).

  • Optional: create a virtual environment (more info here).

  1. Install Resomapper and all its dependencies running the following command from your terminal:

    > pip install resomapper

  2. If you have already been using Resomapper and there is any new version available, you can use the following command to update it:

    > pip install resomapper --upgrade

Then, to start using Resomapper, you’ll need to follow these steps:

  1. Prepare a working directory (an empty folder located wherever you want) and store inside the studies you want to process (more info here).

  2. Enter the command shown below to run the program.

    > resomapper_cli

  3. Follow the instructions shown in the terminal (read the whole manual here for info on the whole workflow).

  4. Finally, retrieve all the resulting maps and files obtained after processing from the same working folder (here you can find more information on what is each file and its location).