Gules Dominance Percent in Roll Calculator
Per-arm binary gules presence percentage, not tincture-occurrence or surface-area proportion.
Description
A roll-level gules share counts arms annotated as containing gules.
A roll-level gules share counts arms annotated as containing gules.1
It is different from the fraction of painted surface that is red.
When to use Gules Dominance Percent in Roll Calculator
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 Gules Dominance Percent in Roll Calculator and understand its results
- Establish the source tradition, viewing frame, coordinate units and independently annotated features.
- Enter armorialGulesPresenceFlags, using the field meanings and rules below, then run the tool.
- Read result.armsContainingGulesPercent, 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 |
|---|---|---|---|
| armorialGulesPresenceFlags | Armorial gules presence flags | list of number | Required |
Supply a nonempty binary presence list, one entry per annotated arm. Sum the ones and divide by the list length, then multiply by one hundred.
gulesPresencePercent=100×ΣpresenceFlags/N 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.armsContainingGulesPercent | arms Containing Gules Percent | number |
{
"input": {
"armorialGulesPresenceFlags": [
1,
0,
1
]
},
"output": {
"result": {
"armsContainingGulesPercent": 66.66666666666666
}
}
}Limitations and assumptions
Presence is supplied, not detected. This is an arm-level proportion, not red area, occurrence frequency or a representative estimate beyond the declared roll.
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; ordinary string lists allow at most 128 strings of 128 UTF-16 units each; numeric matrices allow at most 128 rows and 128 columns, subject to narrower requirements above. 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 Metals-to-Colours Usage Ratio Calculator for Arms Set: Metals and colours are tincture categories under a stated annotation scheme.
References
Similar or alternative tools
- Tincture Frequency Histogram Generator for a Roll
Tincture frequency can describe annotated occurrences in a declared corpus.
- Metals-to-Colours Usage Ratio Calculator for Arms Set
Metals and colours are tincture categories under a stated annotation scheme.