# khyjb1995/mms2017fall architecture

> Architecture diagram of the GitHub repository khyjb1995/mms2017fall, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/khyjb1995/mms2017fall
- Repository: https://github.com/khyjb1995/mms2017fall

## Overview

##### Project type and purpose
- This is an academic “assignments” monorepo containing three independent coding exercises:
- Assignment 1 and Assignment 3: C++ console applications (built with Microsoft Visual C++/MSBuild).
- Assignment 2: A Java Swing audio tone generator (built with IntelliJ/Gradle or IDE-generated project structure).
- Purpose: each directory implements a standalone algorithm or functionality (e.g., audio signal generation, image processing), complete with source code, input data (audio .wav, PGM images), and build outputs.

##### File structure
- Top-level directories:
- Assignment 0, 1, 2, 3 – each a self-contained project.
- README.md at root: generic placeholder.
- For C++ assignments (1 & 3):
- Source: *.cpp, *.h, stdafx.* precompiled headers.
- MSBuild project files: .sln, .vcxproj, filters, and build logs under x64/Debug.
- Inputs and outputs (Assignment 3 uses i1.pgm, i2.pgm).
- For Java assignment (2):
- src/com/tonegenerator/Main.java + Main.form (UI layout).
- audio resources under audio/ and compiled classes under out/production.
- IntelliJ metadata (.iml).
- No shared libraries or cross-assignment dependencies—each module is independently buildable.

##### README for additional insights
- The README contains only placeholder paragraphs, lists, and a markdown table/image link—no architecture hints.
- This confirms there’s no overarching service or runtime: it’s strictly a collection of homework projects.

a. Main components
- “Assignment 1 Module” (C++ build pipeline + runtime)
- “Assignment 2 Module” (Java Swing application + audio resource loader)
- “Assignment 3 Module” (C++ image processing pipeline)
- “Shared Repository Structure” (version control layer)
- “External Tools” (MSBuild, Visual Studio, IntelliJ IDEA)
b. Relationships and interactions
- Developer → Git Repo → Checkout → Build Tools → Module Builds → Run
- Input resources (audio files, PGM images) are consumed by the respective modules at runtime.
- Outputs (executables, processed images) are produced and optionally committed.
c. Architectural patterns or design principles
- Monorepo pattern: multiple isolated subprojects sharing a top-level repo.
- Standard build pipelines per language (C++ MSBuild vs. Java IDE build).
- Resource folder for static inputs (audio/ in Assignment 2, .pgm in Assignment 3).
d. Key technologies and frameworks
- Microsoft Visual C++ (vcxproj, .sln) for Assignments 1 & 3
- Java Swing and IntelliJ IDEA project model for Assignment 2
- Git for version control

## Diagram (Mermaid)

