DDB Grasshopper

الوثائق الكاملة لـ DDB-GH ، والتي تتيح استخدام DDB API ضمن Grasshopper.

ملاحظة للمستخدمين الخارجيين - تشير العديد من الروابط في القسم التالي إلى التطبيقات الداخلية. يرجى التحدث إلى فريق المشروع الخاص بك للحصول على الدعم.

المتطلبات الأساسية

• Rhino 7.1 (opens new window)
• .NET الإطار 4.8 (لـ Rhino/GH 7)*

*عادة ، لا يلزم تثبيت/إجراءات لتلبية هذا المتطلب السابق.

تثبيت

يمكنك الآن العثور على المكون الإضافي DDB-GH في مدير الحزمة Rhino (مُستَحسَن) و ال Arup Apps متجر (opens new window) .

خيار تثبيت DDB -GH 1 - Rhino مدير الحزمة (موصى به / أسرع)

1. مفتوح Rhino.
2. ملاحظة: إذا كان هذا هو اول مرة باستخدام Rhino على هذا الكمبيوتر ، راجع إلى هذا Yammer post (opens new window) للحصول على تعليمات الإعداد (موظفي ARUP فقط).
3. اكتب PackageManager في سطر الأوامر __374 ، اضغط على Enter.
4. ابحث عن DDB ، وحدد DDBGrasshopper عند تحميله. ملاحظة: قد يستغرق هذا عدة ثوان للبحث.
5. انقر فوق Install.
6. اكتب Grasshopper في سطر الأوامر Rhino لفتح GH. يجب أن ترى شريطًا في الجزء العلوي المسمى DDB.
7. 

DDB -GH تثبيت الخيار 2 - Arup Apps

بدلاً من ذلك ، يمكنك تثبيت DDB-GH من خلال Arup Apps تخزين مع هذا الرابط (opens new window) . قد يستغرق التثبيت عدة ساعات بسبب عملية موافقة DT.

معلومات المطور

يقع مستودع DDB-GH هنا (opens new window) . انظر كيف يساهم (opens new window)

دليل DDB-GH خطوة بخطوة

كيف ترشد

يعرض كيفية توجيه الأمثلة على كيفية استخدام مكونات DDB Grasshopper. انظر عناصر القسم أدناه.

ملاحظة: يفترض هذا الإجراء أن المشروع موجود على DDB بالفعل.

قم بإعداد مشروع

قم بتوصيل رقم الوظيفة ومكون Environment بمكون Project للحصول على المشروع من DDB.

أصول المشروع

اربط إما مشروع أو أصل إلى مكون Child Asset للحصول على جميع أصول الأطفال. إنشاء سلسلة من هذه من خلال مشروع Heirachy.

قم بتضمين مكون Child Asset Types لتصفية الأصول التي يتم إرجاعها. مع عدم وجود إدخال بحث ، سيعيد هذا المكون جميع أنواع الأصول الممكنة.

إذا كان من الضروري إضافة أحد الأصول الجديدة ، فاستخدم مكون Get or Create Asset الذي سيتحقق مما إذا كان هناك أحد الأصول بالفعل ، قبل إنشاء واحد جديد.

Deconstruct asset أو تحقق من الأنواع الفرعية

لاستكشاف خصائص الأصل ، استخدم مكون Deconstruct Asset لكسره في خصائصه.

قم بتوصيل نوع الأصول بمكون Asset Sub-type لمعرفة ما إذا كانت هناك أنواع فرعية موجودة للنوع المختار. يمكن استخدام هذه لإنشاء أصول طفل مناسبة.

الحصول على المعلمات

قم بتوصيل مكون Parameter بمكون project أو asset للحصول على جميع المعلمات المرتبطة بالوالد.

استخدم مكون Parameter Type للتصفية إلى المعلمة الصحيحة. مع عدم وجود إدخال بحث ، سيقوم هذا المكون بإرجاع جميع أنواع المعلمات الممكنة.

استخدم هذا كـ "مكتبة" بعد اختيار النوع المناسب ، ثم إضافة العنصر المحدد كإدخال بحث لتصفية المكون لأسفل إلى خيار واحد.

يمكن بعد ذلك استخدام مكون Deconstruct Parameter لتحطيم المعلمة لرؤية خصائصها.

