excel结果中输出弃电量。

docs/CURTAILMENT_LOSS_FEATURES.md

@@ -0,0 +1,134 @@
+# 弃电损失量功能增强文档
+
+## 修改概述
+
+在用户要求下，对 `main.py` 文件的 Excel 输出功能进行了增强，新增了**弃电损失量**相关的统计和输出。
+
+## 主要修改内容
+
+### 1. 统计结果工作表增强
+
+在 `export_results_to_excel` 函数的 `stats_df` 中新增了以下指标：
+
+| 新增指标 | 说明 | 单位 |
+|---------|------|------|
+| 总弃风电量 | 全部时间的弃风量总和 | MWh |
+| 总弃光电量 | 全部时间的弃光量总和 | MWh |
+| 总弃电量 | 弃风量 + 弃光量 | MWh |
+| 弃电损失比例 | 总弃电量 / 总潜在发电量 | % |
+
+**代码位置**：[`main.py:374-377`](main.py:374-377)
+
+```python
+# 计算弃电损失量
+total_curtail_wind = sum(result['curtailed_wind'])
+total_curtail_solar = sum(result['curtailed_solar'])
+total_curtail_energy = total_curtail_wind + total_curtail_solar
+
+# 计算总潜在发电量
+total_potential_generation = sum(solar_output) + sum(wind_output) + sum(thermal_output)
+curtailment_loss_ratio = (total_curtail_energy / total_potential_generation * 100) if total_potential_generation > 0 else 0
+```
+
+### 2. 运行数据工作表增强
+
+在 `data_df` 中新增了以下列：
+
+| 新增列名 | 说明 | 计算方式 |
+|---------|------|----------|
+| 弃电损失量(MW) | 每小时的弃电损失量 | 弃风量 + 弃光量 |
+| 累计弃电量(MWh) | 从开始到当前的累计弃电量 | 逐小时累加弃电损失量 |
+
+**代码位置**：[`main.py:323-348`](main.py:323-348)
+
+```python
+# 计算弃电损失量（弃风+弃光）
+curtailment_loss = [result['curtailed_wind'][i] + result['curtailed_solar'][i] for i in range(len(result['curtailed_wind']))]
+
+# 计算累计弃电损失量
+cumulative_curtailment = []
+cumulative = 0
+for loss in curtailment_loss:
+    cumulative += loss
+    cumulative_curtailment.append(cumulative)
+```
+
+## 功能特点
+
+### 1. 完整的弃电损失分析
+- **小时级分析**：`弃电损失量(MW)` 提供每小时的弃电情况
+- **累计分析**：`累计弃电量(MWh)` 提供弃电的累积趋势
+- **总量统计**：总弃风量、总弃光量、总弃电量的完整统计
+- **比例分析**：弃电损失比例，评估系统效率
+
+### 2. 数据一致性保证
+- 运行数据中的累计弃电量 = 统计结果中的总弃电量
+- 弃电损失量 = 弃风量 + 弃光量（逐小时匹配）
+- 所有计算基于原始优化结果，确保数据一致性
+
+### 3. 用户友好的输出
+- Excel文件中清晰的工作表分类
+- 中文列名，便于理解
+- 合理的单位标注（MW用于功率，MWh用于能量）
+
+## 输出效果
+
+### 统计结果工作表示例
+```
+指标                | 数值
+-------------------|------------------
+总弃风电量          | 12.50 MWh
+总弃光电量          | 8.30 MWh
+总弃电量            | 20.80 MWh
+弃电损失比例        | 2.34%
+```
+
+### 运行数据工作表新增列
+```
+小时 | 弃风量(MW) | 弃光量(MW) | 弃电损失量(MW) | 累计弃电量(MWh)
+-----|-----------|-----------|---------------|--------------
+1    | 0.5       | 0.3       | 0.8           | 0.8
+2    | 0.2       | 0.4       | 0.6           | 1.4
+3    | 0.0       | 0.5       | 0.5           | 1.9
+...  | ...       | ...       | ...           | ...
+```
+
+## 使用说明
+
+1. **运行程序**：`python main.py --excel data.xlsx`
+2. **查看结果**：在生成的Excel文件中查看"统计结果"和"运行数据"工作表
+3. **分析弃电**：
+   - 统计结果：了解总体弃电情况和损失比例
+   - 运行数据：分析逐小时弃电模式和累计趋势
+
+## 技术细节
+
+### 计算公式
+- **弃电损失量** = 弃风量 + 弃光量
+- **累计弃电量** = Σ(弃电损失量) (逐小时累加)
+- **弃电损失比例** = (总弃电量 / 总潜在发电量) × 100%
+- **总潜在发电量** = 光伏总出力 + 风电总出力 + 火电总出力
+
+### 数据来源
+- 基于 `storage_optimization.py` 中的 `result` 字典
+- 使用 `curtailed_wind` 和 `curtailed_solar` 数据
+- 确保与优化算法结果完全一致
+
+## 兼容性
+
+- ✅ 向后兼容：不影响原有功能
+- ✅ Excel格式：保持原有文件结构
+- ✅ 时间尺度：支持24小时和8760小时数据
+- ✅ 数据精度：保持原有计算精度
+
+## 验证
+
+创建了测试文件 `test_main_modifications.py` 用于验证功能正确性：
+- 验证Excel文件导出成功
+- 检查新增列是否正确添加
+- 验证数据计算的一致性
+- 确认统计结果的准确性
+
+## 总结
+
+此次修改成功地在Excel输出中增加了完整的弃电损失量分析功能，为用户提供了更详细和直观的弃电情况分析工具，有助于优化储能系统配置和运行策略。