Coder Social home page Coder Social logo

recoittv's Introduction

README

What is this repository for?

We present an accelerated implementation of an iterative method for cone-beam CT following the Split Bregman formulation, reducing computational time through GPU-accelerated kernels. We provide binaries of a command-line application that implements the method.

Current Version is 1.4.1.

Minimum Requirements

Hardware

  • One NVidia GPU with CUDA support (preferably series 6 or superior).
  • 20 GBytes of RAM (512^3 cubic volume reconstruction)*.

*The memory requirements depend on the size of input and output data.

Software

  • Linux system (x64 architecture) (Recommended: Ubuntu 14.04 or higher) or Windows system (7 or higher) (x64 architecture).
  • NVidia CUDA 8.0 or higher.
  • Support for multi-core architectures based on OpenMP.

Set up

We provide the binaries for our application. You can install the files as they are in any folder in which you have execution permissions. Since it is a command line application it is necessary to use a command shell.

  • Windows: we recommend the usage of PowerShell
  • Linux System: you can use your preferred shell.

Usage

Our application accepts the following parameters:

-fi [string] path to input file

-fo [string] path to output file

-n [int] number of projections

-s [float] initial angle (deg)

-t [int] rotation direction

    -1 - counter-clockwise

    1 - clockwise (default)

-b [int int int] volume size in voxels

-r [int int int] VOI dimension in voxels

-o [float float float] VOI offset in voxels

-c [float float float] volume voxel size (mm)

-d [int int] projection size (pixels)

-e [int int] projection ROI size (pixels)

-g [float float] projection ROI offset (pixels)

-u [float float] projection pixel size (mm)

-p [float] detector-to-object distance (mm)

-q [float] source-to-object distance (mm)

-tv [5xfloat] TV3D parameters

    alpha: threshold for the shrinkage operation

    mu: weights the data constraint

    beta: weigths the previous solution constraint

    lambda: weigths the derivatives constraint

    gamma: weights the positivity constraint

    retroNorm: normalization factor to compensate forward projection and backprojection operations

-kr [float int] Krylov solver parameters

    tolKrylov: convergence criteria

    max_iterations: maximum number of iterations for Alg.2 if convergence criteria is not reached

We provide you some samples to test the application, a test call could be:

./reco-it -fo .\output -fi .\data_0 -a 360 -r 256 256 256 -b 256 256 256 -d 256 256 -n 90 -o 0 0 0 -u 0.2 0.2 -t -1 -c 0.12 0.12 0.12 -q 132 -p 220 -s 0 -h 1 0 0 0 0 0 -tv 0.0003 20 3 2 0 0.00390625 -i 2 -kr 1e-2 100

Please take into account that the calibration file provided and the data must be in the same directory.

Citing TV

When citing this TV application you can use the following bibtex reference:

C. de Molina, E. Serrano, J. Garcia-Blas, J. Carretero, M. Desco, and M. Abella, “GPU-accelerated iterative reconstruction for limited-data tomography in CBCT systems,” BMC Bioinformatics, vol. 19, iss. 1, p. 171, 2018.

Disclaimer

The author makes no warranties about the usage of this application or any parts of its contents and accepts no responsibility for any data loss or other system trouble that may occur from its usage.

Who do I talk to?

For doubts or problems related to the usage of this software, you can contact the following e-mail addresses:

[email protected]

[email protected]

[email protected]

[email protected]

[email protected]

[email protected]

recoittv's People

Contributors

claudiamolina avatar estefania avatar javiergarcia avatar

Stargazers

 avatar

Watchers

 avatar  avatar  avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.