<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="content-type" content="text/html; charset=UTF-8">
<title>Returns the cascade candidate change fraction</title>
</head>
<body><div class="manualnavbar" style="text-align: center;">
<div class="prev" style="text-align: left; float: left;"><a href="function.fann-get-cascade-activation-steepnesses.html">fann_get_cascade_activation_steepnesses</a></div>
<div class="next" style="text-align: right; float: right;"><a href="function.fann-get-cascade-candidate-limit.html">fann_get_cascade_candidate_limit</a></div>
<div class="up"><a href="ref.fann.html">Fann Functions</a></div>
<div class="home"><a href="index.html">PHP Manual</a></div>
</div><hr /><div id="function.fann-get-cascade-candidate-change-fraction" class="refentry">
<div class="refnamediv">
<h1 class="refname">fann_get_cascade_candidate_change_fraction</h1>
<p class="verinfo">(PECL fann >= 1.0.0)</p><p class="refpurpose"><span class="refname">fann_get_cascade_candidate_change_fraction</span> — <span class="dc-title">Returns the cascade candidate change fraction</span></p>
</div>
<div class="refsect1 description" id="refsect1-function.fann-get-cascade-candidate-change-fraction-description">
<h3 class="title">Description</h3>
<div class="methodsynopsis dc-description">
<span class="type">float</span> <span class="methodname"><strong>fann_get_cascade_candidate_change_fraction</strong></span>
( <span class="methodparam"><span class="type">resource</span> <code class="parameter">$ann</code></span>
)</div>
<p class="para rdfs-comment">
The cascade candidate change fraction is a number between 0 and 1 determining how large a fraction the <span class="function"><a href="function.fann-get-mse.html" class="function">fann_get_MSE()</a></span>
value should change within <span class="function"><a href="function.fann-get-cascade-candidate-stagnation-epochs.html" class="function">fann_get_cascade_candidate_stagnation_epochs()</a></span> during training of the candidate neurons,
in order for the training not to stagnate. If the training stagnates, the training of the candidate neurons will be ended
and the best candidate will be selected.
</p>
<p class="para">
It means that if the MSE does not change by a fraction of <span class="function"><strong>fann_get_cascade_candidate_change_fraction()</strong></span> during
a period of <span class="function"><a href="function.fann-get-cascade-candidate-stagnation-epochs.html" class="function">fann_get_cascade_candidate_stagnation_epochs()</a></span>, the training of the candidate neurons is stopped
because the training has stagnated.
</p>
<p class="para">
If the cascade candidate change fraction is low, the candidate neurons will be trained more and if the fraction is high they will be trained less.
</p>
<p class="para">
The default cascade candidate change fraction is 0.01, which is equalent to a 1% change in MSE.
</p>
</div>
<div class="refsect1 parameters" id="refsect1-function.fann-get-cascade-candidate-change-fraction-parameters">
<h3 class="title">Parameters</h3>
<dl>
<dt>
<span class="term"><em><code class="parameter">ann</code></em></span>
<dd>
<p class="para">Neural network <span class="type"><a href="language.types.resource.html" class="type resource">resource</a></span>.</p>
</dd>
</dt>
</dl>
</div>
<div class="refsect1 returnvalues" id="refsect1-function.fann-get-cascade-candidate-change-fraction-returnvalues">
<h3 class="title">Return Values</h3>
<p class="para">
The cascade candidate change fraction, or <strong><code>FALSE</code></strong> on error.
</p>
</div>
<div class="refsect1 seealso" id="refsect1-function.fann-get-cascade-candidate-change-fraction-seealso">
<h3 class="title">See Also</h3>
<p class="para">
<ul class="simplelist">
<li class="member"> <span class="function"><a href="function.fann-set-cascade-candidate-change-fraction.html" class="function" rel="rdfs-seeAlso">fann_set_cascade_candidate_change_fraction()</a> - Sets the cascade candidate change fraction</span></li>
<li class="member"> <span class="function"><a href="function.fann-get-mse.html" class="function" rel="rdfs-seeAlso">fann_get_MSE()</a> - Reads the mean square error from the network</span></li>
<li class="member"> <span class="function"><a href="function.fann-get-cascade-candidate-stagnation-epochs.html" class="function" rel="rdfs-seeAlso">fann_get_cascade_candidate_stagnation_epochs()</a> - Returns the number of cascade candidate stagnation epochs</span></li>
</ul>
</p>
</div>
</div><hr /><div class="manualnavbar" style="text-align: center;">
<div class="prev" style="text-align: left; float: left;"><a href="function.fann-get-cascade-activation-steepnesses.html">fann_get_cascade_activation_steepnesses</a></div>
<div class="next" style="text-align: right; float: right;"><a href="function.fann-get-cascade-candidate-limit.html">fann_get_cascade_candidate_limit</a></div>
<div class="up"><a href="ref.fann.html">Fann Functions</a></div>
<div class="home"><a href="index.html">PHP Manual</a></div>
</div></body></html>