ملحوظة : جميع المكونات مع المخرجات الديناميكية (Child Assets ، Child Asset Types ، Parameters ، إلخ) ، يُظهر كل كائن كإخراج مستقل افتراضيًا. يمكن تغيير هذا بسهولة لعرض جميع المخرجات كقائمة واحدة ، للسماح لعمليات القائمة/الأشجار. انظر لقطة الشاشة أدناه.

تحديث المعلمة

لتحديث المعلمة ، استخدم مكون Add Parameter Revision ، والذي يسمح لك بتحديث القيمة والمصدر والوحدات للمعلمة المحددة.

بالنقر بزر الماوس الأيمن على المكون ، يمكنك تحديد ما إذا كانت المعلمات هي:

• تم إرسالها تلقائيًا أو إرسالها يدويًا
• إذا تم نشر مراجعة جديدة حتى لو لم تتغير القيمة

يجب أن يتم تغيير الوحدات المحددة من نفس النوع مثل الأصل ، ولكن يمكن تغيير الوحدة الفعلية (على سبيل المثال ، إذا كانت المعلمة فيمممن نوع النوع ، يمكن أن تكون الوحدات الجديدة فيم)

اختار الوحدات للمعلمة

استخدم مكون Units للحصول على جميع الوحدات لنوع الوحدة المحدد و/أو نظام الوحدة. يمكن استخدام إدخال بحث اختياري لتضييقه لأسفل.

يمكن أيضًا الوصول إلى الوحدات من مكون Deconstruct Parameter الذي يوفر الوحدة ونوع الوحدة ونظام الوحدة للمعلمة.

إنشاء مصدر للمعلمة

أولاً ، استخدم مكون Source لمعرفة المصادر الموجودة بالفعل للمشروع. يمكن استخدام مكون Source Type لتصفية المصادر وسيعود جميع الأنواع الممكنة لبيئة DDB هذه.

يمكن بعد ذلك تقسيم إخراج المصدر باستخدام مكون Deconstruct Source للحصول على معلومات إضافية حول المصدر.

إذا لم يكن المصدر اللازم للمعلمة موجودًا بعد ، فاستخدم مكون Get or Create Source لإنشاء كائن نوع المصدر. إذا كان المصدر موجودًا بالفعل ، فسيقوم هذا المكون بإرجاع العزم الحالي.

عناصر

يحتوي هذا القسم على جميع المكونات المدرجة في إصدار الإصدار 01 ، مقسمة إلى 5 مجموعات أدناه.

ملاحظة: تتغير المخرجات التي يتم إنشاؤها ديناميكيًا حسب المدخلات.

1. مستوى المشروع

Project مكون

يحمل مشروع من DDB

المدخلات:

• JN - Job number: رقم الوظيفة للمشروع (8 أرقام كسلسلة أو رقم)
• E - Environment: الإخراج من environment المكون (Production/Development/Sandbox)

المخرجات:

• P - Project: كائن مشروع

Environment مكون

يختار بيئة DDB للاستخدام (مع رمز رمزي اختياري)

المدخلات:

• Token (اختياري) - الرمز المميز للمصادقة إذا لزم الأمر
• Environment المنسدلة - نوع بيئة DDB للاستخدام

المخرجات:

• Env - Environment - كائن بيئة DDB

2. الأصول

Child Assets مكون

يحصل على أصول الطفل من مشروع أو أصول الوالدين

المدخلات:

• P - Parent: Parent Project أو Asset للحصول على الأصول من
• T - Asset type: نوع الأصول لتحديد

المخرجات:

• Asset (ديناميكي): كائن الأصول على أساس المدخلات

Asset Search مكون

يبحث في الأصول الحالية لمشروع أو أصل.

المدخلات:

• P - Parent: المشروع الأصل أو الأصل للبحث عن الأصول في
• SN - Search Name: اسم الأصول للبحث عن
• Ex - Exact match: ما إذا كان اسم البحث يحتاج إلى أن يكون مطابقة تمامًا أم لا (صحيح = دقيق ؛ خطأ = مطابقة جزئية)
• SI - Search ID: معرف الأصول للبحث عن
• ST - Search Type: نوع الأصول للبحث عن
• SS-T - Search Sub-type: نوع من الأصول الفرعية للبحث عن
• A/O - And/Or: ما إذا كان يجب على البحث استخدام و/أو لمعايير البحث (True = و ؛ false = أو)

المخرجات:

