Ddb Grasshopper

Vollständige Dokumentation von DDB-GH, die die Verwendung der DDB-API innerhalb von Grasshopper ermöglicht.

Hinweis für externe Benutzer - Viele der Links im folgenden Abschnitt beziehen sich auf interne Anwendungen. Bitte sprechen Sie mit Ihrem Projektteam zur Unterstützung.

Voraussetzungen

• Rhino 7.1 (opens new window)
• .NET Framework 4.8 (für Rhino /gh 7)*

*In der Regel sind keine Installation/Aktionen erforderlich, um diese Voraussetzung zu erfüllen.

Installation

Sie können jetzt das DDB-GH-Plugin in der finden Rhino Paketmanager (empfohlen) und die Arup Apps Store .

DDB -GH -Installation Option 1 - Rhino Paketmanager (Empfohlen / schnellste)

1. Offen Rhino.
2. Hinweis: Wenn dies Ihr ist erstes Mal Verwenden Sie Rhino auf diesem Computer Dies Yammer Post (opens new window) Für Setup -Anweisungen.
3. Geben Sie PackageManager in die Befehlszeile Rhino ein, drücken Sie die Eingabetaste.
4. Suchen Sie nach DDB und wählen Sie DDBGrasshopper, wenn es geladen wird. ** Hinweis: Die Suche kann einige Sekunden dauern.
5. Klicken Sie auf Install.
6. Geben Sie Grasshopper in die Befehlszeile Rhino ein, um GH zu öffnen. Sie sollten ein Band am oberen Zeichen mit DDB sehen.
7. 

DDB -GH -Installation Option 2 - Arup -Apps

Alternativ können Sie DDB-GH durch die installieren Arup -Apps speichern mit diesem Link (opens new window) . Die Installation des DT -Genehmigungsprozesses kann mehrere Stunden dauern.

Entwicklerinformationen

Das DDB-GH-Repository befindet sich Hier (opens new window) . Sehen Sie, wie man beitragen (opens new window)

DDB-GH Schritt für Schritt Anleitung

Anleitung

Diese Anleitung zeigt Beispiele dafür, wie die DDB -Heuschreckenkomponenten erwartet werden. Siehe das Komponenten Abschnitt unten.

HINWEIS: In dieser Prozedur wird das Projekt bereits auf DDB vorhanden.

Richten Sie ein Projekt ein

Schließen Sie eine Jobnummer und Environment -Komponente an die Project -Komponente an, um das Projekt von DDB zu erhalten.

Projektvermögen

Verknüpfen Sie entweder ein Projekt oder ein Vermögenswert mit einer Child Asset ** -Komponente, um alle Kindergüter zu erhalten. Erstellen Sie eine Kette davon durch die Projektheirachy.

Fügen Sie eine Child Asset Types ** -Komponente zum Filtern hinzu, die Vermögenswerte zurückgegeben werden. Ohne Sucheingabe gibt diese Komponente alle möglichen Vermögenstypen zurück.

Wenn ein neuer Vermögenswert hinzugefügt werden muss, wird die Get or Create Asset -Komponente verwendet, die prüft, ob bereits ein Vermögenswert vorhanden ist, bevor ein neues erstellt wird.

Vermögenswerte dekonstruieren oder nach Untertypen suchen

Um die Eigenschaften eines Vermögenswerts zu untersuchen, verwenden Sie die Deconstruct Asset -Komponente, um sie in seine Eigenschaften zu unterteilen.

Schließen Sie einen Asset-Typ an die Asset Sub-type ** -Komponente an, um festzustellen, ob vorhandene Untertypen für den gewählten Typ vorhanden sind. Diese können verwendet werden, um ein profiles Kinderguthilfsmittel zu erstellen.

Parameter erhalten

Schließen Sie eine Parameter ** -Komponente an eine Projekt- oder Asset -Komponente an, um alle mit dem übergeordneten Parameter zugeordnet zu erhalten.

Verwenden Sie die Parameter Type ** Komponente, um auf den richtigen Parameter zu filtern. Ohne Sucheingabe gibt diese Komponente alle möglichen Parametertypen zurück.

