Git Product home page Git Product logo

autofd's Introduction

AutoFD

Matlab script for automated fractal analysis of segmented cardiac images.

Prerequisites

  • Matlab.
  • Windows or Linux.
  • GhostScript.
  • Possibly XPDF.

Input data

Compressed NIfTI files (NII.GZ) of end-diastolic left ventricular short axis stacks.

Method

The approach is based on our FracAnalyse software, but uses pre-exisiting image segmentations to determine a region of interest within the myocardium for fractal analysis.

FD images

Installation

Clone this repo to a folder in your MATLAB workspace then add all directories to the path:

addpath(genpath('folder')); savepath;

Usage

Put the input data into a top-level folder with sub-folders for each subject containing:

  • Grayscale main image sa_ED.nii.gz
  • Segmentation seg_sa_ED.nii.gz or seg_sa_ED.gipl.

The labels are Background = 0, Blood Pool = 1, Myocardium = 2, Other = 3 or 4.

Run the script pft_FractalDimensionCalculationOnMultipleFolders

Dialogue boxes are used to confirm the following:

  • Stacks are stored from Apex to Base (default for the Test Data) or vice-versa.
  • Interpolate images x4 in each direction in-plane (default for the Test Data), or to 0.25 mm pixels.
  • Minimum blood pool pixel count (default = 64 for the sample Test Data, optimised by means of a balanced probability calculation comparing manual and automated workflows) and percentage of blood pool connected to myocardium (default = 50%). Refer to the Processing Flowchart for details.
  • Keep or discard the end slices in the calculation of the summary statistics (the default is keep).

Test data

Data for 7 subjects (A to G) are held in Test Data. Unzip and select as the top level folder for analysis. The acquisition order must be Apex to Base. The preferred interpolation is x4. For the other parameters, either accept or edit the processing defaults.

Outputs

Outputs are written to a new sub-folder Automated FD Calculation Results. Each subject's folder will contain intermediate images (see figure) and box-counting statistics.

Fractal dimension values are output to Summary-Auto-FD-v0.csv. If you run the script more than once, new results will be appended.

Citation

Tokarczuk P, Dawes TJW, O'Regan DP (2018, April 25). UK-Digital-Heart-Project/AutoFD: AutoFD (Version v1.0). Zenodo. http://doi.org/10.5281/zenodo.1228963

DOI

autofd's People

Contributors

ptokarcz avatar doregan avatar timdawes avatar

Watchers

James Cloos 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.