/*
* Apache License
* Version 2.0, January 2004
* http://www.apache.org/licenses/
*
* Copyright 2013 Aurelian Tutuianu
* Copyright 2014 Aurelian Tutuianu
* Copyright 2015 Aurelian Tutuianu
* Copyright 2016 Aurelian Tutuianu
*
* 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.
*
*/
package rapaio.core.distributions.empirical;
import rapaio.core.stat.Variance;
import rapaio.data.Var;
import rapaio.data.filter.var.VFSort;
import java.io.Serializable;
import java.util.Arrays;
/**
* Kernel density estimator.
* Given a sample of values, based on a given kernel and bandwidth it creates
* an estimation of a density function.
*
* @author <a href="mailto:padreati@yahoo.com">Aurelian Tutuianu</a>
*/
public class KDE implements Serializable {
private static final long serialVersionUID = -9221394390068126299L;
private final double[] values;
private final KFunc kernel;
private final double bandwidth;
public KDE(Var values) {
this.values = values.stream().mapToDouble().toArray();
this.kernel = new KFuncGaussian();
this.bandwidth = getSilvermanBandwidth(values);
}
public KDE(Var values, double bandwidth) {
this(values, new KFuncGaussian(), bandwidth);
}
public KDE(Var values, KFunc kernel) {
this(values, kernel, getSilvermanBandwidth(values));
}
public KDE(Var values, KFunc kernel, double bandwidth) {
this.values = new VFSort().fitApply(values).stream().filter(s -> !s.missing()).mapToDouble().toArray();
this.kernel = kernel;
this.bandwidth = bandwidth;
}
public double pdf(double x) {
int from = Arrays.binarySearch(values, kernel.minValue(x, bandwidth));
if (from < 0) from = -from - 1;
int to = Arrays.binarySearch(values, kernel.getMaxValue(x, bandwidth));
if (to < 0) to = -to - 1;
double sum = 0;
for (int i = from; i < to; i++) {
sum += kernel.pdf(x, values[i], bandwidth);
}
return sum / (values.length * bandwidth);
}
public KFunc getKernel() {
return kernel;
}
public double getBandwidth() {
return bandwidth;
}
/**
* Computes the approximation for bandwidth provided by Silverman,
* known also as Silverman's rule of thumb.
* <p>
* Is used when the approximated is gaussian for approximating
* univariate data.
* <p>
* For further reference check:
* http://en.wikipedia.org/wiki/Kernel_density_estimation
*
* @param vector sample of values
* @return teh value of the approximation for bandwidth
*/
public static double getSilvermanBandwidth(Var vector) {
Variance var = Variance.from(vector);
double sd = Math.sqrt(var.value());
if (sd == 0) {
sd = 1;
}
double count = 0;
for (int i = 0; i < vector.rowCount(); i++) if (!vector.missing(i)) count++;
return 1.06 * sd * Math.pow(count, -1. / 5.);
}
}