DDB Grasshopper

Documentación completa de DDB-GH, que permite el uso del DDB API dentro de Grasshopper.

Nota para usuarios externos - Muchos de los enlaces en la siguiente sección se refieren a aplicaciones internas. Hable con su equipo de proyecto para obtener apoyo.

Requisitos previos

• Rhino 7.1 (opens new window)
• .NET Framework 4.8 (para Rhino/GH 7)*

*Por lo general, no se requieren instalación/acciones para satisfacer este requisito previo.

Instalación

Ahora puede encontrar el complemento DDB-GH en el administrador de paquetes Rhino (recomendada) (recomendado) y el Arup Apps tienda (opens new window) .

Opción de instalación DDB -GH 1 - Rhino Administrador de paquetes (recomendado / más rápido)

1. Abierto Rhino.
2. NOTA: Si este es su primera vez Usando Rhino en esta computadora, consulte esta publicación Yammer (opens new window) Para instrucciones de configuración (solo personal de ARUP).
3. Escriba PackageManager en la línea de comando Rhino, presione Enter.
4. Busque DDB y seleccione DDBGrasshopper cuando se carga. Nota: Esto puede tardar varios segundos en buscar.
5. Haga clic en Install.
6. Escriba Grasshopper en la línea de comando Rhino para abrir GH. Debería ver una cinta en la parte superior etiquetada DDB.
7. 

Opción de instalación DDB -GH 2 - Arup Apps

Alternativamente, puede instalar DDB-GH a través del Arup Apps almacenar con este enlace (opens new window) . Esto puede tardar varias horas en instalarse debido al proceso de aprobación de DT.

Información del desarrollador

El repositorio de DDB-GH se encuentra aquí (opens new window) . Ver como contribuir (opens new window)

DDB-GH Guía paso a paso

Como guiar

Este cómo guiar muestra ejemplos de cómo se espera que se usen los componentes DDB Grasshopper. Ver el Componentes Sección debajo de esto.

Nota: Este procedimiento supone que el proyecto ya existe en DDB.

Configurar un proyecto

Conecte un número de trabajo y un componente Environment al componente Project para obtener el proyecto de DDB.

Activos de proyectos

Enlace un proyecto o activo a un componente Child Asset para obtener todos los activos infantiles. Cree una cadena de estos a través del Proyecto Heirachy.

Incluya un componente Child Asset Types para filtrar qué activos se devuelven. Sin entrada de búsqueda, este componente devolverá todos los tipos de activos posibles.

Si se necesita agregar un nuevo activo, use el componente Get or Create Asset que verificará si ya existe un activo, antes de crear uno nuevo.

Deconstruct asset o verificar los subtipos

Para explorar las propiedades de un activo, use el componente Deconstruct Asset para dividirlo en sus propiedades.

Conecte un tipo de activo al componente Asset Sub-type para ver si hay subtipos existentes para el tipo elegido. Estos se pueden usar para crear un activo infantil apropiado.

Obtener parámetros

Conecte un componente Parameter a un componente project o asset para obtener todos los parámetros asociados con el padre.

Use el componente Parameter Type para filtrar hacia abajo al parámetro correcto. Sin entrada de búsqueda, este componente devolverá todos los tipos de parámetros posibles.

Use esto como una 'biblioteca' para elegir el tipo apropiado y luego agregue el elemento seleccionado como una entrada de búsqueda para filtrar el componente a una opción.

El componente Deconstruct Parameter se puede usar para descomponer el parámetro para ver sus propiedades.

Nota : todos los componentes con salidas dinámicas (Child Assets, Child Asset Types, Parameters, etc.) Muestre cada objeto como una salida independiente de forma predeterminada. Esto se puede cambiar fácilmente para mostrar todas las salidas como una lista, para permitir las operaciones de la lista/árbol. Ver captura de pantalla a continuación.

Actualizar un parámetro

Para actualizar un parámetro, use el componente Add Parameter Revision, que le permite actualizar el valor, la fuente y las unidades para el parámetro seleccionado.

Al hacer clic derecho en el componente, puede seleccionar si los parámetros son:

• Enviado o enviado automáticamente
• Si se publica una nueva revisión incluso si el valor no ha cambiado

Las unidades seleccionadas deben por el mismo tipo que el activo, pero la unidad real se puede cambiar (por ejemplo, si el parámetro está enmmde longitud de tipo, las nuevas unidades pueden estar enmetro)

Eligió las unidades para un parámetro

Use el componente Units para obtener todas las unidades para el tipo de unidad seleccionado y/o el sistema de la unidad. Se puede usar una entrada de búsqueda opcional para reducirla.

También se puede acceder a las unidades desde el componente Deconstruct Parameter que proporciona la unidad, el tipo de unidad y el sistema de unidad para el parámetro.

Crear una fuente para un parámetro

Primero, use el componente Source para ver qué fuentes ya existen para el proyecto. El componente Source Type se puede usar para filtrar las fuentes y devolverá todos los tipos posibles para ese entorno DDB.

