Module 10 — Speckle: Collaboration & Version Control
Thời lượng: ~4 giờ · Độ khó: Trung bình
Mục tiêu: Thiết lập quy trình cộng tác đa phần mềm với Speckle — send/receive dữ liệu giữa Rhino, GH, Revit, và web viewer.
10.1 — Speckle là gì?
Speckle là nền tảng mở (open-source) cho:
- Gửi/nhận geometry và dữ liệu giữa các phần mềm AEC
- Version control cho 3D models
- Chia sẻ model qua web browser (không cần phần mềm)
- Automation pipeline giữa Rhino/GH/Revit/etc.
So sánh với giải pháp truyền thống:
IFC/DWG export ← tĩnh, 1 chiều, mất dữ liệu
Speckle ← realtime, 2 chiều, giữ metadata
10.2 — Cài đặt và Tài khoản
1. Tạo tài khoản: app.speckle.systems (miễn phí)
2. Cài Speckle Connector cho Rhino:
Rhino > Package Manager > "Speckle"
3. Cài Speckle GH package:
Tự động khi cài Rhino connector
4. (Optional) Cài Speckle cho Revit từ Speckle.systems/downloads
10.3 — Speckle trong Rhino
Giao diện Speckle
Trong Rhino: SpecklePanel (gõ "Speckle" trong command bar)
→ Danh sách Projects và Streams
→ Send / Receive buttons
Send từ Rhino
1. Chọn objects trong Rhino
2. Speckle Panel → New Stream (hoặc chọn stream có sẵn)
3. "Send" → chọn objects → Add message (commit message)
4. URL được tạo → copy để share
Receive vào Rhino
1. Paste Stream URL vào Speckle Panel
2. Chọn commit version
3. Receive → objects xuất hiện trong Rhino
10.4 — Speckle trong Grasshopper
Send Component
Component: Speckle > Send
Input:
- Data (D) → objects cần gửi (geometry hoặc custom data)
- Stream (S) → Stream URL hoặc ID
- Message (M) → commit message
- Send trigger → Button hoặc True
→ Mỗi lần trigger = 1 commit mới trong version history
Receive Component
Component: Speckle > Receive
Input:
- Stream (S) → Stream URL
- Branch (B) → "main" hoặc branch tên khác
Output:
- Data → objects nhận được
Tự động cập nhật khi có commit mới (nếu bật AutoReceive)
GH Auto-Send Workflow
Use case: GH chạy analysis mỗi khi slider thay đổi → tự động push lên Speckle
Timer component → trigger Send mỗi 30 giây (hoặc Boolean Toggle)
→ Mỗi design iteration được lưu tự động
Kết quả: Version history đầy đủ của toàn bộ quá trình thiết kế
10.5 — Speckle Web Viewer
URL: app.speckle.systems/projects/[ID]/models
→ Xem model 3D trong trình duyệt
→ Click elements → xem properties/data
→ Embed vào website hoặc Notion page
→ Comment trực tiếp trên model
Chia sẻ với Client
1. Tạo Stream Public hoặc invite email
2. Copy viewer link
3. Client mở browser → xem model không cần cài phần mềm
4. Client comment tại điểm cụ thể trên model
5. Architect nhận notification → update GH → push version mới
10.6 — Quy trình Cộng tác Đa Chuyên ngành
Scenario: Kiến trúc sư + Kết cấu sư + MEP engineer
1. KTS: Rhino/GH → Send to Speckle (Branch: "architecture")
2. Kết cấu: Receive từ "architecture" → import vào Karamba/SAP2000
3. Kết cấu: Gửi kết quả phân tích → Send (Branch: "structure")
4. KTS: Receive từ "structure" → xem kết quả → adjust design
5. MEP: Receive cả 2 branches → coordination
Branch system:
main → đã được kiểm duyệt
architecture → KTS đang làm việc
structure → Kết cấu đang làm việc
review → để client xem
Bài tập Module 10 — Setup Collaboration Workflow
Đề bài: Thiết lập pipeline Speckle cho dự án pavilion từ Module 6.
Tasks:
1. Tạo Speckle Project: "Parametric-Pavilion-[Tên của bạn]"
2 branches: "design" và "fabrication"
2. GH → Send tensile pavilion geometry + metadata:
Send Data:
- Membrane mesh
- Mast geometry (lines)
- Panel count (Metadata)
- Total surface area (Metadata)
Branch: "design"
Message: "v1 - initial design"
3. Thay đổi mast height slider → Send lại
Message: "v2 - raised mast by 1m"
4. Trong Speckle Web:
- So sánh v1 và v2 (diff mode)
- Comment 1 điểm trên membrane
5. GH → Receive lại → xác nhận data đúng
6. Send version "fabrication":
- Chỉ gửi flattened panels (unrolled)
- Metadata: Panel ID + Area cho mỗi panel
Branch: "fabrication"
7. Screenshot web viewer → gửi link cho giảng viên
Liên kết kiến thức
Nền tảng cần nắm
Chủ đề liên quan