# 4db444/used_car_price_predictor architecture

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

- Interactive diagram: https://gitdiagram.com/4db444/used_car_price_predictor
- Repository: https://github.com/4db444/used_car_price_predictor

## Overview

This is a Python used-car data analysis and feature-preparation toolkit, not a complete prediction application: the tree has no implemented app or model code, and the README is empty. Its available workflow covers loading data, cleaning it, engineering and encoding features, analysis, and visualizations. The source exports these operations but shows no central pipeline connecting them, so the graph includes only evidenced calls and writes; loader and saver implementations were not sampled.

Main entry points: [`src/__init__.py`](https://github.com/4db444/used_car_price_predictor/blob/master/src/__init__.py) (Public exports), [`src/visualization`](https://github.com/4db444/used_car_price_predictor/tree/master/src/visualization) (Visualization functions), [`src/data/explore.py`](https://github.com/4db444/used_car_price_predictor/blob/master/src/data/explore.py) (Dataset analysis), [`src/data/preprocess.py`](https://github.com/4db444/used_car_price_predictor/blob/master/src/data/preprocess.py) (Data cleaning)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_input["Data access"]
  node_loader["Data loader<br/>[laod_data.py]"]
  node_raw["Raw CSV<br/>[data.csv]"]
end

subgraph group_prep["Data preparation"]
  node_clean["Data cleaning<br/>[preprocess.py]"]
  node_features["Feature creation<br/>[create_features.py]"]
  node_encoding["Feature encoding<br/>[encode_features.py]"]
end

subgraph group_analysis["Analysis"]
  node_analysis["Dataset analysis<br/>[explore.py]"]
  node_visuals["Visualization functions"]
  node_heatmap["Heatmap<br/>[heatmap.py]"]
  node_histogram["Histogram<br/>[histogram.py]"]
  node_scatter["Scatter plot<br/>[scatter_plot.py]"]
end

subgraph group_outputs["Artifacts"]
  node_saver["Data saver<br/>[save_data.py]"]
  node_processed["Processed CSVs"]
  node_reports["Analysis reports"]
  node_figures["Saved figures"]
end

node_user(("Toolkit user"))
node_api["Public exports<br/>[__init__.py]"]

node_user -->|"uses"| node_api
node_api -->|"exports"| node_loader
node_api -->|"exports"| node_clean
node_api -->|"exports"| node_features
node_api -->|"exports"| node_encoding
node_api -->|"exports"| node_analysis
node_api -->|"exports"| node_saver
node_api -->|"exports"| node_visuals
node_clean -.-> node_raw
node_features -.->|"creates features from"| node_clean
node_encoding -.->|"encodes"| node_features
node_analysis -->|"writes CSVs"| node_reports
node_analysis -.->|"analyzes data for"| node_visuals
node_visuals -->|"includes"| node_heatmap
node_visuals -->|"includes"| node_histogram
node_visuals -->|"includes"| node_scatter
node_heatmap -->|"saves figure"| node_figures
node_histogram -->|"saves figure"| node_figures
node_scatter -->|"saves figure"| node_figures
node_loader -.->|"reads"| node_raw
node_saver -.->|"writes"| node_processed

click node_api "https://github.com/4db444/used_car_price_predictor/blob/master/src/__init__.py"
click node_loader "https://github.com/4db444/used_car_price_predictor/blob/master/src/data/laod_data.py"
click node_raw "https://github.com/4db444/used_car_price_predictor/blob/master/data/raw/data.csv"
click node_clean "https://github.com/4db444/used_car_price_predictor/blob/master/src/data/preprocess.py"
click node_features "https://github.com/4db444/used_car_price_predictor/blob/master/src/feature_engineering/create_features.py"
click node_encoding "https://github.com/4db444/used_car_price_predictor/blob/master/src/feature_engineering/encode_features.py"
click node_analysis "https://github.com/4db444/used_car_price_predictor/blob/master/src/data/explore.py"
click node_visuals "https://github.com/4db444/used_car_price_predictor/tree/master/src/visualization"
click node_heatmap "https://github.com/4db444/used_car_price_predictor/blob/master/src/visualization/heatmap.py"
click node_histogram "https://github.com/4db444/used_car_price_predictor/blob/master/src/visualization/histogram.py"
click node_scatter "https://github.com/4db444/used_car_price_predictor/blob/master/src/visualization/scatter_plot.py"
click node_saver "https://github.com/4db444/used_car_price_predictor/blob/master/src/data/save_data.py"
click node_processed "https://github.com/4db444/used_car_price_predictor/tree/master/data/processed"
click node_reports "https://github.com/4db444/used_car_price_predictor/tree/master/reports"
click node_figures "https://github.com/4db444/used_car_price_predictor/tree/master/reports/figures"

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_loader,node_raw,node_user toneBlue
class node_clean,node_features,node_encoding toneAmber
class node_analysis,node_visuals,node_heatmap,node_histogram,node_scatter toneMint
class node_saver,node_processed,node_reports,node_figures toneRose
class node_api toneTeal
```

## Components

### Data access

- [Data loader](https://github.com/4db444/used_car_price_predictor/blob/master/src/data/laod_data.py): `src/data/laod_data.py`
- [Raw CSV](https://github.com/4db444/used_car_price_predictor/blob/master/data/raw/data.csv): `data/raw/data.csv`

### Data preparation

- [Data cleaning](https://github.com/4db444/used_car_price_predictor/blob/master/src/data/preprocess.py): `src/data/preprocess.py`
- [Feature creation](https://github.com/4db444/used_car_price_predictor/blob/master/src/feature_engineering/create_features.py): `src/feature_engineering/create_features.py`
- [Feature encoding](https://github.com/4db444/used_car_price_predictor/blob/master/src/feature_engineering/encode_features.py): `src/feature_engineering/encode_features.py`

### Analysis

- [Dataset analysis](https://github.com/4db444/used_car_price_predictor/blob/master/src/data/explore.py): `src/data/explore.py`
- [Visualization functions](https://github.com/4db444/used_car_price_predictor/tree/master/src/visualization): `src/visualization`
- [Heatmap](https://github.com/4db444/used_car_price_predictor/blob/master/src/visualization/heatmap.py): `src/visualization/heatmap.py`
- [Histogram](https://github.com/4db444/used_car_price_predictor/blob/master/src/visualization/histogram.py): `src/visualization/histogram.py`
- [Scatter plot](https://github.com/4db444/used_car_price_predictor/blob/master/src/visualization/scatter_plot.py): `src/visualization/scatter_plot.py`

### Artifacts

- [Data saver](https://github.com/4db444/used_car_price_predictor/blob/master/src/data/save_data.py): `src/data/save_data.py`
- [Processed CSVs](https://github.com/4db444/used_car_price_predictor/tree/master/data/processed): `data/processed`
- [Analysis reports](https://github.com/4db444/used_car_price_predictor/tree/master/reports): `reports`
- [Saved figures](https://github.com/4db444/used_car_price_predictor/tree/master/reports/figures): `reports/figures`

### Other components

- **Toolkit user**
- [Public exports](https://github.com/4db444/used_car_price_predictor/blob/master/src/__init__.py): `src/__init__.py`

## Connections

- Toolkit user → Public exports: uses
- Public exports → Data loader: exports
- Public exports → Data cleaning: exports
- Public exports → Feature creation: exports
- Public exports → Feature encoding: exports
- Public exports → Dataset analysis: exports
- Public exports → Data saver: exports
- Public exports → Visualization functions: exports
- Data cleaning → Raw CSV
- Feature creation → Data cleaning: creates features from
- Feature encoding → Feature creation: encodes
- Dataset analysis → Analysis reports: writes CSVs
- Dataset analysis → Visualization functions: analyzes data for
- Visualization functions → Heatmap: includes
- Visualization functions → Histogram: includes
- Visualization functions → Scatter plot: includes
- Heatmap → Saved figures: saves figure
- Histogram → Saved figures: saves figure
- Scatter plot → Saved figures: saves figure
- Data loader → Raw CSV: reads
- Data saver → Processed CSVs: writes