Grasshopper ve Connection Arasındaki Yeni REST API
Yeni Rest Connection API'nin yayınlanmasıyla birlikte, Eski API'ye (ConHiddenCalculator) ilişkin mevcut Grasshopper bileşenleri artık çalışmayacaktır; zira bu API, IDEA StatiCa 24.1.3 sürümünden itibaren desteklenmemektedir.
Eklentinin kurulumu
Eski sürümlerde olduğu gibi, eklenti kurulabilir Rhino Package Manager aracılığıyla. Rhino komut satırına PackageManager yazarak Package Manager'ı açın. IDEA StatiCa eklentisinin mevcut en son sürümünü güncelleyin veya yükleyin.
Yeni Grasshopper eklentisinin avantajları
Eklentinin yeni sürümüyle kullanıcılar, yeni API'nin gelişmiş özelliklerine ve Grasshopper ile IDEA StatiCa Connection arasında çok daha kolay bir etkileşime sahip olur.
Eski eklenti sürümü 0.1.X
- Bileşenler kullanılırken API'de neler olduğunu anlamak güçtür
- Çok sayıda G/Ç işlemi
- Uzun süren işlemler (hesaplama gibi) betiğin donmasına neden olur
- Tüm nesneler için çok sayıda bileşen
- Bir projede birden fazla birleşimle çalışmaz
- IDEA StatiCa'nın belirli bir sürümünü seçmek güçtür
Yeni eklenti sürümü 0.2.0
- Gerçek API kültürüyle çok daha sıkı bağlantılı (Python veya C#'a geçişi kolaylaştırır)
- Projeler, kullanıcı tarafından kaydedilene kadar sunucuda kalır
- API bileşenleri asenkrondur; bileşenler hesaplama yaparken kullanıcılar betik yazmaya devam edebilir
- API nesnelerinin otomatik olarak ayrıştırılması
- Projedeki tüm birleşimlerle yerel olarak çalışır
- API ekleyici/çalıştırıcı, kolay sürüm belirtimi sağlar
- IFC dosyalarını doğrudan Grasshopper'da dışa aktarın
- Şablon uygulama iş akışı, uygulama ile birleştirilmiştir
- Pinler ve ankrajlar IOM Bileşenlerinde tanımlanabilir
Bileşenlere genel bakış
Yeni eklenti, Grasshopper şeridinde iki panele ayrılmıştır.
- App Common: Tüm IDEA StatiCa tasarım API'lerinde ortak olan API bileşenleri.
- Connection: Connection API'sine özgü bileşenler.
Grasshopper aracılığıyla API'ye bağlanma
Diğer API istemcilerinde olduğu gibi, Grasshopper betiğini bir çalıştırıcı API örneğine (Connection Service Attacher) bağlayabilir veya hizmeti Grasshopper içinde başlatabilirsiniz (Connection Service Runner). Kullanıcı, API bileşenlerinden herhangi birini çalıştırmadan önce yukarıdaki bileşenlerden birini seçmeli ve çalıştırmalıdır.
Yanlış:
Bileşen, geçerli bir API bağlantısı olmadan çalışmaya çalışırsa bileşen üzerinde bir hata mesajı görüntülenecektir.
Doğru:
Geçerli bir API bağlantısı kurulduktan sonra, betik kapatılana veya başka bir yere gidilene kadar Service bileşeninin yeniden çalıştırılması gerekmez. Bağlantı, tüm bileşenlerin erişebilmesi için yerel olarak depolanır.
API bileşenleri
Aşağıdaki "Active" düğmesi, API ile etkileşime giren bileşenleri kolayca tanımlar. Bir bileşen, Run düğmesine tıklanarak bir kez çalıştırılabilir veya aktif bileşene bağlı bir doğru/yanlış geçişi kullanılarak sürekli olarak çalıştırılabilir.
API bileşenleri, Connection API'sindeki Controller'larla yakından ilişkilidir. Controller'lar ya eylem tabanlıdır (Hesaplama, Dışa Aktarma, Rapor) ya da nesne tabanlıdır (Yük etkisi, Eleman, Parametreler vb.).
Eylem tabanlı: Eylem tabanlı controller'lar, belirli bir birleşim veya proje üzerinde belirli görevler ya da işlemler gerçekleştirir; bunlar hesaplama veya dışa aktarma işlevlerini içerir.
Nesne tabanlı: Nesne tabanlı controller'lar genellikle bir Get bileşenine ve bir Update bileşenine sahip olacaktır:
- Get: Connection içindeki tüm controller türü nesneleri alır ve ayrıştırılabilen veya değiştirilebilen belirli nesneleri getirir.
- Update: Grasshopper betiğinde güncellenmiş olan sağlanan nesneleri günceller. Nesneler, otomatik Modify Object bileşeni kullanılarak güncellenir.
Çoğu API bileşeni, ayrıştırılabilen veya değiştirilebilen nesnelerin girdilerini alır ve çıktılarını sağlar. Bileşenlerin bu formatta sunulması, kullanıcıların eklemesi gereken toplam bileşen sayısını azaltır.
En temel örnek, mevcut birleşimler gibi içindeki mevcut bilgileri elde etmek için bir Projenin ayrıştırılmasıdır.
Basit örnek – birleşim parametrelerinin güncellenmesi
Modify bileşeninin nasıl çalıştığına dair basit örneğe bakın. Aşağıdaki görüntü, bir şablonun basit bir uygulamasında API ve Automatic Object bileşenlerinin kullanımına ve birleşim parametrelerinin güncellenmesine ilişkin bir örneği göstermektedir.
Kullanıma hazır örnekler
Eklentiyi indiren kullanıcılara sıkıştırılmış dosyada tam bir örnek listesi sunulmaktadır: %appdata%\McNeel\Rhinoceros\packages\8.0\IdeaStatiCaGrasshopper\[0.0.0]\Examples 0.2.0.zip
Sürüm uyumluluğu
Yeni eklenti, sürüm 0.2.0, Rhino Package Manager'da mevcuttur ve IDEA StatiCa 24.1.3 ve daha yeni sürümlerle çalışacaktır.
Eski sürüm 0.1.x de mevcut olacak ve IDEA StatiCa 24.1.2 ve daha eski sürümlerle çalışacaktır.
IDEA StatiCa 24.1.4 sürümünde yayınlandı