Readme.txt

*** Usage
To see a working demo, please run (inside the matlab console):
install
demo


*** Credit
If you use this code in scientific work, please cite:

@article{weinberger2009distance,
  title={Distance metric learning for large margin nearest neighbor classification},
  author={Weinberger, K.Q. and Saul, L.K.},
  journal={The Journal of Machine Learning Research},
  volume={10},
  pages={207--244},
  year={2009},
  publisher={JMLR.org}
}


*** Changelog
Update 23/04/2014
- Release version 2.5:
	- introduce new parameter "subsample" (subsample 10% of constraints by default)
	- improve convergence criteria
Update 10/04/2013
- fixed a small but critical bug in applypca.m (this function is optional as pre-processing)
Update 09/17/2013
Version 2.4.1:
- Set default validation parameter to 0.2
- Now perform cross validation over maxstepsize automatically

Update 07/26/2013
Version 2.4:
- Added GB-LMNN
- New demo.m (now including GB-LMNN)
- Made small changes to LMNN (mostly usability)
- Parallelized some C-functions with open-MP 
Credit: 
- Thanks to Gao Huang (Tsinghua university) for helping with the GB-LMNN implementation

Update 13/11/2012
- Fixed a bug that prevented execution with even values for k.

Update 01/11/2012
- Added optional 'diagonal' version to learn diagonal matrices 

Update 09/19/2012
- Added 32-bit Windows binaries (Thanks to Ya Shi)
Update 09/18/2012
- Added parameter 'outdim' to easily specify the output dimensionality
- Small fixes in mtree code, which broke compilation on some windows machines. 
- Speedup in findimps3Dm by substituting some repmats with bsxfun (somehow they have been overlooked)

Update 09/13/2012
- Small fix to setpaths.m script
- Rearranged files to ensure that the mexed files are in the path.
- updated demo

Update 09/06/2012
- Small fix to install.m script

Update 08/23/2012

This package contains the implementation of Large Margin Nearest Neighbors (LMNN). 

Changes from version 2.0 to 2.1:
 - Removed mex files which are no longer faster than the Matlab equivalent (Matlab became a lot faster over the years)
 - Updated mtrees to compile on windows computers and no longer use depreciated libraries
 - Removed all BLAS / LAPACK dependencies 
 - Renamed knnclassify.m to knncl.m (as former clashed with the implementation from the statistics toolbox)
(Many thanks to Jake Gardner who helped a lot with tyding up of the code.)