package jsat.math.decayrates;

import java.util.List;
import jsat.classifiers.svm.Pegasos;
import jsat.parameters.Parameter;
import jsat.parameters.Parameterized;

/**
 *
 * Decays an input by the inverse of the amount of time that has occurred, the 
 * max time being irrelevant. More specifically as 
 * η / ({@link #setAlpha(double) α}({@link #setTau(double) τ} + time))
*
* This decay rate can be used to create the same rate used by {@link Pegasos}, * by using an initial rate of 1 and setting τ = 1 and α = λ, * where λ is the regularization term used by the method calling the * decay rate. * * @author Edward Raff */ public class InverseDecay implements DecayRate, Parameterized { private static final long serialVersionUID = 2756825625752543664L; private double tau; private double alpha; /** * Creates a new Inverse decay rate * @param tau the initial time offset * @param alpha the time scaling */ public InverseDecay(double tau, double alpha) { setTau(tau); setAlpha(alpha); } /** * Creates a new Inverse Decay rate */ public InverseDecay() { this(1, 1); } /** * Controls the scaling of the divisor, increasing α dampens the * whole range of values. Increasing it increases the values. * value. * @param alpha the scaling parameter */ public void setAlpha(double alpha) { if(alpha <= 0 || Double.isInfinite(alpha) || Double.isNaN(alpha)) throw new IllegalArgumentException("alpha must be a positive constant, not " + alpha); this.alpha = alpha; } /** * Returns the scaling parameter * @return the scaling parameter */ public double getAlpha() { return alpha; } /** * Controls the rate early in time, but has a decreasing impact on the rate * returned as time goes forward. Larger values of τ dampen the initial * rates returned, while lower values let the initial rates start higher. * * @param tau the early rate dampening parameter */ public void setTau(double tau) { if(tau <= 0 || Double.isInfinite(tau) || Double.isNaN(tau)) throw new IllegalArgumentException("tau must be a positive constant, not " + tau); this.tau = tau; } /** * Returns the early rate dampening parameter * @return the early rate dampening parameter */ public double getTau() { return tau; } @Override public double rate(double time, double maxTime, double initial) { return rate(time, initial); } @Override public double rate(double time, double initial) { return initial/(alpha*(tau+time)); } @Override public DecayRate clone() { return new InverseDecay(tau, alpha); } @Override public String toString() { return "Inverse Decay"; } }

Ads help maintain this website.