La salida de origen se puede descomponer utilizando el componente Deconstruct Source para obtener la información adicional sobre la fuente.

Si la fuente necesaria para un parámetro aún no existe, use el componente Get or Create Source para crear un objeto de tipo de fuente. Si la fuente ya existe, este componente devolverá el Soure existente.

Componentes

Esta sección contiene todos los componentes incluidos en la versión de la versión 01, dividido en los 5 grupos a continuación.

Nota: Las salidas que se generan cambian dinámicamente según las entradas.

1. Nivel de proyecto

Componente Project

Carga un proyecto de DDB

Entradas:

• JN - Job number: número de trabajo para el proyecto (8 dígitos como cadena o número)
• E - Environment: salida del componente environment (Production/Development/Sandbox)

Salidas:

• P - Project: un objeto de proyecto

Environment componente

Selecciona el entorno DDB para usar (con token opcional)

Entradas:

• Token (opcional) - Token para autenticarse con si es necesario
• Environment Desendodo - Tipo de entorno DDB para usar

Salidas:

• Env - Environment - Objeto de entorno DDB

2. Activos

Componente Child Assets

Obtiene los activos infantiles de un proyecto o activo de los padres

Entradas:

• P - Parent: proyecto principal o activo para obtener activos de
• T - Asset type: tipo de activo para seleccionar

Salidas:

• Asset (dinámica): objeto de activo basado en entradas

Asset Search componente

Busca los activos existentes de un proyecto o activo principal.

Entradas:

• P - Parent: el proyecto o activo principal para buscar activos en
• SN - Search Name: un nombre de activo para buscar
• Ex - Exact match: si el nombre de búsqueda debe ser una coincidencia exacta o no (true = exacta; false = parcial parcial)
• SI - Search ID: una identificación de activo para buscar
• ST - Search Type: un tipo de activo para buscar
• SS-T - Search Sub-type: un subtipo de activo para buscar
• A/O - And/Or: si la búsqueda debe usar y/o para los criterios de búsqueda (true = y; falso = o)

Salidas:

• Assets (dinámica): los activos que coinciden con los criterios de búsqueda

Haga clic con el botón derecho en opciones de menú:

• Incluya el nivel de activos de los padres en la búsqueda
• Mostrar salidas como lista única

Componente Child Asset Types

Obtiene todos los tipos de activos infantiles de un activo/proyecto para padres

Entradas:

• P - Parent: el tipo de entorno, activo o activo principal.

Salidas:

• Asset types (dinámica): los tipos de activos de los padres

Asset Sub-types componente

Entradas:

• At - Asset type: el tipo de activo para obtener los subtipos de

Salidas:

• Asset Sub-Types (dinámica): todos los subtipos disponibles para el tipo de activo seleccionado

Activo deconstruir

Entradas:

• A - Asset: el activo para deconstruir.

Salidas:

• An - Asset name: el nombre del activo
• Ai - Asset ID: el guía del activo
• At - Asset type: el tipo de activo
• As-t - Asset sub-type: los subtipos del activo
• Pa - Parent asset: el activo (o proyecto) principal del activo
• Da - Deleted at: el momento en que se eliminó el activo (si corresponde)
• J - Json: la respuesta JSON para el activo

Obtener o crear activos

Entradas:

• P - Parent: el padre del activo
• An - Asset Name: el nombre del activo para obtener o crear
• Ty - Asset Type: el tipo de activo teh

Salidas:

• A - Asset: el activo devuelto

3. Parámetros

Parámetros

Entradas:

• P - Parent: el proyecto o activo principal
• T - Type: tipo de parámetro opcional para filtrar por

Salidas:

• Parameters (dinámica): la lista de objetos de parámetros para ese padre

Opciones de menú adicionales (haga clic con el botón derecho en el componente):

• Solo muestre los parámetros usados

Cuando se muestran todos los parámetros, los parámetros que no se utilizan tienen un ~ antes que ellos

Componente Parameter Search

Busca los parámetros existentes de un proyecto

Entradas:

• P - Project: el proyecto para buscar parámetros en. Tenga en cuenta que este debe ser el proyecto, y no puede ser un activo diferente (a diferencia del componente de búsqueda de activos).
• T - Search Type: un tipo de parámetro para buscar
• SN - Search Name: un nombre de parámetro para buscar
• Ex - Exact match: si el nombre de búsqueda debe ser una coincidencia exacta o no (true = exacta; false = parcial parcial)
• SI - Search ID: una ID de parámetro para buscar
• SP - Search Parent Asset: Busque los parámetros de un activo principal
• A/O - And/Or: si la búsqueda debe usar y/o para los criterios de búsqueda (true = y; falso = o)

Salidas:

• Parameters (dinámica): los parámetros que coinciden con los criterios de búsqueda

Haga clic con el botón derecho en opciones de menú:

• Incluir parámetros de nivel de proyecto en la búsqueda
• Solo muestre parámetros con valores
• Mostrar salidas como lista única