Verwenden Sie diese als "Bibliothek", um dann den entsprechenden Typ auszuwählen, und fügen Sie dann das ausgewählte Element als Sucheingabe hinzu, um die Komponente auf eine Option zu filtern.

Die Deconstruct Parameter -Komponente kann dann verwendet werden, um den Parameter zu zerstören, um die Eigenschaften zu erkennen.

** *Notiz : Alle Komponenten mit** dynamische Ausgänge*(Child Assets, Child Asset Types, Parameters usw.) Zeigen Sie jedes Objekt standardmäßig als unabhängige Ausgabe an. Dies kann leicht geändert werden, um alle Ausgänge als eine Liste anzuzeigen, um Listen-/Baumoperationen zu ermöglichen. Siehe Screenshot unten.

Aktualisieren Sie einen Parameter

Um einen Parameter zu aktualisieren, verwenden Sie die Add Parameter Revision -Komponente, mit der Sie den Wert, die Quelle und die Einheiten für den ausgewählten Parameter aktualisieren können.

Wenn Sie mit der rechten Maustaste auf die Komponente klicken, können Sie auswählen, ob Parameter:

• Automatisch gesendet oder manuell gesendet
• Wenn eine neue Revision veröffentlicht wird, auch wenn sich der Wert nicht geändert hat

Die ausgewählten Einheiten müssen durch denselben Typ wie der Vermögenswert, aber die tatsächliche Einheit kann geändert werden (z. B. wenn der Parameter in ist inmmvon Typlänge können die neuen Einheiten in seinM)

Wählen Sie die Einheiten für einen Parameter

Verwenden Sie die Units -Komponente, um alle Einheiten für den ausgewählten Einheitstyp und/oder das Einheitssystem zu erhalten. Eine optionale Sucheingabe kann verwendet werden, um sie einzugrenzen.

Einheiten können auch von der Deconstruct Parameter -Komponente zugegriffen werden, mit der ein Einheits-, Einheits- und Einheitssystem für den Parameter bereitgestellt wird.

Erstellen Sie eine Quelle für einen Parameter

Verwenden Sie zunächst die Source -Komponente, um zu sehen, welche Quellen bereits für das Projekt existieren. Die Source Type -Komponente kann verwendet werden, um die Quellen zu filtern, und gibt alle möglichen Typen für diese DDB -Umgebung zurück.

Die Quellausgabe kann dann mit der Deconstruct Source -Komponente unterteilt werden, um die zusätzlichen Informationen über die Quelle zu erhalten.

Wenn die für einen Parameter benötigte Quelle noch nicht vorhanden ist, verwenden Sie die Get or Create Source -Komponente, um ein Quellentyp -Objekt zu erstellen. Wenn die Quelle bereits existiert, gibt diese Komponente das vorhandene Soure zurück.

Komponenten

Dieser Abschnitt enthält alle in der Version 01 enthaltenen Komponenten, die in die 5 Gruppen unten aufgeteilt sind.

HINWEIS: Ausgänge, die sich je nach Eingängen dynamisch ändern.

1. Projektebene

Projektkomponente - lädt ein Projekt von DDB

Intputs:

• JN - Jobnummer: Jobnummer für das Projekt (8 Ziffern als Zeichenfolge oder Nummer)
• E - Umgebung: Ausgabe aus Umgebungskomponenten (Produktion/Entwicklung/Sandbox)

Ausgänge:

• P - Projekt: ein Projektobjekt

Umgebungskomponente - Wählt die zu verwendende DDB -Umgebung aus (mit optionalem Token)

Eingänge:

• Token (optional) - Token, um sich mit zu authentifizieren, falls erforderlich
• Umwelt Dropdown - Art der DDB -Umgebung zu verwenden

Ausgänge:

• Env - Umgebung - DDB -Umgebungsobjekt

2. Vermögen

Kindergüter - Holen Sie sich die Kindergüter aus einem Projekt oder einem Elternvermögen aus

Eingänge:

• P - Elternteil: übergeordnetes Projekt oder Vermögenswert, um einen Vermögenswert aus zu erhalten
• T - Asset Type: Asset Type zur Auswahl

