Description
Let delta = sampleTime-phaseOrigin; phase is its remainder wrapped into [0,period), and cycle = floor(delta/period).
Endocrine sampling can be labeled relative to a declared periodic origin. Wrapped clock phase, cycle count and biological circadian phase are different concepts; a supplied offset or period is not a physiological measurement.
Let delta = sampleTime-phaseOrigin; phase is its remainder wrapped into [0,period), and cycle = floor(delta/period).
When to use this tool
Use Sampling Time Phase Offset when mapping a supplied sampling time onto a declared cycle.
How to use the tool and how it works
- Enter sampleTime, phaseOrigin, suppliedPeriod. Use the units and conventions below.
- Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
- Read phase, cycle. Use the output convention below.
Require positive suppliedPeriod. Let delta = sampleTime-phaseOrigin; phase is its remainder wrapped into [0,period), and cycle = floor(delta/period).1
| Input field | Meaning and units | Accepted input |
|---|---|---|
| sampleTime | Sample Time | Required. Finite number. |
| phaseOrigin | Phase Origin | Required. Finite number. |
| suppliedPeriod | Supplied Period | Required. Finite number; strictly above 0. |
| Output field | Interpretation | Returned shape |
|---|---|---|
| phase | Phase | Required. Finite number. |
| cycle | Cycle | Required. Finite number. |
{
"input": {
"sampleTime": 27,
"phaseOrigin": 10,
"suppliedPeriod": 12
},
"output": {
"phase": 5,
"cycle": 1
}
}Limitations and assumptions
- Use a common time unit and origin. This is a declared periodic coordinate, not an estimate of physiological circadian phase or hormone response.
- 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. Numeric signed-zero results are exported as zero.
Alternative or Complementary methods
Use an appropriate biological timing assessment and synchronized records when real circadian phase matters.
References
Similar or alternative tools
- Sample Clock Phase Known Offset
Return an offset-corrected sample clock phase only when the supplied offset is known.
- Sample Circadian Phase Fraction
Return phaseFraction as (sampleAt-cycleOrigin) wrapped modulo cycleDuration, divided by cycleDuration.