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:
-
Deep Chaining Limits:
Chaining searches (e.g.,Patient -> Observation -> Encounter -> Procedure
) often hits server depth limitations. -
Inefficient Query Execution:
Searching deeply related resources requires multiple chained requests, leading to performance issues and unnecessary round trips. -
Lack of Explicit Traversals:
Relationships in FHIR are implicit in references (e.g.,Observation.subject
pointing toPatient
). 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
-
GraphDefinition Library
- A collection of reusable GraphDefinition objects in JSON/YAML format. A GraphDefinition defines a traversal path between resources.
- See Example GraphDefinition, FHIR Devdays 2021
-
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.
- Reads a GraphDefinition and iteratively queries the FHIR server using RESTful
-
SQLite Data Storage
- Table Schema: see fhir_query.ResourceDB
-
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
-
Load a GraphDefinition
- Define a GraphDefinition object (e.g.,
study-to-documents
) to specify the traversal path.
- Define a GraphDefinition object (e.g.,
-
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
.
- Use the
-
Store Data Locally
- Write the retrieved resources to the SQLite database with their resource types and full JSON representation.
-
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:
- See Vocabulary
- See Patient SurvivalCurves
- See GraphDefinitions
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
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
Algorithm | Hash digest | |
---|---|---|
SHA256 |
41a753f160b24bb90c6466faaec062ac3c075b929aeae6ab4f3d16a184c65316
|
|
MD5 |
bbe3dca201f11cb5d337458a72e46cab
|
|
BLAKE2b-256 |
c8c3839057625c6d4568d22971b6d297d4b8aef3e6c7a2a6260781813a86805f
|
File details
Details for the file fhir_aggregator_client-0.1.9-py3-none-any.whl
.
File metadata
- Download URL: fhir_aggregator_client-0.1.9-py3-none-any.whl
- Upload date:
- Size: 27.9 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/5.0.0 CPython/3.12.1
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 |
47f9f6f90ad1fd493bf5709884a8bc174d4e9bb30ac05f7c3e21c445fdd601e3
|
|
MD5 |
92a6af046a1e2ca9d929c5eef430706a
|
|
BLAKE2b-256 |
93892a7b5be56eceec647df3e63c205e753e504d31fde8d75124e905de9487f2
|