Description
Compare sample reference-site labels and period-match flags.
Environmental-remediation bookkeeping uses explicit water, soil, dry-mass, concentration and sampling bases. A local mass residual, censored-result bound or supplied target margin does not identify a removal mechanism, establish representativeness or determine an environmentally acceptable contaminant level.
Compare sample reference-site labels and period-match flags.
When to use this tool
Use Remediation Reference Source Gap when checking the stated remediation measurement, mass/volume balance or support convention.
How to use the tool and how it works
- Enter sampleIds, referenceSiteIds, suppliedExpectedSiteIds, periodMatched. 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 referenceMismatches, periodMismatches, supportedSamples. Use the output convention below.
Compare sample reference-site labels and period-match flags. Require aligned arrays; count reference mismatches, false period flags and rows with both expected site equality and matched period.1
| Input field | Meaning and units | Accepted input |
|---|---|---|
| sampleIds | Sample Ids | Required. Array of text; maximum UTF-16 length 8192; maximum items 256. |
| referenceSiteIds | Reference Site Ids | Required. Array of text; maximum UTF-16 length 8192; maximum items 256. |
| suppliedExpectedSiteIds | Supplied Expected Site Ids | Required. Array of text; maximum UTF-16 length 8192; maximum items 256. |
| periodMatched | Period Matched | Required. Array of boolean; maximum items 256. |
| Output field | Interpretation | Returned shape |
|---|---|---|
| referenceMismatches | Reference Mismatches | Required. Safe integer. |
| periodMismatches | Period Mismatches | Required. Safe integer. |
| supportedSamples | Supported Samples | Required. Safe integer. |
{
"input": {
"sampleIds": [
"a",
"b"
],
"referenceSiteIds": [
"r1",
"r2"
],
"suppliedExpectedSiteIds": [
"r1",
"r1"
],
"periodMatched": [
true,
true
]
},
"output": {
"referenceMismatches": 1,
"periodMismatches": 0,
"supportedSamples": 1
}
}Limitations and assumptions
- Rows are not deduplicated; supplied flags do not establish an appropriate control site, analytical comparability or causal remediation effect.
- 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 verified sampling and analytical data, consistent material/unit bases and a complete transport or treatment model; involve qualified environmental professionals for practical or regulatory decisions.
References
Similar or alternative tools
- Contaminant Window Support Share
Return method-supported mass within a sampling window.
- Reference Site Ratio Gap
Compare a site/reference ratio with a supplied ratio.