Stable Argsort Indexes
Return stable ascending numeric argsort indexes, retaining equal-key original order without mutating values.
Description
Return stable ascending numeric argsort indexes, retaining equal-key original order without mutating values.
An argsort returns source indexes instead of rearranging the values themselves. Stable ties retain input order.
When to use this tool
Return stable ascending numeric argsort indexes, retaining equal-key original order without mutating values.
- Prepare the supplied values fields for this operation.
- Compare the complete example with the representation used by your own input before carrying the result into another step.
How to use the tool and how it works
- Enter values. Use the exact text syntax, units and index conventions explained below.
- Run the tool. If input validation fails, correct the supplied fields before interpreting any result.
- Read result.indexes. Interpret false, null and empty lists using the distinctions below; they can be valid outputs.
Sort indexes by ascending values, breaking equal-value ties by original index. Return that index list.1
| Input field | Meaning and representation | Accepted input |
|---|---|---|
| values | values. | List of finite numbers; at most 128 entries |
| Output field | Interpretation |
|---|---|
| result | Object containing the named outputs below. |
| result.indexes | The indexes list in the ordering and representation described above. |
{
"input": {
"values": [
30,
10,
10,
20
]
},
"output": {
"result": {
"indexes": [
1,
2,
3,
0
]
}
}
}Limitations and assumptions
- No descending, locale or custom comparison is used. The input list is not mutated.
- All declared input fields are required and unexpected top-level fields are rejected. Numbers must be finite; lists are limited to 128 entries and ordinary text fields to 8,192 UTF-16 code units, with tighter limits where stated.
- JSON text inputs must parse within bounded nesting and size limits. Numeric outputs outside the safe finite range are rejected; large exact integer results use decimal strings. Indexes and half-open spans are zero-based unless a rank is explicitly described as one-based.
Alternative or Complementary methods
Choose the tie policy and whether you need values, original indexes, sorted positions or one-based ranks. Use a complete sort verifier when a local stability or adjacent-comparison check is insufficient.
References
Similar or alternative tools
- Maximum Arg Tie Indexes
Return all original indexes tied at the numeric maximum; empty inputs yield null value and no witnesses.
- Minimum Arg Tie Indexes
Return all original indexes tied at the numeric minimum; empty inputs yield null value and no witnesses.