toxiclibs 0.2-java → 0.5.0-java

data/src/toxi/util/datatypes/BiasedDoubleRange.java

@@ -0,0 +1,141 @@
+/*
+ *   __               .__       .__  ._____.           
+ * _/  |_  _______  __|__| ____ |  | |__\_ |__   ______
+ * \   __\/  _ \  \/  /  |/ ___\|  | |  || __ \ /  ___/
+ *  |  | (  <_> >    <|  \  \___|  |_|  || \_\ \\___ \ 
+ *  |__|  \____/__/\_ \__|\___  >____/__||___  /____  >
+ *                   \/       \/             \/     \/ 
+ *
+ * Copyright (c) 2006-2011 Karsten Schmidt
+ * 
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2.1 of the License, or (at your option) any later version.
+ * 
+ * http://creativecommons.org/licenses/LGPL/2.1/
+ * 
+ * This library 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
+ * Lesser General Public License for more details.
+ * 
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library; if not, write to the Free Software
+ * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
+ */
+
+package toxi.util.datatypes;
+
+import javax.xml.bind.annotation.XmlAttribute;
+
+import toxi.math.MathUtils;
+
+/**
+ *
+ * @author tux
+ */
+public class BiasedDoubleRange extends DoubleRange {
+
+    /**
+     *
+     */
+    @XmlAttribute
+    protected double bias = 0.5;
+
+    /**
+     *
+     */
+    @XmlAttribute
+    protected double standardDeviation = bias * 0.5;
+
+    /**
+     *
+     */
+    public BiasedDoubleRange() {
+        this(0, 1, 0.5, 1);
+    }
+
+    /**
+     * @param min
+     *            min value (inclusive)
+     * @param max
+     *            max value (inclusive)
+     * @param bias
+     *            bias value (can be outside the min/max range, but values will
+     *            be clipped)
+     * @param sd
+     *            standard deviation (if bias at range mean sd=1.0, the entire
+     *            range will be covered)
+     */
+    public BiasedDoubleRange(double min, double max, double bias, double sd) {
+        super(min, max);
+        setBias(bias);
+        setStandardDeviation(sd);
+    }
+
+    /**
+     *
+     * @return
+     */
+    @Override
+    public BiasedDoubleRange copy() {
+        BiasedDoubleRange r = new BiasedDoubleRange(min, max, bias,
+                standardDeviation * 2);
+        r.currValue = currValue;
+        return r;
+    }
+
+    /**
+     * @return the bias
+     */
+    public double getBias() {
+        return bias;
+    }
+
+    /**
+     * @return the standardDeviation
+     */
+    public double getStandardDeviation() {
+        return standardDeviation;
+    }
+
+    /**
+     *
+     * @return
+     */
+    @Override
+    public double pickRandom() {
+        do {
+            currValue = (random.nextGaussian() * standardDeviation * (max - min))
+                    + bias;
+        } while (currValue < min || currValue >= max);
+        return currValue;
+    }
+
+    /**
+     * @param bias
+     *            the bias to set
+     */
+    public final void setBias(double bias) {
+        this.bias = MathUtils.clip(bias, min, max);
+    }
+
+    /**
+     * @param sd
+     *            the standardDeviation to set
+     */
+    public final void setStandardDeviation(double sd) {
+        this.standardDeviation = MathUtils.clip(sd, 0, 1.0) * 0.5;
+    }
+
+    /**
+     *
+     * @return
+     */
+    @Override
+    public String toString() {
+        return "BiasedFloatRange: " + min + " -> " + max + " bias: " + bias
+                + " q: " + standardDeviation;
+    }
+}

data/src/toxi/util/datatypes/BiasedFloatRange.java

