지식 베이스

Grasshopper와 Connection 간의 새로운 REST API

Steel

v25.0

Connection

Grasshopper

Parametric design

이 기사는 다음 언어로도 제공됩니다:

영어에서 AI로 번역됨

Grasshopper 플러그인이 새로운 IDEA StatiCa Connection API 및 IOM 버전으로 업데이트되었습니다. 이는 현대적인 API에 더욱 부합하는 새로운 경험을 제공합니다. 각 구성 요소는 API 상호작용과 긴밀하게 연결되어 있습니다.

새로운 Rest Connection API의 출시로 인해, 구 API(ConHiddenCalculator)와 관련된 현재 Grasshopper 구성 요소는 IDEA StatiCa 버전 24.1.3부터 해당 API가 더 이상 지원되지 않으므로 작동하지 않습니다.

플러그인 설치

이전 버전과 마찬가지로, 플러그인은 Rhino Package Manager를 통해 설치할 수 있습니다. Rhino 명령 프롬프트에서 PackageManager를 입력하여 Package Manager를 여십시오. IDEA StatiCa 플러그인의 최신 버전을 업데이트하거나 설치하기만 하면 됩니다.

새로운 Grasshopper 플러그인의 장점

새 버전의 플러그인을 통해 사용자는 새로운 API의 향상된 기능과 Grasshopper 및 IDEA StatiCa Connection 간의 훨씬 쉬운 상호작용을 이용할 수 있습니다.

구 플러그인 버전 0.1.X

구성 요소 사용 시 API에서 발생하는 작업을 이해하기 어려움
많은 IO 작업
계산과 같은 긴 작업으로 인해 스크립트가 멈춤
모든 객체에 대한 많은 구성 요소
프로젝트 내 여러 연결에서 작동하지 않음
특정 버전의 IDEA StatiCa를 선택하기 어려움

새 플러그인 버전 0.2.0

실제 API 방식과 긴밀하게 연결됨 (Python 또는 C#으로의 전환이 용이)
사용자가 저장하기 전까지 프로젝트는 서버에 유지됨
API 구성 요소는 비동기식으로, 구성 요소가 계산 중에도 사용자가 스크립팅을 계속할 수 있음
API 객체의 자동 분해
프로젝트 내 모든 연결과 기본적으로 호환
API attacher/runner를 통해 버전 지정이 용이
Grasshopper에서 직접 IFC 파일 내보내기
템플릿 적용 워크플로우가 애플리케이션과 통합됨
핀 및 앵커를 IOM 구성 요소에서 정의 가능

구성 요소 개요

새 플러그인은 Grasshopper 리본의 두 패널로 구분됩니다.

App Common: 모든 IDEA StatiCa 설계 API에 공통적인 API 구성 요소.
Connection: 연결 API에 특화된 구성 요소.

Grasshopper를 통한 API 연결

다른 API 클라이언트와 유사하게, Grasshopper 스크립트를 runner API 인스턴스(Connection Service Attacher)에 연결하거나 Grasshopper 내에서 서비스를 시작(Connection Service Runner)할 수 있습니다. 사용자는 API 구성 요소를 실행하기 전에 위의 구성 요소 중 하나를 선택하고 실행해야 합니다.

잘못된 경우:

유효한 API 연결 없이 구성 요소를 실행하려고 하면 해당 구성 요소에 오류 메시지가 표시됩니다.

올바른 경우:

유효한 API 연결이 설정되면, 스크립트가 닫히거나 다른 곳으로 이동하기 전까지 Service 구성 요소를 다시 실행할 필요가 없습니다. 연결은 모든 구성 요소가 접근할 수 있도록 로컬에 저장됩니다.

API 구성 요소

아래의 "Active" 버튼은 API와 상호작용하는 구성 요소를 쉽게 식별합니다. 구성 요소는 Run 버튼을 클릭하여 한 번 실행하거나, active 구성 요소에 연결된 true/false 토글을 사용하여 지속적으로 실행할 수 있습니다.

API 구성 요소는 Connection API의 Controller와 밀접하게 관련되어 있습니다. Controller는 작업 기반(계산, 내보내기, 보고서) 또는 객체 기반(하중 효과, 부재, 매개변수 등)으로 구분됩니다.

작업 기반: 작업 기반 Controller는 특정 연결 또는 프로젝트에 대해 계산 또는 내보내기 기능을 포함한 특정 작업을 수행합니다.

객체 기반: 객체 기반 Controller는 일반적으로 Get 구성 요소와 Update 구성 요소를 가집니다:

Get: Connection 내의 모든 Controller 유형 객체를 검색하고, 분해하거나 수정할 수 있는 특정 객체를 가져옵니다.
Update: Grasshopper 스크립트에서 업데이트된 객체를 갱신합니다. 객체는 자동 Modify Object 구성 요소를 사용하여 업데이트됩니다.

대부분의 API 구성 요소는 분해하거나 수정할 수 있는 객체의 입력과 출력을 처리합니다. 이 형식으로 구성 요소를 제공하면 사용자가 추가해야 하는 구성 요소의 전체 수가 줄어듭니다.

가장 기본적인 예는 프로젝트를 분해하여 사용 가능한 연결과 같은 내부 정보를 얻는 것입니다.