Belief Priority Rank Gap Tool

Description

Return second-minus-first gap, exact tie and firstPreferred under the selected low-rank/high-rank convention.

Belief-revision priorities order supplied records rather than measure their truth. Rank direction, tie handling and the absence of any candidate must be explicit so that a sentinel is not mistaken for a selected belief.

Return second-minus-first gap, exact tie and firstPreferred under the selected low-rank/high-rank convention.

When to use this tool

Use Belief Priority Rank Gap when you need a priority comparison or selection among supplied belief records.

How to use the tool and how it works

Enter firstRank, secondRank, lowerRankHigherPriority. Use the units and conventions below.
Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
Read gap, firstPreferred, tie. Inspect firstPreferred, tie before interpreting the associated values.

Require nonnegative integer ranks. Return second-minus-first gap, exact tie and firstPreferred under the selected low-rank/high-rank convention.^[1]

Input field	Meaning and units	Accepted input
firstRank	First Rank	Required. Safe integer; minimum 0.
secondRank	Second Rank	Required. Safe integer; minimum 0.
lowerRankHigherPriority	Lower Rank Higher Priority	Required. Boolean.

Output field	Interpretation	Returned shape
gap	Difference on the stated unit and subtraction basis.	Required. Safe integer.
firstPreferred	First Preferred	Required. Boolean.
tie	Tie	Required. Boolean.

json

{
  "input": {
    "firstRank": 2,
    "secondRank": 4,
    "lowerRankHigherPriority": true
  },
  "output": {
    "gap": 2,
    "firstPreferred": true,
    "tie": false
  }
}

Limitations and assumptions

Ranks are supplied, not inferred strengths of justification. A numeric preference does not establish truth, rationality or a complete belief-revision policy.
Inputs must satisfy both the field types and the cross-field conditions above. Invalid input causes an error; a successful false flag or documented placeholder is a different result.
Numeric calculations use binary floating point unless exact decimal-integer arithmetic is explicitly stated. No hidden measurement tolerance or decimal rounding is added; nonfinite or out-of-contract results are rejected. Numeric signed-zero results are exported as zero.

Alternative or Complementary methods

Review the reasons for the ordering and use the intended complete revision policy. Evaluate evidence and consistency separately from a numeric rank lookup.

References

Calculation and input contract: epistemology/belief-priority-rank-gap — tool.io

Similar or alternative tools

Belief Retraction Priority Gap
Select the flagged minimum or maximum priority according to lowerIsEarlier, retaining the first tied index; return -1 and zero with defined false when none.
Belief Revision Explicit Priority Tag Tool
Record an explicit belief-revision priority and ordering source without selecting an epistemic entrenchment relation.