```mermaid
flowchart TD
  Developer["Developer"]:::repo
  Repo["Git Repository"]:::repo
  Developer --> Repo
  Workspace["Local Workspace"]:::repo
  Repo --> Workspace

  subgraph "Assignment 1 Module"
    direction TB
    A1_Solution["Assignment 1.sln"]:::cplus
    A1_Project["Assignment 1.vcxproj"]:::cplus
    A1_Filters["Assignment 1.vcxproj.filters"]:::cplus
    A1_Source["Assignment 1.cpp"]:::cplus
    A1_PCH_CPP["stdafx.cpp"]:::cplus
    A1_PCH_H["stdafx.h"]:::cplus
    A1_Targetver["targetver.h"]:::cplus
    A1_Output["Assignment 1.exe"]:::output
    Workspace -->|"checkout"| A1_Solution
    A1_Solution --> A1_Project --> A1_Filters
    A1_Project --> A1_Source --> A1_PCH_CPP --> A1_PCH_H --> A1_Targetver
    A1_Project -->|"msbuild"| A1_Output
  end

  subgraph "Assignment 2 Module"
    direction TB
    A2_IML["Assignment 2.iml"]:::java
    A2_Source["Main.java"]:::java
    A2_Form["Main.form"]:::java
    A2_Audio["Audio Resources (.wav)"]:::resource
    A2_Output["Compiled Classes"]:::output
    Workspace -->|"checkout"| A2_IML
    A2_IML --> A2_Source --> A2_Form
    A2_IML -->|"IDE Build"| A2_Output
    A2_Output --> A2_Audio
  end

  subgraph "Assignment 3 Module"
    direction TB
    A3_Solution["Assignment 1.sln"]:::cplus
    A3_Project["Assignment 1.vcxproj"]:::cplus
    A3_Filters["Assignment 1.vcxproj.filters"]:::cplus
    A3_Source["Assignment 1.cpp"]:::cplus
    A3_PCH_CPP["stdafx.cpp"]:::cplus
    A3_PCH_H["stdafx.h"]:::cplus
    A3_Targetver["targetver.h"]:::cplus
    A3_Img1["i1.pgm"]:::resource
    A3_Img2["i2.pgm"]:::resource
    A3_Img2p["i2p(SS).pgm"]:::resource
    A3_OutputExe["Assignment 1.exe"]:::output
    A3_OutImg1["i1.pgm"]:::output
    A3_OutImg2["i2.pgm"]:::output
    A3_OutImg2p["i2p(SS).pgm"]:::output
    Workspace -->|"checkout"| A3_Solution
    A3_Solution --> A3_Project --> A3_Filters
    A3_Project --> A3_Source --> A3_PCH_CPP --> A3_PCH_H --> A3_Targetver
    A3_Project -->|"msbuild"| A3_OutputExe
    A3_OutputExe --> A3_Img1 --> A3_OutImg1
    A3_OutputExe --> A3_Img2 --> A3_OutImg2
    A3_OutputExe --> A3_Img2p --> A3_OutImg2p
  end

  subgraph "External Tools"
    direction TB
    VS["Visual Studio / MSBuild"]:::tool
    IDEA["IntelliJ IDEA"]:::tool
    VS --> A1_Project
    VS --> A3_Project
    IDEA --> A2_IML
  end

  classDef cplus fill:#f9f,stroke:#333;
  classDef java fill:#9ff,stroke:#333;
  classDef resource fill:#ff9,stroke:#333;
  classDef output fill:#afa,stroke:#333;
  classDef tool fill:#cdf,stroke:#333;
  classDef repo fill:#fcf,stroke:#333;

  click A1_Solution "https://github.com/khyjb1995/mms2017fall/blob/master/Assignment 1/Assignment 1.sln"
  click A1_Project "https://github.com/khyjb1995/mms2017fall/blob/master/Assignment 1/Assignment 1/Assignment 1.vcxproj"
  click A1_Filters "https://github.com/khyjb1995/mms2017fall/blob/master/Assignment 1/Assignment 1/Assignment 1.vcxproj.filters"
  click A1_Source "https://github.com/khyjb1995/mms2017fall/blob/master/Assignment 1/Assignment 1/Assignment 1.cpp"
  click A1_PCH_CPP "https://github.com/khyjb1995/mms2017fall/blob/master/Assignment 1/Assignment 1/stdafx.cpp"
  click A1_PCH_H "https://github.com/khyjb1995/mms2017fall/blob/master/Assignment 1/Assignment 1/stdafx.h"
  click A1_Targetver "https://github.com/khyjb1995/mms2017fall/blob/master/Assignment 1/Assignment 1/targetver.h"
  click A1_Output "https://github.com/khyjb1995/mms2017fall/blob/master/Assignment 1/x64/Debug/Assignment 1.exe"

  click A2_IML "https://github.com/khyjb1995/mms2017fall/blob/master/Assignment 2/Assignment 2.iml"
  click A2_Source "https://github.com/khyjb1995/mms2017fall/blob/master/Assignment 2/src/com/tonegenerator/Main.java"
  click A2_Form "https://github.com/khyjb1995/mms2017fall/blob/master/Assignment 2/src/com/tonegenerator/Main.form"
  click A2_Audio "https://github.com/khyjb1995/mms2017fall/blob/master/Assignment 2/audio/*.wav"
  click A2_Output "https://github.com/khyjb1995/mms2017fall/tree/master/Assignment 2/out/production/Assignment 2/"

  click A3_Solution "https://github.com/khyjb1995/mms2017fall/blob/master/Assignment 3/Assignment 1.sln"
  click A3_Project "https://github.com/khyjb1995/mms2017fall/blob/master/Assignment 3/Assignment 1/Assignment 1.vcxproj"
  click A3_Filters "https://github.com/khyjb1995/mms2017fall/blob/master/Assignment 3/Assignment 1/Assignment 1.vcxproj.filters"
  click A3_Source "https://github.com/khyjb1995/mms2017fall/blob/master/Assignment 3/Assignment 1/Assignment 1.cpp"
  click A3_PCH_CPP "https://github.com/khyjb1995/mms2017fall/blob/master/Assignment 3/Assignment 1/stdafx.cpp"
  click A3_PCH_H "https://github.com/khyjb1995/mms2017fall/blob/master/Assignment 3/Assignment 1/stdafx.h"
  click A3_Targetver "https://github.com/khyjb1995/mms2017fall/blob/master/Assignment 3/Assignment 1/targetver.h"
  click A3_Img1 "https://github.com/khyjb1995/mms2017fall/blob/master/Assignment 3/Assignment 1/i1.pgm"
  click A3_Img2 "https://github.com/khyjb1995/mms2017fall/blob/master/Assignment 3/Assignment 1/i2.pgm"
  click A3_Img2p "https://github.com/khyjb1995/mms2017fall/blob/master/Assignment 3/Assignment 1/i2p(SS).pgm"
  click A3_OutputExe "https://github.com/khyjb1995/mms2017fall/blob/master/Assignment 3/x64/Debug/Assignment 1.exe"
  click A3_OutImg1 "https://github.com/khyjb1995/mms2017fall/blob/master/Assignment 3/x64/Debug/i1.pgm"
  click A3_OutImg2 "https://github.com/khyjb1995/mms2017fall/blob/master/Assignment 3/x64/Debug/i2.pgm"
  click A3_OutImg2p "https://github.com/khyjb1995/mms2017fall/blob/master/Assignment 3/x64/Debug/i2p(SS).pgm"
```
