用途:面向 Speckle 开发,指导创建基础对象、几何图元、集合和领域对象(Wall、Floor、Beam 等),避免常见错误。
主要能力:
- Base 对象创建。Python:from specklepy.objects import Base;C#:using Speckle.Sdk.Models; new Base()。支持动态属性(字典式 obj["name"]、属性式 obj.name)与构造函数 kwargs。
- 类型化属性:Python 用 @dataclass(kw_only=True) 继承 Base 并指定 speckle_type;C# 继承 Base,可用 [DetachProperty]。
- 几何图元:Point(x,y,z,units)、Vector、Line(start,end,units)、Polyline(value 扁平坐标,closed,units)、Arc/Circle/Ellipse(需 Plane)、Mesh(vertices 顶点扁平坐标、faces 以顶点数开头的索引编码)、Brep(NURBS 边界表示)。
- 集合:Collection(name, collectionType, elements),须构成严格有向树,根集合为顶层容器。
- 领域对象(C# Speckle.Objects):Wall、Floor、Beam、Column 等,含语义属性、displayValue 与可选 bbox。
- displayValue:存放可视化几何图元列表,供查看器渲染,需分离。
- 分离机制:动态属性名加 @ 前缀,或 C# 用 [DetachProperty],实现去重、惰性加载和高效传输。
关键规则与限制:
- 几何对象必须设置 units;合法值含 "m"(服务端默认)、"mm"、"cm"、"ft"、"in",缺失会导致接收端比例错误。
- 不可将几何图元直接作为根对象发送,查看器不会渲染,须用 Base 容器包装并命名属性。
- 属性名禁用 . 和 /,禁用空字符串与连续 @@;__ 前缀属性不参与序列化和哈希。
- 集合不可有环或共享父节点。
- 勿在大对象循环中调用 get_id()/GetId(),会触发完整递归序列化。
- Brep 通常由连接器生成,不建议手工构造。
用法:Python 引入 specklepy.objects 与 specklepy.objects.geometry,按类型构造并设置 units,再通过 operations.send(base=container, transports=[transport]) 发送。C# 引入 Speckle.Sdk.Models、Speckle.Objects.Geometry、Speckle.Objects.Other、Speckle.Objects.BuiltElements,用 Operations.Send。
适用场景:编写 Speckle 连接器、生成几何与 BIM 语义对象、组织集合层级、优化大数据传输。
限制:本技能未提供具体版本号、安装命令、收费信息与定价,均暂未提供;部分完整示例可参见其引用文档。官方参考包括 docs.speckle.systems 与 speckle.guide 相关页面。