multi_energy_complementarity/docs/PROJECT_STRUCTURE.md

项目结构说明

目录结构

D:\code\storage\
├── src/                           # 核心源代码
│   ├── storage_optimization.py    # 储能容量优化核心模块
│   ├── excel_reader.py             # Excel数据读取模块
│   ├── economic_optimization.py   # 经济优化模块
│   ├── solar_optimization.py      # 太阳能优化模块
│   └── advanced_visualization.py  # 高级可视化模块
│
├── tests/                         # 测试文件
│   ├── test_*.py                  # 所有Python测试文件
│   ├── test_*.xlsx                # 测试Excel文件
│   ├── extreme_*.xlsx             # 极端场景测试文件
│   └── test_zero_grid_simple.py   # 简化版测试文件
│
├── config/                        # 配置文件
│   ├── pyproject.toml             # 项目配置
│   ├── requirements.txt           # 依赖配置
│   ├── uv.lock                    # uv锁定文件
│   └── main.spec                  # PyInstaller配置
│
├── docs/                          # 文档文件
│   ├── README.md                  # 项目主文档
│   └── README_exe.md              # 可执行文件说明
│
├── scripts/                       # 示例和演示脚本
│   ├── example_usage.py           # 使用示例
│   ├── solar_optimization_examples.py  # 太阳能优化示例
│   └── solar_scenarios_demo.py    # 太阳能场景演示
│
├── images/                        # 图片文件
│   ├── *.png                      # 所有生成的图表和可视化图片
│
├── templates/                     # Excel模板文件
│   ├── data_template_*.xlsx       # 数据模板
│   ├── economic_data_template_*.xlsx  # 经济优化模板
│   └── data_template_*-*.xlsx     # 临时和修改的模板
│
├── results/                       # 优化结果文件
│   └── storage_optimization_results_*.xlsx  # 储能优化结果
│
├── reports/                       # 报告文件
│   └── economic_optimization_report_*.xlsx  # 经济优化报告
│
├── build/                         # 构建输出
├── dist/                          # 分发文件
├── __pycache__/                   # Python缓存
├── .mypy_cache/                   # MyPy缓存
├── .vscode/                       # VS Code配置
├── .gitignore                     # Git忽略文件
├── .python-version                # Python版本
└── main.py                        # 主程序入口

文件分类说明

📁 src/ - 核心源代码

• storage_optimization.py: 储能容量优化的核心算法
• excel_reader.py: Excel文件读取和数据验证
• economic_optimization.py: 经济指标优化模块
• solar_optimization.py: 太阳能系统优化
• advanced_visualization.py: 高级数据可视化

📁 tests/ - 测试文件

• 所有 test_*.py 文件：单元测试和集成测试
• 所有 test_*.xlsx 文件：测试用Excel数据
• extreme_*.xlsx：极端场景测试数据

📁 config/ - 配置文件

• pyproject.toml: 项目元数据和依赖管理
• requirements.txt: Python依赖包列表
• uv.lock: 依赖版本锁定文件
• main.spec: PyInstaller打包配置

📁 docs/ - 文档

• README.md: 项目主文档
• README_exe.md: 可执行文件使用说明

📁 scripts/ - 示例和演示

• example_usage.py: 基本使用示例
• solar_optimization_examples.py: 太阳能优化示例
• solar_scenarios_demo.py: 太阳能场景演示

📁 images/ - 图片文件

• 所有 .png 文件：系统生成的图表和可视化结果

📁 templates/ - Excel模板

• data_template_*.xlsx: 基础数据模板
• economic_data_template_*.xlsx: 经济优化模板
• 临时和修改的模板文件

📁 results/ - 优化结果

• storage_optimization_results_*.xlsx: 储能优化计算结果

📁 reports/ - 报告文件

• economic_optimization_report_*.xlsx: 经济优化分析报告

使用说明

运行主程序

uv run python main.py --excel templates/data_template_8760.xlsx

运行测试

uv run python tests/test_excel_data.py

运行示例

uv run python scripts/example_usage.py

创建Excel模板

uv run python src/excel_reader.py --economic

注意事项

1. 导入路径: 由于文件移动，可能需要调整Python导入路径
2. 相对路径: 某些脚本中的文件路径可能需要更新
3. 配置文件: pyproject.toml等配置文件位置已改变
4. 可执行文件: 如果使用了打包的exe，需要检查路径引用

维护建议

• 定期清理 results/ 和 reports/ 中的旧文件
• 保持 templates/ 中的模板文件更新
• 及时更新 config/ 中的依赖配置
• 维护 docs/ 中的文档与代码同步