Nonclinical Sample Time Gap Tool

Description

Compare explicit nonclinical sample clocks; no dose, clearance or exposure model.

Pharmacokinetic research describes concentration over time using measurement units and an explicit model. Concentration-time area, its time-weighted moment, inverse-time rate constants, clearance, and volume are related but distinct quantities. A conversion or local model term does not estimate every parameter or validate a complete study.

Compare explicit nonclinical sample clocks; no dose, clearance or exposure model.

When to use this tool

Use Nonclinical Sample Time Gap when you need this concentration-time conversion, sampling check, local integral panel, or explicitly supplied kinetic-model term.

How to use the tool and how it works

Enter plannedTimes, measuredTimes, suppliedOrigin. 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 plannedRelative, measuredRelative, timingResiduals. Use the output convention below.

Require equally sized plannedTimes and measuredTimes. Subtract suppliedOrigin from each array into plannedRelative and measuredRelative, and return timingResiduals=measured-planned.^[1]

Input field	Meaning and units	Accepted input
plannedTimes	Planned Times	Required. Array of finite number; maximum items 256.
measuredTimes	Measured Times	Required. Array of finite number; maximum items 256.
suppliedOrigin	Supplied Origin	Required. Finite number.

Output field	Interpretation	Returned shape
plannedRelative	Planned Relative	Required. Array of finite number; maximum items 256.
measuredRelative	Measured Relative	Required. Array of finite number; maximum items 256.
timingResiduals	Timing Residuals	Required. Array of finite number; maximum items 256.

json

{
  "input": {
    "plannedTimes": [
      10,
      20
    ],
    "measuredTimes": [
      11,
      19
    ],
    "suppliedOrigin": 5
  },
  "output": {
    "plannedRelative": [
      5,
      15
    ],
    "measuredRelative": [
      6,
      14
    ],
    "timingResiduals": [
      1,
      -1
    ]
  }
}

Limitations and assumptions

All times need one unit and origin. Empty lists and unordered times are accepted; this does not match samples, estimate clock drift, or validate a sampling protocol.
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

Use a complete study analysis when a local panel, transformation, or model factor is insufficient. Check sampling times, censoring, assay support, unit conventions, and the validity of the assumed kinetic regime.

References

Calculation and input contract: pharmacokinetics/nonclinical-sample-time-gap — tool.io

Similar or alternative tools

Concentration Time Unit Factor
Convert an already supplied nonclinical concentration-time quantity using explicit compatible unit factors.
Nonclinical Concentration Logstep
Compare explicitly supplied nonclinical concentration observations without dosing or extrapolated patient predictions.