Giter VIP home page Giter VIP logo

tacmagic's Introduction

tacmagic: PET Analysis in R

DOI Build Status Coverage status JOSS

To foster openness, replicability, and efficiency, tacmagic facilitates loading and analysis of positron emission tomography data in R.

As a tacmagic is a new package, we strongly recommend checking all work against existing analyses to confirm the results are as expected, and welcome any feedback.

Installation

The stable version of the package can be installed from CRAN, and the more recent development version can be installed with the devtools package.

Use the following R commands to download the version you would like: for the CRAN release, install.packages("tacmagic"), for the github release version that may not yet be available on CRAN, devtools::install_github("ropensci/tacmagic"), and for the very latest in-development version that is more likely to have bugs or errors and thus is not suitable for production use, use devtools::install_github("ropensci/tacmagic", ref="devel").

Features

The features of tacmagic are demonstrated in the package's walkthrough vignette, which is highly recommended for first-time uses.

Data loading and weighted-averages

Time-activity curve (TAC) and/or region of interest (ROI) volume data can be loaded from various file formats including PMOD .tac and .voistat files, a .mat file from the magia pipeline, and Turku PET Centre's .DFT format.

There is support for converting the radioactivity units in TAC data.

This package is not affiliated with any of the above pipelines.

Time-activity curve plotting

Basic plotting of one or more TAC from one or more participants is available.

Binding potential models

Non-invasive models are implemented including the standardized uptake volume (SUV), SUV ratio (SUVR), and the non-invasive Logan reference method.

Batch and group-wise analysis

Loading and analysis functions can be run as a batch or by individual participant.

Licence

Copyright (C) 2018 Eric E. Brown

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

We also note specifically that this package is not intended for clinical use, and may contain bugs or errors, so any results should be verified. As above, we provide no warranty and assume no liability.

Citation

Please cite this software package if you use it in your analyses.

Brown, E. E. (2019). tacmagic: PET Analysis in R. Journal of Open Source Software, 4(34), 1281. doi:10.21105/joss.01281.

ropensci_footer

tacmagic's People

Contributors

eebrown avatar jeroen avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar  avatar

Forkers

franzkrah

tacmagic's Issues

TAC data from voistat file

Simplify code by retrieving TAC data from voistat file, rather than relying on .tac file for TAC data and .voistat file for volume (as .voistat file contains both).

Time axis on TAC plots

I will need to update the time axis on TAC plots. Currently it is by frame, but it would be better to translate this into time (seconds/minutes).

Add JOSS Badge to README

Just noticed you don't have the JOSS badge on your README - it would be helpful if you could add the badge to link directly to the corresponding article:

DOI

Time weighting

SUVR calculation merges ROIs and weights by volume but should also weight for time when the window includes frames of unequal time.

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.