Description
Normalize each actual row independently with null for all cells of zero-support rows; undefined evidence is not converted to zero.
A confusion table uses actual labels as rows and predicted labels as columns. Cells can contain occurrence counts or supplied nonnegative weights; the axis label order must stay with the matrix. Row, column and joint normalization have different denominators, and a zero denominator needs an explicit undefined result.
Normalize each actual row independently with null for all cells of zero-support rows; undefined evidence is not converted to zero.
When to use this tool
Use this tool to normalize each actual row independently with null for all cells of zero-support rows; undefined evidence is not converted to zero.
How to use the tool and how it works
- Enter matrix, labels using the input definitions below.
- Run the operation. Resolve malformed-input errors before interpreting the result.
- Read result.rates. Interpret signs, units, ordering and null values using the rules below.
Validate the square nonnegative actual-row/predicted-column table. Divide each cell by its row sum; emit null for every cell in a zero-support row.1
| Input field | Meaning and units | Accepted input |
|---|---|---|
| matrix | Square nonnegative finite table: matrix[actualIndex][predictedIndex], both axes in labels order. | Dense list of at most 128 rows of at most 128 finite numbers; the operation’s shape constraints also apply. |
| labels | Distinct label strings defining actual row and predicted column order; score tools require at least one label. | Dense list of at most 128 strings, each at most 8,192 UTF-16 code units. |
| Output field | Interpretation |
|---|---|
| result | Object containing the fields below. |
| result.rates | Cells divided by their actual-row sum; every cell is null in a zero-support row. |
{
"input": {
"matrix": [
[
2,
1
],
[
0,
1
]
],
"labels": [
"a",
"b"
]
},
"output": {
"result": {
"rates": [
[
0.6666666666666666,
0.3333333333333333
],
[
0,
1
]
]
}
}
}Limitations and assumptions
- Rates describe supplied observations or weights, not calibrated population probabilities. Undefined support is retained as null.
- Label strings are compared exactly. Confusion values may be nonnegative fractional weights; a count interpretation requires count data. Probability-like score rows use [0,1] entries with sum tolerance 10⁻⁸, without establishing calibration.
- Every declared top-level input is required and unknown fields are rejected. Ordinary strings are limited to 8,192 UTF-16 code units and lists to 128 entries, with tighter operation-specific bounds where stated. JSON text has bounded nesting and node counts.
- Numeric outputs must be finite and within the absolute safe-integer magnitude; exact larger integers use decimal text. Source positions are zero-based UTF-16 offsets and span ends are exclusive unless a different convention is explicitly stated.
Alternative or Complementary methods
Check label coverage and axis order before comparing tables. Use a separate evaluation design for uncertainty, calibration, operating thresholds and the consequences of real-world decisions.
References
Similar or alternative tools
- Confusion Column Rate Table
Normalize each predicted column independently with null for zero-support columns; no calibrated probability claim.
- Confusion Joint Rate Table
Normalize joint observed weight by total support, preserving null on a zero-total table; does not estimate a joint population distribution.