@@ -0,0 +1,141 @@
+/*
+ *   __               .__       .__  ._____.           
+ * _/  |_  _______  __|__| ____ |  | |__\_ |__   ______
+ * \   __\/  _ \  \/  /  |/ ___\|  | |  || __ \ /  ___/
+ *  |  | (  <_> >    <|  \  \___|  |_|  || \_\ \\___ \ 
+ *  |__|  \____/__/\_ \__|\___  >____/__||___  /____  >
+ *                   \/       \/             \/     \/ 
+ *
+ * Copyright (c) 2006-2011 Karsten Schmidt
+ * 
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2.1 of the License, or (at your option) any later version.
+ * 
+ * http://creativecommons.org/licenses/LGPL/2.1/
+ * 
+ * This library 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
+ * Lesser General Public License for more details.
+ * 
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library; if not, write to the Free Software
+ * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
+ */
+
+package toxi.util.datatypes;
+
+import javax.xml.bind.annotation.XmlAttribute;
+
+import toxi.math.MathUtils;
+
+/**
+ *
+ * @author tux
+ */
+public class BiasedFloatRange extends FloatRange {
+
+    /**
+     *
+     */
+    @XmlAttribute
+    protected float bias = 0.5f;
+
+    /**
+     *
+     */
+    @XmlAttribute
+    protected float standardDeviation = bias * 0.5f;
+
+    /**
+     *
+     */
+    public BiasedFloatRange() {
+        this(0, 1, 0.5f, 1);
+    }
+
+    /**
+     * @param min
+     *            min value (inclusive)
+     * @param max
+     *            max value (inclusive)
+     * @param bias
+     *            bias value (can be outside the min/max range, but values will
+     *            be clipped)
+     * @param sd
+     *            standard deviation (if bias at range mean sd=1.0, the entire
+     *            range will be covered)
+     */
+    public BiasedFloatRange(float min, float max, float bias, float sd) {
+        super(min, max);
+        setBias(bias);
+        setStandardDeviation(sd);
+    }
+
+    /**
+     *
+     * @return
+     */
+    @Override
+    public BiasedFloatRange copy() {
+        BiasedFloatRange r = new BiasedFloatRange(min, max, bias,
+                standardDeviation * 2);
+        r.currValue = currValue;
+        return r;
+    }
+
+    /**
+     * @return the bias
+     */
+    public float getBias() {
+        return bias;
+    }
+
+    /**
+     * @return the standardDeviation
+     */
+    public float getStandardDeviation() {
+        return standardDeviation;
+    }
+
+    /**
+     *
+     * @return
+     */
+    @Override
+    public float pickRandom() {
+        do {
+            currValue = (float) (random.nextGaussian() * standardDeviation * (max - min))
+                    + bias;
+        } while (currValue < min || currValue >= max);
+        return currValue;
+    }
+
+    /**
+     * @param bias
+     *            the bias to set
+     */
+    public final void setBias(float bias) {
+        this.bias = MathUtils.clip(bias, min, max);
+    }
+
+    /**
+     * @param sd
+     *            the standardDeviation to set
+     */
+    public final void setStandardDeviation(float sd) {
+        this.standardDeviation = MathUtils.clip(sd, 0, 1.0f) * 0.5f;
+    }
+
+    /**
+     *
+     * @return
+     */
+    @Override
+    public String toString() {
+        return "BiasedFloatRange: " + min + " -> " + max + " bias: " + bias
+                + " q: " + standardDeviation;
+    }
+}

data/src/toxi/util/datatypes/BiasedIntegerRange.java

