How monajemi-arman/simple-clinical-data-processing works
The product converts clinical CSVs and narrative text into a shared ClinicalOutput format, validates both result sets, and offers terminal or JSON-file output. Structured processing validates and maps lab/medication rows; narrative processing applies configured medSpaCy target rules and extracts entities and clinical facts. The main workflow is explicit in main.py. Some structured-loader internals are excerpted only partially, so the graph avoids detailing their unshown helper calls.
Main entry points: main.py Workflow runner · process_narrative.py Narrative extraction · process_structured.py CSV validation and mapping · structured Lab and medication CSVs
Components 13
Orchestration
- Workflow runner
src/simple_clinical_data_processing/main.py
Structured Data
- Lab and medication CSVs
data/structured - CSV validation and mapping
src/simple_clinical_data_processing/process_structured.py - Structured schemas
src/simple_clinical_data_processing/config.py
Narrative Data
- Clinical narratives
data/narrative - Narrative extraction
src/simple_clinical_data_processing/process_narrative.py - Target rules
config/target-rules.json - medSpaCy
Validation and Output
- Output schema
config/output-schema.json - Document validation
src/simple_clinical_data_processing/main.py - Clinical documents
src/simple_clinical_data_processing/main.py - Terminal and file output
src/simple_clinical_data_processing/main.py
Other components
- User
Connections 14
- User → Workflow runner: runs
README.md - Workflow runner → CSV validation and mapping: loads CSVs
src/simple_clinical_data_processing/main.py - Workflow runner → Narrative extraction: processes text
src/simple_clinical_data_processing/main.py - Lab and medication CSVs → CSV validation and mapping: reads rows
- CSV validation and mapping → Structured schemas: uses schemas
src/simple_clinical_data_processing/process_structured.py - Clinical narratives → Narrative extraction: reads text
src/simple_clinical_data_processing/process_narrative.py - Narrative extraction → Target rules: loads rules
src/simple_clinical_data_processing/process_narrative.py - Narrative extraction → medSpaCy: processes text
src/simple_clinical_data_processing/process_narrative.py - Workflow runner → Output schema: loads schema
src/simple_clinical_data_processing/main.py - Workflow runner → Document validation: validates results
src/simple_clinical_data_processing/main.py - CSV validation and mapping → Clinical documents: builds documents
src/simple_clinical_data_processing/process_structured.py - Narrative extraction → Clinical documents: builds documents
src/simple_clinical_data_processing/process_narrative.py - Document validation → Terminal and file output: offers results
src/simple_clinical_data_processing/main.py - User → Terminal and file output: chooses output
src/simple_clinical_data_processing/main.py