Tomosipo

Tomosipo is a Pythonic interface to the ASTRA Toolbox for flexible, high-performance 3D tomography. It aims to:

  • Expose a user-friendly API for 3D tomography without compromising performance or flexibility;

  • Enable convenient definition, manipulation and visualisation of complex 3D geometries;

  • Provide easy integration with other libraries and frameworks, such as PyTorch.

If you are looking for reconstruction algorithms built on top of Tomosipo, see ts_algorithms.

Install

Minimal installation

We recommend using conda to install the required dependencies. The following commands create a new environment named tomosipo and install tomosipo from GitHub:

conda create -n tomosipo -c conda-forge astra-toolbox
conda activate tomosipo
pip install git+https://github.com/cicwi/tomosipo.git

Installation with optional dependencies

To use tomosipo with PyTorch, and ts_algorithms, install:

conda create -n tomosipo -c conda-forge astra-toolbox pytorch
conda activate tomosipo
pip install git+https://github.com/cicwi/tomosipo
pip install git+https://github.com/ahendriksen/ts_algorithms

First steps

How the documentation is organized

Tomosipo has different types of documentation:

  • Tutorials are detailed walk-through guides. Start here if you’re new to tomosipo or tomography.

  • In-depth guides discuss key concepts at a high level and provide useful background information and explanation.

  • Short recipes explain how to perform common tasks assuming some knowledge of tomosipo.

  • API reference is an extensive technical reference for tomosipo.

Other resources

Video

Blog