Storage Location Support Share Tool

Description

Return distinct-sample location support.

Biobank administration tracks specimen IDs, source labels, storage addresses and inventory assertions. A check symbol, row-major index or supported-record count helps reconcile metadata while actual specimen identity, storage conditions and availability require verified records and physical controls.

Return distinct-sample location support.

When to use this tool

Use Storage Location Support Share when checking the stated biobank address, label, inventory or support convention.

How to use the tool and how it works

Enter sampleIds, locationIds, verifiedLocations, inventoryCurrent. 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 samples, supportedSamples, unlocatedSamples, share, defined. Inspect defined before interpreting the associated values.

Return distinct-sample location support. Require aligned arrays; support needs a nonempty location in verifiedLocations and current inventory, unlocatedSamples counts IDs lacking any nonempty location, share divides or is undefined for no samples.^[1]

Input field	Meaning and units	Accepted input
sampleIds	Sample 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.
inventoryCurrent	Inventory Current	Required. Array of boolean; maximum items 256.

Output field	Interpretation	Returned shape
samples	Samples	Required. Safe integer.
supportedSamples	Supported Samples	Required. Safe integer.
unlocatedSamples	Unlocated Samples	Required. Safe integer.
share	Dimensionless numerator/denominator ratio under the explicit basis above.	Required. Finite number.
defined	Whether the stated denominator or information basis supports this value; inspect placeholders before interpretation.	Required. Boolean.

json

{
  "input": {
    "sampleIds": [
      "a",
      "b"
    ],
    "locationIds": [
      "L1",
      ""
    ],
    "verifiedLocations": [
      "L1"
    ],
    "inventoryCurrent": [
      true,
      true
    ]
  },
  "output": {
    "samples": 2,
    "supportedSamples": 1,
    "unlocatedSamples": 1,
    "share": 0.5,
    "defined": true
  }
}

Limitations and assumptions

Any qualifying duplicate can support a sample; location and inventory assertions do not authenticate specimens or physical storage conditions.
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

Use the complete inventory/label format and verified physical records; inspect actual storage and specimen conditions under appropriate professional procedures.

References

Calculation and input contract: biobanking/storage-location-support-share — tool.io

Similar or alternative tools

Biofabrication Batch Sample Parent Pair
Compare a sample's supplied parent batch.
Biobank Specimen Matrix Unit Pair
Compare a specimen's supplied matrix and unit labels.