389 lines
22 KiB
JSON
389 lines
22 KiB
JSON
{
|
|
"archgen": {
|
|
"version": "0.1.0",
|
|
"description": "ArchGen Schema — 建筑几何与核心实体",
|
|
"tags": {
|
|
"scale": {
|
|
"building": "建筑尺度",
|
|
"community": "社区/街区尺度",
|
|
"urban": "城市尺度"
|
|
},
|
|
"simulation": {
|
|
"energy": "能耗模拟",
|
|
"daylight": "采光分析",
|
|
"solar": "日照分析",
|
|
"thermal_comfort": "热舒适分析",
|
|
"carbon": "碳排放核算",
|
|
"wind": "风环境模拟",
|
|
"general": "通用（不特定于某种模拟）"
|
|
}
|
|
}
|
|
},
|
|
|
|
"types": {
|
|
"Point3d": {
|
|
"description": "三维点坐标",
|
|
"fields": {
|
|
"x": { "type": "number", "default": 0 },
|
|
"y": { "type": "number", "default": 0 },
|
|
"z": { "type": "number", "default": 0 }
|
|
}
|
|
},
|
|
"Polyline3d": {
|
|
"description": "三维多段线（点列表）",
|
|
"fields": {
|
|
"points": { "type": "Point3d[]", "default": [] }
|
|
}
|
|
},
|
|
"Vector3d": {
|
|
"description": "三维向量",
|
|
"fields": {
|
|
"x": { "type": "number", "default": 0 },
|
|
"y": { "type": "number", "default": 0 },
|
|
"z": { "type": "number", "default": 0 }
|
|
}
|
|
},
|
|
"Line3d": {
|
|
"description": "直线（起点+终点）",
|
|
"fields": {
|
|
"from": { "type": "Point3d" },
|
|
"to": { "type": "Point3d" }
|
|
}
|
|
},
|
|
"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" }
|
|
}
|
|
},
|
|
"UVRect": {
|
|
"description": "UV 矩形坐标 [u, v, 宽比, 高比]",
|
|
"fields": {
|
|
"u": { "type": "number" },
|
|
"v": { "type": "number" },
|
|
"widthRatio": { "type": "number" },
|
|
"heightRatio": { "type": "number" }
|
|
}
|
|
}
|
|
},
|
|
|
|
"enums": {
|
|
"Direction": {
|
|
"description": "朝向",
|
|
"values": ["N", "NE", "E", "SE", "S", "SW", "W", "NW"]
|
|
},
|
|
"BoundaryType": {
|
|
"description": "边界类型",
|
|
"values": [
|
|
"exterior_wall", "interior_wall", "curtain_wall",
|
|
"roof", "floor", "slab", "foundation"
|
|
]
|
|
},
|
|
"ElementType": {
|
|
"description": "结构构件类型",
|
|
"values": [
|
|
"column", "beam", "slab", "wall",
|
|
"foundation", "stair", "ramp"
|
|
]
|
|
},
|
|
"ApertureGeometryType": {
|
|
"description": "洞口几何类型",
|
|
"values": ["window", "door", "curtain_wall", "generic"]
|
|
},
|
|
"ApertureContextType": {
|
|
"description": "洞口内外上下文",
|
|
"values": ["EXTERIOR", "INTERIOR"]
|
|
},
|
|
"RoomCreationMethod": {
|
|
"description": "房间创建方式",
|
|
"values": ["planar_extrude", "mass_slice", "manual"]
|
|
},
|
|
"RelationType": {
|
|
"description": "拓扑关系类型",
|
|
"values": ["adjacent", "contains", "crosses", "flows", "touches", "sight"]
|
|
}
|
|
},
|
|
|
|
"entities": {
|
|
"Building": {
|
|
"description": "建筑顶级实体",
|
|
"tags": { "scale": ["building", "community", "urban"] },
|
|
"attributes": {
|
|
"identifier": { "type": "string", "required": true, "description": "唯一标识符", "tags": { "simulation": ["general"] } },
|
|
"displayName": { "type": "string", "description": "显示名称", "tags": { "simulation": ["general"] } },
|
|
"schemaVersion": { "type": "string", "required": true, "description": "archgen-schema 版本", "tags": { "simulation": ["general"] } },
|
|
"siteBasePoint": { "type": "Point3d", "required": true, "description": "建筑基准点", "tags": { "simulation": ["general"] } },
|
|
"northAngle": { "type": "number", "required": true, "default": 0, "description": "建筑正北角度", "tags": { "simulation": ["energy", "daylight", "solar", "thermal_comfort", "wind"] } },
|
|
"globalSettings": { "type": "object", "description": "全局设置", "tags": { "simulation": ["general"] } },
|
|
"metadata": { "type": "object", "description": "自定义元数据", "tags": { "simulation": ["general"] } }
|
|
},
|
|
"children": {
|
|
"floors": { "type": "Floor", "multiple": true, "description": "楼层列表", "tags": { "scale": ["building", "community"], "simulation": ["general"] } },
|
|
"masses": { "type": "MassEntity", "multiple": true, "description": "参数化体量", "tags": { "scale": ["building"], "simulation": ["general"] } },
|
|
"shafts": { "type": "Shaft", "multiple": true, "description": "竖井", "tags": { "scale": ["building"], "simulation": ["general"] } },
|
|
"shades": { "type": "Shade", "multiple": true, "description": "遮阳", "tags": { "scale": ["building", "community"], "simulation": ["energy", "daylight", "solar", "thermal_comfort"] } },
|
|
"siteShades": { "type": "Shade", "multiple": true, "description": "外部遮阳（树木、邻楼）", "tags": { "scale": ["building", "community", "urban"], "simulation": ["energy", "daylight", "solar", "wind"] } },
|
|
"gridSystem": { "type": "GridSystem", "description": "轴网系统", "tags": { "scale": ["building"], "simulation": ["general"] } },
|
|
"relations": { "type": "Relation", "multiple": true, "description": "拓扑关系", "tags": { "scale": ["building", "community", "urban"], "simulation": ["general"] } }
|
|
}
|
|
},
|
|
|
|
"Floor": {
|
|
"description": "楼层",
|
|
"tags": { "scale": ["building", "community"] },
|
|
"attributes": {
|
|
"identifier": { "type": "string", "required": true, "description": "唯一标识符", "tags": { "simulation": ["general"] } },
|
|
"displayName": { "type": "string", "description": "显示名称", "tags": { "simulation": ["general"] } },
|
|
"elevation": { "type": "number", "required": true, "description": "楼层标高 Z", "tags": { "simulation": ["general"] } },
|
|
"height": { "type": "number", "required": true, "description": "层高", "unit": "m", "tags": { "simulation": ["energy", "daylight", "thermal_comfort", "carbon"] } },
|
|
"story": { "type": "integer", "required": true, "description": "楼层序号", "tags": { "simulation": ["general"] } },
|
|
"outline": { "type": "Polyline3d", "description": "楼板轮廓", "tags": { "simulation": ["general"] } },
|
|
"metadata": { "type": "object", "tags": { "simulation": ["general"] } }
|
|
},
|
|
"children": {
|
|
"rooms": { "type": "Room", "multiple": true, "description": "房间" },
|
|
"apertures": { "type": "Aperture", "multiple": true, "description": "楼层级洞口", "tags": { "scale": ["building"], "simulation": ["energy", "daylight", "wind"] } },
|
|
"elements": { "type": "Element", "multiple": true, "description": "结构构件", "tags": { "scale": ["building"], "simulation": ["general"] } }
|
|
}
|
|
},
|
|
|
|
"Room": {
|
|
"description": "房间",
|
|
"tags": { "scale": ["building", "community"] },
|
|
"discriminator": "creationMethod",
|
|
"variants": {
|
|
"planar_extrude": {
|
|
"description": "平面轮廓拉伸创建",
|
|
"attributes": {
|
|
"identifier": { "type": "string", "required": true, "tags": { "simulation": ["general"] } },
|
|
"displayName": { "type": "string", "tags": { "simulation": ["general"] } },
|
|
"creationMethod": { "type": "RoomCreationMethod", "required": true, "default": "planar_extrude", "tags": { "simulation": ["general"] } },
|
|
"programType": { "type": "string", "description": "房间功能类型", "tags": { "scale": ["building"], "simulation": ["energy", "thermal_comfort", "carbon"] } },
|
|
"region": { "type": "Polyline3d", "required": true, "description": "房间轮廓", "tags": { "simulation": ["energy", "daylight", "solar", "wind", "thermal_comfort"] } },
|
|
"height": { "type": "number", "required": true, "description": "房间高度", "tags": { "simulation": ["energy", "daylight", "thermal_comfort"] } },
|
|
"elevation": { "type": "number", "description": "楼层内 Z 偏移", "tags": { "simulation": ["general"] } },
|
|
"boundaries": { "type": "Boundary[]", "description": "房间边界/墙体", "tags": { "simulation": ["energy", "thermal_comfort"] } },
|
|
"apertures": { "type": "string[]", "description": "关联洞口 ID 列表", "tags": { "scale": ["building"], "simulation": ["energy", "daylight", "wind"] } },
|
|
"elements": { "type": "Element[]", "description": "房间内构件", "tags": { "scale": ["building"], "simulation": ["general"] } },
|
|
"geometryDriver": { "type": "object", "description": "几何驱动参数", "tags": { "simulation": ["general"] } },
|
|
"metadata": { "type": "object", "tags": { "simulation": ["general"] } }
|
|
}
|
|
},
|
|
"mass_slice": {
|
|
"description": "体量切片创建",
|
|
"attributes": {
|
|
"identifier": { "type": "string", "required": true, "tags": { "simulation": ["general"] } },
|
|
"displayName": { "type": "string", "tags": { "simulation": ["general"] } },
|
|
"creationMethod": { "type": "RoomCreationMethod", "required": true, "default": "mass_slice", "tags": { "simulation": ["general"] } },
|
|
"programType": { "type": "string", "tags": { "scale": ["building"], "simulation": ["energy", "thermal_comfort", "carbon"] } },
|
|
"region": { "type": "Polyline3d", "required": true, "tags": { "simulation": ["energy", "daylight", "solar", "wind", "thermal_comfort"] } },
|
|
"height": { "type": "number", "required": true, "tags": { "simulation": ["energy", "daylight", "thermal_comfort"] } },
|
|
"elevation": { "type": "number", "tags": { "simulation": ["general"] } },
|
|
"boundaries": { "type": "Boundary[]", "tags": { "simulation": ["energy", "thermal_comfort"] } },
|
|
"apertures": { "type": "string[]", "tags": { "scale": ["building"], "simulation": ["energy", "daylight", "wind"] } },
|
|
"elements": { "type": "Element[]", "tags": { "scale": ["building"], "simulation": ["general"] } },
|
|
"driverRef": {
|
|
"type": "object", "required": true, "description": "体量引用",
|
|
"tags": { "simulation": ["general"] },
|
|
"attributes": {
|
|
"massId": { "type": "string", "required": true },
|
|
"sliceZ": { "type": "number", "required": true }
|
|
}
|
|
},
|
|
"metadata": { "type": "object", "tags": { "simulation": ["general"] } }
|
|
}
|
|
},
|
|
"manual": {
|
|
"description": "手动绘制",
|
|
"attributes": {
|
|
"identifier": { "type": "string", "required": true, "tags": { "simulation": ["general"] } },
|
|
"displayName": { "type": "string", "tags": { "simulation": ["general"] } },
|
|
"creationMethod": { "type": "RoomCreationMethod", "required": true, "default": "manual", "tags": { "simulation": ["general"] } },
|
|
"programType": { "type": "string", "tags": { "scale": ["building"], "simulation": ["energy", "thermal_comfort", "carbon"] } },
|
|
"region": { "type": "Polyline3d", "required": true, "tags": { "simulation": ["energy", "daylight", "solar", "wind", "thermal_comfort"] } },
|
|
"height": { "type": "number", "required": true, "tags": { "simulation": ["energy", "daylight", "thermal_comfort"] } },
|
|
"elevation": { "type": "number", "tags": { "simulation": ["general"] } },
|
|
"boundaries": { "type": "Boundary[]", "tags": { "simulation": ["energy", "thermal_comfort"] } },
|
|
"apertures": { "type": "string[]", "tags": { "scale": ["building"], "simulation": ["energy", "daylight", "wind"] } },
|
|
"elements": { "type": "Element[]", "tags": { "scale": ["building"], "simulation": ["general"] } },
|
|
"metadata": { "type": "object", "tags": { "simulation": ["general"] } }
|
|
}
|
|
}
|
|
}
|
|
},
|
|
|
|
"Aperture": {
|
|
"description": "建筑洞口",
|
|
"tags": { "scale": ["building"], "simulation": ["energy", "daylight", "solar", "wind"] },
|
|
"discriminator": "sourceType",
|
|
"variants": {
|
|
"hosted": {
|
|
"description": "绑定到特定形体面",
|
|
"attributes": {
|
|
"identifier": { "type": "string", "required": true, "tags": { "simulation": ["general"] } },
|
|
"displayName": { "type": "string", "tags": { "simulation": ["general"] } },
|
|
"sourceType": { "type": "string", "required": true, "default": "hosted", "tags": { "simulation": ["general"] } },
|
|
"geometryType": { "type": "ApertureGeometryType", "required": true, "tags": { "simulation": ["energy", "daylight", "solar", "wind"] } },
|
|
"width": { "type": "number", "tags": { "simulation": ["energy", "daylight"] } },
|
|
"height": { "type": "number", "tags": { "simulation": ["energy", "daylight"] } },
|
|
"sillHeight": { "type": "number", "description": "窗台高", "tags": { "simulation": ["energy", "daylight"] } },
|
|
"parent": { "type": "string", "description": "父实体 ID", "tags": { "simulation": ["general"] } },
|
|
"rooms": { "type": "string[]", "description": "相邻房间 ID", "tags": { "simulation": ["energy", "thermal_comfort"] } },
|
|
"openRatio": { "type": "number", "default": 0, "description": "开启比", "tags": { "simulation": ["energy", "wind", "thermal_comfort"] } },
|
|
"operable": { "type": "boolean", "default": false, "tags": { "simulation": ["energy", "wind", "thermal_comfort"] } },
|
|
"hosting": {
|
|
"type": "object", "required": true, "description": "宿主绑定信息",
|
|
"tags": { "simulation": ["general"] },
|
|
"attributes": {
|
|
"hostId": { "type": "string", "required": true },
|
|
"faceIndex": { "type": "integer", "required": true },
|
|
"uvRect": { "type": "UVRect", "required": true },
|
|
"context": { "type": "ApertureContextType", "required": true }
|
|
}
|
|
},
|
|
"metadata": { "type": "object", "tags": { "simulation": ["general"] } }
|
|
}
|
|
},
|
|
"declarative": {
|
|
"description": "声明式放置",
|
|
"attributes": {
|
|
"identifier": { "type": "string", "required": true, "tags": { "simulation": ["general"] } },
|
|
"displayName": { "type": "string", "tags": { "simulation": ["general"] } },
|
|
"sourceType": { "type": "string", "required": true, "default": "declarative", "tags": { "simulation": ["general"] } },
|
|
"geometryType": { "type": "ApertureGeometryType", "required": true, "tags": { "simulation": ["energy", "daylight", "solar", "wind"] } },
|
|
"width": { "type": "number", "tags": { "simulation": ["energy", "daylight"] } },
|
|
"height": { "type": "number", "tags": { "simulation": ["energy", "daylight"] } },
|
|
"sillHeight": { "type": "number", "tags": { "simulation": ["energy", "daylight"] } },
|
|
"parent": { "type": "string", "tags": { "simulation": ["general"] } },
|
|
"rooms": { "type": "string[]", "tags": { "simulation": ["energy", "thermal_comfort"] } },
|
|
"openRatio": { "type": "number", "default": 0, "tags": { "simulation": ["energy", "wind", "thermal_comfort"] } },
|
|
"operable": { "type": "boolean", "default": false, "tags": { "simulation": ["energy", "wind", "thermal_comfort"] } },
|
|
"placement": {
|
|
"type": "object", "description": "放置描述",
|
|
"tags": { "simulation": ["general"] },
|
|
"attributes": {
|
|
"boundaryId": { "type": "string" },
|
|
"position": { "type": "string", "description": "center, start, end 或距离" },
|
|
"orientation": { "type": "Direction" }
|
|
}
|
|
},
|
|
"metadata": { "type": "object", "tags": { "simulation": ["general"] } }
|
|
}
|
|
}
|
|
}
|
|
},
|
|
|
|
"Boundary": {
|
|
"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": "BoundaryType", "required": true, "tags": { "simulation": ["energy", "thermal_comfort", "carbon"] } },
|
|
"region": { "type": "Polyline3d", "required": true, "description": "边界线段或多边形", "tags": { "simulation": ["energy", "thermal_comfort"] } },
|
|
"thickness": { "type": "number", "description": "墙厚", "unit": "m", "tags": { "scale": ["building"], "simulation": ["energy", "thermal_comfort", "carbon"] } },
|
|
"height": { "type": "number", "description": "墙高", "unit": "m", "tags": { "simulation": ["energy", "thermal_comfort"] } },
|
|
"direction": { "type": "Direction", "description": "朝向", "tags": { "simulation": ["energy", "daylight", "solar"] } },
|
|
"pitch": { "type": "number", "description": "倾斜角度", "unit": "deg", "tags": { "simulation": ["energy", "solar"] } },
|
|
"hostRoomId": { "type": "string", "description": "所属房间 ID", "tags": { "simulation": ["general"] } },
|
|
"constructionId": { "type": "string", "description": "构造 ID", "tags": { "simulation": ["energy", "thermal_comfort", "carbon"] } },
|
|
"sharedBy": { "type": "string[]", "description": "共享此边界的房间 ID 列表", "tags": { "simulation": ["thermal_comfort"] } },
|
|
"metadata": { "type": "object", "tags": { "simulation": ["general"] } }
|
|
}
|
|
},
|
|
|
|
"Element": {
|
|
"description": "结构构件",
|
|
"tags": { "scale": ["building"] },
|
|
"attributes": {
|
|
"identifier": { "type": "string", "required": true, "tags": { "simulation": ["general"] } },
|
|
"displayName": { "type": "string", "tags": { "simulation": ["general"] } },
|
|
"type": { "type": "ElementType", "required": true, "tags": { "simulation": ["general"] } },
|
|
"region": { "type": "Polyline3d", "description": "截面轮廓", "tags": { "simulation": ["general"] } },
|
|
"height": { "type": "number", "unit": "m", "tags": { "simulation": ["general"] } },
|
|
"materialId": { "type": "string", "description": "材料 ID", "tags": { "simulation": ["carbon"] } },
|
|
"metadata": { "type": "object", "tags": { "simulation": ["general"] } }
|
|
}
|
|
},
|
|
|
|
"MassEntity": {
|
|
"description": "参数化体量",
|
|
"tags": { "scale": ["building"] },
|
|
"attributes": {
|
|
"identifier": { "type": "string", "required": true, "tags": { "simulation": ["general"] } },
|
|
"displayName": { "type": "string", "tags": { "simulation": ["general"] } },
|
|
"region": { "type": "Polyline3d", "tags": { "simulation": ["general"] } },
|
|
"height": { "type": "number", "unit": "m", "tags": { "simulation": ["general"] } },
|
|
"metadata": { "type": "object", "tags": { "simulation": ["general"] } }
|
|
}
|
|
},
|
|
|
|
"Shaft": {
|
|
"description": "竖井（楼梯/电梯/管道）",
|
|
"tags": { "scale": ["building"] },
|
|
"attributes": {
|
|
"identifier": { "type": "string", "required": true, "tags": { "simulation": ["general"] } },
|
|
"displayName": { "type": "string", "tags": { "simulation": ["general"] } },
|
|
"type": { "type": "string", "description": "stair/elevator/duct", "tags": { "simulation": ["general"] } },
|
|
"spanLevels": { "type": "string[]", "description": "穿越的楼层 ID", "tags": { "simulation": ["general"] } },
|
|
"region": { "type": "Polyline3d", "description": "竖井截面", "tags": { "simulation": ["general"] } },
|
|
"metadata": { "type": "object", "tags": { "simulation": ["general"] } }
|
|
}
|
|
},
|
|
|
|
"Shade": {
|
|
"description": "遮阳构件",
|
|
"tags": { "scale": ["building", "community"], "simulation": ["energy", "daylight", "solar", "thermal_comfort"] },
|
|
"attributes": {
|
|
"identifier": { "type": "string", "required": true, "tags": { "simulation": ["general"] } },
|
|
"displayName": { "type": "string", "tags": { "simulation": ["general"] } },
|
|
"region": { "type": "Polyline3d", "description": "遮阳轮廓", "tags": { "simulation": ["energy", "daylight", "solar", "thermal_comfort"] } },
|
|
"height": { "type": "number", "unit": "m", "tags": { "simulation": ["energy", "daylight", "solar"] } },
|
|
"transmittance": { "type": "number", "default": 0, "description": "透射率 0-1", "tags": { "simulation": ["energy", "daylight", "solar"] } },
|
|
"metadata": { "type": "object", "tags": { "simulation": ["general"] } }
|
|
}
|
|
},
|
|
|
|
"GridSystem": {
|
|
"description": "轴网系统",
|
|
"tags": { "scale": ["building"] },
|
|
"attributes": {
|
|
"identifier": { "type": "string", "required": true, "tags": { "simulation": ["general"] } },
|
|
"displayName": { "type": "string", "tags": { "simulation": ["general"] } },
|
|
"axisX": { "type": "string[]", "description": "X 向轴线名", "tags": { "simulation": ["general"] } },
|
|
"axisY": { "type": "string[]", "description": "Y 向轴线名", "tags": { "simulation": ["general"] } },
|
|
"spacingsX": { "type": "number[]", "description": "X 向跨距", "unit": "m", "tags": { "simulation": ["general"] } },
|
|
"spacingsY": { "type": "number[]", "description": "Y 向跨距", "unit": "m", "tags": { "simulation": ["general"] } },
|
|
"origin": { "type": "Point3d", "required": true, "description": "轴网原点", "tags": { "simulation": ["general"] } },
|
|
"metadata": { "type": "object", "tags": { "simulation": ["general"] } }
|
|
}
|
|
},
|
|
|
|
"Relation": {
|
|
"description": "拓扑关系边",
|
|
"tags": { "scale": ["building", "community", "urban"] },
|
|
"attributes": {
|
|
"type": { "type": "RelationType", "required": true, "tags": { "simulation": ["general"] } },
|
|
"source": { "type": "string", "required": true, "description": "源实体 ID", "tags": { "simulation": ["general"] } },
|
|
"target": { "type": "string", "required": true, "description": "目标实体 ID", "tags": { "simulation": ["general"] } },
|
|
"metadata": { "type": "object", "tags": { "simulation": ["general"] } }
|
|
}
|
|
}
|
|
}
|
|
}
|