Ausgänge:

• Asset (dynamisch): Asset -Objekt basierend auf Eingaben

Kinderarzttypen

Eingänge:

• P - Elternteil: Die übergeordnete Umgebung, das Vermögens- oder Vermögenstyp.

Ausgänge:

• Vermögenstypen (dynamisch): Die Anlagestypen des Elternteils

Asset Sub-Type

Eingänge:

• AT - ASSET -Typ: Der Vermögenstyp, um die Untertypen von zu erhalten

Ausgänge:

• Asset-Untertypen (dynamisch): Alle verfügbaren Untertypen für ausgewählten Vermögenstypen

Vermögenswert dekonstruieren

Eingänge:

• A - Asset: Das zu dekonstruierte Vermögenswert.

Ausgänge:

• An - Vermögensname: Der Name des Vermögenswerts
• AI - Asset ID: Die Richtlinien des Vermögenswerts
• AT - Vermögenstyp: Der Typ des Vermögenswerts
• AS-T-Asset Sub-Type: Die Untertypen des Vermögenswerts
• PA - Elternvermögen: Das übergeordnete Vermögenswert (oder das Projekt) des Vermögenswerts
• DA - gelöscht zu: Die Zeit, in der das Vermögenswert gelöscht wurde (falls zutreffend)
• J - JSON: Die JSON -Antwort für den Vermögenswert

Asset erhalten oder erstellen

Eingänge:

• P - Elternteil: Der Elternteil des Vermögenswerts
• An - Vermögensname: Der Name des Vermögenswerts zum Erhalten oder Erstellen
• Ty - Asset Typ: Die Art des Teh -Vermögenswerts

Ausgänge:

• A - Vermögenswert: Das zurückgegebene Vermögenswert

3. Parameter

Parameter

Eingänge:

• P - Elternteil: Das übergeordnete Projekt oder das übergeordnete Vermögenswert
• T - Typ: Optionaler Parametertyp zum Filter durch

Ausgänge:

• Parameter (dynamisch): Die Liste der Parameterobjekte für dieses übergeordnete

Zusätzliche Menüoptionen (mit der rechten Maustaste auf Komponente klicken):

• Zeigen Sie nur verwendete Parameter an

Wenn alle Parameter angezeigt werden, haben Parameter, die nicht genutzt werden

Parametertypen

Eingänge:

• P - Elternteil: Das übergeordnete Projekt oder das übergeordnete Vermögenswert
• S - Suche: Optionale Sucheingabe in Filter BY

Ausgänge:

• Parametertypen (dynamisch): Liste der verfügbaren Parametertypen für dieses übergeordnete

Dekonstruieren Parameter

Eingänge:

• P - Parameter: der zu dekonstruiere Parameter

Ausgänge:

• N - Name: Der Name des Parameters
• V - Wert: Der Wert des Parameters
• PT - Parametertyp: Der Parametertyp des Parameters
• A - übergeordnetes Asset: Das übergeordnete Vermögenswert des Parameters
• U - Einheiten: Die Einheiten des Parameters
• UT - Einheitstyp: Der Einheitstyp des Parameters
• US - Einheitssystem: Das Einheitssystem des Parameters
• S - Quelle: Die Quelle des Parameters
• T - Datentyp: Der Datentyp des Parameters
• ST - STAUS: Der Status des Parameters
• D - Datum: Das Datum des Parameters wurde hinzugefügt oder aktualisiert
• I - ID: Die Richtlinie des Parameters
• J - JSON: Die JSON -Antwort für den Parameter

Dekonstruktion des Parametertyps

Eingänge:

• P - Parametertyp: Der zu Dekonstruktion des Parametertyps

Ausgänge:

• N - Name: Der Name des Parameters
• DT - Datentyp: Der Datentyp des Parameters
• GP - Globaler Parameter: Boolean dafür, ob es sich um einen globalen Parameter handelt
• UT - Einheitstyp: Der Einheitstyp des Parameters
• US - Einheitssystem: Das Einheitssystem des Parameters
• ID - ID: Die Richtlinie des Parametertyps
• J - JSON: Die JSON -Antwort für den Parametertyp

