# jenyapu/bioengineering-11-00596 architecture

> Architecture diagram of the GitHub repository jenyapu/bioengineering-11-00596, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-02-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/jenyapu/bioengineering-11-00596
- Repository: https://github.com/jenyapu/bioengineering-11-00596

## Overview

##### Project Type Analysis
This is a scientific data processing and analysis pipeline project, specifically designed for biomedical signal processing. The project processes ECG and seismocardiogram data to detect heart rates and calculate metrics.

##### Main Components

A. Data Layer:
- Input Data Sources (datasets/)
- CEBSDB Dataset
- Experiment Dataset
- Processed Data (datasets/processed/)
- Output Data (output/detection/)
- Derived Metrics
- Full Results

B. Processing Modules:
- Basic Module (modules/basic/)
- Constants
- Core Methods
- Visualization
- Experiment Module (modules/experiment/)
- Pipeline Processing
- Metrics Calculation
- Visualization
- Heart Rate Detection

**[Input Data Sources]**
- ↓
**[Basic Processing Module]**
- ↓
**[Experiment Processing Module]**
- ↓
**[Output Generation]**

##### Specific Elements

a. Data Flow Section:
- [Raw Datasets] → [Processed Datasets] → [Analysis Pipeline] → [Output Metrics]

b. Processing Pipeline:
- [Core Methods] → [Heart Rate Detection] → [Metrics Calculation] → [Results Visualization]

##### Important Details to Highlight

- Parallel processing of CEBSDB and Experiment datasets
- Metrics calculation flow for both datasets
- Visualization capabilities
- Relationship between ECG-based algorithms and seismocardiogram processing

##### Additional Recommendations

- Version information for key dependencies
- Error handling and validation flows
- Where parallel processing occurs
- Data validation checkpoints

Remember to include a reference to the original paper and any external dependencies that are crucial to the system's operation.

## Diagram (Mermaid)

```mermaid
graph TB
    subgraph Data_Sources
        CEBSDB[CEBSDB Dataset]:::data
        ExpData[Experiment Dataset]:::data
    end

    subgraph Processed_Data
        ProcCEBSDB["Processed CEBSDB"]:::data
        ProcExp["Processed Experiment"]:::data
    end

    subgraph Basic_Module
        Constants["Constants"]:::core
        CoreMethods["Core Methods"]:::core
        BasicVis["Basic Visualization"]:::vis
    end

    subgraph Experiment_Module
        Pipeline["Pipeline Processing"]:::process
        HRDetection["Heart Rate Detection"]:::process
        ExpVis["Experiment Visualization"]:::vis
        
        subgraph Metrics_Calculation
            MetricsCEBSDB["CEBSDB Metrics"]:::metrics
            MetricsExp["Experiment Metrics"]:::metrics
            MetricsSubject["Per Subject Metrics"]:::metrics
        end
    end

    subgraph Output_Generation
        DerivedMetrics["Derived Metrics"]:::output
        FullResults["Full Results"]:::output
        DetectionVis["Detection Visualizations"]:::vis
        CompPlots["Compilation Plots"]:::vis
    end

    %% Data flow connections
    CEBSDB --> ProcCEBSDB
    ExpData --> ProcExp
    
    ProcCEBSDB --> Pipeline
    ProcExp --> Pipeline
    
    Pipeline --> HRDetection
    HRDetection --> MetricsCEBSDB
    HRDetection --> MetricsExp
    HRDetection --> MetricsSubject
    
    MetricsCEBSDB --> DerivedMetrics
    MetricsExp --> DerivedMetrics
    MetricsSubject --> DerivedMetrics
    
    BasicVis --> ExpVis
    ExpVis --> DetectionVis
    ExpVis --> CompPlots
    
    %% Core dependencies
    Constants -.-> CoreMethods
    CoreMethods -.-> Pipeline
    CoreMethods -.-> HRDetection
    
    %% Style definitions
    classDef data fill:#b3e0ff,stroke:#333,stroke-width:2px
    classDef core fill:#98FB98,stroke:#333,stroke-width:2px
    classDef process fill:#90EE90,stroke:#333,stroke-width:2px
    classDef vis fill:#FFE4B5,stroke:#333,stroke-width:2px
    classDef metrics fill:#FFA07A,stroke:#333,stroke-width:2px
    classDef output fill:#DDA0DD,stroke:#333,stroke-width:2px

    %% Click events
    click ProcCEBSDB "https://github.com/JenyaPu/bioengineering-11-00596/tree/master/datasets/processed/cebsdb/"
    click ProcExp "https://github.com/JenyaPu/bioengineering-11-00596/tree/master/datasets/processed/experiment/"
    click Constants "https://github.com/JenyaPu/bioengineering-11-00596/blob/master/modules/basic/consts.py"
    click CoreMethods "https://github.com/JenyaPu/bioengineering-11-00596/blob/master/modules/basic/core_methods.py"
    click BasicVis "https://github.com/JenyaPu/bioengineering-11-00596/blob/master/modules/basic/visualization.py"
    click Pipeline "https://github.com/JenyaPu/bioengineering-11-00596/blob/master/modules/experiment/exp_pipeline.py"
    click HRDetection "https://github.com/JenyaPu/bioengineering-11-00596/blob/master/modules/experiment/exp_instant_hr.py"
    click ExpVis "https://github.com/JenyaPu/bioengineering-11-00596/blob/master/modules/experiment/exp_visualization.py"
    click MetricsCEBSDB "https://github.com/JenyaPu/bioengineering-11-00596/blob/master/modules/experiment/calc_metrics_cebsdb.py"
    click MetricsExp "https://github.com/JenyaPu/bioengineering-11-00596/blob/master/modules/experiment/calc_metrics_experiment.py"
    click MetricsSubject "https://github.com/JenyaPu/bioengineering-11-00596/blob/master/modules/experiment/calc_metrics_experiment_per_subject.py"
    click DerivedMetrics "https://github.com/JenyaPu/bioengineering-11-00596/tree/master/output/detection/derived/"
    click FullResults "https://github.com/JenyaPu/bioengineering-11-00596/tree/master/output/detection/full/"
    click DetectionVis "https://github.com/JenyaPu/bioengineering-11-00596/tree/master/images/detection/"
    click CompPlots "https://github.com/JenyaPu/bioengineering-11-00596/blob/master/modules/experiment/compilation_plot.py"
```
