You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@labs.apache.org by to...@apache.org on 2013/03/22 16:02:41 UTC

svn commit: r1459827 - in /labs/yay/trunk/api/src/main/java/org/apache/yay: ActivationFunction.java Example.java Feature.java Input.java LearningStrategy.java NeuralNetwork.java PredictionStrategy.java TrainingExample.java

Author: tommaso
Date: Fri Mar 22 15:02:40 2013
New Revision: 1459827

URL: http://svn.apache.org/r1459827
Log:
started refactoring API

Added:
    labs/yay/trunk/api/src/main/java/org/apache/yay/Input.java
      - copied, changed from r1453398, labs/yay/trunk/api/src/main/java/org/apache/yay/Example.java
Removed:
    labs/yay/trunk/api/src/main/java/org/apache/yay/Example.java
Modified:
    labs/yay/trunk/api/src/main/java/org/apache/yay/ActivationFunction.java
    labs/yay/trunk/api/src/main/java/org/apache/yay/Feature.java
    labs/yay/trunk/api/src/main/java/org/apache/yay/LearningStrategy.java
    labs/yay/trunk/api/src/main/java/org/apache/yay/NeuralNetwork.java
    labs/yay/trunk/api/src/main/java/org/apache/yay/PredictionStrategy.java
    labs/yay/trunk/api/src/main/java/org/apache/yay/TrainingExample.java

Modified: labs/yay/trunk/api/src/main/java/org/apache/yay/ActivationFunction.java
URL: http://svn.apache.org/viewvc/labs/yay/trunk/api/src/main/java/org/apache/yay/ActivationFunction.java?rev=1459827&r1=1459826&r2=1459827&view=diff
==============================================================================
--- labs/yay/trunk/api/src/main/java/org/apache/yay/ActivationFunction.java (original)
+++ labs/yay/trunk/api/src/main/java/org/apache/yay/ActivationFunction.java Fri Mar 22 15:02:40 2013
@@ -23,6 +23,8 @@ package org.apache.yay;
  * An activation function AF has horizontal asymptotes at 0 and 1 and a non
  * decreasing first derivative AF' with AF and AF' both being computable.
  *
