Biospecimen Method Source Gap Tool

Description

Count biospecimen method/source record gaps.

Biomonitoring records connect specimens, analytical methods, observation durations and exposure windows. Literal matches and coverage shares describe supplied records, while specimen stability, actual exposure and the suitability of a health interpretation require independent measurement and professional assessment.

Count biospecimen method/source record gaps.

When to use this tool

Use Biospecimen Method Source Gap when checking the stated specimen record, timing or monitoring-support convention.

How to use the tool and how it works

Enter specimenIds, recordedMethods, requiredMethods, sourceIds. 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 methodMismatches, missingSources, sourcedMethodMatches. Use the output convention below.

Count biospecimen method/source record gaps. Require aligned specimen, recorded/required-method and source arrays; return literal method mismatch count, empty-source count and jointly matched/nonempty-source row count.^[1]

Input field	Meaning and units	Accepted input
specimenIds	Specimen Ids	Required. Array of text; maximum UTF-16 length 8192; maximum items 256.
recordedMethods	Recorded Methods	Required. Array of text; maximum UTF-16 length 8192; maximum items 256.
requiredMethods	Required Methods	Required. Array of text; maximum UTF-16 length 8192; maximum items 256.
sourceIds	Source Ids	Required. Array of text; maximum UTF-16 length 8192; maximum items 256.

Output field	Interpretation	Returned shape
methodMismatches	Method Mismatches	Required. Safe integer.
missingSources	Missing Sources	Required. Safe integer.
sourcedMethodMatches	Sourced Method Matches	Required. Safe integer.

json

{
  "input": {
    "specimenIds": [
      "a",
      "b"
    ],
    "recordedMethods": [
      "M1",
      "M2"
    ],
    "requiredMethods": [
      "M1",
      "M1"
    ],
    "sourceIds": [
      "s1",
      ""
    ]
  },
  "output": {
    "methodMismatches": 1,
    "missingSources": 1,
    "sourcedMethodMatches": 1
  }
}

Limitations and assumptions

Counts are per record, not distinct specimens; source presence does not authenticate a method or validate laboratory results.
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

Inspect verified collection and laboratory records and use an appropriate exposure/measurement analysis; seek qualified professional interpretation for health-related decisions.

References

Calculation and input contract: biomonitoring/biospecimen-method-source-gap — tool.io

Similar or alternative tools

Biomonitoring Sample Matrix Source Match
Compare sample matrix, source and method labels literally.
Biomonitoring Assay Method Bridge Gap Tool
Calculate biomonitoring assay method bridge gap from explicit caller-supplied inputs.