The FftTools Package

Introduction

This package adds functions and classes that support a variety of Fast Fourier Transform alternatives which have proven useful in a medical image processing workflow.

NPM

This package uses the node package manager to manage its version control and dependencies. To use this package simply:

1. Install Node: https://nodejs.org/en/

2. Run npm install fft-tools at a unix-like terminal.

This will automatically download the files for this package (and the packages it depends on) into a node_modules folder. If you add this folder to your MATLAB path the package FftTools will be available.

It is crucial to note the difference in naming conventions between MATLAB and NPM. The npm package name is fft-tools and the MATLAB package name is '+FftTools'. If you are new to MATLAB packages please learn more about them here: http://www.mathworks.com/help/matlab/matlab_oop/scoping-classes-with-packages.html.

Tests

To make sure this software works as expected, tests have been provided and which can be run by executing FftTools.test. These tests provide a very basic data-in data-out testing and it's these example data files that take up the bulk of the size of this repository.

Since all test data is stored in +tests/private, the files in this folder should not be version controlled. You need to tell your local git to not track changes in them via git update-index --assume-unchanged as described here: http://stackoverflow.com/questions/12288212/git-update-index-assume-unchanged-on-directory.

If you want to contribute to this project please keep tests in mind and do not commit any new data without telling git to "assume-unchanged" to avoid bloating the .git file.

Docs

In the docs/ directory some markdown files are provided explaining how to use each of the functions and classes this package provides.