README.md

Hutch Cohort Discovery

Hutch Tools for working with the HDR UK Cohort Discovery Tool.

hutch-cohort-discovery/
├── app/
│   ├── 🐇 bunny/
│   ├── 🔄 Hutch.Relay/
│   └── 🔗 RQuestBridge/
└── lib/
    ├── 🎾 Hutch.Rackit/
    └── 📦 FiveSafes.Net/

Applications

🐇 Bunny

An HDR UK Cohort Discovery Task Resolver.

Fetches and resolves Availability and Distribution Queries against a PostgreSQL OMOP-CDM database.

🔄 Relay

A Federated Proxy for the HDR UK Cohort Discovery Tool's Task API.

• Connects to an upstream Task API (e.g. the HDR UK Cohort Discovery Tool).
• Fetches tasks.
• Queues them for one or more downstream sub nodes (e.g. Bunny instances).
• Accepts task results from the downstream nodes.
• Submits aggregate results to the upstream Task API.

Implements a subset of the Task API for the downstream nodes to interact with.

🔗 RquestBridge

An integration for the HDR UK Cohort Discovery Tool with the DARE UK TRE-FX architecture.

• Connects to an upstream Task API (e.g. the HDR UK Cohort Discovery Tool).
• Fetches tasks.
• Prepares a Five Safes RO-Crate to handle the task using the rquest-omop-worker workflow and Bunny CLI.
• Submits the prepared crate to a TRE-FX Submission Layer.
• Retrieves results from the TRE-FX Submission Layer and returns them to the upstream Task API.

Libraries

🎾 RACKit

RACKit is the RQuest API Client Kit, a .NET Library for interacting with the HDR UK Cohort Discovery Task API.

Samples

The samples/ directory contains a sample application showcasing the use of RACKit to connect to a Task API.

📦 FiveSafes.Net

A .NET library for working with the Five Safes RO-Crate profile.