Shareholder Quorum Subsampling Coverage
Audit caller taxon draw order to a simple observed-frequency share quorum; explicitly not a full randomized shareholder-quorum subsampling algorithm with dominant-taxon and singleton coverage conventions.
Description
A frequency-share quorum accumulates observed abundance from taxa in a chosen order.
A frequency-share quorum accumulates observed abundance from taxa in a chosen order. Order affects how many taxa are selected.
Audit caller taxon draw order to a simple observed-frequency share quorum; explicitly not a full randomized shareholder-quorum subsampling algorithm with dominant-taxon and singleton coverage conventions.
When to use Shareholder Quorum Subsampling Coverage
Use this tool to audit caller taxon draw order to a simple observed-frequency share quorum; explicitly not a full randomized shareholder-quorum subsampling algorithm with dominant-taxon and singleton coverage conventions.
Prepare the fossil measurements or occurrence records and the chosen calibration parameters. Retain the stated coordinate, age and measurement conventions.
How to use Shareholder Quorum Subsampling Coverage and understand its results
- Prepare the fossil measurements or occurrence records and the chosen calibration parameters. Retain the stated coordinate, age and measurement conventions.
- Enter taxonAbundanceCounts, taxonDrawOrder, targetFrequencyShareQuorum using the field table and calculation rules, then run the tool.
- Read selectedTaxonIndexes, accumulatedFrequencyShare, quorumReached. The explanation below defines the units, signs, ordering and any flags or placeholder values.
- If the tool reports an input issue, correct the values and run it again. Apply the stated assumptions when interpreting a successfully returned result.
| Input field | Meaning | Value type; see rules below | Requirement |
|---|---|---|---|
| taxonAbundanceCounts | Taxon abundance counts | list of number | Required |
| taxonDrawOrder | Taxon draw order | list of number | Required |
| targetFrequencyShareQuorum | Target frequency share quorum | number | Required |
Use nonnegative integer abundances with positive total and a complete unique zero-based permutation of taxa. Skip zero counts and stop at a target share in (0,1], allowing a small floating-point boundary tolerance.1
accumulated share = Σ selected taxon counts/total counts Units, indexing, boundary conditions and exceptional cases are defined in the calculation rules above.
| Output field | Meaning | Value type |
|---|---|---|
| selectedTaxonIndexes | Selected taxon indexes | list of number |
| accumulatedFrequencyShare | Accumulated frequency share | number |
| quorumReached | Quorum reached | boolean |
{
"input": {
"taxonAbundanceCounts": [
1,
3,
6
],
"taxonDrawOrder": [
2,
1,
0
],
"targetFrequencyShareQuorum": 0.8
},
"output": {
"selectedTaxonIndexes": [
2,
1
],
"accumulatedFrequencyShare": 0.8999999999999999,
"quorumReached": true
}
}Limitations and assumptions
This is a supplied-order frequency audit, not full randomized shareholder-quorum subsampling.
Numbers and computed results must be finite; overflow produces an error. Numeric lists are limited to 100,000 entries; the rules above may require smaller limits. Missing required fields, extra fields, wrong value types and violations of the calculation rules are input errors. A successfully returned false flag is an evaluated outcome; its meaning is explained above.
Alternative or Complementary methods
Use Good's U Sample Coverage: Compute Good’s U=1-f1/N on positive observed abundance counts; coverage estimates sampled individual probability mass, not species completeness or a guarantee that rare taxa were found. For a complementary task, use Sampled-in-Bin Occurance Normalizer: Normalize sampled-in-bin occurrence counts by measured rock exposure and caller recovery probability, not by unequal bin duration alone; no unsampled-bin imputation.
References
-
Shareholder Quorum Subsampling Coverage — tool.io
Similar or alternative tools
- Good's U Sample Coverage
Compute Good’s U=1-f1/N on positive observed abundance counts; coverage estimates sampled individual probability mass, not species completeness or a guarantee that rare taxa were found.
- Sampled-in-Bin Occurance Normalizer
Normalize sampled-in-bin occurrence counts by measured rock exposure and caller recovery probability, not by unequal bin duration alone; no unsampled-bin imputation.