How maastrichtu-ids/cohort-explorer works
iCARE4CVD Cohort Explorer lets custodians upload and map cohort metadata, and lets scientists explore cohorts, analyze metadata, and configure Data Clean Rooms (DCRs). The main flow runs from the web UI through FastAPI routes to RDF metadata in a triplestore; selected cohort metadata is then used to provision a DCR through Decentriq. The graph preserves documented mapping, EDA, and no-code analysis branches. Backend route wiring is sampled; several feature details and the database implementation are documented but not present in the supplied tree.
Main entry points: pages Explorer UI · mapping.py Mapping API · decentriq.py DCR management · cohorts.tsx Cohort explorer
Components 21
Web experience
- Explorer UI
frontend/src/pages - Cohort explorer
frontend/src/pages/cohorts.tsx - Metadata upload
frontend/src/pages/upload.tsx - Mapping UI
frontend/src/pages/mapping.tsx - EDA dashboard
frontend/src/components/eda/EdaDashboard.tsx - No-code wizard
frontend/src/components/nocode/NocodeWizard.tsx
Backend services
- FastAPI application
backend/src/main.py - OAuth and sessions
backend/src/auth.py - Metadata ingestion
backend/src/upload.py - Explore API
backend/src/explore.py - Mapping API
backend/src/mapping.py - DCR management
backend/src/decentriq.py - Analysis API
backend/src/data_analysis.py
Metadata and mapping
- Cross-study linker
backend/CohortVarLinker/main.py - RDF triplestore
Analysis tools
- EDA services
backend/src/eda_scripts.py - No-code analysis
backend/src/nocode.py
External platforms
- Decentriq platform
- OHDSI Athena
Other components
- Data custodian
- Data scientist
Connections 25
- Data custodian → Explorer UI: uses
- Data scientist → Explorer UI: uses
- Explorer UI → OAuth and sessions: authenticates
- OAuth and sessions → Decentriq platform: OAuth
- Explorer UI → Metadata upload: uploads through
- Metadata upload → Metadata ingestion: sends metadata
- Metadata ingestion → RDF triplestore: writes RDF
- Explorer UI → Cohort explorer: explores through
- Cohort explorer → Explore API: requests metadata
- Explore API → RDF triplestore: queries
- Explorer UI → Mapping UI: maps through
- Mapping UI → Mapping API: submits mappings
- Mapping API → RDF triplestore: stores mappings
- Mapping API → OHDSI Athena: retrieves concepts
- Mapping API → Cross-study linker: generates mappings
- Explorer UI → EDA dashboard: views EDA
- EDA dashboard → EDA services: requests summaries
- Explorer UI → No-code wizard: configures analysis
- No-code wizard → No-code analysis: submits analysis
- No-code analysis → Decentriq platform: runs in DCR
- Explorer UI → DCR management: requests DCR
- DCR management → RDF triplestore: reads cohort metadata
- DCR management → Decentriq platform: provisions DCR
- Explorer UI → Analysis API: requests analysis
- Analysis API → Decentriq platform: accesses DCR