Parameter Types componente

Entradas:

• P - Parent: el proyecto o activo principal
• S - Search: entrada de búsqueda opcional para filtrar por

Salidas:

• Parameter Types (dinámica): lista de tipos de parámetros disponibles para ese padre

Deconstruct Parameter componente

Entradas:

• P - Parameter: el parámetro para deconstruir

Salidas:

• N - Name: el nombre del parámetro
• V - Value: el valor del parámetro
• Pt - Parameter Type: el tipo de parámetro del parámetro
• A - Parent Asset: el activo principal del parámetro
• U - Units: las unidades del parámetro
• Ut - Unit type: el tipo de unidad del parámetro
• Us - Unit system: el sistema unitario del parámetro
• S - Source: la fuente del parámetro
• T - Data Type: el tipo de datos del parámetro
• St - Status: el estado del parámetro
• D - Date: la fecha en que se agregó o actualizó el parámetro
• I - ID: el GUID del parámetro
• J - Json: la respuesta JSON para el parámetro

Componente Deconstruct Parameter Type

Entradas:

• P - Parameter Type: el tipo de parámetro para deconstruir

Salidas:

• N - Name: el nombre del parámetro
• Dt - Data Type: el tipo de datos del parámetro
• GP - Global parameter: booleano para si es un parámetro global
• UT - Unit type: el tipo de unidad del parámetro
• US - Unit system: el sistema unitario del parámetro
• ID - ID: el GUID del tipo de parámetro
• J - Json: la respuesta JSON para el tipo de parámetro

Componente Add Parameter Revision

Entradas:

• T - Parameter Type: el tipo de parámetro del parámetro para actualizar
• P - Parent Asset: el activo principal del parámetro para actualizar
• V - Value: el valor para actualizar el parámetro con
• S - Source: la fuente del nuevo parámetro
• U - Units: la entrada de la unidad opcional usará unidades predeterminadas si no se proporciona

Salidas:

• P - Parameter: el objeto de parámetro actualizado

Haga clic con el botón derecho en opciones de menú:

• Siempre publica la revisión, incluso con el mismo valor
• Enviar automáticamente actualizaciones

4. Unidades

Units componente

Entradas:

• E - Environment: el entorno DDB para obtener las unidades para
• S - Search: una entrada de búsqueda para filtrar las unidades

Salidas:

• Units (dinámica): las unidades basadas en el entorno y la búsqueda DDB (por ejemplo, MM, CM, M, KM)

Componente Unit Types

Entradas:

• E - Environment: el entorno DDB para obtener los tipos de unidad para
• S - Search: una entrada de búsqueda para filtrar los tipos de unidad

Salidas:

• Unit types (dinámica): los tipos de unidad basados en el entorno y la búsqueda DDB (por ejemplo, longitud, peso, volumen)

Componente Unit Systems

Entradas:

• E - Environment: el entorno DDB para obtener los sistemas unitarios para

Salidas:

• Unit systems (dinámica): los sistemas unitarios basados en el entorno y la búsqueda DDB (E.E.G. Metric, Imperial)

5. Fuentes

Componente Sources

Entradas:

• P - Project: el proyecto matriz
• T - Type: el tipo de fuente
• S - Search: búsqueda basada en texto para la fuente

Salidas:

• Sources (dinámica): objetos de origen basados en entradas

Componente Source Types

Entradas:

• E - Environment: el entorno DDB para obtener las fuentes para

Salidas:

• Source types (dinámica): los tipos de fuente disponibles para el entorno seleccionado

Deconstruct Source componente

Entradas:

• S - Source: la fuente para deconstruir

Salidas:

• Ti - Title: el título de la fuente
• R - Reference: la referencia para la fuente
• Ty - Type: el tipo de fuente
• U - URL: la URL para la fuente
• D - Date: la fecha en que se agregó la fuente
• I - ID: el guía de la fuente
• J - Json: la respuesta JSON para la fuente

Componente Get or Create Source

Entradas:

• P - Project: el proyecto para la fuente
• Ti - Title: el título de la fuente
• R - Reference: la referencia para la fuente
• Ty - Type: el tipo de fuente para la fuente
• U - URL: la URL para la fuente
• D - Date: la fecha en que se agregó la fuente

Salidas:

• S - Source: la fuente

99. Componentes antiguos

Esta sección contiene los componentes antiguos que aún funcionan, pero que ya no se actualizan o se admiten. Estos componentes se eliminarán por completo del complemento DDB-GH en el futuro cercano, por lo que no recomendamos usarlos en los scripts del proyecto.

Tutorial general Grasshopper

¿Necesita ayuda con Grasshopper?

Para el conocimiento general Grasshopper/tutoriales, le recomendamos que se refiera a esto Grasshopper Guía de inicio (opens new window) . Esto no está relacionado con DDB-GH, pero proporciona una comprensión útil de los conceptos básicos de Grasshopper.