+ * These are usually used in {@link Neuron}s in order to propagate the "signal"
+ * throughout the whole {@link NeuralNetwork}.
  */
 public interface ActivationFunction<T> {
 

Modified: labs/yay/trunk/api/src/main/java/org/apache/yay/Feature.java
URL: http://svn.apache.org/viewvc/labs/yay/trunk/api/src/main/java/org/apache/yay/Feature.java?rev=1459827&r1=1459826&r2=1459827&view=diff
==============================================================================
--- labs/yay/trunk/api/src/main/java/org/apache/yay/Feature.java (original)
+++ labs/yay/trunk/api/src/main/java/org/apache/yay/Feature.java Fri Mar 22 15:02:40 2013
@@ -19,7 +19,7 @@
 package org.apache.yay;
 
 /**
- * A feature of a training example
+ * A feature of an input/sample
  */
 public class Feature<T> {
 

Copied: labs/yay/trunk/api/src/main/java/org/apache/yay/Input.java (from r1453398, labs/yay/trunk/api/src/main/java/org/apache/yay/Example.java)
URL: http://svn.apache.org/viewvc/labs/yay/trunk/api/src/main/java/org/apache/yay/Input.java?p2=labs/yay/trunk/api/src/main/java/org/apache/yay/Input.java&p1=labs/yay/trunk/api/src/main/java/org/apache/yay/Example.java&r1=1453398&r2=1459827&rev=1459827&view=diff
==============================================================================
--- labs/yay/trunk/api/src/main/java/org/apache/yay/Example.java (original)
+++ labs/yay/trunk/api/src/main/java/org/apache/yay/Input.java Fri Mar 22 15:02:40 2013
@@ -21,9 +21,9 @@ package org.apache.yay;
 import java.util.ArrayList;
 
 /**
- * A sample/input characterized by its features (typed with type F)
+ * A sample/input characterized by its features.
  */
-public interface Example<F> {
+public interface Input<F> {
 
   public ArrayList<Feature<F>> getFeatures();
 

Modified: labs/yay/trunk/api/src/main/java/org/apache/yay/LearningStrategy.java
URL: http://svn.apache.org/viewvc/labs/yay/trunk/api/src/main/java/org/apache/yay/LearningStrategy.java?rev=1459827&r1=1459826&r2=1459827&view=diff
==============================================================================
--- labs/yay/trunk/api/src/main/java/org/apache/yay/LearningStrategy.java (original)
+++ labs/yay/trunk/api/src/main/java/org/apache/yay/LearningStrategy.java Fri Mar 22 15:02:40 2013
@@ -27,7 +27,7 @@ import java.util.Collection;
  */
 public interface LearningStrategy<F, O> {
 
-  public RealMatrix[] learnWeights(RealMatrix[] weightsMatrixSet, Collection<TrainingExample<F, O>>
-          trainingExamples) throws WeightLearningException;
+  public RealMatrix[] learnWeights(RealMatrix[] weightsMatrixSet, TrainingSet<F, O>
+         trainingSet) throws WeightLearningException;
 
 }

Modified: labs/yay/trunk/api/src/main/java/org/apache/yay/NeuralNetwork.java
URL: http://svn.apache.org/viewvc/labs/yay/trunk/api/src/main/java/org/apache/yay/NeuralNetwork.java?rev=1459827&r1=1459826&r2=1459827&view=diff
==============================================================================
--- labs/yay/trunk/api/src/main/java/org/apache/yay/NeuralNetwork.java (original)
+++ labs/yay/trunk/api/src/main/java/org/apache/yay/NeuralNetwork.java Fri Mar 22 15:02:40 2013
@@ -23,8 +23,8 @@ package org.apache.yay;
  */
 public interface NeuralNetwork<I, O> {
 
-  public void learn(TrainingExample<I,O>... trainingExamples) throws LearningException;
+  public void learn(TrainingSet<I, O> trainingSet) throws LearningException;
 
-  public O predict(Example<I> input) throws PredictionException;
+  public O predict(Input<I> input) throws PredictionException;
 
 }

Modified: labs/yay/trunk/api/src/main/java/org/apache/yay/PredictionStrategy.java
URL: http://svn.apache.org/viewvc/labs/yay/trunk/api/src/main/java/org/apache/yay/PredictionStrategy.java?rev=1459827&r1=1459826&r2=1459827&view=diff
==============================================================================
--- labs/yay/trunk/api/src/main/java/org/apache/yay/PredictionStrategy.java (original)
+++ labs/yay/trunk/api/src/main/java/org/apache/yay/PredictionStrategy.java Fri Mar 22 15:02:40 2013
@@ -23,12 +23,13 @@ import org.apache.commons.math3.linear.R
 import java.util.Collection;
 
 /**
- * A {@link PredictionStrategy} defines an algorithm for the prediction of an output of type O given an input of type I
+ * A {@link PredictionStrategy} defines an algorithm for the prediction of an output
+ * <code>O</code> given an input <code>I</code>.
  */
 public interface PredictionStrategy<I, O> {
 
-  public O predictOutput(Collection<I> input, RealMatrix[] weightsMatrixSet);
+  public O predictOutput(Collection<I> inputs, RealMatrix[] weightsMatrixSet);
 
-  public RealMatrix[] debugOutput(Collection<I> input, RealMatrix[] weightsMatrixSet);
+  public RealMatrix[] debugOutput(Collection<I> inputs, RealMatrix[] weightsMatrixSet);
 
 }

Modified: labs/yay/trunk/api/src/main/java/org/apache/yay/TrainingExample.java
URL: http://svn.apache.org/viewvc/labs/yay/trunk/api/src/main/java/org/apache/yay/TrainingExample.java?rev=1459827&r1=1459826&r2=1459827&view=diff
==============================================================================
--- labs/yay/trunk/api/src/main/java/org/apache/yay/TrainingExample.java (original)
+++ labs/yay/trunk/api/src/main/java/org/apache/yay/TrainingExample.java Fri Mar 22 15:02:40 2013
@@ -21,7 +21,7 @@ package org.apache.yay;
 /**
  * A training example with input features and associated output
  */
-public interface TrainingExample<F, O> extends Example<F> {
+public interface TrainingExample<F, O> extends Input<F> {
 
   public O getOutput();
 



---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@labs.apache.org
For additional commands, e-mail: commits-help@labs.apache.org