/*
* Encog(tm) Core v2.5 - Java Version
* http://www.heatonresearch.com/encog/
* http://code.google.com/p/encog-java/
* Copyright 2008-2010 Heaton Research, Inc.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*
* For more information on Heaton Research copyrights, licenses
* and trademarks visit:
* http://www.heatonresearch.com/copyright
*/
package org.encog.neural.networks.synapse;
import org.encog.mathutil.matrices.Matrix;
import org.encog.neural.NeuralNetworkError;
import org.encog.neural.data.NeuralData;
import org.encog.neural.networks.layers.Layer;
import org.encog.persist.EncogCollection;
import org.encog.persist.Persistor;
import org.encog.persist.persistors.DirectSynapsePersistor;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
/**
* A direct synapse will present the entire input array to each of the directly
* connected neurons in the next layer. This layer type is useful when building
* a radial basis neural network.
*
* This synapse type is not teachable.
*
* @author jheaton
*
*/
public class DirectSynapse extends BasicSynapse {
/**
*
*/
private static final long serialVersionUID = -3495349786238542641L;
/**
* The logging object.
*/
@SuppressWarnings("unused")
private final transient Logger logger =
LoggerFactory.getLogger(this.getClass());
/**
* Simple default constructor.
*/
public DirectSynapse() {
}
/**
* Construct a direct synapse between the two specified layers.
*
* @param fromLayer
* The starting layer.
* @param toLayer
* The ending layer.
*/
public DirectSynapse(final Layer fromLayer, final Layer toLayer) {
setFromLayer(fromLayer);
setToLayer(toLayer);
}
/**
* @return A clone of this object.
*/
@Override
public Object clone() {
final DirectSynapse result = new DirectSynapse(getFromLayer(),
getToLayer());
return result;
}
/**
* Compute the output from this synapse.
*
* @param input
* The input to this synapse.
* @return The output is the same as the input.
*/
public NeuralData compute(final NeuralData input) {
return input;
}
/**
* Create a persistor for this type of synapse.
*
* @return A persistor.
*/
public Persistor createPersistor() {
return new DirectSynapsePersistor();
}
/**
* @return null, this synapse type has no matrix.
*/
public Matrix getMatrix() {
return null;
}
/**
* @return 0, this synapse type has no matrix.
*/
public int getMatrixSize() {
return 0;
}
/**
* @return The type of synapse that this is.
*/
public SynapseType getType() {
return SynapseType.Direct;
}
/**
* @return False, because this type of synapse is not teachable.
*/
public boolean isTeachable() {
return false;
}
/**
* Attempt to set the matrix for this layer. This will throw an error,
* because this layer type does not have a matrix.
*
* @param matrix
* Not used.
*/
public void setMatrix(final Matrix matrix) {
throw new NeuralNetworkError(
"Can't set the matrix for a DirectSynapse");
}
}