CLhepResponse

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/ivive-app/json-schema/ivive-app-clhep-response-schema.json",
  "title": "CLhepResponse",
  "x-generated": "2026-11-12",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/ivive-app-openapi.json#/components/schemas/CLhepResponse",
  "properties": {
    "clhep": {
      "type": "number",
      "title": "Clhep",
      "description": "Predicted hepatic clearance (mL/min/kg)."
    },
    "eh": {
      "type": "number",
      "title": "Eh",
      "description": "Hepatic extraction ratio (0–1). EH = CLhep / Qh."
    },
    "classification": {
      "type": "string",
      "title": "Classification",
      "description": "Clearance class: 'high' (EH>0.7), 'medium' (0.3≤EH≤0.7), 'low' (EH<0.3)."
    },
    "model_used": {
      "type": "string",
      "title": "Model Used",
      "description": "Model actually applied (reflects default when omitted in request)."
    },
    "species": {
      "type": "string",
      "title": "Species",
      "description": "Species used for physiological parameters."
    },
    "clint_scaled": {
      "type": "number",
      "title": "Clint Scaled",
      "description": "CLint scaled to the whole liver (mL/min/kg), before fu_mic."
    },
    "clint_u": {
      "type": "number",
      "title": "Clint U",
      "description": "Unbound scaled CLint = clint_scaled / fu_mic (mL/min/kg)."
    },
    "fu_b": {
      "type": "number",
      "title": "Fu B",
      "description": "Unbound fraction in blood = fu_p / Rb."
    },
    "qh": {
      "type": "number",
      "title": "Qh",
      "description": "Hepatic blood flow (mL/min/kg)."
    },
    "clp": {
      "type": "number",
      "title": "Clp",
      "description": "Predicted plasma clearance = CLhep × Rb (mL/min/kg). Uncorrected."
    },
    "clp_corrected": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Clp Corrected",
      "description": "Plasma CL after the lab correction (mL/min/kg). Null without correction_id."
    },
    "band": {
      "anyOf": [
        {
          "$ref": "#/$defs/ObservedBand"
        },
        {
          "type": "null"
        }
      ],
      "description": "Range holding observed plasma CL for 50% of calibration compounds at this prediction. Null outside the calibration domain (see flags)."
    },
    "upper_bound": {
      "type": "boolean",
      "title": "Upper Bound",
      "description": "True when clint_censored was set: clhep, eh, clp and clp_corrected are upper bounds, not estimates.",
      "default": false
    },
    "flags": {
      "items": {
        "$ref": "#/$defs/DomainFlag"
      },
      "type": "array",
      "title": "Flags",
      "description": "Applicability-domain warnings."
    }
  },
  "type": "object",
  "required": [
    "clhep",
    "eh",
    "classification",
    "model_used",
    "species",
    "clint_scaled",
    "clint_u",
    "fu_b",
    "qh",
    "clp"
  ],
  "$defs": {
    "DomainFlag": {
      "properties": {
        "code": {
          "type": "string",
          "title": "Code",
          "description": "fu_p_below_0.01 | renal_possible | species_not_calibrated | outside_correction_range | clint_below_loq"
        },
        "message": {
          "type": "string",
          "title": "Message"
        }
      },
      "type": "object",
      "required": [
        "code",
        "message"
      ],
      "title": "DomainFlag"
    },
    "ObservedBand": {
      "properties": {
        "low": {
          "type": "number",
          "title": "Low",
          "description": "Lower bound of observed plasma CL (mL/min/kg)."
        },
        "high": {
          "type": "number",
          "title": "High",
          "description": "Upper bound of observed plasma CL (mL/min/kg)."
        },
        "coverage": {
          "type": "number",
          "title": "Coverage",
          "description": "Fraction of calibration compounds whose observed CL fell inside (0.5)."
        },
        "basis": {
          "type": "string",
          "enum": [
            "reference",
            "lab"
          ],
          "title": "Basis",
          "description": "reference: 301 human drugs, around the uncorrected prediction; lab: the correction's compounds, around the corrected prediction."
        },
        "n": {
          "type": "integer",
          "title": "N",
          "description": "Number of calibration compounds."
        }
      },
      "type": "object",
      "required": [
        "low",
        "high",
        "coverage",
        "basis",
        "n"
      ],
      "title": "ObservedBand"
    }
  }
}