docs: 更新 README — 社区 Schema defs 数量与 CEA 映射文档链接

- schema-community.json: 7→11 defs(新增 BuildingRef, WeatherContext, SimulationContext)
- schema-community-energy.json: 8→11 defs(新增 CommunityEnergyDemand 等)
- 移除 AI 标注(已人工审核)
- 新增 bps-schema 社区级字段说明
- 新增 CEA 字段映射文档链接
This commit is contained in:
ringo
2026-05-29 14:47:52 +08:00
parent 1f7ba8ee47
commit 7eab40f8fc
+16 -4
View File
@@ -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)