How databricks-industry-solutions/pixels works
Pixels is a Databricks healthcare-imaging solution accelerator: it catalogs DICOM files, extracts and protects metadata, and supports SQL analysis, OHIF viewing, segmentation, and model workflows. The central documented path is catalog → metadata extraction → save for SQL access; interactive viewing and inference use separate app and serving paths. Gateway internals are represented where excerpts establish their role. Several broader capabilities, including training and anonymization, are documented in the README but their implementation details were not sampled.
Main entry points: dicom-web-gateway/app.py DICOMweb gateway · dicom-web/app.py OHIF viewer app · catalog.py DICOM catalog · dicom_meta_extractor.py Metadata extractors
Components 25
Ingest and protect
- DICOM catalog
src/dbx/pixels/catalog.py - Metadata extractors
src/dbx/pixels/dicom/dicom_meta_extractor.py - Metadata anonymizer
src/dbx/pixels/dicom/dicom_anonymizer_extractor.py - Image redaction
src/dbx/pixels/dicom/redactor/Redactor.py
Metadata analytics
- Catalog tables
src/dbx/pixels/catalog.py - SQL analysis
notebooks/DE-ID/DICOM - Catalog Dataset.py
Viewer and DICOMweb
- OHIF viewer app
apps/dicom-web/app.py - OHIF viewer client
apps/dicom-web/ohif/app-config.js - DICOMweb gateway
apps/dicom-web-gateway/app.py - QIDO search
apps/dicom-web-gateway/utils/handlers/_qido.py - WADO retrieval
apps/dicom-web-gateway/utils/handlers/_wado.py - STOW ingestion
apps/dicom-web-gateway/utils/handlers/_stow.py - NIfTI overlays
apps/dicom-web-gateway/utils/handlers/_nifti.py - Volume file I/O
apps/dicom-web-gateway/utils/dicom_io.py
AI workflows
- Model serving
src/dbx/pixels/modelserving/client.py - MONAI inference
models/monai/ModelServing.py - Model training
src/dbx/pixels/modeltraining/_training.py
Shared platform
- Shared app routes
src/dbx/pixels/common/routes.py - App middleware
src/dbx/pixels/common/middleware.py - Lakebase index
src/dbx/pixels/lakebase.py - SQL client
apps/dicom-web-gateway/utils/sql_client.py
Other components
- Imaging user
- Unity Catalog Volumes
- Databricks SQL warehouse
- Serving endpoint
Connections 27
- Imaging user → DICOM catalog: catalogs files
README.md - DICOM catalog → Metadata extractors: provides catalog
README.md - Metadata extractors → Catalog tables: saves metadata
README.md - Imaging user → SQL analysis: queries metadata
README.md - Metadata extractors → Metadata anonymizer: protects metadata
README.md - Imaging user → Image redaction: protects images
README.md - Imaging user → OHIF viewer client: views and labels
README.md - OHIF viewer client → OHIF viewer app: uses app
apps/dicom-web/app.py - OHIF viewer app → DICOMweb gateway: proxies DICOMweb
apps/dicom-web/app.py - DICOMweb gateway → QIDO search: routes search
apps/dicom-web-gateway/app.py - DICOMweb gateway → WADO retrieval: routes retrieval
apps/dicom-web-gateway/app.py - DICOMweb gateway → STOW ingestion: routes storage
apps/dicom-web-gateway/app.py - DICOMweb gateway → NIfTI overlays: routes overlays
apps/dicom-web-gateway/app.py - WADO retrieval → Volume file I/O: reads image bytes
- STOW ingestion → Volume file I/O: writes instances
apps/dicom-web-gateway/utils/handlers/_stow.py - Volume file I/O → Unity Catalog Volumes: reads and writes
apps/dicom-web-gateway/utils/dicom_io.py - DICOMweb gateway → SQL client: queries index
- SQL client → Databricks SQL warehouse: executes SQL
apps/dicom-web-gateway/utils/sql_client.py - DICOMweb gateway → Lakebase index: uses index cache
- Imaging user → Model serving: requests inference
README.md - Model serving → Serving endpoint: calls endpoint
- Serving endpoint → MONAI inference: runs model
README.md - Imaging user → Model training: launches training
README.md - OHIF viewer app → Shared app routes: shares app routes
apps/dicom-web/app.py - Shared app routes → Model serving: proxies inference
src/dbx/pixels/common/routes.py - OHIF viewer app → App middleware: configures requests
apps/dicom-web/app.py - DICOM catalog → Unity Catalog Volumes: indexes files
README.md