Parameterrevision hinzufügen

Eingänge:

• T - Parametertyp: Der Parametertyp des zu aktualisierenden Parameters
• P - übergeordnetes Asset: Der übergeordnete Vermögen des Parameters zu aktualisieren
• V - Wert: Der Wert zum Aktualisieren des Parameters mit
• S - Quelle: Die Quelle des neuen Parameters
• U - Einheiten: Optionale Eingabeeingabe, verwendet Standardeinheiten, falls dies nicht angegeben ist

Ausgänge:

• P - Parameter: Das aktualisierte Parameterobjekt

Klicken Sie mit der rechten Maustaste Menüoptionen:

• Immer die Revision posten, auch mit dem gleichen Wert
• Senden Sie automatisch Updates

4. Einheiten

Einheiten

Eingänge:

• E - Umgebung: Die DDB -Umgebung, um die Einheiten für zu erhalten
• S - Suche: Eine Sucheingabe, um die Einheiten zu filtern

Ausgänge:

• Einheiten (dynamisch) - die Einheiten basierend auf der DDB -Umgebung und der Suche (z. B. MM, CM, M, KM)

Einheitstypen

Eingänge:

• E - Umgebung: Die DDB -Umgebung, um die Einheitstypen für die Art zu erhalten
• S - Suche: Eine Sucheingabe, um die Einheitstypen zu filtern

Ausgänge:

• Einheitstypen (dynamisch) - Die Einheitstypen basierend auf der DDB -Umgebung und der Suche (z. B. Länge, Gewicht, Volumen)

Einheitssysteme

Eingänge:

• E - Umgebung: Die DDB -Umgebung, um die Einheitssysteme für zu erhalten

Ausgänge:

• Einheitssysteme (dynamisch) - Die Einheitssysteme basierend auf der DDB -Umgebung und der Suche (E.E.G. Metric, Imperial)

5. Quellen

Quellen

Eingänge:

• P - Projekt:
• T - Typ:
• S - Suche:

Ausgänge:

• Quellen (dynamisch): Quellobjekte basierend auf Eingaben

Quellentypen

Eingänge:

• E - Umgebung: Die DDB -Umgebung, um die Quellen für die Quellen zu erhalten

Ausgänge:

• Quellentypen (dynamisch) - Die verfügbaren Quelltypen für die ausgewählte Umgebung

Quelle dekonstruieren

Eingänge:

• S - Quelle: Die Quelle zum Dekonstruktion

Ausgänge:

• Ti - Titel: Der Titel der Quelle
• R - Referenz: Die Referenz für die Quelle
• Ty - Typ: Der Quellentyp
• U - URL: Die URL für die Quelle
• D - Datum: Das Datum der Quelle wurde hinzugefügt
• I - ID: Die Richtlinie der Quelle
• J - JSON: Die JSON -Antwort für die Quelle

Quelle holen oder erstellen

Eingänge:

• P - Projekt: Das Projekt für die Quelle
• Ti - Titel: Der Titel für die Quelle
• R - Referenz: Die Referenz für die Quelle
• Ty - Typ: Der Quellentyp für die Quelle
• U - URL: Die URL für die Quelle
• D - Datum: Das Datum der Quelle wurde hinzugefügt

Ausgänge:

• S - Quelle: die Quelle

99. Alte Komponenten

Dieser Abschnitt enthält die alten Komponenten, die noch funktionieren, aber nicht mehr aktualisiert oder unterstützt werden. Diese Komponenten werden in naher Zukunft vollständig aus dem DDB-GH-Plugin entfernt. Wir empfehlen daher nicht, diese für Projektskripte zu verwenden.

Allgemeines Grasshopper Tutorial

Benötigen Sie Hilfe bei Grasshopper?

Für allgemeine Grasshopper Wissen/Tutorials empfehlen wir Ihnen, dies zu beziehen Grasshopper Erste Anleitung (opens new window) . Dies hängt nicht mit DDB-GH zusammen, bietet jedoch ein hilfreiches Verständnis der Grundlagen von Grasshopper.