Description
Return source-language coverage in a bibliography.
Regional records connect place labels, language coverage, source vintages, calendar offsets and historical units. A literal label or supplied year offset can organize metadata without resolving changes in borders, calendar systems or naming authority. Unknown and ambiguous values must retain their explicit flags.
Return source-language coverage in a bibliography.
When to use this tool
Use Source Language Coverage Share when checking the stated regional record, period, hierarchy or text convention.
How to use the tool and how it works
- Enter bibliographyIds, languageLabels, targetLanguage. Follow any array-alignment requirements below. Use the units and conventions below.
- Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
- Read representedSources, totalSources, share, defined. Inspect defined before interpreting the associated values.
Return source-language coverage in a bibliography. Require aligned arrays and unique bibliography IDs; count target-language rows, divide by total sources or return zero with defined false when empty.1
| Input field | Meaning and units | Accepted input |
|---|---|---|
| bibliographyIds | Bibliography Ids | Required. Array of text; maximum UTF-16 length 8192; maximum items 256. |
| languageLabels | Language Labels | Required. Array of text; maximum UTF-16 length 8192; maximum items 256. |
| targetLanguage | Target Language | Required. Text; maximum UTF-16 length 8192. |
| Output field | Interpretation | Returned shape |
|---|---|---|
| representedSources | Represented Sources | Required. Safe integer. |
| totalSources | Total Sources | Required. Safe integer. |
| share | Dimensionless reported share using the selected denominator; not a probability estimate. | Required. Finite number. |
| defined | Whether the associated denominator or reporting quantity is defined; inspect before interpreting zero placeholders. | Required. Boolean. |
{
"input": {
"bibliographyIds": [
"S1",
"S2",
"S3"
],
"languageLabels": [
"L1",
"L2",
"L1"
],
"targetLanguage": "L1"
},
"output": {
"representedSources": 2,
"totalSources": 3,
"share": 0.6666666666666666,
"defined": true
}
}Limitations and assumptions
- Language labels and corpus coverage are supplied; no language detection, source quality or regional representativeness is established.
- Inputs must satisfy both the field types and the cross-field conditions above. Invalid input causes an error; a successful false flag or documented placeholder is a different result.
Alternative or Complementary methods
Consult the original sources, applicable calendar and historical naming/measurement authorities for geographic or historical interpretation.
References
Similar or alternative tools
- Regional Reference Period Share
Return reference-period share after excluded overlap duration.
- Regional Source Language Coverage Flag
Compare explicit requested and source language-code lists without inferring linguistic representativeness.