TissUUmaps 3.0.3

TissUUmaps is a lightweight viewer that uses basic web tools to visualize gene expression data or any kind of point data on top of whole slide images.

FlaskTissUUmaps

FlaskTissUUmaps is a python server for TissUUmaps using Flask that comes with a standalone User Interface.

Windows installation

1. Download the Windows Installer from the last release and install it. Note that the installer is not signed yet and may trigger warnings from the browser and from the firewall. You can safely pass these warnings.

2. Start TissUUmaps.

Installation from PIP

Note that steps 1-4 are optional and can be replaced by installing a recent version of Python.

1. Install Anaconda (or miniconda).

2. Create a new conda environment from an Anaconda prompt:

   conda create --name tissuumaps --channel conda-forge python=3.9
   

3. Activate the new conda environment:

   conda activate tissuumaps
   

4. You should be in the tissuumaps environment:

   (tissuumaps) C:\
   

5. Install the TissUUmaps library:

   pip install TissUUmaps[full]
   

Option 1: Start the Graphical User Interface of TissUUmaps

1. Start the TissUUmaps user interface:

   tissuumaps
   

Option 2: Start only the flask server

1. Start TissUUmaps as a server:

   tissuumaps_server path_to_your_images
   

2. Open http://127.0.0.1:5000/ in your favorite browser.

   :warning: Remember that Flask is running on a built-in development server (flask run) and should not be used in production. If you want to deploy FlaskTissUUmaps on a production server, please read https://flask.palletsprojects.com/en/1.1.x/tutorial/deploy/ or any similar tutorial.

Image format

FlaskTissUUmaps allows to visualize all images from a folder and sub-folders in TissUUmaps. By using a minimal deepzoom server, FlaskTissUUmaps removes the need for creating DZI files of every image.

FlaskTissUUmaps can read whole slide images in any format recognized by the OpenSlide library:

• Aperio (.svs, .tif)
• Hamamatsu (.ndpi, .vms, .vmu)
• Leica (.scn)
• MIRAX (.mrxs)
• Philips (.tiff)
• Sakura (.svslide)
• Trestle (.tif)
• Ventana (.bif, .tif)
• Generic tiled TIFF (.tif)

FlaskTissUUmaps will convert any other format into a pyramidal tiff (in a temporary .tissuumaps folder) using vips.