Length Record Ranking Comparator

Actual actual unique mapped cave length inventory competition ranking, ties and unknown evidence retained. Reference date/coverage and actual survey conventions external; not global authoritative record.

Description

Cave-length rankings require compatible, independently established record conventions.

Cave-length rankings require compatible, independently established record conventions.^[1]

Unknown records and ties should remain visible rather than forcing one complete ordered list.

When to use Length Record Ranking Comparator

Use this tool to obtain rankedKnownIds, competitionRanks, unknownIds from the supplied records using the stated calculation. Establish the survey or observation scope, reference frame, units and independently applicable calibration or qualified plan.

How to use Length Record Ranking Comparator and understand its results

Establish the survey or observation scope, reference frame, units and independently applicable calibration or qualified plan.
Enter actualCaveRecordIds, independentlyVerifiedRecordValuesMeters, recordEvidenceKnownFlags, using the field meanings and rules below, then run the tool.
Read rankedKnownIds alongside competitionRanks, and keep unknownIds separate. Ties share ranks and leave gaps after the tied group.
Correct any reported input issue and run again. Before using a successful result, check the stated units, signs, reference scope and observation coverage.

Input field	Meaning	Value type	Requirement
actualCaveRecordIds	Actual cave record ids	list of string	Required
independentlyVerifiedRecordValuesMeters	Independently verified record values meters	list of number	Required
recordEvidenceKnownFlags	Record evidence known flags; binary 1 means the matched observation is known, 0 means unknown	list of number	Required

Supply nonempty aligned unique nonblank record IDs, nonnegative finite values in metres and binary known flags. Rank only known records by descending value. Equal values receive the same competition rank, with gaps after ties; tied IDs retain input order. Return unknown IDs separately. No known records yields empty known rankings alongside unresolved IDs. The tool does not fetch records or check comparability.

rank_i=1+count(knownValues greater than value_i)

Use the matching field units and the exact boundary, ordering and reference rules above.

Output field	Meaning	Value type
result	Qualified observed calculation or explicit reference	object
result.rankedKnownIds	Known record identifiers sorted by descending value, with input order retained for ties.	list
result.competitionRanks	Descending competition ranks aligned with rankedKnownIds; ties share ranks and leave gaps.	list
result.unknownIds	Record identifiers whose contributions remain unknown, in supplied order.	list

json

{
  "input": {
    "actualCaveRecordIds": [
      "a",
      "b",
      "c"
    ],
    "independentlyVerifiedRecordValuesMeters": [
      10,
      10,
      3
    ],
    "recordEvidenceKnownFlags": [
      1,
      1,
      0
    ]
  },
  "output": {
    "result": {
      "rankedKnownIds": [
        "a",
        "b"
      ],
      "competitionRanks": [
        1,
        1
      ],
      "unknownIds": [
        "c"
      ]
    }
  }
}

Limitations and assumptions

The actual observation coverage, calibration and qualified plan determine applicability. A numerical result does not establish survey accuracy, route suitability, atmosphere conditions or equipment adequacy beyond the declared comparison.

Missing required fields, unknown fields, wrong types and violated rules return input issues. Numeric values and outputs must be finite. Lists and matrices must be dense, without missing cells. Numeric lists allow at most 10000 entries, subject to the narrower lengths and code rules above. String lists allow at most 128 entries of at most 128 UTF-16 units each; blank and duplicate rules are stated above. Extremely large composite outputs are rejected.

Alternative or Complementary methods

For a related step, use Cave System Total Length Aggregator: Mapped cave length counts unique physical passage segments under a declared survey convention. For a complementary comparison, use Mapped Length per Session Productivity Calculator: New unique mapped length per session summarizes a defined survey activity record.

References

Length Record Ranking Comparator — tool.io

Similar or alternative tools

Cave System Total Length Aggregator
Mapped cave length counts unique physical passage segments under a declared survey convention.
Mapped Length per Session Productivity Calculator
New unique mapped length per session summarizes a defined survey activity record.