# nikhileshnarkhede/symboptai architecture

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

- Interactive diagram: https://gitdiagram.com/nikhileshnarkhede/symboptai
- Repository: https://github.com/nikhileshnarkhede/symboptai

## Overview

SymbOptAI is a research workflow for discovering and using interpretable equations to predict and optimize mechanical properties of 3D-printed materials. Its documented path runs from experimental design and bootstrap augmentation through symbolic regression, equation analysis, feature-enhanced neural-network training, and NSGA-II inverse design. Equation verification and feature-importance analysis are additional analysis capabilities. The README establishes the overall stage sequence; sampled source confirms formula parsing and feature generation within the DNN pipeline. Unsampled modules and integrations are not assumed to call one another.

Main entry points: [`5. DNN with Feature Engineering/final_FE_DNN_pipeline.py`](https://github.com/nikhileshnarkhede/symboptai/blob/main/5.%20DNN%20with%20Feature%20Engineering/final_FE_DNN_pipeline.py) (Feature-enhanced DNN), [`4.1 Eqation _verification and Terms analysis/Verification_of_equations.py`](https://github.com/nikhileshnarkhede/symboptai/blob/main/4.1%20Eqation%20_verification%20and%20Terms%20analysis/Verification_of_equations.py) (Equation verification), [`3. SRA Equation Grenrator/Equations_Generator.py`](https://github.com/nikhileshnarkhede/symboptai/blob/main/3.%20SRA%20Equation%20Grenrator/Equations_Generator.py) (Symbolic regression), [`4.1 Eqation _verification and Terms analysis`](https://github.com/nikhileshnarkhede/symboptai/tree/main/4.1%20Eqation%20_verification%20and%20Terms%20analysis) (Equation analysis)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_data["Data preparation"]
  node_doe["Taguchi DOE<br/>[doe.py]"]
  node_bootstrap["Bootstrap validation"]
end

subgraph group_equations["Symbolic equations"]
  node_sra["Symbolic regression"]
  node_equation_analysis["Equation analysis"]
  node_term_parser["Equation term parser<br/>[Equation_Terms.py]"]
  node_term_tools["Term normalization tools"]
  node_formula_eval["Term calculation"]
  node_verification["Equation verification"]
end

subgraph group_prediction["Prediction analysis"]
  node_feature_importance["Feature importance"]
  node_dnn_pipeline["Feature-enhanced DNN"]
  node_dnn_model["DNN model utilities<br/>[model_FE_DNN.py]"]
end

subgraph group_design["Inverse design"]
  node_optimization["NSGA-II optimization<br/>[Optimization.py]"]
end

node_researcher(("Researcher"))
node_properties["Six property predictions"]
node_design_results["Optimized settings"]

node_researcher -->|"specifies factors"| node_doe
node_doe -->|"designs experiments"| node_bootstrap
node_bootstrap -->|"augments data"| node_sra
node_sra -->|"produces equations"| node_equation_analysis
node_equation_analysis -->|"engineers features"| node_dnn_pipeline
node_dnn_pipeline -->|"supplies predictions"| node_optimization
node_optimization -->|"identifies settings"| node_design_results
node_researcher -->|"validates equations"| node_verification
node_sra -->|"equations verified"| node_verification
node_researcher -->|"analyzes features"| node_feature_importance
node_feature_importance -.->|"ranks importance"| node_properties
node_dnn_pipeline -->|"predicts properties"| node_properties
node_dnn_pipeline -->|"parses equations"| node_term_parser
node_dnn_pipeline -->|"builds term features"| node_formula_eval
node_verification -->|"analyzes equations"| node_term_parser
node_verification -->|"evaluates terms"| node_formula_eval
node_equation_analysis -.->|"normalizes terms"| node_term_tools
node_dnn_pipeline -.->|"model utilities"| node_dnn_model

click node_doe "https://github.com/nikhileshnarkhede/symboptai/blob/main/1.%20DOE/doe.py"
click node_bootstrap "https://github.com/nikhileshnarkhede/symboptai/blob/main/2.%20Synthetic%20Data%20Generation%20and%20Validation/synthetic_data_generation_and_validation.py"
click node_sra "https://github.com/nikhileshnarkhede/symboptai/blob/main/3.%20SRA%20Equation%20Grenrator/Equations_Generator.py"
click node_equation_analysis "https://github.com/nikhileshnarkhede/symboptai/tree/main/4.1%20Eqation%20_verification%20and%20Terms%20analysis"
click node_term_parser "https://github.com/nikhileshnarkhede/symboptai/blob/main/4.1%20Eqation%20_verification%20and%20Terms%20analysis/Equation_Terms.py"
click node_term_tools "https://github.com/nikhileshnarkhede/symboptai/blob/main/4.1%20Eqation%20_verification%20and%20Terms%20analysis/canonicalize_term_full_Recursive_normalization_with_Fun_formula.py"
click node_formula_eval "https://github.com/nikhileshnarkhede/symboptai/blob/main/5.%20DNN%20with%20Feature%20Engineering/Term_wise_calculation.py"
click node_verification "https://github.com/nikhileshnarkhede/symboptai/blob/main/4.1%20Eqation%20_verification%20and%20Terms%20analysis/Verification_of_equations.py"
click node_feature_importance "https://github.com/nikhileshnarkhede/symboptai/blob/main/4.2%20Feature%20Importances%20for%20Each%20Property/feature_importances_for_each_property.py"
click node_dnn_pipeline "https://github.com/nikhileshnarkhede/symboptai/blob/main/5.%20DNN%20with%20Feature%20Engineering/final_FE_DNN_pipeline.py"
click node_dnn_model "https://github.com/nikhileshnarkhede/symboptai/blob/main/5.%20DNN%20with%20Feature%20Engineering/model_FE_DNN.py"
click node_optimization "https://github.com/nikhileshnarkhede/symboptai/blob/main/6.%20NSGA%202%20optimization/Optimization.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_doe,node_bootstrap toneBlue
class node_sra,node_equation_analysis,node_term_parser,node_term_tools,node_formula_eval,node_verification toneAmber
class node_feature_importance,node_dnn_pipeline,node_dnn_model toneMint
class node_optimization toneRose
class node_researcher,node_properties,node_design_results toneIndigo
```

## Components

### Data preparation

- [Taguchi DOE](https://github.com/nikhileshnarkhede/symboptai/blob/main/1.%20DOE/doe.py): `1. DOE/doe.py`
- [Bootstrap validation](https://github.com/nikhileshnarkhede/symboptai/blob/main/2.%20Synthetic%20Data%20Generation%20and%20Validation/synthetic_data_generation_and_validation.py): `2. Synthetic Data Generation and Validation/synthetic_data_generation_and_validation.py`

### Symbolic equations

- [Symbolic regression](https://github.com/nikhileshnarkhede/symboptai/blob/main/3.%20SRA%20Equation%20Grenrator/Equations_Generator.py): `3. SRA Equation Grenrator/Equations_Generator.py`
- [Equation analysis](https://github.com/nikhileshnarkhede/symboptai/tree/main/4.1%20Eqation%20_verification%20and%20Terms%20analysis): `4.1 Eqation _verification and Terms analysis`
- [Equation term parser](https://github.com/nikhileshnarkhede/symboptai/blob/main/4.1%20Eqation%20_verification%20and%20Terms%20analysis/Equation_Terms.py): `4.1 Eqation _verification and Terms analysis/Equation_Terms.py`
- [Term normalization tools](https://github.com/nikhileshnarkhede/symboptai/blob/main/4.1%20Eqation%20_verification%20and%20Terms%20analysis/canonicalize_term_full_Recursive_normalization_with_Fun_formula.py): `4.1 Eqation _verification and Terms analysis/canonicalize_term_full_Recursive_normalization_with_Fun_formula.py`
- [Term calculation](https://github.com/nikhileshnarkhede/symboptai/blob/main/5.%20DNN%20with%20Feature%20Engineering/Term_wise_calculation.py): `5. DNN with Feature Engineering/Term_wise_calculation.py`
- [Equation verification](https://github.com/nikhileshnarkhede/symboptai/blob/main/4.1%20Eqation%20_verification%20and%20Terms%20analysis/Verification_of_equations.py): `4.1 Eqation _verification and Terms analysis/Verification_of_equations.py`

### Prediction analysis

- [Feature importance](https://github.com/nikhileshnarkhede/symboptai/blob/main/4.2%20Feature%20Importances%20for%20Each%20Property/feature_importances_for_each_property.py): `4.2 Feature Importances for Each Property/feature_importances_for_each_property.py`
- [Feature-enhanced DNN](https://github.com/nikhileshnarkhede/symboptai/blob/main/5.%20DNN%20with%20Feature%20Engineering/final_FE_DNN_pipeline.py): `5. DNN with Feature Engineering/final_FE_DNN_pipeline.py`
- [DNN model utilities](https://github.com/nikhileshnarkhede/symboptai/blob/main/5.%20DNN%20with%20Feature%20Engineering/model_FE_DNN.py): `5. DNN with Feature Engineering/model_FE_DNN.py`

### Inverse design

- [NSGA-II optimization](https://github.com/nikhileshnarkhede/symboptai/blob/main/6.%20NSGA%202%20optimization/Optimization.py): `6. NSGA 2 optimization/Optimization.py`

### Other components

- **Researcher**
- **Six property predictions**
- **Optimized settings**

## Connections

- Researcher → Taguchi DOE: specifies factors (evidence: `README.md`)
- Taguchi DOE → Bootstrap validation: designs experiments (evidence: `README.md`)
- Bootstrap validation → Symbolic regression: augments data (evidence: `README.md`)
- Symbolic regression → Equation analysis: produces equations (evidence: `README.md`)
- Equation analysis → Feature-enhanced DNN: engineers features (evidence: `README.md`)
- Feature-enhanced DNN → NSGA-II optimization: supplies predictions (evidence: `README.md`)
- NSGA-II optimization → Optimized settings: identifies settings (evidence: `README.md`)
- Researcher → Equation verification: validates equations (evidence: `README.md`)
- Symbolic regression → Equation verification: equations verified (evidence: `README.md`)
- Researcher → Feature importance: analyzes features (evidence: `README.md`)
- Feature importance → Six property predictions: ranks importance
- Feature-enhanced DNN → Six property predictions: predicts properties (evidence: `README.md`)
- Feature-enhanced DNN → Equation term parser: parses equations (evidence: `5. DNN with Feature Engineering/final_FE_DNN_pipeline.py`)
- Feature-enhanced DNN → Term calculation: builds term features (evidence: `5. DNN with Feature Engineering/final_FE_DNN_pipeline.py`)
- Equation verification → Equation term parser: analyzes equations (evidence: `4.1 Eqation _verification and Terms analysis/Verification_of_equations.py`)
- Equation verification → Term calculation: evaluates terms (evidence: `4.1 Eqation _verification and Terms analysis/Verification_of_equations.py`)
- Equation analysis → Term normalization tools: normalizes terms (evidence: `4.1 Eqation _verification and Terms analysis/Terms_counter_full_Recursive_normalization_with_Fun_formula.py`)
- Feature-enhanced DNN → DNN model utilities: model utilities
