Asym Rank by Dbl
Description
Rank objects by the distance of a double property to a given value (or pair of values). The assigned rank varies according to a bell-shaped curve centered at the given value. Moreover, the ranking can be asymmetric, meaning that one bell curve is used to the left of one value and another bell curve to the right of the other value (the interval in between is ranked constantly 1).
Input
SOURCE [OBJ]
: the list of objects to rank
Output
CLOSE [OBJ]
: ranked objects, objects closed are ranked more highlyFAR [OBJ]
: ranked objects, objects further away are ranked more highly
Parameters
Property
: the double property to checkUse sub-properties
: when set totrue
, the values of all sub properties are also included. Sub-properties can be defined in the data with therdfs:subPropertyOf
relation.Ranking curve symmetry
: WhenSymmetric
, a single ranking curve centered aroundValue
is used. WhenAsymmetric
, two ranking curves and values can be specified (see below).Value
: the value against which theProperty
of each object is comparedThreshold type
: When set toAbsolute
theThreshold distance
is understood as an absolute distance from the specifiedValue
. When set toRelative
, theThreshold distance
is understood as a fraction ofValue
(e.g., having a relative threshold distance of 0.5 for a value of 10 is the same as having an absolute threshold distance of 5).Threshold distance
: The distance at which the specifiedRank at threshold distance
is attained. Can either be absolute or relative, as determined byThreshold type
. If set to 0, an indicator function is used as our ranking curve (i.e., all values not equal toValue
are filtered out). If set to 1, a constant ranking curve with value 1 is used (i.e., ranks remain unchanged). These two options are really only useful in the asymmetric case.Rank at threshold distance
: The rank to be attained at the specifiedThreshold distance
. If set to 0, a bump function in the shape of the 5th order smoothstep function on both sides ofValue
is used as our ranking curve (see https://en.wikipedia.org/wiki/Smoothstep). If set to 1, a constant ranking curve with value 1 is used (i.e., ranks remain unchanged). For all values in between, the ranking curve has the shape of a Gaussian centered atValue
and with peak value 1.
If the Ranking curve symmetry
is Asymmetric
then each of the curve parameters above can be
specified individually for the left and right side, respectively. The behavior of each of
these is the same as for the symmetric case. The left-side ranking curve is applied to all
objects where the selected Property
lies to the left of the specified Left value
, while
the right-side ranking curve is applied to all objects where the selected Property
lies to
the right of the specified Right value
. Between these two values, a constant ranking curve
of value 1 is applied and so the rank is left unchanged.