# kartik-ey17/research-paper-nutrition architecture

> Architecture diagram of the GitHub repository kartik-ey17/research-paper-nutrition, 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/kartik-ey17/research-paper-nutrition
- Repository: https://github.com/kartik-ey17/research-paper-nutrition

## Overview

This repository is a cleaned Protein-NAP dataset, not an application with a user-facing runtime workflow. Its principal use is to work with cleaned food and recipe nutrition, relate foods to recipes and meals, and use the normalized meal-plan hierarchy and reference tables. The README documents these dataset roles and relationships; the sampled main.py contains no source excerpt, so the graph shows documented data relationships rather than an execution pipeline.

Main entry points: [`tables/foods_clean.csv`](https://github.com/kartik-ey17/research-paper-nutrition/blob/main/tables/foods_clean.csv) (Foods), [`tables/recipe_components_clean.csv`](https://github.com/kartik-ey17/research-paper-nutrition/blob/main/tables/recipe_components_clean.csv) (Recipe components), [`tables/meal_plan_versions_clean.csv`](https://github.com/kartik-ey17/research-paper-nutrition/blob/main/tables/meal_plan_versions_clean.csv) (Plan versions), [`tables/meals_clean.csv`](https://github.com/kartik-ey17/research-paper-nutrition/blob/main/tables/meals_clean.csv) (Meals)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_food["Food data"]
  node_foods["Foods<br/>[foods_clean.csv]"]
  node_food_nutrients["Food nutrients"]
  node_food_measures["Food measures"]
end

subgraph group_recipe["Recipes"]
  node_recipes["Recipes<br/>[recipes_clean.csv]"]
  node_recipe_components["Recipe components"]
end

subgraph group_meal["Meal planning"]
  node_meal_plans["Meal plans"]
  node_plan_versions["Plan versions"]
  node_meals["Meals<br/>[meals_clean.csv]"]
  node_meal_components["Meal components"]
end

subgraph group_reference["References and audit"]
  node_nutrients["Nutrients"]
  node_food_groups["Food groups"]
  node_food_sources["Food sources"]
  node_activities["Activities"]
  node_recipe_categories["Recipe categories"]
  node_cleaning_report["Cleaning report"]
end

node_food_nutrients -->|"pivoted into"| node_foods
node_recipe_components -->|"relates to"| node_recipes
node_recipe_components -->|"references foods"| node_foods
node_meal_plans -->|"has versions"| node_plan_versions
node_plan_versions -->|"organizes meals"| node_meals
node_meals -->|"has components"| node_meal_components
node_meal_components -->|"references foods"| node_foods

click node_foods "https://github.com/kartik-ey17/research-paper-nutrition/blob/main/tables/foods_clean.csv"
click node_food_nutrients "https://github.com/kartik-ey17/research-paper-nutrition/blob/main/tables/food_nutrients_long.csv"
click node_food_measures "https://github.com/kartik-ey17/research-paper-nutrition/blob/main/tables/food_measures_clean.csv"
click node_recipes "https://github.com/kartik-ey17/research-paper-nutrition/blob/main/tables/recipes_clean.csv"
click node_recipe_components "https://github.com/kartik-ey17/research-paper-nutrition/blob/main/tables/recipe_components_clean.csv"
click node_meal_plans "https://github.com/kartik-ey17/research-paper-nutrition/blob/main/tables/meal_plans_clean.csv"
click node_plan_versions "https://github.com/kartik-ey17/research-paper-nutrition/blob/main/tables/meal_plan_versions_clean.csv"
click node_meals "https://github.com/kartik-ey17/research-paper-nutrition/blob/main/tables/meals_clean.csv"
click node_meal_components "https://github.com/kartik-ey17/research-paper-nutrition/blob/main/tables/meal_components_clean.csv"
click node_nutrients "https://github.com/kartik-ey17/research-paper-nutrition/blob/main/tables/nutrients_clean.csv"
click node_food_groups "https://github.com/kartik-ey17/research-paper-nutrition/blob/main/tables/food_groups_clean.csv"
click node_food_sources "https://github.com/kartik-ey17/research-paper-nutrition/blob/main/tables/food_sources_clean.csv"
click node_activities "https://github.com/kartik-ey17/research-paper-nutrition/blob/main/tables/activities_clean.csv"
click node_recipe_categories "https://github.com/kartik-ey17/research-paper-nutrition/blob/main/tables/recipe_categories_clean.csv"
click node_cleaning_report "https://github.com/kartik-ey17/research-paper-nutrition/blob/main/audit/cleaning_report.txt"

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_foods,node_food_nutrients,node_food_measures toneBlue
class node_recipes,node_recipe_components toneAmber
class node_meal_plans,node_plan_versions,node_meals,node_meal_components toneMint
class node_nutrients,node_food_groups,node_food_sources,node_activities,node_recipe_categories,node_cleaning_report toneRose
```

## Components

### Food data

- [Foods](https://github.com/kartik-ey17/research-paper-nutrition/blob/main/tables/foods_clean.csv): `tables/foods_clean.csv`
- [Food nutrients](https://github.com/kartik-ey17/research-paper-nutrition/blob/main/tables/food_nutrients_long.csv): `tables/food_nutrients_long.csv`
- [Food measures](https://github.com/kartik-ey17/research-paper-nutrition/blob/main/tables/food_measures_clean.csv): `tables/food_measures_clean.csv`

### Recipes

- [Recipes](https://github.com/kartik-ey17/research-paper-nutrition/blob/main/tables/recipes_clean.csv): `tables/recipes_clean.csv`
- [Recipe components](https://github.com/kartik-ey17/research-paper-nutrition/blob/main/tables/recipe_components_clean.csv): `tables/recipe_components_clean.csv`

### Meal planning

- [Meal plans](https://github.com/kartik-ey17/research-paper-nutrition/blob/main/tables/meal_plans_clean.csv): `tables/meal_plans_clean.csv`
- [Plan versions](https://github.com/kartik-ey17/research-paper-nutrition/blob/main/tables/meal_plan_versions_clean.csv): `tables/meal_plan_versions_clean.csv`
- [Meals](https://github.com/kartik-ey17/research-paper-nutrition/blob/main/tables/meals_clean.csv): `tables/meals_clean.csv`
- [Meal components](https://github.com/kartik-ey17/research-paper-nutrition/blob/main/tables/meal_components_clean.csv): `tables/meal_components_clean.csv`

### References and audit

- [Nutrients](https://github.com/kartik-ey17/research-paper-nutrition/blob/main/tables/nutrients_clean.csv): `tables/nutrients_clean.csv`
- [Food groups](https://github.com/kartik-ey17/research-paper-nutrition/blob/main/tables/food_groups_clean.csv): `tables/food_groups_clean.csv`
- [Food sources](https://github.com/kartik-ey17/research-paper-nutrition/blob/main/tables/food_sources_clean.csv): `tables/food_sources_clean.csv`
- [Activities](https://github.com/kartik-ey17/research-paper-nutrition/blob/main/tables/activities_clean.csv): `tables/activities_clean.csv`
- [Recipe categories](https://github.com/kartik-ey17/research-paper-nutrition/blob/main/tables/recipe_categories_clean.csv): `tables/recipe_categories_clean.csv`
- [Cleaning report](https://github.com/kartik-ey17/research-paper-nutrition/blob/main/audit/cleaning_report.txt): `audit/cleaning_report.txt`

## Connections

- Food nutrients → Foods: pivoted into
- Recipe components → Recipes: relates to
- Recipe components → Foods: references foods
- Meal plans → Plan versions: has versions
- Plan versions → Meals: organizes meals
- Meals → Meal components: has components
- Meal components → Foods: references foods