Bug Fix Release 1.5.4

-Accuracy fix for more complex rigid transformations brings us to version 1.5.4.

Critical Bug Fix Release v1.5.3

-Fixed a bug related to the global offset of each image, leading to many montages having clipped edges or layers that simply did not appear in the montage. (Thank you to Ms. Cava and Ojukwu, as well as @asalmon91, for the heads up.)

-Added version alerts, so that the user can know upon loading that their version is behind the currently released version with a simple message box.

Public Release v1.5.0- Speed and Polish

We have added a number of new features to this software worthy of a new release, including:

1. Auto-scaling- Multiple FOV can now be aligned within in a single montage! The LUT has a column where the user can place the number of pixels per fringe of their scaling grid for any given image number. The software will automatically rescale all images to the largest pixels/fringe (smallest FOV) for alignment and output.

2. The software no longer cares if the LUT entries don't exactly match the dataset you've selected, allowing you to use a single LUT file for both the OS and OD. Remember: the Nasal/Temporal coordinates are flipped between OS/OD!

See the new template file in the main directory "MODERN_both_OD_n_OS_TEMPLATE_LUT.xlsx" for an example of how to take advantage of these two new features.

3. Photoshop integration- if your MATLAB has been linked with Photoshop (CS5+), then you can directly load your data into it, instead of having to import it after the fact. The raw transformations are still output for your records.

4. Efficiency improvements leading to a faster run-time and a much smaller memory footprint. Large montages (600> images) now take less time, and typically use less than 4GB of RAM!

5. ToolboxToolbox integration. (For more information go here: https://github.com/ToolboxHub/ToolboxToolbox)

6. Bug fixes galore!

Enjoy!

As always, please cite the following paper if use this software in your work:

M. Chen, R. F. Cooper, G. K. Han, J. Gee, D. H. Brainard, and J. I. W. Morgan, "Multi-modal automatic montaging of adaptive optics retinal images," Biomedical Optics Express, Vol. 7 (12), pp. 4899-4918, 2016.

Public Release v1.1.0

The primary feature of this release is a change to how results with discontinuities (i.e. multiple pieces) are displayed and saved. Previously, multiple pieces would be named differently, but the center of each piece would be saved in the same location. It then became the responsibility of the user to separate and move the pieces to their relative locations.

Now, these pieces will be placed adjacent to each other (with a space in between) using the average coordinate information over the respective pieces. This should allow for easier manual adjustment of discontinuous pieces when imported into Photoshop, and a more clear identification of which images are grouped with which piece.

This feature is backwards compatible with montages completed using the previous version. Use the "Append" function (see README.md) on existing montages to resave them with the new output format.

Please cite the following paper if use this software in your work:

M. Chen, R. F. Cooper, G. K. Han, J. Gee, D. H. Brainard, and J. I. W. Morgan, "Multi-modal automatic montaging of adaptive optics retinal images," Biomedical Optics Express, Vol. 7 (12), pp. 4899-4918, 2016.

Public Release v1.0.0

This is the initial public release of our automatic adaptive optics montaging software. It includes the code and instructions for running our montaging GUI and reproducing the figures and tables shown in our paper:

M. Chen, R. F. Cooper, G. K. Han, J. Gee, D. H. Brainard, and J. I. W. Morgan, "Multi-modal automatic montaging of adaptive optics retinal images," Biomedical Optics Express, Vol. 7 (12), pp. 4899-4918, 2016.