Clinical Resources

Diagnostic Tests

Overview

The Diagnostic Tests section captures studies and investigations performed during care, such as imaging, cardiac studies, and pulmonary function tests, along with their findings.

Structuring these results connects a diagnosis to the evidence that supports it and gives downstream systems a clear record of what was ordered and what it showed.

Clinical Data in Source Documents

Diagnostic tests are typically documented in Assessment, Diagnostic Studies, or Impression sections, and sometimes inline within the History of Present Illness.

They usually pair a study name with a short interpretation, for example “pulmonary function test: moderate obstruction” or “echocardiogram: EF 45 percent”, and may include the date the study was performed.

JSON Output

During processing, the platform extracts each study into a structured JSON entry that records the test, its finding, and where it was documented.

Each diagnostic test includes:

• Name: The study or investigation performed.
• Result: The reported finding or interpretation.
• Section Reference: The document section the test was found under.
• Date Performed: When the study was carried out.
• Page Number: The source page, for traceability.

{
  "diagnostic_tests": [
    {
      "name": "Pulmonary function test",
      "result": "Moderate obstruction",
      "section_header": "Assessment",
      "date_performed": "2025-01-20",
      "page_number": 4
    }
  ]
}

FHIR Output

Each diagnostic test is mapped to a FHIR DiagnosticReport resource, which represents the study and carries its interpretation. Numeric or coded findings can additionally be represented as linked Observation resources.

Key mappings include:

• Name: Populated into DiagnosticReport.code.text.
• Result: Captured in DiagnosticReport.conclusion.
• Date Performed: Mapped to DiagnosticReport.effectiveDateTime.
• Patient Link: DiagnosticReport.subject references the patient.

{
  "fullUrl": "urn:uuid:7d2a9c14-3e56-4b78-9a01-2f6c8b5d1e40",
  "resource": {
    "resourceType": "DiagnosticReport",
    "status": "final",
    "code": {
      "text": "Pulmonary function test"
    },
    "subject": {
      "reference": "Patient/b17aaab1-311c-4d98-9c93-030277d0aeb0"
    },
    "effectiveDateTime": "2025-01-20",
    "conclusion": "Moderate obstruction"
  }
}