Skip to content

TORCH Import

Extracts patient data from a TORCH server. Supports two modes: CRTDL-based extraction and direct TORCH URL import.

What it does

CRTDL mode (submit + poll + download):

  • Sends CRTDL query to TORCH
  • Polls for extraction completion
  • Downloads FHIR NDJSON data

Direct URL mode (poll + download):

  • Polls an existing TORCH extraction/result URL
  • Downloads FHIR NDJSON data when ready
  • Skips the extraction submission step

Configuration

yaml
services:
  torch:
    base_url: "https://your-torch-server.org"
    username: "your-username"
    password: "your-password"
    extraction_timeout_minutes: 30  # default
    polling_interval_seconds: 5     # default
    max_polling_interval_seconds: 30 # default

pipeline:
  enabled_steps:
    - torch

Usage

With CRTDL file

bash
aether pipeline start query.crtdl

With TORCH URL

bash
aether pipeline start "https://torch.example.com/fhir/extraction/result-123"

URLs containing /fhir/extraction/ or /fhir/result/ are automatically recognized as TORCH URLs. See the TORCH Integration guide for details.

Configuration Options

OptionTypeDefaultDescription
base_urlstring-TORCH server URL (required)
usernamestring-Authentication username
passwordstring-Authentication password
extraction_timeout_minutesint30Max wait time for extraction
polling_interval_secondsint5Initial status check interval
max_polling_interval_secondsint30Max interval (exponential backoff)

Healthcare data integration made simple