- Use cv::AutoBuffer rather than new allocation
- Fix "assignment operator could not be generated" warning

- updated existing Doxyfile.in
- added corresponding cmake instructions
- added some specific files (layout, icon)
- clean existing doxygen warnings

1. someMatrix.data -> someMatrix.prt()
2. someMatrix.data + someMatrix.step * lineIndex -> someMatrix.ptr( lineIndex )
3. (SomeType*) someMatrix.data -> someMatrix.ptr<SomeType>()
4. someMatrix.data -> !someMatrix.empty() ( or !someMatrix.data -> someMatrix.empty() ) in logical expressions

Revert "Avoid obtaining several identical dimensions between two LSH sub-vectors by choosing orthogonal sub-vectors."

This reverts commit e85bacff.

This reverts commit 8e93c19d.

Revert "Allows to choose orthogonal sub-vectors for LSH without using a static table among LshTable instances"

This reverts commit e63d7de8.

This reverts commit 2f8b5731.

Add the ensureSimpleDistance() method to ensure the user the returned distance is not ^2 (the default for L2 for instance)

Allows to choose orthogonal sub-vectors for LSH without using a static table among LshTable instances

version of print_params for backwards compatibility.

Fix: freeing previous elements has to be done before loading new parameters to avoid trying to delete unexisting objects if arrays size was modified

Avoid obtaining several identical dimensions between two LSH sub-vectors by choosing orthogonal sub-vectors.

Add a new method for initializing KMeans centers that leads to better clusters and thus better retrieval when final centers have to be existing keypoints instead of clusters barycenters.

When a cluster is empty for KMeans, it's better to give it the point from another cluster j that is the furthest one from center j.

Move templates in dist.h in order to share them between KMeansIndex and HierarchicalClusteringIndex classes.

As some processed distances are already ^2, use template to select whether or not we have to ^2 in KMeanspp

Pick centers in KMeans++ with a probability proportional to their distance^2, instead of simple distance, to previous centers

Original author: me.

Original author: Alex Wilson.

This reverts commit a9975b14, to prepare
for cherry-picking upstream's solution.

We don't use -Wcast-align ourselves, but the headers trigger warnings
for those users who do, which is not nice.

This is fixed upstream in mariusmuja/flann@b615f26, but that fix
would break binary compatibility, so I had to make a different one.

Since the bug isn't quite obvious, here's an explanation. In the const
version of any::cast, if policy is a small_any_policy, its get_value
returns its input argument. So r becomes a pointer to obj, and the
return value is a reference to a local variable, which is invalidated
when the function exits.