Nieuwe REST API tussen Grasshopper en Connection
Met de release van de nieuwe Rest Connection API zullen de huidige Grasshopper-componenten gerelateerd aan de oude API (ConHiddenCalculator) niet langer werken, aangezien deze API niet meer wordt ondersteund vanaf IDEA StatiCa versie 24.1.3.
Installatie van de plugin
Net als bij oudere versies kan de plugin worden geïnstalleerd via de Rhino Package Manager. Open de Package Manager door PackageManager te typen in de Rhino-opdrachtprompt. Update of installeer eenvoudig de laatst beschikbare versie van de IDEA StatiCa-plugin.
De voordelen van de nieuwe Grasshopper-plugin
Met de nieuwe versie van de plugin hebben gebruikers toegang tot verbeterde functies van de nieuwe API en veel eenvoudigere interactie tussen Grasshopper en IDEA StatiCa Connection.
Oude pluginversie 0.1.X
- Moeilijk te begrijpen wat er in de API gebeurt bij het gebruik van componenten
- Veel IO-bewerkingen
- Lange bewerkingen (zoals berekening) zorgen ervoor dat het script vastloopt
- Veel componenten voor alle objecten
- Werkt niet met meerdere verbindingen in een project
- Moeilijk om een specifieke versie van IDEA StatiCa te kiezen
Nieuwe pluginversie 0.2.0
- Zeer nauw gekoppeld aan de daadwerkelijke API-cultuur (eenvoudigere overgang naar Python of C#)
- Projecten staan op de server totdat ze door de gebruiker worden opgeslagen
- API-componenten zijn asynchroon, gebruikers kunnen doorgaan met scripten terwijl componenten aan het berekenen zijn
- Automatische decompositie van API-objecten
- Werkt native met alle verbindingen in het project
- API-attacher/runner maakt eenvoudige versiespecificatie mogelijk
- Exporteer IFC-bestanden direct in Grasshopper
- Sjabloontoepassingsworkflow is geünificeerd met de applicatie
- Pinnen en ankers kunnen worden gedefinieerd in de IOM-componenten
Overzicht van componenten
De nieuwe plugin is opgedeeld in twee panelen in het Grasshopper-lint.
- App Common: API-componenten die gemeenschappelijk zijn voor alle IDEA StatiCa-ontwerp-API's.
- Connection: Componenten die specifiek zijn voor de connection API.
Verbinding maken met de API via Grasshopper
Vergelijkbaar met andere API-clients kunt u het Grasshopper-script verbinden meteen runner API-instantie (Connection Service Attacher) of de service starten binnen Grasshopper (Connection Service Runner). Een gebruiker moet een van de bovenstaande componenten selecteren en uitvoeren voordat een van de API-componenten kan worden uitgevoerd.
Fout:
U ontvangt een foutmelding op het component als het component heeft geprobeerd te draaien zonder een geldige API-verbinding.
Correct:
Zodra er een geldige API-verbinding is, hoeft het Service-component niet opnieuw te worden uitgevoerd totdat het script wordt gesloten of ervan wordt weggenavigeerd. De verbinding wordt lokaal opgeslagen zodat alle componenten er toegang toe hebben.
API-componenten
De "Active"-knop hieronder identificeert eenvoudig componenten die interactie hebben met de API. Een component kan eenmalig worden uitgevoerd door op de Run knop te klikken of continu worden uitgevoerd door een waar/onwaar-schakelaar te gebruiken die is aangesloten op het actieve component.
API-componenten zijn nauw gerelateerd aan Controllers in de Connection API. Controllers zijn ofwel actie-gebaseerd (Berekening, Export, Rapport) of object-gebaseerd (Belastingseffect, Staaf, Parameters, enz.).
Actie-gebaseerd: Actie-gebaseerde controllers voeren specifieke taken of bewerkingen uit op een specifieke verbinding of project, deze omvatten berekenings- of exportfunctionaliteit
Object-gebaseerd: Object-gebaseerde controllers hebben doorgaans een Get-component en een Update-component:
- Get: Haalt alle controller-type objecten op in de Connection en haalt specifieke objecten op die kunnen worden gedecomponeerd of gewijzigd.
- Update: Werkt geleverde objecten bij die zijn bijgewerkt in het Grasshopper-script. Objecten worden bijgewerkt met behulp van het automatische Modify Object-component.
De meeste API-componenten nemen inputs en leveren outputs van objecten, die kunnen worden gedecomponeerd of gewijzigd.Het leveren van componenten in dit formaat vermindert het totale aantal componenten dat gebruikers moeten toevoegen.
Het meest basale voorbeeld is het decomponen van een Project om de beschikbare informatie erin te verkrijgen, zoals de beschikbare verbindingen.
Eenvoudig voorbeeld – verbindingsparameters bijwerken
Zie het eenvoudige voorbeeld van hoe het Modify-component werkt. De onderstaande afbeelding toont een voorbeeld van het gebruik van API- en Automatic Object-componenten in een eenvoudige toepassing van een sjabloon en het bijwerken van verbindingsparameters.
Kant-en-klare voorbeelden
Een volledige lijst met voorbeelden is beschikbaar voor gebruikers die de plugin downloaden in het gecomprimeerde bestand: %appdata%\McNeel\Rhinoceros\packages\8.0\IdeaStatiCaGrasshopper\[0.0.0]\Examples 0.2.0.zip
Versiecompatibiliteit
De nieuwe plugin, versie 0.2.0, is beschikbaar in de Rhino Package Manager en werkt met IDEA StatiCa versie 24.1.3 en nieuwer.
De oudere versie 0.1.x zal ook beschikbaar zijn en werkt met IDEA StatiCa versie 24.1.2 en ouder.
Uitgebracht in IDEA StatiCa versie 24.1.4