• Assets (ديناميكي): الأصول التي تطابق معايير البحث

انقر بزر الماوس الأيمن على خيارات القائمة:

• قم بتضمين مستوى أصول الوالدين في البحث
• إظهار المخرجات كقائمة واحدة

Child Asset Types مكون

يحصل على جميع أنواع الأصول الفرعية لأصل/مشروع الوالدين

المدخلات:

• P - Parent: الوالد البيئي ، نوع الأصول أو الأصول.

المخرجات:

• Asset types (ديناميكي): أنواع الأصول من الوالد

Asset Sub-types مكون

المدخلات:

• At - Asset type: نوع الأصول للحصول على الأنواع الفرعية من

المخرجات:

• Asset Sub-Types (ديناميكي): جميع الأنواع الفرعية المتاحة لنوع الأصول المحددة

تفكيك الأصول

المدخلات:

• A - Asset: الأصل لتفكيك.

المخرجات:

• An - Asset name: اسم الأصل
• Ai - Asset ID: Guid of the Asset
• At - Asset type: نوع الأصل
• As-t - Asset sub-type: الأنواع الفرعية للأصل
• Pa - Parent asset: الأصل الأصل (أو المشروع) للأصل
• Da - Deleted at: الوقت الذي تم فيه حذف الأصل (إن أمكن)
• J - Json: استجابة JSON للأصل

الحصول على أو إنشاء الأصول

المدخلات:

• P - Parent: والد الأصل
• An - Asset Name: اسم الأصل للحصول على أو إنشاء
• Ty - Asset Type: نوع أصول teh

المخرجات:

• A - Asset: الأصل الذي تم إرجاعه

3. المعلمات

حدود

المدخلات:

• P - Parent: المشروع أو الأصل الأصل
• T - Type: نوع المعلمة اختياري للتصفية بواسطة

المخرجات:

• Parameters (ديناميكي): قائمة كائنات المعلمة لذلك الوالد

خيارات قائمة إضافية (انقر بزر الماوس الأيمن على المكون):

• فقط عرض المعلمات المستخدمة

عندما يتم عرض جميع المعلمات ، فإن المعلمات غير المستخدمة لها ~

Parameter Search مكون

يبحث في المعلمات الحالية للمشروع

المدخلات:

• P - Project: المشروع للبحث عن المعلمات في. لاحظ أن هذا يجب أن يكون المشروع ، ولا يمكن أن يكون أحد الأصول المختلفة (على عكس مكون بحث الأصول).
• T - Search Type: نوع المعلمة للبحث عن
• SN - Search Name: اسم معلمة للبحث عن
• Ex - Exact match: ما إذا كان اسم البحث يحتاج إلى أن يكون مطابقة تمامًا أم لا (صحيح = دقيق ؛ خطأ = مطابقة جزئية)
• SI - Search ID: معرف المعلمة للبحث عن
• SP - Search Parent Asset: ابحث عن معلمات الأصل الوالد
• A/O - And/Or: ما إذا كان يجب على البحث استخدام و/أو لمعايير البحث (True = و ؛ false = أو)

المخرجات:

• Parameters (ديناميكي): المعلمات التي تتطابق مع معايير البحث

انقر بزر الماوس الأيمن على خيارات القائمة:

• قم بتضمين معلمات مستوى المشروع في البحث
• فقط إظهار المعلمات مع القيم
• إظهار المخرجات كقائمة واحدة

Parameter Types مكون

المدخلات:

• P - Parent: المشروع أو الأصل الأصل
• S - Search: إدخال بحث اختياري للتصفية بواسطة

المخرجات:

• Parameter Types (ديناميكي): قائمة بأنواع المعلمات المتاحة لهذا الوالد

Deconstruct Parameter مكون

المدخلات:

• P - Parameter: المعلمة لتفكيكها

المخرجات:

• N - Name: اسم المعلمة
• V - Value: قيمة المعلمة
• Pt - Parameter Type: نوع المعلمة للمعلمة
• A - Parent Asset: الأصل الأصل للمعلمة
• U - Units: وحدات المعلمة
• Ut - Unit type: نوع الوحدة للمعلمة
• Us - Unit system: نظام الوحدة للمعلمة
• S - Source: مصدر المعلمة
• T - Data Type: نوع بيانات المعلمة
• St - Status: حالة المعلمة
• D - Date: تاريخ إضافة أو تحديث المعلمة
• I - ID: GUID من المعلمة
• J - Json: استجابة JSON للمعلمة

