API REST mới giữa Grasshopper và Connection

Với việc phát hành REST Connection API mới, các thành phần Grasshopper hiện tại liên quan đến API cũ (ConHiddenCalculator) sẽ không còn hoạt động vì API này không còn được hỗ trợ từ IDEA StatiCa phiên bản 24.1.3.

Cài đặt plugin

Cũng như các phiên bản cũ hơn, plugin có thể được cài đặt thông qua Rhino Package Manager. Mở Package Manager bằng cách gõ PackageManager trong dòng lệnh Rhino. Chỉ cần cập nhật hoặc cài đặt phiên bản mới nhất của plugin IDEA StatiCa.

Ưu điểm của plugin Grasshopper mới

Với phiên bản mới của plugin, người dùng có thể truy cập các tính năng nâng cao của API mới và tương tác dễ dàng hơn nhiều giữa Grasshopper và IDEA StatiCa Connection.

Phiên bản plugin cũ 0.1.X

• Khó hiểu những gì đang xảy ra trong API khi sử dụng các thành phần
• Nhiều thao tác IO
• Các thao tác dài (như tính toán) khiến script bị đóng băng
• Nhiều thành phần cho tất cả các đối tượng
• Không hoạt động với nhiều liên kết trong một dự án
• Khó chọn phiên bản cụ thể của IDEA StatiCa

Phiên bản plugin mới 0.2.0

• Liên kết rất chặt chẽ với văn hóa API thực tế (dễ dàng chuyển đổi sang Python hoặc C#) 
• Các dự án được lưu trên máy chủ cho đến khi người dùng lưu lại
• Các thành phần API là bất đồng bộ, người dùng có thể tiếp tục viết script trong khi các thành phần đang tính toán
• Tự động phân tách các đối tượng API
• Hoạt động nguyên bản với tất cả các liên kết trong dự án
• API attacher/runner cho phép chỉ định phiên bản dễ dàng
• Xuất file IFC trực tiếp trong Grasshopper 
• Quy trình áp dụng mẫu được thống nhất với ứng dụng
• Các chốt và neo có thể được định nghĩa trong các thành phần IOM

Tổng quan về các thành phần

Plugin mới được chia thành hai bảng trong thanh ribbon của Grasshopper. 

1. App Common: Các thành phần API chung cho tất cả các API thiết kế của IDEA StatiCa. 
2. Connection: Các thành phần dành riêng cho Connection API. 

Kết nối với API thông qua Grasshopper

Tương tự như các API client khác, bạn có thể kết nối script Grasshopper với một phiên bản API runner (Connection Service Attacher) hoặc khởi động dịch vụ trong Grasshopper (Connection Service Runner). Người dùng phải chọn một trong các thành phần trên và chạy nó trước khi bất kỳ thành phần API nào có thể chạy. 

Sai:

Bạn sẽ nhận được thông báo lỗi trên thành phần nếu thành phần đó đã cố chạy mà không có kết nối API hợp lệ.

Đúng: 

Khi đã có kết nối API hợp lệ, thành phần Service sẽ không cần chạy lại cho đến khi script được đóng hoặc điều hướng ra khỏi nó. Kết nối được lưu trữ cục bộ để tất cả các thành phần có thể truy cập.

Các thành phần API

Nút "Active" bên dưới giúp dễ dàng nhận biết các thành phần tương tác với API. Một thành phần có thể được chạy một lần bằng cách nhấn nút Run hoặc thực thi liên tục bằng cách sử dụng công tắc true/false được kết nối vào thành phần active.

Các thành phần API có liên quan chặt chẽ đến Controllers trong Connection API. Controllers có thể dựa trên hành động (Calculation, Export, Report) hoặc dựa trên đối tượng (Hiệu ứng tải trọng, Cấu kiện, Tham số, v.v.).

Dựa trên hành động: Các controller dựa trên hành động thực hiện các tác vụ hoặc thao tác cụ thể trên một liên kết hoặc dự án cụ thể, bao gồm chức năng tính toán hoặc xuất dữ liệu

 Dựa trên đối tượng: Các controller dựa trên đối tượng thường có thành phần Get và thành phần Update:

• Get: Truy xuất tất cả các đối tượng kiểu controller trong Connection và truy xuất các đối tượng cụ thể có thể được phân tách hoặc chỉnh sửa. 
• Update: Cập nhật các đối tượng được cung cấp đã được cập nhật trong script Grasshopper. Các đối tượng được cập nhật bằng thành phần Modify Object tự động.

Hầu hết các thành phần API sẽ nhận đầu vào và cung cấp đầu ra là các đối tượng, có thể được phân tách hoặc chỉnh sửa. Cung cấp các thành phần theo định dạng này giúp giảm tổng số thành phần mà người dùng cần thêm vào.

Ví dụ cơ bản nhất là phân tách một Project để lấy thông tin có sẵn trong đó, chẳng hạn như các liên kết hiện có. 

Ví dụ đơn giản – cập nhật tham số liên kết

Xem ví dụ đơn giản về cách thành phần Modify hoạt động. Hình ảnh dưới đây cho thấy ví dụ về việc sử dụng các thành phần API và Automatic Object trong một ứng dụng đơn giản của mẫu và cập nhật các tham số liên kết. 

Các ví dụ sẵn sàng sử dụng

Danh sách đầy đủ các ví dụ có sẵn cho người dùng tải plugin trong file nén: %appdata%\McNeel\Rhinoceros\packages\8.0\IdeaStatiCaGrasshopper\[0.0.0]\Examples 0.2.0.zip

Tương thích phiên bản

Plugin mới, phiên bản 0.2.0, có sẵn trong Rhino Package Manager và sẽ hoạt động với IDEA StatiCa phiên bản 24.1.3 và mới hơn.

Phiên bản cũ hơn 0.1.x cũng sẽ có sẵn và sẽ hoạt động với IDEA StatiCa phiên bản 24.1.2 và cũ hơn.

Phát hành trong IDEA StatiCa phiên bản 24.1.4