ctpros 0.0.1

Computed Tomography Processing Registration Open Sourced

ctpros

A handy graphic user interface (GUI) and application programming interface (API) to apply common imaging techniques to your research images.

Two micro-CT images of a single specimen are shown post-registration of their overlapping region before being stitched.

Summary

This program's goal is to ease the utilization of Python's powerful imaging library in medical imaging research. By combining raw image data with paired affine matrices to describe their real-world orientations, relationships and properly scaled metrics can be applied between images of varying resolutions, easing common image processing pipelines. Enabling manipulation of these affine transformations with intuitive dragging and rotating operations allows researchers to better visualize and explore their data.

Index

• Requirements
• Installation
• Usage
• Contributors
• License

Requirements

All:

• Python 3.7 64-bit
  • Development occurred in 3.7. Use later versions at your own discretion.

Windows:

• Visual Studio Build Tools for C++ compilation

Headless:

• xvfb
  • X virtual frame buffer to mimic a screen
• OpenGL

  apt-get install -y libgl1-mesa-dev  xvfb
  

Installation

Install ctpros using pip in your preferred Python environment:

"path\to\venv\Scripts\activate"
pip install ctpros

See the Windows guide for a comprehensive look at the requirements and project installation.

Usage

Use either the user-friendly graphic user interface or the more advanced application programming interface for experienced programmers.

Graphic User Interface

Upon installation on Windows, ctpros.bat is generated on the user's desktop. Select that file to run ctpros.

Alternatively, call ctpros as a module from the Python (virtual) environment which it is installed in:

"path\to\venv\Scripts\activate"
python -m ctpros

This will open the GUI associated to the program. See the GUI Controls for more details.

Application Programming Interface

Import ctpros like any other Python module to access the GUI and NumPy-derived image classes.

import ctpros

myaim = ctpros.AIM(shape=(50,50,50),dtype='int16')

See the notebooks for examples of API usage.

Contributors

See CONTRIBUTING.md

License

GPL 3.0