# Binom Rank by Date

### Description
Rank objects binomially depending on a date property of theirs (the distance between two dates is measured in
number of days).

### Input
- `SOURCE [OBJ]`: the list of objects to rank

### Output
- `INCREASING [OBJ]`: ranked objects using the specified ranking curve with increasing monotonicity (i.e. the
  rank tends towards 1 on the right side of the tipping point and towards 0 on the left).
- `DECREASING [OBJ]`: ranked objects using the specified ranking curve with decreasing monotonicity (i.e. the
  rank tends towards 0 on the right side of the tipping point and towards 1 on the left). For most cases, this is
  just the complement of `INCREASING` with the exception of the `Heaviside` function.

### Parameters
- `Property`: the date property to use for the binomial ranking
- `Use sub-properties`: when set to `true`, the values of all sub properties are also included. Sub-properties
  can be defined in the data with the `rdfs:subPropertyOf` relation.
- `Ranking curve`: the binomial ranking curve (a.k.a. activation function) to be used. Possible options are
  `Sigmoid` (logistic function), `Heaviside` (step function), `Arctan`, `Softsign` and `Piecewise Linear`.
  All of these are scaled such that the resulting ranks lie between 0 and 1.
- `Tipping Point`: for `Sigmoid`, `Arctan`, `Softsign` and `Piecewise Linear`, this is the point where the
  ranking curve attains 0.5. For `Heaviside`, this is the point where the curve jumps from 0 to 1.
- `Slope`: Specifies the slope at the tipping point. The higher the slope, the steeper the curve. For `Heaviside`
  this is interpreted as the value at the tipping point.