Description
For positive period and radiansPerPeriod wrap signalPhase-referencePhase to the shortest signed phaseGap, subtracting one period when the wrapped gap exceeds half a period; return angularGap=phaseGap/period*radiansPerPeriod.
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 positive period and radiansPerPeriod wrap signalPhase-referencePhase to the shortest signed phaseGap, subtracting one period when the wrapped gap exceeds half a period; return angularGap=phaseGap/period*radiansPerPeriod.
When to use this tool
Use Signal Reference Phase Gap 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 signalPhase, referencePhase, period, radiansPerPeriod. Use the units and conventions below.
- Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
- Read phaseGap, angularGap. Use the output convention below.
For positive period and radiansPerPeriod wrap signalPhase-referencePhase to the shortest signed phaseGap, subtracting one period when the wrapped gap exceeds half a period; return angularGap=phaseGap/period*radiansPerPeriod.1
| Input field | Meaning and units | Accepted input |
|---|---|---|
| signalPhase | Signal Phase | Required. Finite number. |
| referencePhase | Reference Phase | Required. Finite number. |
| period | Positive full-cycle span in the phase coordinate unit. | Required. Finite number; strictly above 0. |
| radiansPerPeriod | Positive angular span assigned to one period; supply 2*pi for a full radian cycle. | Required. Finite number; strictly above 0. |
| Output field | Interpretation | Returned shape |
|---|---|---|
| phaseGap | Phase Gap | Required. Finite number. |
| angularGap | Angular Gap | Required. Finite number. |
{
"input": {
"signalPhase": 9,
"referencePhase": 1,
"period": 10,
"radiansPerPeriod": 6.283185307179586
},
"output": {
"phaseGap": -2,
"angularGap": -1.2566370614359172
}
}Limitations and assumptions
- Phase inputs and period share one coordinate unit. An exact half-period tie is positive, and radiansPerPeriod is supplied rather than assumed to be 2*pi; no phase extraction is performed.
- 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
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.
- Research Signal Baseline Shift
Compare supplied research signal baseline choices without physiological diagnosis.