Nerve Trace Trigger Offset Token Tool

Description

Compute signed trace timing relative to a supplied trigger and offset, without a nerve-conduction interpretation.

Neurophysiological research records use sample coordinates, event clocks, epoch boundaries, references, signal amplitudes, and spectral bins. Timing conversions and support shares depend on rate, origin, exclusion, and boundary policies. Arithmetic on supplied values is separate from signal detection, validated acquisition, or neurological interpretation.

Compute signed trace timing relative to a supplied trigger and offset, without a nerve-conduction interpretation.

When to use this tool

Use Nerve Trace Trigger Offset Token when you need this research signal, sample, event, epoch, reference, or spectral component from supplied data.

How to use the tool and how it works

Enter sampleIndex, triggerIndex, samplePeriod, suppliedLatencyOffset. Use the units and conventions below.
Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
Read elapsed, correctedElapsed. Use the output convention below.

For positive samplePeriod return elapsed=(sampleIndex-triggerIndex)*samplePeriod and correctedElapsed=elapsed-suppliedLatencyOffset.^[1]

Input field	Meaning and units	Accepted input
sampleIndex	Sample Index	Required. Safe integer.
triggerIndex	Trigger Index	Required. Safe integer.
samplePeriod	Sample Period	Required. Finite number; strictly above 0.
suppliedLatencyOffset	Supplied Latency Offset	Required. Finite number.

Output field	Interpretation	Returned shape
elapsed	Elapsed	Required. Finite number.
correctedElapsed	Corrected Elapsed	Required. Finite number.

json

{
  "input": {
    "sampleIndex": 120,
    "triggerIndex": 100,
    "samplePeriod": 0.5,
    "suppliedLatencyOffset": 2
  },
  "output": {
    "elapsed": 10,
    "correctedElapsed": 8
  }
}

Limitations and assumptions

Indices are integer sample coordinates and period/offset need one time unit. Negative latencies are retained; triggers, acquisition delays, nerve physiology, and clinical event timing are not detected or validated.
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 calibrated acquisition and the intended signal-analysis protocol for a complete assessment. Verify sample rate, coordinate origin, clock offsets, reference configuration, filtering assumptions, and observation support.

References

Calculation and input contract: neurology/nerve-trace-trigger-offset-token — tool.io

Similar or alternative tools

Nerve Trace Stimulus Response Gap
Signed interval from supplied event sample indices after an explicit trigger-delay correction, without event detection or a diagnostic latency limit.
EEG Event Sample Index Offset Term
Relative event sample/time offset when both supplied indices share the same origin, which cancels in subtraction; sample frequency is explicit and offsets may be negative.