The documentation for camp is avaiable on Read the Docs: https://sci-camp.rtfd.io/
pip install camp
CAMP is designed as a general-purpose tool for medical image and data processing. PyTorch provides an efficient backend for mathematical routines (linear algebra, automatic differentiation, etc.) with support for GPU acceleration and distributed computing. PyTorch also allows CAMP to be portable due to full CPU-only support.
CAMP adopts coordinate system conventions designed to be compatible with medical imaging systems, including meta-data for a consistent world coordinate frame. Image transformations and image processing can be performed relative to the coordinate system in which the images reside, which facilitates multi-scale algorithms. Core representations for data include structured and unstructured grids.
Structured grids represent data with consistent rectilinear element spacing. These grids are commonly defined by the origin and element spacing attributes. Images and vector fields are most commonly represented by a structured grid. CAMP defines many operators to perform computation on structured grid data, including Gaussian blur and composition of deformation fields. Multi-channel (including color) images are supported -- the internal convention is channels-first representation (C x D x H x W).
Unstructured grids represent data with arbitrary element shape and location. Currently, only triangular mesh objects are supported, which aim to represent surface data via edge and vertex representation. Data values may be face-centered or node-centered. The unstructured grid objects maintain a world coordinate system that preserves relationships between other unstructured and structured grid data. An example implementation of deformable surface-based registration is implemented using the unstructured grid representation, based on Glaunes et al. (2004). Watch a summary video using this implementation on YouTube.
Many medical imaging formats are supported through SimpleITK.
camp depends on these software packages for math routines and data I/O.
Python 3.6 (or newer) and the following python packages and versions:
If available, this code uses a compatible GPU for accelerated computation. See https://pytorch.org/get-started/locally/ for details on how to install pytorch with gpu support for your system. You will then need to install the other dependencies.
If you know that you will not use a GPU, you can install the CPU-only version of pytorch. See https://pytorch.org/get-started/locally/#no-cuda-1 for how to install the CPU-only version. You will then need to install the other dependencies.
See also the list of contributors who participated in this project.
This project is licensed under the MIT License - see the LICENSE.md file for details
- Zimmerman, B. E., Johnson, S. L., Odéen, H. A., Shea, J. E., Factor, R. E., Joshi, S. C., & Payne, A. H. (2021). Histology to 3D In Vivo MR Registration for Volumetric Evaluation of MRgFUS Treatment Assessment Biomarkers. Manuscript submitted for publication.
- Zimmerman, B. E., Johnson, S., Odéen, H., Shea, J., Foote, M. D., Winkler, N., Sarang Joshi, & Payne, A. (2020). Learning Multiparametric Biomarkers for Assessing MR-Guided Focused Ultrasound Treatments. IEEE Transactions on Biomedical Engineering.