Deconstruct Parameter Type مكون

المدخلات:

• P - Parameter Type: نوع المعلمة لتفكيك

المخرجات:

• N - Name: اسم المعلمة
• Dt - Data Type: نوع بيانات المعلمة
• GP - Global parameter: منطقية لما إذا كانت معلمة عالمية
• UT - Unit type: نوع الوحدة للمعلمة
• US - Unit system: نظام الوحدة للمعلمة
• ID - ID: GUID من نوع المعلمة
• J - Json: استجابة JSON لنوع المعلمة

Add Parameter Revision مكون

المدخلات:

• T - Parameter Type: نوع المعلمة للمعلمة للتحديث
• P - Parent Asset: الأصل الأصل للمعلمة للتحديث
• V - Value: القيمة لتحديث المعلمة مع
• S - Source: مصدر المعلمة الجديدة
• U - Units: إدخال وحدة اختياري ، سوف يستخدم الوحدات الافتراضية إذا لم يتم توفيره

المخرجات:

• P - Parameter: كائن المعلمة المحدث

انقر بزر الماوس الأيمن على خيارات القائمة:

• دائما نشر المراجعة ، حتى مع نفس القيمة
• إرسال التحديثات تلقائيا

4. الوحدات

Units مكون

المدخلات:

• E - Environment: بيئة DDB للحصول على الوحدات
• S - Search: إدخال بحث لتصفية الوحدات

المخرجات:

• Units (ديناميكي) - الوحدات المستندة إلى بيئة DDB والبحث (مثل MM ، CM ، M ، KM)

Unit Types مكون

المدخلات:

• E - Environment: بيئة DDB للحصول على أنواع الوحدات
• S - Search: إدخال بحث لتصفية أنواع الوحدات

المخرجات:

• Unit types (ديناميكي) - أنواع الوحدات القائمة على بيئة DDB والبحث (مثل الطول والوزن والحجم)

Unit Systems مكون

المدخلات:

• E - Environment: بيئة DDB للحصول على أنظمة الوحدة

المخرجات:

• Unit systems (ديناميكي) - أنظمة الوحدة المستندة إلى بيئة DDB والبحث (E.E.G. Metric ، Imperial)

5. مصادر

Sources مكون

المدخلات:

• P - Project: المشروع الأصل
• T - Type: نوع المصدر
• S - Search: البحث المستند إلى النص عن المصدر

المخرجات:

• Sources (ديناميكي): كائنات المصدر تعتمد على المدخلات

Source Types مكون

المدخلات:

• E - Environment: بيئة DDB للحصول على مصادر ل

المخرجات:

• Source types (ديناميكي) - أنواع المصادر المتاحة للبيئة المحددة

Deconstruct Source مكون

المدخلات:

• S - Source: المصدر لتفكيك

المخرجات:

• Ti - Title: عنوان المصدر
• R - Reference: مرجع المصدر
• Ty - Type: نوع المصدر
• U - URL: عنوان URL للمصدر
• D - Date: تم إضافة تاريخ المصدر
• I - ID: دليل المصدر
• J - Json: استجابة JSON للمصدر

Get or Create Source مكون

المدخلات:

• P - Project: مشروع المصدر
• Ti - Title: عنوان المصدر
• R - Reference: مرجع المصدر
• Ty - Type: نوع المصدر للمصدر
• U - URL: عنوان URL للمصدر
• D - Date: تم إضافة تاريخ المصدر

المخرجات:

• S - Source: المصدر

99. المكونات القديمة

يحتوي هذا القسم على المكونات القديمة التي لا تزال تعمل ، ولكن لم يتم تحديثها أو دعمها. ستتم إزالة هذه المكونات بالكامل من البرنامج المساعد DDB-GH في المستقبل القريب ، لذلك لا نوصي باستخدام هذه البرامج النصية للمشروع.

عام Grasshopper البرنامج التعليمي

هل تحتاج إلى بعض المساعدة في Grasshopper؟

بالنسبة للمعرفة/البرامج التعليمية العامة Grasshopper Grasshopper دليل البدء (opens new window) . هذا لا علاقة له بـ DDB-GH ، ولكنه يوفر فهمًا مفيدًا لأساسيات Grasshopper.