C# Class StopGuessing.DataStructures.DecayingDouble

A class that represents a double that decays over time using a half life, to borrow a concept from radioactive decay. A value that is assigned a value 1d and a half life of one day will have value 0.5d after one day, .25d after two days, and so on. More generally, if you assign the value x, after e half lives it's value will be x/(2^e). Since a double that decays with time will have a constantly-changing real value, it should never be used as the key into a Dictionary or kept in a HashSet. It should not be compared for exact equality.

Afficher le fichier Open project: Microsoft/StopGuessing Class Usage Examples

Méthodes publiques

Méthode	Description
Add ( System.TimeSpan halfLife, DecayingDouble amountToAdd ) : DecayingDouble
Add ( double amountToAdd, System.TimeSpan halfLife, System.DateTime timeOfAddOperationUtc = null ) : void	In-place addition
AddInPlace ( System.TimeSpan halfLife, DecayingDouble amountToAdd ) : void
AddInPlace ( System.TimeSpan halfLife, double amountToAdd, System.DateTime whenToAddIt ) : void
Decay ( double valueLastSetTo, System.TimeSpan halfLife, System.DateTime whenLastSetUtc, System.DateTime timeToDecayTo = null ) : double
DecayingDouble ( double initialValue = 0d, System.DateTime initialLastUpdateUtc = null ) : System	A double that decays with time
GetValue ( System.TimeSpan halfLife, System.DateTime whenUtc = null ) : double	Get the value of the double at a given instant in time. If using the current system time, the preferred way to get the value is not to call this method but to simply access the Value field.
SetValue ( DecayingDouble source ) : void
SetValue ( double newValue, System.DateTime whenUtc = null ) : void	Set the value at a point in time. If setting using the current system time, the preferred approach is to simply set the Value field.
Subtract ( System.TimeSpan halfLife, DecayingDouble amountToRemove ) : DecayingDouble
SubtractInPlace ( System.TimeSpan halfLife, DecayingDouble amountToSubtract ) : void
SubtractInPlace ( System.TimeSpan halfLife, double amountToSubtract, System.DateTime whenToSubtractIt ) : void

Method Details

Add() public méthode

public Add ( System.TimeSpan halfLife, DecayingDouble amountToAdd ) : DecayingDouble
halfLife	System.TimeSpan
amountToAdd	DecayingDouble
Résultat	DecayingDouble

Add() public méthode

In-place addition

public Add ( double amountToAdd, System.TimeSpan halfLife, System.DateTime timeOfAddOperationUtc = null ) : void
amountToAdd	double	The amount to add to the existing value.
halfLife	System.TimeSpan	The half life to use when determining the existing value.
timeOfAddOperationUtc	System.DateTime	When to add it, in UTC time (if NULL, sets it to the current clock time)
Résultat	void

AddInPlace() public méthode

public AddInPlace ( System.TimeSpan halfLife, DecayingDouble amountToAdd ) : void
halfLife	System.TimeSpan
amountToAdd	DecayingDouble
Résultat	void

AddInPlace() public méthode

public AddInPlace ( System.TimeSpan halfLife, double amountToAdd, System.DateTime whenToAddIt ) : void
halfLife	System.TimeSpan
amountToAdd	double
whenToAddIt	System.DateTime
Résultat	void

Decay() public static méthode

public static Decay ( double valueLastSetTo, System.TimeSpan halfLife, System.DateTime whenLastSetUtc, System.DateTime timeToDecayTo = null ) : double
valueLastSetTo	double
halfLife	System.TimeSpan
whenLastSetUtc	System.DateTime
timeToDecayTo	System.DateTime
Résultat	double

DecayingDouble() public méthode

A double that decays with time

public DecayingDouble ( double initialValue = 0d, System.DateTime initialLastUpdateUtc = null ) : System
initialValue	double	The initial value of the double, which defaults to zero.
initialLastUpdateUtc	System.DateTime	The time when the value was set, which defaults to now.
Résultat	System

GetValue() public méthode

Get the value of the double at a given instant in time. If using the current system time, the preferred way to get the value is not to call this method but to simply access the Value field.

public GetValue ( System.TimeSpan halfLife, System.DateTime whenUtc = null ) : double
halfLife	System.TimeSpan	The half life to use when determining the current value.
whenUtc	System.DateTime	The instant of time for which the value should be calcualted, factoring in /// the decay rate. The default time is the current UTC time.
Résultat	double

SetValue() public méthode

public SetValue ( DecayingDouble source ) : void
source	DecayingDouble
Résultat	void

SetValue() public méthode

Set the value at a point in time. If setting using the current system time, the preferred approach is to simply set the Value field.

public SetValue ( double newValue, System.DateTime whenUtc = null ) : void
newValue	double	The new value to set.
whenUtc	System.DateTime	When the set happened so as to correctly calculate future decay rates. /// Should be adjusted to UTC time. /// The default time is the current system time adjusted to UTC.
Résultat	void

Subtract() public méthode

public Subtract ( System.TimeSpan halfLife, DecayingDouble amountToRemove ) : DecayingDouble
halfLife	System.TimeSpan
amountToRemove	DecayingDouble
Résultat	DecayingDouble

SubtractInPlace() public méthode

public SubtractInPlace ( System.TimeSpan halfLife, DecayingDouble amountToSubtract ) : void
halfLife	System.TimeSpan
amountToSubtract	DecayingDouble
Résultat	void

SubtractInPlace() public méthode

public SubtractInPlace ( System.TimeSpan halfLife, double amountToSubtract, System.DateTime whenToSubtractIt ) : void
halfLife	System.TimeSpan
amountToSubtract	double
whenToSubtractIt	System.DateTime
Résultat	void