﻿Bonsu - The Interactive Phase Retrieval Suite


NOTES
============
Bonsu is a collection of tools and algorithms primarily for the reconstruction of phase information from diffraction intensity measurements.
If Bonsu is used within article publications, it is requested that authors cite this publication:

Newton M. C., Nishino Y. and Robinson I. K., J. Appl. Cryst. (2012). 45, 840-843
doi:10.1107/S0021889812026751 



HISTORY
============

Version 3.3.2

	+ Compatibility with h5py 3.x
	* Bug fixes.

Version 3.3.1

	* Bug fixes.

Version 3.3.0

	+ Posix threading and SIMD AVX2 support.
	* Bug fixes.

Version 3.2.2

	+ Memory management improvements.
	* Minor interface improvements and bug fixes.

Version 3.2.1

	+ Compatibility with wxPython 4.1.0
	* Minor interface improvements and bug fixes.

Version 3.2.0

	+ Custom algorithm design interface.
	+ Reweighted 2D saddle-point optimisation algorithm.
	* Minor interface improvements and bug fixes.

Version 3.1.0

	+ Diamond nexus beamline data viewer for I16.
	+ Concurrent phase reconstruction
	* Rotate Support function now works for large arrays
	* Minor interface improvements and bug fixes.

Version 3.0.0

	+ Algorithm scripting interface.
	+ Python script function.
	+ Memory management for large arrays.
	* Minor interface improvements and bug fixes.

Version 2.6.0

	+ Scene menu entry for visualisation tools.
	+ Anti-aliasing menu option.
	+ Visualisation XYZ orientation widget styling. 
	+ Visualisation scale bar styling. 
	+ Specular/diffuse lighting option in visualisation.
	+ Added Centred Resize function.
	* Fixed byte/string array view bug in HDF viewer with Python 3.
	* Fixed 2D visualisation viewport size correction.  

Version 2.5.0

	+ Compatibility with Python 3.
	* Minor interface improvements and bug fixes.

Version 2.4.0

	+ Memory array manipulation in Python shell.
	* Fixed animate scene bug.

Version 2.3.1

	+ Check box to pipeline items to optionally exempt from execution.
	+ XYZ orientation widget. 
	+ Stacked TIFF file support.
	* Fixed load array to memory bugs.
	* Compatibility wxPython 4.  

Version 2.2.0

	+ ER, HPR and RAAR partial coherence algorithms added.
	+ Load and save point spread functions added. 
	* Minor interface improvements and bug fixes.
	* Fixed bug in shrink wrap support creation method.

Version 2.1.0

	+ Added View Support pipeline item.
	+ Partial coherence algorithm now shows Richardson-Lucy iterations
	* Fixed various interface bugs.

Version 2.0.1

	* Fixed various interface bugs.

Version 2.0.0

	+ Added Comments pipeline item.
	* Fixed various interface bugs.

Version 1.4.2

	* Added Apple OSX desktop integration.
	* Fixed various interface bugs.

Version 1.4.1

	* Fixed various interface bugs.


Version 1.4.0

	+ Added a number of new array operations.
	+ Added support for saving arrays from memory slots.
	+ Various improvements to the interface.
	* Fixed various interface bugs.


Version 1.3.0

	+ Added compatibility with VTK 6.
	+ Added compatibility with wxpython 3.
	+ Added support for loading of arrays directly into memory slots
	+ Various improvements to the interface.
	* Fixed various interface bugs.


Version 1.2.0

	* Fixed various bugs for improved stability.
	* Fixed bug in visualisation animation.
	* Improved compatibility with msvc/intel compilers.
	+ Added partial coherence algorithm.
	
  

Version 1.1.0

	+ Added support for program wide array manipulation in memory.
	* Fixed sequence data array size change bug.
	+ Added support for changeable working directory.
	+ Added support for alternative colour map lookup tables.
	+ Added array Gaussian fill operation.
	+ Added array Fourier transform operation.
	+ Added array convolution operation.
	+ Added array conjugate and reflect operation.
	+ Added support for undocking/docking visualisation.
	* Fixed array wrap operation for arrays with odd dimensions.


Version 1.0.0

	+ First stable release.



INSTALL
============
- Bonsu requires:
Python >= 2.7
wxPython >= 2.8.10
FFTW with threading >= 3.0
NumPy (FFTW aware) >= 1.4.1
VTK (with python bindings) >= 5.4.2
h5py
A C++ compiler such as gcc

- To instal the package, type:
$ python setup.py build
$ su -c 'python setup.py install'

- To run, type:
$ bonsu 


COPYING / LICENCE
============
Copyright 2011 - 2020 - Marcus C. Newton <Bonsu.Devel@gmail.com>
Registration number 284653218

Please send any bugs, problems, and proposals to: Bonsu.Devel@gmail.com
or visit: http://github.com/bonsudev/bonsu

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.

You should have received a copy of the GNU General Public License
along with this program.  If not, see <http://www.gnu.org/licenses/>.
