# vishaldharsan27-ux/marine_ai architecture

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

- Interactive diagram: https://gitdiagram.com/vishaldharsan27-ux/marine_ai
- Repository: https://github.com/vishaldharsan27-ux/marine_ai

## Overview

This repository currently exposes a command-line fisheries modeling workflow: running `main.py` loads fisheries and weather data, cleans fisheries records, reshapes them for modeling, then trains and evaluates a catch model. The README describes preprocessing and prediction capabilities, but the corresponding `src/ml/` files are absent from the supplied tree; their nodes therefore use null paths. The weather data directory is also only a documented placeholder, and no user-facing prediction service is implemented.

Main entry points: [`main.py`](https://github.com/vishaldharsan27-ux/marine_ai/blob/feature/species-dict/main.py) (Pipeline entry), [`data/raw/cmfri/Table_A-5.5.csv`](https://github.com/vishaldharsan27-ux/marine_ai/blob/feature/species-dict/data/raw/cmfri/Table_A-5.5.csv) (Catch statistics)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_inputs["Data inputs"]
  node_catch_data[("Catch statistics<br/>[Table_A-5.5.csv]")]
  node_weather_data[("Weather data")]
end

subgraph group_pipeline["Modeling pipeline"]
  node_entry["Pipeline entry<br/>[main.py]"]
  node_data_loading["Data loading"]
  node_cleaning["Data cleaning"]
  node_feature_engineering["Feature engineering"]
end

subgraph group_modeling["Catch modeling"]
  node_catch_model["Catch model"]
  node_evaluation["Model evaluation<br/>[main.py]"]
end

node_operator(("Pipeline operator"))

node_operator -->|"runs"| node_entry
node_entry -->|"loads data"| node_data_loading
node_catch_data -->|"supplies statistics"| node_data_loading
node_weather_data -->|"supplies weather"| node_data_loading
node_entry -->|"cleans fisheries"| node_cleaning
node_entry -->|"engineers features"| node_feature_engineering
node_entry -->|"trains model"| node_catch_model
node_entry -->|"evaluates model"| node_evaluation
node_catch_model -->|"provides trained model"| node_evaluation

click node_entry "https://github.com/vishaldharsan27-ux/marine_ai/blob/feature/species-dict/main.py"
click node_catch_data "https://github.com/vishaldharsan27-ux/marine_ai/blob/feature/species-dict/data/raw/cmfri/Table_A-5.5.csv"
click node_evaluation "https://github.com/vishaldharsan27-ux/marine_ai/blob/feature/species-dict/main.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_catch_data,node_weather_data toneBlue
class node_entry,node_data_loading,node_cleaning,node_feature_engineering toneAmber
class node_catch_model,node_evaluation toneMint
class node_operator toneIndigo
```

## Components

### Data inputs

- [Catch statistics](https://github.com/vishaldharsan27-ux/marine_ai/blob/feature/species-dict/data/raw/cmfri/Table_A-5.5.csv): `data/raw/cmfri/Table_A-5.5.csv`
- **Weather data**

### Modeling pipeline

- [Pipeline entry](https://github.com/vishaldharsan27-ux/marine_ai/blob/feature/species-dict/main.py): `main.py`
- **Data loading**
- **Data cleaning**
- **Feature engineering**

### Catch modeling

- **Catch model**
- [Model evaluation](https://github.com/vishaldharsan27-ux/marine_ai/blob/feature/species-dict/main.py): `main.py`

### Other components

- **Pipeline operator**

## Connections

- Pipeline operator → Pipeline entry: runs (evidence: `README.md`)
- Pipeline entry → Data loading: loads data (evidence: `main.py`)
- Catch statistics → Data loading: supplies statistics (evidence: `README.md`)
- Weather data → Data loading: supplies weather (evidence: `README.md`)
- Pipeline entry → Data cleaning: cleans fisheries (evidence: `main.py`)
- Pipeline entry → Feature engineering: engineers features (evidence: `main.py`)
- Pipeline entry → Catch model: trains model (evidence: `main.py`)
- Pipeline entry → Model evaluation: evaluates model (evidence: `main.py`)
- Catch model → Model evaluation: provides trained model (evidence: `main.py`)
