ctpros 0.0.3

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

• Installation
• Usage
• Contributors
• License

Installation

Guides

Not familiar with Python? See the following guides on how to install this project and its requirements without causing issues with other (or future) Python projects:

• Windows Guide

For the familiar, pip install ctpros in your Python virtual environment with the below system requirements:

Requirements

All Environments

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

Headless Servers

If utilizing or testing graphics commands:

• xvfb
  • X virtual frame buffer to mimic a screen
• OpenGL
  • Open-sourced graphics library (libgl1-mesa-dev)

Usage

Use either the graphic user interface for your visualization and general image manipulation needs or the application programming interface for your scripting needs.

Graphic User Interface

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

For the familiar, call python -m ctpros from the Python virtual environment in which it is installed.

For detailed controls, see the GUI Controls Guide.

Application Programming Interface

Import ctpros like any other Python module to access the GUI and NumPy-derived image classes. Be sure to use the virtual environment ctpros is installed in to be able to import it.

import ctpros

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

See the notebooks for more examples of API usage.

Contributors

See CONTRIBUTING.md

License

GPL 3.0