<!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 output 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-num-candidates.html">fann_get_cascade_num_candidates</a></div>
<div class="next" style="text-align: right; float: right;"><a href="function.fann-get-cascade-output-stagnation-epochs.html">fann_get_cascade_output_stagnation_epochs</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-output-change-fraction" class="refentry">
<div class="refnamediv">
<h1 class="refname">fann_get_cascade_output_change_fraction</h1>
<p class="verinfo">(PECL fann >= 1.0.0)</p><p class="refpurpose"><span class="refname">fann_get_cascade_output_change_fraction</span> — <span class="dc-title">Returns the cascade output change fraction</span></p>
</div>
<div class="refsect1 description" id="refsect1-function.fann-get-cascade-output-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_output_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 output change fraction is a number between 0 and 1 determining how large a fraction of 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-output-stagnation-epochs.html" class="function">fann_get_cascade_output_stagnation_epochs()</a></span> during training of the output connections,
in order for the training not to stagnate. If the training stagnates, the training of the output connections
will be ended and new candidates will be prepared.
</p>
<p class="para">
It means that if the MSE does not change by a fraction of <span class="function"><strong>fann_get_cascade_output_change_fraction()</strong></span> during
a period of <span class="function"><a href="function.fann-get-cascade-output-stagnation-epochs.html" class="function">fann_get_cascade_output_stagnation_epochs()</a></span>, the training of the output connections is
stopped because the training has stagnated.
</p>
<p class="para">
If the cascade output change fraction is low, the output connections will be trained more and if the fraction is high,
they will be trained less.
</p>
<p class="para">
The default cascade output 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-output-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-output-change-fraction-returnvalues">
<h3 class="title">Return Values</h3>
<p class="para">
The cascade output change fraction, or <strong><code>FALSE</code></strong> on error.
</p>
</div>
<div class="refsect1 seealso" id="refsect1-function.fann-get-cascade-output-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-output-change-fraction.html" class="function" rel="rdfs-seeAlso">fann_set_cascade_output_change_fraction()</a> - Sets the cascade output 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-output-stagnation-epochs.html" class="function" rel="rdfs-seeAlso">fann_get_cascade_output_stagnation_epochs()</a> - Returns the number of cascade output 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-num-candidates.html">fann_get_cascade_num_candidates</a></div>
<div class="next" style="text-align: right; float: right;"><a href="function.fann-get-cascade-output-stagnation-epochs.html">fann_get_cascade_output_stagnation_epochs</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>
