Metals-to-Colours Usage Ratio Calculator for Arms Set
Compare independently annotated same-basis metal/colour occurrence counts, excludes proper/fur/unclassified denominator.
Description
Metals and colours are tincture categories under a stated annotation scheme.
Metals and colours are tincture categories under a stated annotation scheme.1
An occurrence ratio excludes other categories unless the caller has assigned them explicitly.
When to use Metals-to-Colours Usage Ratio Calculator for Arms Set
Use this tool to calculate or review the supplied observations under the stated rules. Establish the source tradition, viewing frame, coordinate units and independently annotated features.
How to use Metals-to-Colours Usage Ratio Calculator for Arms Set and understand its results
- Establish the source tradition, viewing frame, coordinate units and independently annotated features.
- Enter annotatedMetalOccurrences, annotatedColourOccurrences, using the field meanings and rules below, then run the tool.
- Read result.metalToColourRatio, using the output meanings and calculation rules below.
- 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 |
|---|---|---|---|
| annotatedMetalOccurrences | Annotated metal occurrences | number | Required |
| annotatedColourOccurrences | Annotated colour occurrences | number | Required |
Use a nonnegative safe-integer metal occurrence count and a strictly positive safe-integer colour occurrence count. Return metal occurrences divided by colour occurrences.
metalColourRatio=metalOccurrences/colourOccurrences Use the matching field units and the exact boundary, ordering and reference rules above.
| Output field | Meaning | Value type |
|---|---|---|
| result | Calculated observation or reference | object |
| result.metalToColourRatio | metal To Colour Ratio | number |
{
"input": {
"annotatedMetalOccurrences": 6,
"annotatedColourOccurrences": 4
},
"output": {
"result": {
"metalToColourRatio": 1.5
}
}
}Limitations and assumptions
The denominator cannot be zero. This is an occurrence ratio, not area coverage or a tincture-rule verdict; furs and other categories are omitted from the supplied counts.
Missing required fields, unknown fields, wrong types and violated rules return input issues. Numeric values and outputs must be finite. Extremely large composite outputs are rejected.
Alternative or Complementary methods
For a related step, use Tincture Frequency Histogram Generator for a Roll: Tincture frequency can describe annotated occurrences in a declared corpus. For a complementary comparison, use Gules Dominance Percent in Roll Calculator: A roll-level gules share counts arms annotated as containing gules.
References
Similar or alternative tools
- Tincture Frequency Histogram Generator for a Roll
Tincture frequency can describe annotated occurrences in a declared corpus.
- Gules Dominance Percent in Roll Calculator
A roll-level gules share counts arms annotated as containing gules.