Kennisbank

Nieuwe REST API tussen Grasshopper en Connection

Steel

v25.0

Connection

Grasshopper

Dit artikel is ook beschikbaar in:

De Grasshopper plugin is bijgewerkt naar de nieuwe IDEA StatiCa Connection API en IOM versie. Het biedt een nieuwe ervaring die meer in lijn is met moderne API's. Elk onderdeel is nauw gekoppeld aan de API-interactie.

Met de release van de nieuwe Rest Connection API zullen de huidige Grasshopper-componenten die gerelateerd zijn aan de oude API(ConHiddenCalculator) niet langer werken, omdat deze API niet langer wordt ondersteund vanaf IDEA StatiCa versie 24.1.3.

Installatie van de plugin

Net als bij oudere versies kan de plugin geïnstalleerd worden via de Rhino Package Manager. Open de Package Manager door PackageManager te typen in de Rhino command prompt. Update of installeer de laatste 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 plugin versie 0.1.X

Moeilijk te begrijpen wat er gebeurt in de API bij het gebruik van componenten
Veel IO operaties
Lange operaties (zoals berekening) laten het script bevriezen
Veel componenten voor alle objecten
Niet werken met meerdere verbindingen in een project
Moeilijk om een specifieke versie van IDEA StatiCa te kiezen

Nieuwe plugin versie 0.2.0

Zeer nauw gekoppeld aan de gebruikelijke API-cultuur (betere overgang naar Python of C#)
Projecten staan op de server totdat ze worden opgeslagen door de gebruiker
API componenten zijn async, gebruikers kunnen doorgaan met scripts terwijl componenten aan het rekenen zijn
Automatisch ontleden van API objecten
Werkt rechtstreeks met alle verbindingen in het project
API attacher/runner maakt een eenvoudige versie specificatie mogelijk
IFC-bestanden direct exporteren in Grasshopper
Template-workflow is afgestemd op de hoofdapplicatie
Stalen pennen en ankers kunnen worden gedefinieerd in de IOM-componenten

Overzicht componenten

De nieuwe plugin is onderverdeeld in twee panelen in de Grasshopper ribbon.

App common: API-componenten die algemeen zijn voor alle IDEA StatiCa design-API's.
Connection: Componenten die specifiek zijn voor de Connection-API.

Verbinding maken met de API via Grasshopper

Net als bij andere API-clients kunt u het Grasshopper-script verbinden met een runner API-instantie (Connection Service Attacher) of de service binnen Grasshopper starten (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 krijgt een foutmelding als de component heeft geprobeerd te draaien zonder geldige API-verbinding.

Juist:

Zodra er een geldige API-verbinding is, hoeft de servicecomponent niet opnieuw te worden uitgevoerd zolang het script actief blijft. De verbinding wordt lokaal opgeslagen en is toegankelijk voor alle componenten.

API-componenten

De knop "Active" hieronder maakt het eenvoudig om componenten te identificeren die interageren met de API. Een component kan eenmalig worden uitgevoerd via de knop "Run", of continu via een true/false-schakelaar die is gekoppeld aan de "Active"-component.

API componenten zijn nauw verwant aan Controllers in de Connection API. Controllers zijn gebaseerd op acties (Berekening, Export, Rapport) of op objecten (Last effect, Staaf, Parameters, enz.).

Op actie gebaseerd: Op actie gebaseerde controllers voeren specifieke taken of bewerkingen uit op een specifieke verbinding of een specifiek project.

Objectgebaseerd: Object-gebaseerde controllers hebben meestal een Get component en een Update component:

Get: Haalt alle controller-type objecten in de verbinding op en identificeert specifieke objecten die kunnen worden uitgelezen (Deconstruct) of gewijzigd (Modify).
Update: werkt de objecten bij die zijn bijgewerkt in het Grasshopper-script. Objecten worden bijgewerkt met behulp van het automatische onderdeel Object wijzigen.

De meeste API-componenten nemen invoer en geven objecten als uitvoer die kunnen worden gedeconstrueerd of aangepast. Door componenten op deze manier aan te bieden, wordt het totale aantal benodigde componenten voor de gebruiker verminderd.

Het meest eenvoudige voorbeeld is het deconstrueren van een Project om de beschikbare informatie te krijgen, zoals de beschikbare verbindingen.

Eenvoudig voorbeeld - Connection parameters bijwerken

Bekijk het eenvoudige voorbeeld van hoe de Modify component werkt. De afbeelding hieronder toont een voorbeeld van het gebruik van API- en Automatic Object-componenten in een eenvoudige toepassing van een template en het bijwerken van parameters.