FastPathology is an open-source platform for deep learning-based research and decision support in digital pathology, created by SINTEF Medical Technology and the Norwegian University of Science and Technology (NTNU).
A paper presenting the software and some benchmarks has been published in IEEE Access. The paper is open-access and can be accessed directly from this link.
Follow the instructions for your operating system:
- Download and install the Microsoft Visual C++ Redistributable 2015-2019 (64bit/x64).
- Download and run the Windows installer from the release page.
- Run fastpathology from your start menu.
- Install OpenCL for Linux by downloading an implementation depending on the CPU/GPU you have:
- NVIDIA - Install CUDA
- Intel - Install the OpenCL NEO driver
- AMD - Install the ROCm stack
- If none of the above fits, you can try the Portable Computing Lanauge (PCOL), although reduced performance is likely.
- Download the debian package from the release page.
- Install the debian package from the terminal or by double-clicking it:
sudo dpkg -i fastpathology_ubuntu*.deb
- Go the folder /opt/fastpathology/bin and run the fastpathology executable, or run it from the ubuntu menu (windows button->type fastpathology).
Note that the macOS version of FastPathology is experimental.
- Install homebrew if you don't already have it. Then, install the following packages using homebrew:
brew install openslide libomp
- Download the tar.xz package from the release page.
- Extract the archive to somewhere on your drive
- Disable the gatekeeper from your terminal:
sudo spctl --master-disable
- Go to extracted folder and find the bin folder and run the executable fastpathology
If you have an NVIDIA GPU on your machine you can enable high-speed inference by downloading and installing the following:
Note: Make sure to download the correct versions. NVIDIA GPU inference is not supported on Mac.
The software is implemented in C++ based on FAST. A wide range of features have been added to the platform and FAST to make working with Whole Slide Images (WSIs) a piece of cake!
- Graphical User Interface - User-friendly GUI for working with WSIs without any code interaction
- Deep learning - Deployment and support for multi-input/output Convolutional Neural Networks (CNNs)
- Visualization - Real-time streaming of predictions on top of the WSI with low memory cost
- Use cases - Patch-wise classification, low and high-resolution segmentation, and object detection are supported
- Inference Engines - FAST includes a variety of different inference engines, i.e. TensorFlow CPU/CUDA (support both TF v1 and v2 models), TensorRT (UFF and ONNX), and OpenVINO (CPU/GPU/VPU)
- Text pipelines - Possibility to create your own pipelines using the built-in script editor
- Formats - Through OpenSlide FastPathology supports various WSI formats, as well as additional support for the CellSens VSI format through FAST
Very simple demonstrations of the platforms can be found on Youtube. More in-depth demonstrations will be added in the future. Wikis and tutorials can be found in the wiki. More information can be found from the pages section on the right in the wiki home.
- Pettersen et al., Code-free development and deployment of deep segmentation models for digital pathology (2022), Frontiers in Medicine, https://www.frontiersin.org/articles/10.3389/fmed.2021.816281/full
- Pedersen et al., Hybrid guiding: A multi-resolution refinement approach for semantic segmentation of gigapixel histopathological images (2021), preprint arXiv: https://arxiv.org/abs/2112.03455
- Either
- Clone this repository
git clone https://github.com/SINTEFMedtek/FAST-Pathology.git
- Setup build environment using CMake
Linux (Ubuntu)Windows (Visual Studio) Modify generator -G string to match your Visual studio version. This command will create a visual studio solution in your build folder.mkdir build cd build cmake .. -DFAST_DIR=/path/to/FAST/cmake/
mkdir build cd build cmake .. -DFAST_DIR=C:\path\to\FAST\cmake\ -G "Visual Studio 16 2019" -A x64
- Build
cmake --build . --config Release --target fastpathology
- Run
Linux (Ubuntu)
Windows
./fastpathology
cd Release fastpathology.exe
NOTE: Visual Studio 19 have been tested with both FAST and FastPathology and works well.
Please, consider citing our paper, if you find the work useful:
@ARTICLE{9399433, author={Pedersen, André and Valla, Marit and Bofin, Anna M. and De Frutos, Javier Pérez and Reinertsen, Ingerid and Smistad, Erik}, journal={IEEE Access}, title={FastPathology: An Open-Source Platform for Deep Learning-Based Research and Decision Support in Digital Pathology}, year={2021}, volume={9}, number={}, pages={58216-58229}, doi={10.1109/ACCESS.2021.3072231}}