Description
Sum all volumes into totalVolume and selected valid-source volumes into sampledValidVolume; return their share when positive, otherwise zero with defined=false.
Laboratory records distinguish specimen identity, sampling coverage, retained quantities, processing times, image scale, and measurement uncertainty. Areas, volumes, counts, and source-support flags measure different aspects of a record. A local calculation does not identify tissue or establish diagnostic adequacy.
Sum all volumes into totalVolume and selected valid-source volumes into sampledValidVolume; return their share when positive, otherwise zero with defined=false.
When to use this tool
Use Tissue Block Sampling Share when you need this specimen-record, sampling, processing-time, dimensional, or uncertainty calculation.
How to use the tool and how it works
- Enter blockVolumes, selected, validSource. 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 totalVolume, sampledValidVolume, share, defined. Inspect defined before interpreting the associated values.
Require aligned nonnegative blockVolumes, selected, and validSource arrays. Sum all volumes into totalVolume and selected valid-source volumes into sampledValidVolume; return their share when positive, otherwise zero with defined=false.1
| Input field | Meaning and units | Accepted input |
|---|---|---|
| blockVolumes | Block Volumes | Required. Array of finite number; minimum 0; maximum items 256. |
| selected | Selected | Required. Array of boolean; maximum items 256. |
| validSource | Valid Source | Required. Array of boolean; maximum items 256. |
| Output field | Interpretation | Returned shape |
|---|---|---|
| totalVolume | Total Volume | Required. Finite number. |
| sampledValidVolume | Sampled Valid Volume | Required. Finite number. |
| share | Dimensionless share under the stated denominator; not a percent numeral. | Required. Finite number. |
| defined | Whether the associated denominator or quantity is defined; read before using a zero placeholder. | Required. Boolean. |
{
"input": {
"blockVolumes": [
2,
3,
5
],
"selected": [
true,
true,
false
],
"validSource": [
true,
false,
true
]
},
"output": {
"totalVolume": 10,
"sampledValidVolume": 2,
"share": 0.2,
"defined": true
}
}Limitations and assumptions
- Volumes and source flags are supplied and overlap is not removed. A volume-weighted share is not proof of representative tissue sampling, cellular composition, or diagnostic adequacy.
- 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.
- Numeric calculations use binary floating point unless exact decimal-integer arithmetic is explicitly stated. No hidden measurement tolerance or decimal rounding is added; nonfinite or out-of-contract results are rejected. Signed zero is exported as zero.
Alternative or Complementary methods
Use validated laboratory procedures, traceable measurements, and authenticated specimen records for a complete assessment. Check the relevant sampling and processing assumptions before interpreting a local quantity.
References
Similar or alternative tools
- Tissue Block Sampling Area Share
Return sampledUnion=first+second-overlap, sampledShare=union/blockArea, and remainingArea=blockArea-union.
- Slide Region Area Fraction
Compute a supplied research annotation area fraction without diagnostic classification.