You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@commons.apache.org by er...@apache.org on 2015/09/14 02:24:38 UTC

[3/6] [math] MATH-1268

MATH-1268

API for algorithms that create some visualization of a 2D SOFM.


Project: http://git-wip-us.apache.org/repos/asf/commons-math/repo
Commit: http://git-wip-us.apache.org/repos/asf/commons-math/commit/999761ba
Tree: http://git-wip-us.apache.org/repos/asf/commons-math/tree/999761ba
Diff: http://git-wip-us.apache.org/repos/asf/commons-math/diff/999761ba

Branch: refs/heads/master
Commit: 999761ba1bc5da820a1d2527c4aae29d95a7013a
Parents: f348d34
Author: Gilles <er...@apache.org>
Authored: Mon Sep 14 02:07:36 2015 +0200
Committer: Gilles <er...@apache.org>
Committed: Mon Sep 14 02:07:36 2015 +0200

----------------------------------------------------------------------
 .../twod/util/MapDataVisualization.java         | 37 ++++++++++++++++++++
 .../neuralnet/twod/util/MapVisualization.java   | 33 +++++++++++++++++
 .../ml/neuralnet/twod/util/package-info.java    | 22 ++++++++++++
 3 files changed, 92 insertions(+)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/commons-math/blob/999761ba/src/main/java/org/apache/commons/math4/ml/neuralnet/twod/util/MapDataVisualization.java
----------------------------------------------------------------------
diff --git a/src/main/java/org/apache/commons/math4/ml/neuralnet/twod/util/MapDataVisualization.java b/src/main/java/org/apache/commons/math4/ml/neuralnet/twod/util/MapDataVisualization.java
new file mode 100644
index 0000000..00a6b8d
--- /dev/null
+++ b/src/main/java/org/apache/commons/math4/ml/neuralnet/twod/util/MapDataVisualization.java
@@ -0,0 +1,37 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You 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.
+ */
+
+package org.apache.commons.math4.ml.neuralnet.twod.util;
+
+import org.apache.commons.math4.ml.neuralnet.twod.NeuronSquareMesh2D;
+
+/**
+ * Interface for algorithms that compute some metrics of the projection of
+ * data on a 2D-map.
+ */
+public interface MapDataVisualization {
+    /**
+     * Creates an image of the {@code data} metrics when represented by the
+     * {@code map}.
+     *
+     * @param map Map.
+     * @param data Data.
+     * @return a 2D-array (in row major order) representing the metrics.
+     */
+    double[][] computeImage(NeuronSquareMesh2D map,
+                            Iterable<double[]> data);
+}

http://git-wip-us.apache.org/repos/asf/commons-math/blob/999761ba/src/main/java/org/apache/commons/math4/ml/neuralnet/twod/util/MapVisualization.java
----------------------------------------------------------------------
diff --git a/src/main/java/org/apache/commons/math4/ml/neuralnet/twod/util/MapVisualization.java b/src/main/java/org/apache/commons/math4/ml/neuralnet/twod/util/MapVisualization.java
new file mode 100644
index 0000000..b5d6873
--- /dev/null
+++ b/src/main/java/org/apache/commons/math4/ml/neuralnet/twod/util/MapVisualization.java
@@ -0,0 +1,33 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You 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.
+ */
+
+package org.apache.commons.math4.ml.neuralnet.twod.util;
+
+import org.apache.commons.math4.ml.neuralnet.twod.NeuronSquareMesh2D;
+
+/**
+ * Interface for algorithms that compute some property of a 2D-map.
+ */
+public interface MapVisualization {
+    /**
+     * Creates an image of the {@code map}.
+     *
+     * @param map Map.
+     * @return a 2D-array (in row major order) representing the property.
+     */
+    double[][] computeImage(NeuronSquareMesh2D map);
+}

http://git-wip-us.apache.org/repos/asf/commons-math/blob/999761ba/src/main/java/org/apache/commons/math4/ml/neuralnet/twod/util/package-info.java
----------------------------------------------------------------------
diff --git a/src/main/java/org/apache/commons/math4/ml/neuralnet/twod/util/package-info.java b/src/main/java/org/apache/commons/math4/ml/neuralnet/twod/util/package-info.java
new file mode 100644
index 0000000..9984c70
--- /dev/null
+++ b/src/main/java/org/apache/commons/math4/ml/neuralnet/twod/util/package-info.java
@@ -0,0 +1,22 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You 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.
+ */
+
+/**
+ * Utilities to visualize two-dimensional neural networks.
+ */
+
+package org.apache.commons.math4.ml.neuralnet.twod.util;