# akmasin/computational-physics architecture

> Architecture diagram of the GitHub repository akmasin/computational-physics, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/akmasin/computational-physics
- Repository: https://github.com/akmasin/computational-physics

## Overview

This repository is a small collection of computational-physics projects, not one unified application. Its clearest user workflow is the prayer-time GUI: choose a date and city, calculate prayer times, and display them. A separate mechanics branch animates falling-stick simulations. The astronomy excerpts show the GUI-to-calculator and calculator-to-Julian-date-conversion calls; some related files are unsampled, so no connections are inferred for them.

Main entry points: [`Computational Astronomy (Komputasi Astronomi)/GUI 1.1.py`](https://github.com/akmasin/computational-physics/blob/master/Computational%20Astronomy%20(Komputasi%20Astronomi)/GUI%201.1.py) (Prayer-time GUI), [`Computational Astronomy (Komputasi Astronomi)/waktusholat.py`](https://github.com/akmasin/computational-physics/blob/master/Computational%20Astronomy%20(Komputasi%20Astronomi)/waktusholat.py) (Prayer-time calculator), [`Computational Astronomy (Komputasi Astronomi)/GUI 1.2.py`](https://github.com/akmasin/computational-physics/blob/master/Computational%20Astronomy%20(Komputasi%20Astronomi)/GUI%201.2.py) (Standalone GUI), [`Computational Astronomy (Komputasi Astronomi)/jdconverter.py`](https://github.com/akmasin/computational-physics/blob/master/Computational%20Astronomy%20(Komputasi%20Astronomi)/jdconverter.py) (Julian date conversion)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_prayer_ui["Prayer-time UI"]
  node_gui_11["Prayer-time GUI<br/>[GUI 1.1.py]"]
  node_gui_12["Standalone GUI<br/>[GUI 1.2.py]"]
end

subgraph group_astro_calc["Astronomy calculations"]
  node_city_data[("City workbook")]
  node_prayer_calc["Prayer-time calculator<br/>[waktusholat.py]"]
  node_jd_convert["Julian date conversion<br/>[jdconverter.py]"]
end

subgraph group_mechanics["Mechanics simulations"]
  node_falling_stick["Falling-stick simulation<br/>[Falling Stick.py]"]
  node_falling_stick_2["Alternate stick simulation<br/>[Falling Stick 2.py]"]
end

node_user(("User"))

node_user -->|"enters date and city"| node_gui_11
node_gui_11 -->|"reads city data"| node_city_data
node_gui_11 -->|"requests prayer times"| node_prayer_calc
node_prayer_calc -->|"reads city coordinates"| node_city_data
node_prayer_calc -->|"converts date"| node_jd_convert
node_user -->|"enters date and city"| node_gui_12
node_user -.->|"runs simulation"| node_falling_stick
node_user -.->|"runs simulation"| node_falling_stick_2

click node_gui_11 "https://github.com/akmasin/computational-physics/blob/master/Computational%20Astronomy%20(Komputasi%20Astronomi)/GUI%201.1.py"
click node_gui_12 "https://github.com/akmasin/computational-physics/blob/master/Computational%20Astronomy%20(Komputasi%20Astronomi)/GUI%201.2.py"
click node_prayer_calc "https://github.com/akmasin/computational-physics/blob/master/Computational%20Astronomy%20(Komputasi%20Astronomi)/waktusholat.py"
click node_jd_convert "https://github.com/akmasin/computational-physics/blob/master/Computational%20Astronomy%20(Komputasi%20Astronomi)/jdconverter.py"
click node_falling_stick "https://github.com/akmasin/computational-physics/blob/master/Mechanics/Falling%20Stick.py"
click node_falling_stick_2 "https://github.com/akmasin/computational-physics/blob/master/Mechanics/Falling%20Stick%202.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_gui_11,node_gui_12,node_user toneBlue
class node_city_data,node_prayer_calc,node_jd_convert toneAmber
class node_falling_stick,node_falling_stick_2 toneMint
```

## Components

### Prayer-time UI

- [Prayer-time GUI](https://github.com/akmasin/computational-physics/blob/master/Computational%20Astronomy%20(Komputasi%20Astronomi)/GUI%201.1.py): `Computational Astronomy (Komputasi Astronomi)/GUI 1.1.py`
- [Standalone GUI](https://github.com/akmasin/computational-physics/blob/master/Computational%20Astronomy%20(Komputasi%20Astronomi)/GUI%201.2.py): `Computational Astronomy (Komputasi Astronomi)/GUI 1.2.py`

### Astronomy calculations

- **City workbook**
- [Prayer-time calculator](https://github.com/akmasin/computational-physics/blob/master/Computational%20Astronomy%20(Komputasi%20Astronomi)/waktusholat.py): `Computational Astronomy (Komputasi Astronomi)/waktusholat.py`
- [Julian date conversion](https://github.com/akmasin/computational-physics/blob/master/Computational%20Astronomy%20(Komputasi%20Astronomi)/jdconverter.py): `Computational Astronomy (Komputasi Astronomi)/jdconverter.py`

### Mechanics simulations

- [Falling-stick simulation](https://github.com/akmasin/computational-physics/blob/master/Mechanics/Falling%20Stick.py): `Mechanics/Falling Stick.py`
- [Alternate stick simulation](https://github.com/akmasin/computational-physics/blob/master/Mechanics/Falling%20Stick%202.py): `Mechanics/Falling Stick 2.py`

### Other components

- **User**

## Connections

- User → Prayer-time GUI: enters date and city (evidence: `Computational Astronomy (Komputasi Astronomi)/GUI 1.1.py`)
- Prayer-time GUI → City workbook: reads city data (evidence: `Computational Astronomy (Komputasi Astronomi)/GUI 1.1.py`)
- Prayer-time GUI → Prayer-time calculator: requests prayer times (evidence: `Computational Astronomy (Komputasi Astronomi)/GUI 1.1.py`)
- Prayer-time calculator → City workbook: reads city coordinates (evidence: `Computational Astronomy (Komputasi Astronomi)/waktusholat.py`)
- Prayer-time calculator → Julian date conversion: converts date (evidence: `Computational Astronomy (Komputasi Astronomi)/waktusholat.py`)
- User → Standalone GUI: enters date and city (evidence: `Computational Astronomy (Komputasi Astronomi)/GUI 1.2.py`)
- User → Falling-stick simulation: runs simulation
- User → Alternate stick simulation: runs simulation
