tooluniverse-pharmacokinetics

Computes pharmacokinetic parameters from concentration-time data using non-compartmental analysis.

1.7k|254|Updated Mar 3, 2025
One-click install
npx skills add https://github.com/mims-harvard/ToolUniverse --skill tooluniverse-pharmacokinetics
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tooluniverse-pharmacokinetics
Source: https://github.com/mims-harvard/ToolUniverse/tree/main/plugins/tooluniverse/skills/tooluniverse-pharmacokinetics
Command: npx skills add https://github.com/mims-harvard/ToolUniverse --skill tooluniverse-pharmacokinetics

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Turning raw plasma concentration-time measurements into standard pharmacokinetic parameters (Cmax, AUC, half-life, clearance, volume of distribution, bioavailability) requires careful trapezoidal integration, terminal-phase regression, and BLQ handling that is error-prone when done manually.

Core Features & Use Cases

  • Non-Compartmental Analysis (NCA): Computes Cmax, Tmax, AUC0-last, AUC0-inf, terminal half-life, clearance, volume of distribution, and MRT using the FDA/EMA linear-up/log-down trapezoidal method.
  • Absolute Bioavailability: Calculates F from IV and oral AUC data with dose normalization.
  • CSV-Based Local Analysis: The bundled nca_from_csv.py script processes concentration-time CSV files with explicit BLQ (below limit of quantification) handling.
  • Use Case: Given plasma concentrations measured at 0, 0.5, 1, 2, 4, 8, 12, and 24 hours after a 100 mg IV dose, compute the full PK parameter set and flag whether AUC extrapolation exceeds 20%.

Quick Start

Ask the agent to run NCA on your concentration-time data, for example: compute the pharmacokinetic parameters for these plasma concentrations measured over 24 hours after a 100 mg IV dose.

Frequently Asked Questions about tooluniverse-pharmacokinetics

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I calculate AUC and half-life from concentration-time data?

Run non-compartmental analysis with NCA_compute_parameters by passing arrays of times and concentrations plus dose and route. It returns AUC0-last, AUC0-inf, terminal half-life from log-linear regression, Cmax, Tmax, clearance, and volume of distribution.

How do I calculate absolute bioavailability from IV and oral data?

Use NCA_calculate_bioavailability with the oral AUC, oral dose, IV AUC, and IV dose. It computes F = (AUC_po / Dose_po) / (AUC_iv / Dose_iv), reported as a fraction or percentage.

How should BLQ values be handled in NCA analysis?

Treat leading BLQ samples before the first measurable concentration as zero, and drop BLQ values in the terminal tail rather than setting them to zero, which would corrupt the terminal slope. The nca_from_csv.py script applies this handling automatically.

Why are clearance and Vd from oral data called apparent?

Oral clearance and volume of distribution are reported as CL/F and Vd/F because absorption is incomplete and bioavailability is unknown without IV data. They should never be presented as true clearance or volume without intravenous reference data.

When is AUC0-infinity unreliable in non-compartmental analysis?

AUC0-inf is unreliable when the extrapolated portion exceeds 20% of the total AUC or when the terminal fit has r-squared below 0.9 or fewer than three terminal points. In those cases report AUC0-last and extend sampling.

Can NCA be used for multiple-dose or steady-state data?

NCA here assumes a single dose. For steady-state data, analyze one dosing interval as AUC0-tau and handle accumulation separately, stating the assumption explicitly in the report.