feat: Add MLP surrogate with Turbo Mode for 100x faster optimization

Neural Acceleration (MLP Surrogate):
- Add run_nn_optimization.py with hybrid FEA/NN workflow
- MLP architecture: 4-layer (64->128->128->64) with BatchNorm/Dropout
- Three workflow modes:
  - --all: Sequential export->train->optimize->validate
  - --hybrid-loop: Iterative Train->NN->Validate->Retrain cycle
  - --turbo: Aggressive single-best validation (RECOMMENDED)
- Turbo mode: 5000 NN trials + 50 FEA validations in ~12 minutes
- Separate nn_study.db to avoid overloading dashboard

Performance Results (bracket_pareto_3obj study):
- NN prediction errors: mass 1-5%, stress 1-4%, stiffness 5-15%
- Found minimum mass designs at boundary (angle~30deg, thick~30mm)
- 100x speedup vs pure FEA exploration

Protocol Operating System:
- Add .claude/skills/ with Bootstrap, Cheatsheet, Context Loader
- Add docs/protocols/ with operations (OP_01-06) and system (SYS_10-14)
- Update SYS_14_NEURAL_ACCELERATION.md with MLP Turbo Mode docs

NX Automation:
- Add optimization_engine/hooks/ for NX CAD/CAE automation
- Add study_wizard.py for guided study creation
- Fix FEM mesh update: load idealized part before UpdateFemodel()

New Study:
- bracket_pareto_3obj: 3-objective Pareto (mass, stress, stiffness)
- 167 FEA trials + 5000 NN trials completed
- Demonstrates full hybrid workflow

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
Antoine
2025-12-06 20:01:59 -05:00
parent 0cb2808c44
commit 602560c46a
70 changed files with 31018 additions and 289 deletions

View File

@@ -1,7 +1,7 @@
# Create Optimization Study Skill
**Last Updated**: December 4, 2025
**Version**: 2.1 - Added Mandatory Documentation Requirements
**Last Updated**: December 6, 2025
**Version**: 2.2 - Added Model Introspection
You are helping the user create a complete Atomizer optimization study from a natural language description.
@@ -9,12 +9,50 @@ You are helping the user create a complete Atomizer optimization study from a na
---
## MANDATORY: Model Introspection
**ALWAYS run introspection when user provides NX files or asks for model analysis:**
```python
from optimization_engine.hooks.nx_cad.model_introspection import (
introspect_part,
introspect_simulation,
introspect_op2,
introspect_study
)
# Introspect entire study directory (recommended)
study_info = introspect_study("studies/my_study/")
# Or introspect individual files
part_info = introspect_part("path/to/model.prt")
sim_info = introspect_simulation("path/to/model.sim")
op2_info = introspect_op2("path/to/results.op2")
```
### What Introspection Provides
| Source | Information Extracted |
|--------|----------------------|
| `.prt` | Expressions (potential design variables), bodies, mass, material, features |
| `.sim` | Solutions (SOL types), boundary conditions, loads, materials, mesh info, output requests |
| `.op2` | Available results (displacement, stress, strain, SPC forces, frequencies), subcases |
### Generate MODEL_INTROSPECTION.md
**MANDATORY**: Save introspection report at study creation:
- Location: `studies/{study_name}/MODEL_INTROSPECTION.md`
- Contains: All expressions, solutions, available results, optimization recommendations
---
## MANDATORY DOCUMENTATION CHECKLIST
**EVERY study MUST have these files. A study is NOT complete without them:**
| File | Purpose | When Created |
|------|---------|--------------|
| `MODEL_INTROSPECTION.md` | **Model Analysis** - Expressions, solutions, available results | At study creation |
| `README.md` | **Engineering Blueprint** - Full mathematical formulation, design variables, objectives, algorithm config | At study creation |
| `STUDY_REPORT.md` | **Results Tracking** - Progress, best designs, surrogate accuracy, recommendations | At study creation (template) |
@@ -2053,6 +2091,7 @@ Multi-Solution: {Yes/No}
✓ studies/{study_name}/1_setup/workflow_config.json
✓ studies/{study_name}/run_optimization.py
✓ studies/{study_name}/reset_study.py
✓ studies/{study_name}/MODEL_INTROSPECTION.md # MANDATORY - Model analysis
✓ studies/{study_name}/README.md # Engineering blueprint
✓ studies/{study_name}/STUDY_REPORT.md # MANDATORY - Results report template
[✓] studies/{study_name}/NX_FILE_MODIFICATIONS_REQUIRED.md (if needed)