Cycle Sampling Support Share Tool

Description

For exact selectedCycle matches sum all durations into recordedDuration and valid-row durations into supportedDuration; return expectedShare=supportedDuration/expectedDuration.

Physiological models use measured signals, reference levels, rates, and physical balances. A content difference, normalized phase, or energy term depends on its unit system and model assumptions. Supplied coefficients and annotations define the calculation but do not establish biological plausibility or measurement accuracy.

For exact selectedCycle matches sum all durations into recordedDuration and valid-row durations into supportedDuration; return expectedShare=supportedDuration/expectedDuration.

When to use this tool

Use Cycle Sampling Support Share when you need this explicit signal, content, phase, flow, or physical-balance term under compatible supplied units.

How to use the tool and how it works

Enter cycleIds, sampleDurations, valid, selectedCycle, expectedDuration. 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 supportedDuration, recordedDuration, expectedShare. Use the output convention below.

Require aligned cycleIds, nonnegative sampleDurations, and valid flags, plus positive expectedDuration. For exact selectedCycle matches sum all durations into recordedDuration and valid-row durations into supportedDuration; return expectedShare=supportedDuration/expectedDuration.^[1]

Input field	Meaning and units	Accepted input
cycleIds	Cycle Ids	Required. Array of text; maximum UTF-16 length 8192; maximum items 256.
sampleDurations	Sample Durations	Required. Array of finite number; minimum 0; maximum items 256.
valid	Valid	Required. Array of boolean; maximum items 256.
selectedCycle	Selected Cycle	Required. Text; maximum UTF-16 length 8192.
expectedDuration	Expected Duration	Required. Finite number; strictly above 0.

Output field	Interpretation	Returned shape
supportedDuration	Supported Duration	Required. Finite number.
recordedDuration	Recorded Duration	Required. Finite number.
expectedShare	Expected Share	Required. Finite number.

json

{
  "input": {
    "cycleIds": [
      "A",
      "A",
      "B"
    ],
    "sampleDurations": [
      2,
      3,
      5
    ],
    "valid": [
      true,
      false,
      true
    ],
    "selectedCycle": "A",
    "expectedDuration": 10
  },
  "output": {
    "supportedDuration": 2,
    "recordedDuration": 5,
    "expectedShare": 0.2
  }
}

Limitations and assumptions

Durations need one time unit. Overlapping samples are not merged and expectedShare can exceed one; the score measures supplied support rather than detecting cycles or validating the signal.
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

Choose a physiological and measurement model suited to the signal or experiment. Verify coefficients, unit conversions, baseline definitions, and sampling support before combining local terms.

References

Calculation and input contract: physiology/cycle-sampling-support-share — tool.io

Similar or alternative tools

Cycle Phase Relative Time
For positive cycleLength wrap eventAt-origin into a nonnegative phase below cycleLength and return fraction=phase/cycleLength.
Blood Flow Shear Rate Radius Factor
Ideal fully developed laminar Newtonian circular-tube wall shear-rate approximation, preserving signed flow and coherent units.