Skip to main content

No project description provided

Project description

fhir-query

Leveraging FHIR GraphDefinition for Data Traversals and Local Analysis


Overview

This project leverages FHIR GraphDefinition objects to define and execute graph-based traversals across multiple interconnected FHIR resource graphs. The data retrieved is written to a local SQLite database for persistence and later transformed into analyst-friendly dataframes for analysis using tools like Python’s pandas library.


Motivation

FHIR Search provides a robust querying framework but comes with significant limitations:

  1. Deep Chaining Limits:
    Chaining searches (e.g., Patient -> Observation -> Encounter -> Procedure) often hits server depth limitations.

  2. Inefficient Query Execution:
    Searching deeply related resources requires multiple chained requests, leading to performance issues and unnecessary round trips.

  3. Lack of Explicit Traversals:
    Relationships in FHIR are implicit in references (e.g., Observation.subject pointing to Patient). This implicit structure requires manual composition of queries, which is prone to errors.

By using FHIR GraphDefinition, we declaratively define resource relationships and efficiently retrieve data. Once retrieved, the data is stored locally and can be transformed into dataframes for advanced analysis.


Key Features

  • GraphDefinition-Driven Traversals: Use GraphDefinition objects to define explicit relationships between resources and automate traversal logic.
  • Local SQLite Storage: Persist the retrieved FHIR data in a local SQLite database for querying and offline analysis.
  • Analyst-Friendly Dataframes: Convert stored FHIR resources into pandas dataframes for ease of use in analytical workflows.
  • Reusable Graph Definitions: Maintain a library of GraphDefinition YAML files that can be reused across different workflows and projects.

Architecture

Components

  1. GraphDefinition Library

  2. Traversal Engine

    • Reads a GraphDefinition and iteratively queries the FHIR server using RESTful _include and _revinclude operations for efficiency.
    • Stores the retrieved resources in a SQLite database in JSON format for flexibility.
  3. SQLite Data Storage

    • Table Schema: see fhir_query.ResourceDB
  4. Analyst-Friendly DataFrames TODO

    • Transforms FHIR data from SQLite into pandas dataframes for easier analysis.
    • Data can be filtered, aggregated, or visualized to meet analytical use cases.

Workflow

  1. Load a GraphDefinition

    • Define a GraphDefinition object (e.g., study-to-documents) to specify the traversal path.
  2. Execute Traversal

    • Use the Traversal Engine to query the FHIR server based on the GraphDefinition.
    • Follow each link and include related resources efficiently using _include or _revinclude.
  3. Store Data Locally

    • Write the retrieved resources to the SQLite database with their resource types and full JSON representation.
  4. Transform to DataFrames TODO

    • Retrieve specific resource types or relationships from the SQLite database.
    • Convert the JSON data into structured pandas dataframes for analysis.

Usage

To use the fq command, you need to provide the necessary options. Below is an example of how to use the command:

fq --help
Usage: fq [OPTIONS] COMMAND [ARGS]...

  FHIR-Aggregator utilities.

Commands:
  ls          List all the installed GraphDefinitions.
  run         Run GraphDefinition queries.
  results     Work with the results of a GraphDefinition query.
  vocabulary  FHIR-Aggregator's key Resources and CodeSystems.

Examples:

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

fhir_aggregator_client-0.1.9.tar.gz (28.9 kB view details)

Uploaded Source

Built Distribution

fhir_aggregator_client-0.1.9-py3-none-any.whl (27.9 kB view details)

Uploaded Python 3

File details

Details for the file fhir_aggregator_client-0.1.9.tar.gz.

File metadata

  • Download URL: fhir_aggregator_client-0.1.9.tar.gz
  • Upload date:
  • Size: 28.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.0.0 CPython/3.12.1

File hashes

Hashes for fhir_aggregator_client-0.1.9.tar.gz
Algorithm Hash digest
SHA256 41a753f160b24bb90c6466faaec062ac3c075b929aeae6ab4f3d16a184c65316
MD5 bbe3dca201f11cb5d337458a72e46cab
BLAKE2b-256 c8c3839057625c6d4568d22971b6d297d4b8aef3e6c7a2a6260781813a86805f

See more details on using hashes here.

File details

Details for the file fhir_aggregator_client-0.1.9-py3-none-any.whl.

File metadata

File hashes

Hashes for fhir_aggregator_client-0.1.9-py3-none-any.whl
Algorithm Hash digest
SHA256 47f9f6f90ad1fd493bf5709884a8bc174d4e9bb30ac05f7c3e21c445fdd601e3
MD5 92a6af046a1e2ca9d929c5eef430706a
BLAKE2b-256 93892a7b5be56eceec647df3e63c205e753e504d31fde8d75124e905de9487f2

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page