# nikil-crypto-spec/python-logic architecture

> Architecture diagram of the GitHub repository nikil-crypto-spec/python-logic, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-27). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/nikil-crypto-spec/python-logic
- Repository: https://github.com/nikil-crypto-spec/python-logic

## Overview

This is a single-file collection of Python data-analysis exercises, not a packaged application. Its clearest user-to-result workflow takes numeric bounds, creates random Pandas DataFrames, and prints statistics. The same script also demonstrates marks and salary calculations, collection operations, NumPy arrays, and Pandas employee, sales, and hospital analyses. All components share one source path; the README provides no further product detail.

Main entry points: [`logic.py`](https://github.com/nikil-crypto-spec/python-logic/blob/main/logic.py) (Script Workflow)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interactive["Random DataFrames"]
  node_get_input["Read Bounds<br/>[logic.py]"]
  node_script["Script Workflow<br/>[logic.py]"]
  node_create_df["Create DataFrame<br/>[logic.py]"]
  node_statistics["Calculate Statistics<br/>[logic.py]"]
end

subgraph group_basics["Core Exercises"]
  node_marks["Marks Summary<br/>[logic.py]"]
  node_salary["Salary Analysis<br/>[logic.py]"]
  node_collections["Collection Exercises<br/>[logic.py]"]
end

subgraph group_numpy["NumPy Examples"]
  node_arrays["Array Statistics<br/>[logic.py]"]
  node_matrix["Sales Matrix<br/>[logic.py]"]
end

subgraph group_pandas["Pandas Analysis"]
  node_employees["Employee Analysis<br/>[logic.py]"]
  node_sales["Sales Analysis<br/>[logic.py]"]
  node_hospital["Hospital Analysis<br/>[logic.py]"]
end

node_user(("User"))

node_user -->|"enters bounds"| node_get_input
node_get_input -->|"returns bounds"| node_script
node_script -->|"calls"| node_create_df
node_create_df -->|"returns DataFrame"| node_script
node_script -->|"calls with DataFrame"| node_statistics

click node_get_input "https://github.com/nikil-crypto-spec/python-logic/blob/main/logic.py"
click node_script "https://github.com/nikil-crypto-spec/python-logic/blob/main/logic.py"
click node_create_df "https://github.com/nikil-crypto-spec/python-logic/blob/main/logic.py"
click node_statistics "https://github.com/nikil-crypto-spec/python-logic/blob/main/logic.py"
click node_marks "https://github.com/nikil-crypto-spec/python-logic/blob/main/logic.py"
click node_salary "https://github.com/nikil-crypto-spec/python-logic/blob/main/logic.py"
click node_collections "https://github.com/nikil-crypto-spec/python-logic/blob/main/logic.py"
click node_arrays "https://github.com/nikil-crypto-spec/python-logic/blob/main/logic.py"
click node_matrix "https://github.com/nikil-crypto-spec/python-logic/blob/main/logic.py"
click node_employees "https://github.com/nikil-crypto-spec/python-logic/blob/main/logic.py"
click node_sales "https://github.com/nikil-crypto-spec/python-logic/blob/main/logic.py"
click node_hospital "https://github.com/nikil-crypto-spec/python-logic/blob/main/logic.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_get_input,node_script,node_create_df,node_statistics,node_user toneBlue
class node_marks,node_salary,node_collections toneAmber
class node_arrays,node_matrix toneMint
class node_employees,node_sales,node_hospital toneRose
```

## Components

### Random DataFrames

- [Read Bounds](https://github.com/nikil-crypto-spec/python-logic/blob/main/logic.py): `logic.py`
- [Script Workflow](https://github.com/nikil-crypto-spec/python-logic/blob/main/logic.py): `logic.py`
- [Create DataFrame](https://github.com/nikil-crypto-spec/python-logic/blob/main/logic.py): `logic.py`
- [Calculate Statistics](https://github.com/nikil-crypto-spec/python-logic/blob/main/logic.py): `logic.py`

### Core Exercises

- [Marks Summary](https://github.com/nikil-crypto-spec/python-logic/blob/main/logic.py): `logic.py`
- [Salary Analysis](https://github.com/nikil-crypto-spec/python-logic/blob/main/logic.py): `logic.py`
- [Collection Exercises](https://github.com/nikil-crypto-spec/python-logic/blob/main/logic.py): `logic.py`

### NumPy Examples

- [Array Statistics](https://github.com/nikil-crypto-spec/python-logic/blob/main/logic.py): `logic.py`
- [Sales Matrix](https://github.com/nikil-crypto-spec/python-logic/blob/main/logic.py): `logic.py`

### Pandas Analysis

- [Employee Analysis](https://github.com/nikil-crypto-spec/python-logic/blob/main/logic.py): `logic.py`
- [Sales Analysis](https://github.com/nikil-crypto-spec/python-logic/blob/main/logic.py): `logic.py`
- [Hospital Analysis](https://github.com/nikil-crypto-spec/python-logic/blob/main/logic.py): `logic.py`

### Other components

- **User**

## Connections

- User → Read Bounds: enters bounds
- Read Bounds → Script Workflow: returns bounds
- Script Workflow → Create DataFrame: calls
- Create DataFrame → Script Workflow: returns DataFrame
- Script Workflow → Calculate Statistics: calls with DataFrame