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)