summaryrefslogtreecommitdiff
path: root/src/de/lmu/ifi/dbs/elki/data/VectorUtil.java
diff options
context:
space:
mode:
Diffstat (limited to 'src/de/lmu/ifi/dbs/elki/data/VectorUtil.java')
-rw-r--r--src/de/lmu/ifi/dbs/elki/data/VectorUtil.java79
1 files changed, 79 insertions, 0 deletions
diff --git a/src/de/lmu/ifi/dbs/elki/data/VectorUtil.java b/src/de/lmu/ifi/dbs/elki/data/VectorUtil.java
new file mode 100644
index 00000000..46f94e24
--- /dev/null
+++ b/src/de/lmu/ifi/dbs/elki/data/VectorUtil.java
@@ -0,0 +1,79 @@
+package de.lmu.ifi.dbs.elki.data;
+/*
+This file is part of ELKI:
+Environment for Developing KDD-Applications Supported by Index-Structures
+
+Copyright (C) 2011
+Ludwig-Maximilians-Universität München
+Lehr- und Forschungseinheit für Datenbanksysteme
+ELKI Development Team
+
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU Affero General Public License as published by
+the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+GNU Affero General Public License for more details.
+
+You should have received a copy of the GNU Affero General Public License
+along with this program. If not, see <http://www.gnu.org/licenses/>.
+*/
+
+import java.util.Random;
+
+import de.lmu.ifi.dbs.elki.math.DoubleMinMax;
+import de.lmu.ifi.dbs.elki.math.MathUtil;
+
+/**
+ * Utility functions for use with vectors.
+ *
+ * Note: obviously, many functions are class methods or database related.
+ *
+ * @author Erich Schubert
+ *
+ * @apiviz.uses de.lmu.ifi.dbs.elki.data.NumberVector
+ */
+public final class VectorUtil {
+ /**
+ * Return the range across all dimensions. Useful in particular for time series.
+ *
+ * @param vec Vector to process.
+ * @param <V> Vector type
+ * @return [min, max]
+ */
+ public static <V extends NumberVector<?, ?>> DoubleMinMax getRangeDouble(V vec) {
+ DoubleMinMax minmax = new DoubleMinMax();
+
+ for(int i = 0; i < vec.getDimensionality(); i++) {
+ minmax.put(vec.doubleValue(i + 1));
+ }
+
+ return minmax;
+ }
+
+ /**
+ * Produce a new vector based on random numbers in [0:1] of the same type and
+ * dimensionality as the given vector.
+ *
+ * @param template existing instance of wanted dimensionality.
+ * @param r Random generator
+ * @return new instance
+ */
+ public static <V extends NumberVector<V, ?>> V randomVector(V template, Random r) {
+ return template.newInstance(MathUtil.randomDoubleArray(template.getDimensionality(), r));
+ }
+
+ /**
+ * Produce a new vector based on random numbers in [0:1] of the same type and
+ * dimensionality as the given vector.
+ *
+ * @param template existing instance of wanted dimensionality.
+ * @return new instance
+ */
+ public static <V extends NumberVector<V, ?>> V randomVector(V template) {
+ return randomVector(template, new Random());
+ }
+} \ No newline at end of file