updated the docs

--HG--
extra : convert_revision : svn%3Afdd8eb12-d10e-0410-9acb-85c331704f74/trunk%403245
This commit is contained in:
Davis King 2009-10-16 01:27:40 +00:00
parent a36189a5fc
commit 7679e6aa18
2 changed files with 14 additions and 18 deletions

View File

@ -126,8 +126,8 @@ Davis E. King. <a href="http://www.jmlr.org/papers/volume10/king09a/king09a.pdf"
<item>cross_validate_trainer</item>
<item>cross_validate_trainer_threaded</item>
<item>pick_initial_centers</item>
<item>rank_features_rbf</item>
<item>verbose_rank_features_rbf</item>
<item>find_gamma_with_big_centroid_gap</item>
<item>verbose_find_gamma_with_big_centroid_gap</item>
</section>
</top>
@ -747,14 +747,6 @@ Davis E. King. <a href="http://www.jmlr.org/papers/volume10/king09a/king09a.pdf"
does this by computing the distance between the centroids of both classes in kernel defined
feature space. Good features are then ones that result in the biggest separation between
the two centroids.
<p>
Note that there are convenience wrappers for calling this function.
They are the <a href="#rank_features_rbf">rank_features_rbf</a> and
<a href="#verbose_rank_features_rbf">verbose_rank_features_rbf</a> functions.
They automatically create the <a href="#kcentroid">kcentroid</a> required to
use this function and fill out the relevant parameters for you with a reasonable set
of defaults.
</p>
</description>
<examples>
<example>rank_features_ex.cpp.html</example>
@ -765,13 +757,14 @@ Davis E. King. <a href="http://www.jmlr.org/papers/volume10/king09a/king09a.pdf"
<!-- ************************************************************************* -->
<component>
<name>rank_features_rbf</name>
<name>find_gamma_with_big_centroid_gap</name>
<file>dlib/svm.h</file>
<spec_file link="true">dlib/svm/feature_ranking_abstract.h</spec_file>
<description>
This is just a wrapper for the <a href="#rank_features">rank_features</a> function. It
sets up the ranking to use the <a href="#radial_basis_kernel">radial_basis_kernel</a> and
automatically picks the gamma parameter of this kernel.
This is a function that tries to pick a reasonable default value for the
gamma parameter of the <a href="#radial_basis_kernel">radial_basis_kernel</a>. It
picks the parameter that gives the largest separation between the centroids, in
kernel feature space, of two classes of data.
</description>
<examples>
<example>rank_features_ex.cpp.html</example>
@ -782,11 +775,12 @@ Davis E. King. <a href="http://www.jmlr.org/papers/volume10/king09a/king09a.pdf"
<!-- ************************************************************************* -->
<component>
<name>verbose_rank_features_rbf</name>
<name>verbose_find_gamma_with_big_centroid_gap</name>
<file>dlib/svm.h</file>
<spec_file link="true">dlib/svm/feature_ranking_abstract.h</spec_file>
<description>
This is just a version of <a href="#rank_features_rbf">rank_features_rbf</a> that is
This is just a version of
<a href="#find_gamma_with_big_centroid_gap">find_gamma_with_big_centroid_gap</a> that is
verbose in the sense that it prints out status messages as it proceeds.
</description>
<examples>

View File

@ -28,6 +28,8 @@
<term file="dlib/optimization/optimization_abstract.h.html" name="central_differences"/>
<term file="dlib/optimization/optimization_abstract.h.html" name="line_search_funct"/>
<term file="dlib/optimization/optimization_line_search_abstract.h.html" name="optimize_single_variable_failure"/>
<term file="dlib/optimization/optimization_bobyqa_abstract.h.html" name="bobyqa_failure"/>
<term file="algorithms.html" name="derivative"/>
<term file="algorithms.html" name="make_line_search_function"/>
@ -138,8 +140,8 @@
<term file="ml.html" name="kkmeans"/>
<term file="ml.html" name="pick_initial_centers"/>
<term file="ml.html" name="rank_features"/>
<term file="ml.html" name="rank_features_rbf"/>
<term file="ml.html" name="verbose_rank_features_rbf"/>
<term file="ml.html" name="find_gamma_with_big_centroid_gap"/>
<term file="ml.html" name="verbose_find_gamma_with_big_centroid_gap"/>
<term file="dlib/svm/svm_abstract.h.html" name="maximum_nu"/>
<term file="ml.html" name="null_trainer"/>