initial commit: schema-building.json and schema-energy.json

2026-05-21 21:52:31 +08:00
commit 58097e4d12
4 changed files with 767 additions and 0 deletions
@@ -0,0 +1,201 @@
+{
+  "archgen": {
+    "version": "0.1.0",
+    "description": "ArchGen Schema — 能耗模拟领域",
+    "tags": {
+      "scale": {
+        "building": "建筑尺度",
+        "community": "社区/街区尺度",
+        "urban": "城市尺度"
+      },
+      "simulation": {
+        "energy": "能耗模拟",
+        "daylight": "采光分析",
+        "solar": "日照分析",
+        "thermal_comfort": "热舒适分析",
+        "carbon": "碳排放核算",
+        "wind": "风环境模拟",
+        "general": "通用"
+      }
+    }
+  },
+
+  "types": {
+    "TimePoint": {
+      "description": "时刻点 [时, 分]",
+      "fields": {
+        "hour": { "type": "integer", "default": 0 },
+        "minute": { "type": "integer", "default": 0 }
+      }
+    },
+    "DatePoint": {
+      "description": "日期点 [月, 日]",
+      "fields": {
+        "month": { "type": "integer", "default": 1 },
+        "day": { "type": "integer", "default": 1 }
+      }
+    },
+    "Period": {
+      "description": "时间范围",
+      "fields": {
+        "start": { "type": "DatePoint" },
+        "end": { "type": "DatePoint" }
+      }
+    }
+  },
+
+  "enums": {
+    "MaterialType": {
+      "description": "材料类型",
+      "values": ["EnergyMaterial", "EnergyMaterialNoMass", "EnergyWindowMaterialSimpleGlazSys"]
+    },
+    "ConstructionType": {
+      "description": "构造类型",
+      "values": ["OpaqueConstruction", "WindowConstruction"]
+    },
+    "Roughness": {
+      "description": "表面粗糙度",
+      "values": ["VeryRough", "Rough", "MediumRough", "MediumSmooth", "Smooth", "VerySmooth"]
+    }
+  },
+
+  "entities": {
+    "MaterialProps": {
+      "description": "材料热工物理属性",
+      "tags": { "scale": ["building", "community"], "simulation": ["energy", "thermal_comfort", "carbon"] },
+      "attributes": {
+        "identifier": { "type": "string", "required": true, "tags": { "simulation": ["general"] } },
+        "displayName": { "type": "string", "tags": { "simulation": ["general"] } },
+        "type": { "type": "MaterialType", "default": "EnergyMaterial", "tags": { "simulation": ["energy", "carbon"] } },
+        "conductivity": { "type": "number", "default": 1, "unit": "W/m·K", "description": "导热系数", "tags": { "simulation": ["energy", "thermal_comfort"] } },
+        "specificHeat": { "type": "number", "default": 100, "unit": "J/kg·K", "description": "热容", "tags": { "simulation": ["energy", "thermal_comfort"] } },
+        "density": { "type": "number", "default": 1000, "unit": "kg/m³", "description": "密度", "tags": { "simulation": ["energy", "carbon"] } },
+        "thickness": { "type": "number", "default": 100, "unit": "mm", "description": "厚度", "tags": { "simulation": ["energy", "thermal_comfort", "carbon"] } },
+        "roughness": { "type": "Roughness", "default": "MediumRough", "description": "表面粗糙度", "tags": { "simulation": ["energy", "thermal_comfort"] } },
+        "thermalAbsorptance": { "type": "number", "default": 0.9, "description": "热吸收率", "tags": { "scale": ["building"], "simulation": ["energy", "thermal_comfort"] } },
+        "solarAbsorptance": { "type": "number", "default": 0.9, "description": "太阳吸收率", "tags": { "simulation": ["energy", "daylight", "solar", "thermal_comfort"] } },
+        "visibleAbsorptance": { "type": "number", "default": 0.9, "description": "可见光吸收率", "tags": { "scale": ["building"], "simulation": ["daylight"] } },
+        "rValue": { "type": "number", "unit": "m²·K/W", "description": "热阻", "tags": { "simulation": ["energy", "thermal_comfort"] } },
+        "uFactor": { "type": "number", "unit": "W/m²·K", "description": "传热系数", "tags": { "simulation": ["energy", "thermal_comfort"] } },
+        "shgc": { "type": "number", "default": 0.6, "description": "太阳得热系数", "tags": { "simulation": ["energy", "daylight", "solar", "thermal_comfort"] } },
+        "vt": { "type": "number", "default": 0.6, "description": "可见光透射比", "tags": { "simulation": ["daylight"] } },
+        "embodiedCarbon": { "type": "number", "default": 0, "unit": "kgCO₂/m²", "description": "隐含碳排放", "tags": { "scale": ["building", "community", "urban"], "simulation": ["carbon"] } },
+        "embodiedEnergy": { "type": "number", "default": 0, "unit": "MJ/m²", "description": "隐含能耗", "tags": { "scale": ["building", "community", "urban"], "simulation": ["carbon"] } }
+      }
+    },
+
+    "Construction": {
+      "description": "单一构造定义（包含多层材料）",
+      "tags": { "scale": ["building"], "simulation": ["energy", "thermal_comfort", "carbon"] },
+      "attributes": {
+        "identifier": { "type": "string", "required": true, "tags": { "simulation": ["general"] } },
+        "displayName": { "type": "string", "required": true, "tags": { "simulation": ["general"] } },
+        "type": { "type": "ConstructionType", "default": "OpaqueConstruction", "tags": { "simulation": ["energy", "thermal_comfort", "carbon"] } }
+      },
+      "children": {
+        "materials": { "type": "MaterialProps", "multiple": true, "description": "材料层列表（从外到内）", "tags": { "simulation": ["energy", "thermal_comfort", "carbon"] } }
+      }
+    },
+
+    "SubSet": {
+      "description": "特定部位的构造组合",
+      "tags": { "scale": ["building"], "simulation": ["energy", "thermal_comfort", "carbon"] },
+      "attributes": {
+        "identifier": { "type": "string", "required": true, "tags": { "simulation": ["general"] } },
+        "type": { "type": "string", "tags": { "simulation": ["general"] } },
+        "exteriorConstruction": { "type": "Construction", "description": "外部构造", "tags": { "simulation": ["energy", "thermal_comfort", "carbon"] } },
+        "interiorConstruction": { "type": "Construction", "description": "内部构造", "tags": { "simulation": ["energy", "thermal_comfort"] } },
+        "groundConstruction": { "type": "Construction", "description": "地面构造", "tags": { "simulation": ["energy", "thermal_comfort"] } },
+        "overheadConstruction": { "type": "Construction", "description": "顶棚构造", "tags": { "simulation": ["energy", "thermal_comfort"] } },
+        "skylightConstruction": { "type": "Construction", "description": "天窗构造", "tags": { "simulation": ["energy", "daylight"] } },
+        "operableConstruction": { "type": "Construction", "description": "可开启构造", "tags": { "simulation": ["energy", "wind"] } },
+        "windowConstruction": { "type": "Construction", "description": "窗户构造", "tags": { "simulation": ["energy", "daylight", "solar"] } }
+      }
+    },
+
+    "ConstructionSet": {
+      "description": "全楼构造合集",
+      "tags": { "scale": ["building"], "simulation": ["energy", "thermal_comfort", "carbon"] },
+      "attributes": {
+        "identifier": { "type": "string", "required": true, "tags": { "simulation": ["general"] } },
+        "displayName": { "type": "string", "required": true, "tags": { "simulation": ["general"] } },
+        "airBoundaryConstruction": { "type": "string", "description": "空气边界构造 ID", "tags": { "simulation": ["energy"] } },
+        "shadeConstruction": { "type": "string", "description": "遮阳构造 ID", "tags": { "simulation": ["energy", "daylight", "solar"] } }
+      },
+      "children": {
+        "wallSet": { "type": "SubSet", "description": "墙体构造", "tags": { "simulation": ["energy", "thermal_comfort", "carbon"] } },
+        "floorSet": { "type": "SubSet", "description": "楼板构造", "tags": { "simulation": ["energy", "thermal_comfort", "carbon"] } },
+        "roofCeilingSet": { "type": "SubSet", "description": "屋顶/顶棚构造", "tags": { "simulation": ["energy", "thermal_comfort", "carbon"] } },
+        "doorSet": { "type": "SubSet", "description": "门构造", "tags": { "simulation": ["energy", "thermal_comfort"] } },
+        "apertureSet": { "type": "SubSet", "description": "洞口构造", "tags": { "simulation": ["energy", "daylight", "solar"] } }
+      }
+    },
+
+    "RoomProgram": {
+      "description": "房间功能程序定义（人员、灯光、设备等热增益参数）",
+      "tags": { "scale": ["building"], "simulation": ["energy", "thermal_comfort", "carbon"] },
+      "attributes": {
+        "identifier": { "type": "string", "required": true, "tags": { "simulation": ["general"] } },
+        "displayName": { "type": "string", "required": true, "tags": { "simulation": ["general"] } },
+        "peopleDensity": { "type": "number", "default": 0.0333, "unit": "people/m²", "description": "人员密度", "tags": { "simulation": ["energy", "thermal_comfort", "carbon"] } },
+        "lightingDensity": { "type": "number", "default": 0, "unit": "W/m²", "description": "照明功率密度", "tags": { "simulation": ["energy", "daylight", "carbon"] } },
+        "equipmentDensity": { "type": "number", "default": 0, "unit": "W/m²", "description": "设备功率密度", "tags": { "simulation": ["energy", "carbon"] } },
+        "infiltrationCoefficient": { "type": "number", "default": 0.0003, "unit": "m³/s·m²", "description": "渗透风系数", "tags": { "simulation": ["energy", "wind", "thermal_comfort"] } },
+        "heatingSetpoint": { "type": "number", "default": 18, "unit": "°C", "description": "采暖设定温度", "tags": { "simulation": ["energy", "thermal_comfort"] } },
+        "coolingSetpoint": { "type": "number", "default": 26, "unit": "°C", "description": "制冷设定温度", "tags": { "simulation": ["energy", "thermal_comfort"] } }
+      },
+      "children": {
+        "occupancySchedule": { "type": "ScheduleRuleset", "description": "人员在室率排程", "tags": { "simulation": ["energy", "thermal_comfort"] } },
+        "lightingSchedule": { "type": "ScheduleRuleset", "description": "照明使用率排程", "tags": { "simulation": ["energy", "daylight"] } },
+        "equipmentSchedule": { "type": "ScheduleRuleset", "description": "设备使用率排程", "tags": { "simulation": ["energy"] } },
+        "infiltrationSchedule": { "type": "ScheduleRuleset", "description": "渗透风排程", "tags": { "simulation": ["energy", "wind"] } },
+        "heatingSchedule": { "type": "ScheduleRuleset", "description": "采暖设定温度排程", "tags": { "simulation": ["energy", "thermal_comfort"] } },
+        "coolingSchedule": { "type": "ScheduleRuleset", "description": "制冷设定温度排程", "tags": { "simulation": ["energy", "thermal_comfort"] } }
+      }
+    },
+
+    "ScheduleDay": {
+      "description": "单一全天时刻值序列定义",
+      "tags": { "simulation": ["general"] },
+      "attributes": {
+        "identifier": { "type": "string", "required": true, "tags": { "simulation": ["general"] } },
+        "times": { "type": "TimePoint[]", "description": "时刻点列表", "tags": { "simulation": ["general"] } },
+        "values": { "type": "number[]", "description": "对应时刻的值列表", "tags": { "simulation": ["general"] } },
+        "interpolate": { "type": "boolean", "default": false, "description": "是否插值", "tags": { "simulation": ["general"] } }
+      }
+    },
+
+    "ScheduleRule": {
+      "description": "基于日期范围与星期的排程应用规则",
+      "tags": { "simulation": ["general"] },
+      "attributes": {
+        "startDate": { "type": "DatePoint", "required": true, "description": "规则开始日期", "tags": { "simulation": ["general"] } },
+        "endDate": { "type": "DatePoint", "required": true, "description": "规则结束日期", "tags": { "simulation": ["general"] } },
+        "applyMonday": { "type": "boolean", "default": true, "tags": { "simulation": ["general"] } },
+        "applyTuesday": { "type": "boolean", "default": true, "tags": { "simulation": ["general"] } },
+        "applyWednesday": { "type": "boolean", "default": true, "tags": { "simulation": ["general"] } },
+        "applyThursday": { "type": "boolean", "default": true, "tags": { "simulation": ["general"] } },
+        "applyFriday": { "type": "boolean", "default": true, "tags": { "simulation": ["general"] } },
+        "applySaturday": { "type": "boolean", "default": true, "tags": { "simulation": ["general"] } },
+        "applySunday": { "type": "boolean", "default": true, "tags": { "simulation": ["general"] } }
+      },
+      "children": {
+        "scheduleDay": { "type": "ScheduleDay", "description": "关联的日排程", "tags": { "simulation": ["general"] } }
+      }
+    },
+
+    "ScheduleRuleset": {
+      "description": "排程规则集（包含默认值与特殊规则）",
+      "tags": { "simulation": ["general"] },
+      "attributes": {
+        "identifier": { "type": "string", "required": true, "tags": { "simulation": ["general"] } },
+        "displayName": { "type": "string", "tags": { "simulation": ["general"] } }
+      },
+      "children": {
+        "defaultDaySchedule": { "type": "ScheduleDay", "description": "默认日排程", "tags": { "simulation": ["general"] } },
+        "scheduleRules": { "type": "ScheduleRule", "multiple": true, "description": "特殊规则列表", "tags": { "simulation": ["general"] } },
+        "daySchedules": { "type": "ScheduleDay", "multiple": true, "description": "所有日排程列表", "tags": { "simulation": ["general"] } }
+      }
+    }
+  }
+}