@@ -0,0 +1,141 @@
+/*
+ *   __               .__       .__  ._____.           
+ * _/  |_  _______  __|__| ____ |  | |__\_ |__   ______
+ * \   __\/  _ \  \/  /  |/ ___\|  | |  || __ \ /  ___/
+ *  |  | (  <_> >    <|  \  \___|  |_|  || \_\ \\___ \ 
+ *  |__|  \____/__/\_ \__|\___  >____/__||___  /____  >
+ *                   \/       \/             \/     \/ 
+ *
+ * Copyright (c) 2006-2011 Karsten Schmidt
+ * 
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2.1 of the License, or (at your option) any later version.
+ * 
+ * http://creativecommons.org/licenses/LGPL/2.1/
+ * 
+ * This library 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
+ * Lesser General Public License for more details.
+ * 
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library; if not, write to the Free Software
+ * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
+ */
+
+package toxi.util.datatypes;
+
+import javax.xml.bind.annotation.XmlAttribute;
+
+import toxi.math.MathUtils;
+
+/**
+ *
+ * @author tux
+ */
+public class BiasedIntegerRange extends IntegerRange {
+
+    /**
+     *
+     */
+    @XmlAttribute
+    public int bias;
+
+    /**
+     *
+     */
+    @XmlAttribute
+    public float standardDeviation;
+
+    /**
+     *
+     */
+    public BiasedIntegerRange() {
+        this(0, 100, 50, 1.0f);
+    }
+
+    /**
+     * @param min
+     *            min value (inclusive)
+     * @param max
+     *            max value (inclusive)
+     * @param bias
+     *            bias value (can be outside the min/max range, but values will
+     *            be clipped)
+     * @param sd
+     *            standard deviation (if bias at range means sd=1.0, the entire
+     *            range will be covered)
+     */
+    public BiasedIntegerRange(int min, int max, int bias, float sd) {
+        super(min, max);
+        this.bias = bias;
+        this.standardDeviation = sd * 0.5f;
+    }
+
+    /**
+     *
+     * @return
+     */
+    @Override
+    public BiasedIntegerRange copy() {
+        BiasedIntegerRange r = new BiasedIntegerRange(min, max, bias,
+                standardDeviation * 2);
+        r.currValue = currValue;
+        return r;
+    }
+
+    /**
+     * @return the bias
+     */
+    public int getBias() {
+        return bias;
+    }
+
+    /**
+     * @return the standardDeviation
+     */
+    public float getStandardDeviation() {
+        return standardDeviation;
+    }
+
+    /**
+     *
+     * @return
+     */
+    @Override
+    public int pickRandom() {
+        do {
+            currValue = (int) (random.nextGaussian() * standardDeviation * (max - min))
+                    + bias;
+        } while (currValue < min || currValue >= max);
+        return currValue;
+    }
+
+    /**
+     * @param bias
+     *            the bias to set
+     */
+    public void setBias(int bias) {
+        this.bias = MathUtils.clip(bias, min, max);
+    }
+
+    /**
+     * @param sd
+     *            the standardDeviation to set
+     */
+    public void setStandardDeviation(float sd) {
+        this.standardDeviation = MathUtils.clip(sd, 0, 1.0f) * 0.5f;
+    }
+
+    /**
+     *
+     * @return
+     */
+    @Override
+    public String toString() {
+        return "BiasedIntegerRange: " + min + " -> " + max + " bias: " + bias
+                + " q: " + standardDeviation;
+    }
+}

data/src/toxi/util/datatypes/DoubleRange.java

