Nca Tools

Configuration File: nca_tools.json Tool Type: Local Tools Count: 3

This page contains all tools defined in the nca_tools.json configuration file.

Available Tools

NCA_calculate_bioavailability (Type: NCATool)

Calculate absolute oral bioavailability (F) from paired IV and PO pharmacokinetic study AUC value…

NCA_calculate_bioavailability tool specification

Tool Information:

  • Name: NCA_calculate_bioavailability

  • Type: NCATool

  • Description: Calculate absolute oral bioavailability (F) from paired IV and PO pharmacokinetic study AUC values and doses. Formula: F = (AUC_PO × Dose_IV) / (AUC_IV × Dose_PO). Classifies result as High (≥80%), Moderate (30–80%), Low (10–30%), or Very Low (<10%) with clinical interpretation. F > 20% is typically considered acceptable for small molecule oral drugs. F ≥ 80% required for bioequivalence. Use after NCA_compute_parameters to calculate AUC from raw time-concentration data for both IV and PO arms.

Parameters:

  • auc_po (number) (required) AUC from the oral (PO) arm. Must be in same units as auc_iv. Example: 2400 (ng/mL·h).

  • dose_po (number) (required) Dose administered orally. Must be in same units as dose_iv. Example: 100 (mg).

  • auc_iv (number) (required) AUC from the intravenous (IV) arm. Example: 3500 (ng/mL·h).

  • dose_iv (number) (required) Dose administered intravenously. Example: 50 (mg).

Example Usage:

query = {
    "name": "NCA_calculate_bioavailability",
    "arguments": {
        "auc_po": "example_value",
        "dose_po": "example_value",
        "auc_iv": "example_value",
        "dose_iv": "example_value"
    }
}
result = tu.run(query)

NCA_compute_parameters (Type: NCATool)

Perform Non-Compartmental Analysis (NCA) on time-concentration pharmacokinetic data. Computes key…

NCA_compute_parameters tool specification

Tool Information:

  • Name: NCA_compute_parameters

  • Type: NCATool

  • Description: Perform Non-Compartmental Analysis (NCA) on time-concentration pharmacokinetic data. Computes key PK parameters: Cmax (peak concentration), Tmax (time to peak), AUC0-t (area under curve to last measured point using linear-log trapezoidal method), AUC0-inf (extrapolated), terminal elimination half-life (t½), elimination rate constant (λz), clearance (CL), and volume of distribution (Vd) when dose is provided. Follows FDA/EMA NCA guidelines. Use this when you have raw plasma concentration vs. time data from a PK study. Output includes goodness of AUC extrapolation assessment.

Parameters:

  • times (array) (required) Time points in consistent units (hours recommended). Example: [0, 0.25, 0.5, 1, 2, 4, 8, 12, 24].

  • concentrations (array) (required) Plasma concentrations at each time point (same length as times). Example: [0, 150, 280, 220, 180, 120, 60, 30, 8].

  • dose ([‘number’, ‘null’]) (optional) Administered dose (optional). Required to calculate CL and Vd. Example: 100 (for 100 mg dose).

  • route ([‘string’, ‘null’]) (optional) Route of administration: ‘iv’ (default) or ‘po’. Affects Vd calculation formula.

  • dose_unit ([‘string’, ‘null’]) (optional) Unit of dose (default: ‘mg’). Examples: ‘mg’, ‘ug’, ‘nmol’.

  • conc_unit ([‘string’, ‘null’]) (optional) Unit of concentration (default: ‘ng/mL’). Examples: ‘ng/mL’, ‘ug/L’, ‘nM’.

  • time_unit ([‘string’, ‘null’]) (optional) Unit of time (default: ‘h’). Examples: ‘h’, ‘min’, ‘d’.

Example Usage:

query = {
    "name": "NCA_compute_parameters",
    "arguments": {
        "times": ["item1", "item2"],
        "concentrations": ["item1", "item2"]
    }
}
result = tu.run(query)

NCA_fit_one_compartment (Type: NCATool)

Fit a one-compartment IV bolus pharmacokinetic model (C(t) = C0 × exp(-k_el × t)) to plasma conce…

NCA_fit_one_compartment tool specification

Tool Information:

  • Name: NCA_fit_one_compartment

  • Type: NCATool

  • Description: Fit a one-compartment IV bolus pharmacokinetic model (C(t) = C0 × exp(-k_el × t)) to plasma concentration-time data using nonlinear least squares. Returns C0 (initial concentration), k_el (elimination rate constant), t½ (half-life), R², and when dose is provided: Vd (volume of distribution) and CL (clearance). Assumes mono-exponential decline — appropriate for drugs with rapid distribution and linear elimination. If R² < 0.85, consider a two-compartment model. Use NCA_compute_parameters for model-independent analysis.

Parameters:

  • times (array) (required) Time points after IV administration. Example: [0, 0.5, 1, 2, 4, 8, 12, 24].

  • concentrations (array) (required) Plasma concentrations at each time point. Example: [500, 380, 290, 170, 60, 8, 1.1, 0.1].

  • dose ([‘number’, ‘null’]) (optional) Administered IV dose. Required to calculate Vd and CL.

  • dose_unit ([‘string’, ‘null’]) (optional) Unit of dose (default: ‘mg’).

  • conc_unit ([‘string’, ‘null’]) (optional) Unit of concentration (default: ‘ng/mL’).

  • time_unit ([‘string’, ‘null’]) (optional) Unit of time (default: ‘h’).

Example Usage:

query = {
    "name": "NCA_fit_one_compartment",
    "arguments": {
        "times": ["item1", "item2"],
        "concentrations": ["item1", "item2"]
    }
}
result = tu.run(query)