From 7eab40f8fce6e0e62d887ac2cb57eba0d5a4572b Mon Sep 17 00:00:00 2001 From: ringo Date: Fri, 29 May 2026 14:47:52 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E6=9B=B4=E6=96=B0=20README=20=E2=80=94?= =?UTF-8?q?=20=E7=A4=BE=E5=8C=BA=20Schema=20defs=20=E6=95=B0=E9=87=8F?= =?UTF-8?q?=E4=B8=8E=20CEA=20=E6=98=A0=E5=B0=84=E6=96=87=E6=A1=A3=E9=93=BE?= =?UTF-8?q?=E6=8E=A5?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - schema-community.json: 7→11 defs（新增 BuildingRef, WeatherContext, SimulationContext） - schema-community-energy.json: 8→11 defs（新增 CommunityEnergyDemand 等） - 移除 AI 标注（已人工审核） - 新增 bps-schema 社区级字段说明 - 新增 CEA 字段映射文档链接 --- README.md | 20 ++++++++++++++++---- 1 file changed, 16 insertions(+), 4 deletions(-) diff --git a/README.md b/README.md index a87ff96..5dffd4d 100644 --- a/README.md +++ b/README.md @@ -19,8 +19,8 @@ | 文件 | $id | defs | 说明 | |------|-----|------|------| -| `schema-community.json` | bps/community | 7 | 社区几何：Site / Terrain / Road / GreenSpace / WaterBody（AI 生成的示例文件，需人工审核后使用） | -| `schema-community-energy.json` | bps/community-energy | 8 | 区域能源：Plant / Network / Pipe / BuildingConnection（AI 生成的示例文件，需人工审核后使用） | +| `schema-community.json` | bps/community | 11 | 社区几何：Site / Terrain / Road / GreenSpace / WaterBody / BuildingRef / WeatherContext / SimulationContext | +| `schema-community-energy.json` | bps/community-energy | 11 | 区域能源：Plant / Network / Pipe / BuildingConnection / CommunityEnergyDemand | | `schema-community-cfd.json` | bps/community-cfd | 13 | 社区风环境：计算域 / 网格 / 湍流 / 边界条件 / 求解器（AI 生成的示例文件，需人工审核后使用） | | `schema-community-microclimate.json` | bps/community-microclimate | 2 | 微气候：UHI 强度 / 风速修正 / 地表反照率（AI 生成的示例文件，需人工审核后使用） | @@ -38,7 +38,11 @@ |------|-----|------|------| | `schema-all.json` | bps/all | 11 | 引用以上所有文件，提供完整验证入口 | -**合计**：11 个领域文件 + 1 个聚合文件，171 个类型定义。 +**合计**：11 个领域文件 + 1 个聚合文件，178 个类型定义。 + +## 与 CEA 的字段映射 + +详见 [docs/cea-mapping.md](docs/cea-mapping.md)。该文档记录了 bps-schema 各字段与 CEA（City Energy Analyst）输入/输出文件的对应关系，涵盖社区级的建筑属性、气象配置、模拟配置、用能需求汇总。高层持续更新。 ## Schema 规范 @@ -156,9 +160,13 @@ ### 几何（schema-community.json） -- `Site` — 场地顶级实体，含 2D 边界 +- `Site` — 场地顶级实体，含 2D 边界、地形、道路、绿地、水体 - `TerrainGrid` / `TerrainTIN` — 高程网格或三角网 - `Road` / `GreenSpace` / `WaterBody` — 基础设施 +- `BuildingRef` — 社区建筑引用，通过 `ref` 指向 building schema 标识符 +- `CommunityBuildingAttributes` — 社区尺度的建筑属性：使用类型、构造标准、层数、高度、底面积、热区/占位/电气比例 +- `WeatherContext` — 气象数据引用（EPW 路径、气候区、经纬度） +- `SimulationContext` — 模拟配置（数据库区域、场景名称） ### 区域能源（schema-community-energy.json） @@ -166,6 +174,10 @@ - `Plant` — 源站（CHP / Boiler / HeatPump / Chiller / PV 等） - `Network` — 管网（CHW / HW / Steam / Electricity） - `Pipe` / `BuildingConnection` — 管段与建筑接入 +- `CommunityEnergyDemand` — **新增** 社区级用能需求汇总 + - `BuildingEnergyDemand` — 每栋建筑年度用能（heating/cooling/electricity/dhw MWh + 峰值） + - `AggregatedEnergyDemand` — 社区聚合指标（总用能、EUI） +- DistrictEnergy 新增 `demand` 字段，连接负荷输入与区域能源系统 ### 风环境（schema-community-cfd.json）