@@ -0,0 +1,251 @@
+/*
+ *   __               .__       .__  ._____.           
+ * _/  |_  _______  __|__| ____ |  | |__\_ |__   ______
+ * \   __\/  _ \  \/  /  |/ ___\|  | |  || __ \ /  ___/
+ *  |  | (  <_> >    <|  \  \___|  |_|  || \_\ \\___ \ 
+ *  |__|  \____/__/\_ \__|\___  >____/__||___  /____  >
+ *                   \/       \/             \/     \/ 
+ *
+ * Copyright (c) 2006-2011 Karsten Schmidt
+ * 
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2.1 of the License, or (at your option) any later version.
+ * 
+ * http://creativecommons.org/licenses/LGPL/2.1/
+ * 
+ * This library 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
+ * Lesser General Public License for more details.
+ * 
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library; if not, write to the Free Software
+ * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
+ */
+
+package toxi.util.datatypes;
+
+import java.util.LinkedList;
+import java.util.List;
+import java.util.Random;
+
+import javax.xml.bind.annotation.XmlAttribute;
+
+import toxi.math.MathUtils;
+
+/**
+ *
+ * @author tux
+ */
+public class DoubleRange {
+
+    /**
+     *
+     * @param samples
+     * @return
+     */
+    public static DoubleRange fromSamples(double... samples) {
+        double min = Double.MAX_VALUE;
+        double max = Double.MIN_VALUE;
+        for (double s : samples) {
+            min = MathUtils.min(min, s);
+            max = MathUtils.max(max, s);
+        }
+        return new DoubleRange(min, max);
+    }
+
+    /**
+     *
+     * @param samples
+     * @return
+     */
+    public static DoubleRange fromSamples(List<Double> samples) {
+        double min = Double.MAX_VALUE;
+        double max = Double.MIN_VALUE;
+        for (double s : samples) {
+            min = MathUtils.min(min, s);
+            max = MathUtils.max(max, s);
+        }
+        return new DoubleRange(min, max);
+    }
+
+    @XmlAttribute
+    public double min,
+
+    /**
+     *
+     */
+
+    /**
+     *
+     */
+    max;
+
+    /**
+     *
+     */
+    @XmlAttribute(name = "default")
+    public double currValue;
+
+    /**
+     *
+     */
+    protected Random random = new Random();
+
+    /**
+     *
+     */
+    public DoubleRange() {
+        this(0d, 1d);
+    }
+
+    /**
+     *
+     * @param min
+     * @param max
+     */
+    public DoubleRange(double min, double max) {
+        // swap if necessary...
+        if (min > max) {
+            double t = max;
+            max = min;
+            min = t;
+        }
+        this.min = min;
+        this.max = max;
+        this.currValue = min;
+    }
+
+    /**
+     *
+     * @param val
+     * @return
+     */
+    public double adjustCurrentBy(double val) {
+        return setCurrent(currValue + val);
+    }
+
+    /**
+     *
+     * @return
+     */
+    public DoubleRange copy() {
+        DoubleRange range = new DoubleRange(min, max);
+        range.currValue = currValue;
+        range.random = random;
+        return range;
+    }
+
+    /**
+     * Returns the value at the normalized position <code>(0.0 = min ... 1.0 =
+     * max-EPS)</code> within the range. Since the max value is exclusive, the
+     * value returned for position 1.0 is the range max value minus
+     * {@link MathUtils#EPS}. Also note the given position is not being clipped
+     * to the 0.0-1.0 interval, so when passing in values outside that interval
+     * will produce out-of-range values too.
+     * 
+     * @param perc
+     * @return value within the range
+     */
+    public final double getAt(double perc) {
+        return min + (max - min - MathUtils.EPS) * perc;
+    }
+
+    /**
+     *
+     * @return
+     */
+    public double getCurrent() {
+        return currValue;
+    }
+
+    /**
+     *
+     * @return
+     */
+    public double getMedian() {
+        return (min + max) * 0.5f;
+    }
+
+    /**
+     *
+     * @return
+     */
+    public double getRange() {
+        return max - min;
+    }
+
+    /**
+     *
+     * @param val
+     * @return
+     */
+    public boolean isValueInRange(float val) {
+        return val >= min && val <= max;
+    }
+
+    /**
+     *
+     * @return
+     */
+    public double pickRandom() {
+        currValue = MathUtils.random(random, (float) min, (float) max);
+        return currValue;
+    }
+
+    /**
+     *
+     * @param seed
+     * @return
+     */
+    public DoubleRange seed(long seed) {
+        random.setSeed(seed);
+        return this;
+    }
+
+    /**
+     *
+     * @param val
+     * @return
+     */
+    public double setCurrent(double val) {
+        currValue = MathUtils.clip(val, min, max);
+        return currValue;
+    }
+
+    /**
+     *
+     * @param rnd
+     * @return
+     */
+    public DoubleRange setRandom(Random rnd) {
+        random = rnd;
+        return this;
+    }
+
+    /**
+     *
+     * @param step
+     * @return
+     */
+    public Double[] toArray(double step) {
+        List<Double> range = new LinkedList<>();
+        double v = min;
+        while (v < max) {
+            range.add(v);
+            v += step;
+        }
+        return range.toArray(new Double[0]);
+    }
+
+    /**
+     *
+     * @return
+     */
+    @Override
+    public String toString() {
+        return "DoubleRange: " + min + " -> " + max;
+    }
+}