# mriosrivas/dsp-course-material architecture

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

- Interactive diagram: https://gitdiagram.com/mriosrivas/dsp-course-material
- Repository: https://github.com/mriosrivas/dsp-course-material

## Overview

##### Main Components Structure

a) Infrastructure Layer
- Docker Container (Anaconda3)
- Jupyter Notebook Server
- File System Mount Points

b) Core Components Layer
- Python Environment
- Key Libraries (NumPy, Matplotlib, Pandas)
- Data Storage (pickle files, .dat files)

c) Educational Modules Layer (arranged sequentially)
- Basic Concepts (Introduction, Statistics)
- Signal Processing Fundamentals (Decompositions, Convolution)
- Transform Domain (Fourier Transform, FFT)
- Filter Design (IIR, FIR, Moving Average, Windowed-Sinc)
- Applications (LMS Filter, Rock vs Metal Classification)

d) Data Layer
- Input Signals (.dat files)
- Images
- Datasets (CSV files)
- Cached Results (pickle files)

##### Key Relationships to Highlight

- Docker container → Jupyter server
- Jupyter server → Python environment
- Module dependencies (sequential flow from basic to advanced topics)
- Data flow between modules and storage
- Input/Output relationships for each module

##### Implementation Details

- Module independence (each topic is self-contained)
- Data flow patterns (raw data → processed results)
- Resource management (file system organization)
- Learning progression path

## Diagram (Mermaid)

```mermaid
graph TB
    subgraph Infrastructure
        DC[Docker Container]:::infra
        JS[Jupyter Server]:::infra
        FS[File System Mount]:::infra
        DC --> JS
        JS --> FS
    end

    subgraph Core
        PY[Python Environment]:::core
        LIB[NumPy/Matplotlib/Pandas]:::core
        JS --> PY
        PY --> LIB
    end

    subgraph "Educational Modules"
        direction TB
        BC["Basic Concepts"]:::module
        SPF["Signal Processing Fundamentals"]:::module
        TD["Transform Domain"]:::module
        FD["Filter Design"]:::module
        APP["Applications"]:::module

        BC --> SPF
        SPF --> TD
        TD --> FD
        FD --> APP

        subgraph "Basic Concepts Detail"
            INTRO["Introduction"]:::lesson
            STATS["Statistics"]:::lesson
        end

        subgraph "Signal Processing Detail"
            DECOMP["Decompositions"]:::lesson
            CONV["Convolution"]:::lesson
            RSUM["Running Sum"]:::lesson
        end

        subgraph "Transform Domain Detail"
            FT["Fourier Transform"]:::lesson
            CFT["Complex Fourier"]:::lesson
            FFT["Fast Fourier Transform"]:::lesson
        end

        subgraph "Filter Design Detail"
            IIR["IIR Filters"]:::lesson
            MA["Moving Average"]:::lesson
            WS["Windowed-Sinc"]:::lesson
        end

        subgraph "Applications Detail"
            LMS["LMS Filter"]:::lesson
            RVM["Rock vs Metal Classification"]:::lesson
        end
    end

    subgraph "Data Layer"
        IS["Input Signals"]:::data
        IMG["Images"]:::data
        DS["Datasets"]:::data
        CR["Cached Results"]:::data
    end

    %% Component connections
    PY --> BC
    IS --> CONV
    IS --> RSUM
    DS --> RVM
    IMG --> BC
    CR --> APP

    %% Click events
    click INTRO "https://github.com/mriosrivas/DSP-course-material/blob/main//00_Introduction/Introduction.ipynb"
    click STATS "https://github.com/mriosrivas/DSP-course-material/blob/main//01_Statistics/Statistics.ipynb"
    click DECOMP "https://github.com/mriosrivas/DSP-course-material/blob/main//02_Decompositions/Common Decompositions.ipynb"
    click CONV "https://github.com/mriosrivas/DSP-course-material/blob/main//03_Convolution/Convolution.ipynb"
    click RSUM "https://github.com/mriosrivas/DSP-course-material/blob/main//04_Running_Sum_and_First_Difference/Running_Sum_First_Difference.ipynb"
    click FT "https://github.com/mriosrivas/DSP-course-material/tree/main//05_Fourier_Transform"
    click CFT "https://github.com/mriosrivas/DSP-course-material/blob/main//06_Complex_Fourier_Transform/Complex Fourier Transform.ipynb"
    click FFT "https://github.com/mriosrivas/DSP-course-material/blob/main//07. Fast_Fourier_Transform/FFT.ipynb"
    click IIR "https://github.com/mriosrivas/DSP-course-material/blob/main//08. IIR Digital Filter Design/Digital Filters.ipynb"
    click MA "https://github.com/mriosrivas/DSP-course-material/blob/main//09. FIR Filter -Moving Average/Moving_Average.ipynb"
    click WS "https://github.com/mriosrivas/DSP-course-material/blob/main//10. FIR Filter -Windowed-Sinc Filters/FIR Filter - 1.Windowed-Sinc Filters.ipynb"
    click LMS "https://github.com/mriosrivas/DSP-course-material/blob/main//Project: LMS filter and ADALINE algorithm/LMS filter and ADALINE algorithm.ipynb"
    click RVM "https://github.com/mriosrivas/DSP-course-material/blob/main//Project: Rock vs Metal/Rock vs Metal.ipynb"
    click IS "https://github.com/mriosrivas/DSP-course-material/tree/main//03_Convolution/Signals/"
    click DS "https://github.com/mriosrivas/DSP-course-material/tree/main//Project: Rock vs Metal/Dataset/"

    %% Styling
    classDef infra fill:#a8d1f0
    classDef core fill:#b8e994
    classDef module fill:#f8c291
    classDef lesson fill:#f6e58d
    classDef data fill:#778beb

    %% Legend
    subgraph Legend
        L1[Infrastructure Component]:::infra
        L2[Core Component]:::core
        L3[Module]:::module
        L4[Lesson]:::lesson
        L5[Data Storage]:::data
    end
```
