Description
Count distinct boxes and distinct boxes with any nonempty listed verified location and manifest flag, dividing or returning zero with defined false for no boxes.
Laboratory study records distinguish observations, sample identities, personnel, and supporting sources. Missingness and duplication depend on record scope; a metadata check cannot establish scientific validity or regulatory acceptance.
Count distinct boxes and distinct boxes with any nonempty listed verified location and manifest flag, dividing or returning zero with defined false for no boxes.
When to use this tool
Use Archive Location Support Share when you need a laboratory-record consistency or source-support check.
How to use the tool and how it works
- Enter boxIds, locationIds, verifiedLocations, manifestPresent. Keep parallel arrays aligned. Use the units and conventions below.
- Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
- Read boxes, supportedBoxes, share, defined. Inspect defined before interpreting the associated values.
Require aligned boxIds, locationIds, and manifestPresent flags. Count distinct boxes and distinct boxes with any nonempty listed verified location and manifest flag, dividing or returning zero with defined false for no boxes.1
| Input field | Meaning and units | Accepted input |
|---|---|---|
| boxIds | Box Ids | Required. Array of text; maximum UTF-16 length 8192; maximum items 256. |
| locationIds | Location Ids | Required. Array of text; maximum UTF-16 length 8192; maximum items 256. |
| verifiedLocations | Verified Locations | Required. Array of text; maximum UTF-16 length 8192; maximum items 256. |
| manifestPresent | Manifest Present | Required. Array of boolean; maximum items 256. |
| Output field | Interpretation | Returned shape |
|---|---|---|
| boxes | Boxes | Required. Safe integer. |
| supportedBoxes | Supported Boxes | Required. Safe integer. |
| share | Dimensionless share on the numerator and denominator basis stated above. | Required. Finite number. |
| defined | Whether the stated denominator or normalization exists; inspect before interpreting a zero placeholder. | Required. Boolean. |
{
"input": {
"boxIds": [
"b1",
"b2"
],
"locationIds": [
"L1",
"L2"
],
"verifiedLocations": [
"L1"
],
"manifestPresent": [
true,
true
]
},
"output": {
"boxes": 2,
"supportedBoxes": 1,
"share": 0.5,
"defined": true
}
}Limitations and assumptions
- One supported row can cover a box with other unsupported rows; actual locations, manifests, archive completeness, and traceability are not independently verified.
- 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
Review the controlled study records and audit trail for the complete evidentiary chain. Resolve duplicate identifiers, sampling units, and authorization rules before drawing study-level conclusions.
References
Similar or alternative tools
- Archive Box Capacity Remainder
Use exact integer division and remainder to return fullBoxes and remainingRecords.
- Archive Container Span Budget
Subtract distinct unavailable slots and count repeated annotations separately.