Dynamo
Primer for v2.0
Español
Español
  • Acerca de
  • Introducción
    • ¿Qué es Dynamo y cómo funciona?
    • Manual de introducción, comunidad y plataforma de Dynamo
  • Configuración de Dynamo
  • Interfaz de usuario
    • Espacio de trabajo
    • Biblioteca
  • Nodos y cables
  • Nodos y conceptos básicos
    • Índice de nodos
    • Geometría para el diseño computacional
      • Descripción general de la geometría
      • Vector, plano y sistema de coordenadas
      • Puntos
      • Curvas
      • Superficies
      • Sólidos
      • Mallas
    • Los bloques de construcción de los programas
      • Datos
      • Matemáticas
      • Lógica
      • Cadenas
      • Color
    • Diseño con listas
      • ¿Qué es una lista?
      • Trabajo con listas
      • Listas de listas
      • Listas de n dimensiones
    • Diccionarios en Dynamo
      • ¿Qué es un diccionario?
      • Nodos de diccionario
      • Diccionarios en bloques de código
      • Casos de uso de Revit
  • Nodos y paquetes personalizados
    • Nodos personalizados
      • Introducción a los nodos personalizados
      • Creación de un nodo personalizado
      • Publicación en la biblioteca
    • Paquetes
      • Introducción a los paquetes
      • Caso real de paquete: Kit de herramientas de malla
      • Desarrollo de un paquete
      • Publicación de un paquete
      • Importación de Zero-Touch
  • Dynamo para Revit
    • La conexión de Revit
    • Selección
    • Edición
    • Creación
    • Personalización
    • Documentación
  • Dynamo for Civil 3D
    • La conexión con Civil 3D
    • Introducción
    • Biblioteca de nodos
    • Flujos de trabajo de ejemplo
      • Carreteras
        • Colocación de farolas
      • Land
        • Colocación de servicios
      • Servicios
        • Renombrar estructuras
      • Raíl
        • Envolvente libre
      • Topografía
        • Administración de grupos de puntos
    • Temas avanzados
      • Enlace de objetos
      • Python y Civil 3D
    • Reproductor de Dynamo
    • Paquetes útiles
    • Recursos
  • Codificación en Dynamo
    • Bloques de código y DesignScript
      • ¿Qué es un bloque de código?
      • Sintaxis de DesignScript
      • Abreviatura
      • Funciones
    • Geometría con DesignScript
      • Conceptos básicos de geometría con DesignScript
      • Primitivas geométricas
      • Matemáticas vectoriales
      • Curvas: puntos interpolados y de control
      • Traslación, rotación y otras transformaciones
      • Superficies: interpoladas, puntos de control, solevación y revolución
      • Parametrización geométrica
      • Intersección y recorte
      • Operaciones booleanas geométricas
      • Generadores de puntos de Python
    • Python
      • Nodos de Python
      • Python y Revit
      • Configurar su propia plantilla de Python
    • Cambios en el lenguaje
  • Prácticas recomendadas
    • Estrategias gráficas
    • Estrategias de creación de secuencias de comandos
    • Referencia de secuencias de comandos
    • Administración del programa
    • Trabajar de forma eficaz con grandes conjuntos de datos en Dynamo
  • Flujos de trabajo de ejemplo
    • Flujos de trabajo para empezar
      • Jarrón paramétrico
      • Puntos de atractor
    • Índice de conceptos
  • Guía de introducción para desarrolladores
    • Compilar Dynamo a partir del código fuente
      • Compilar DynamoRevit a partir del código fuente
      • Administración y actualización de dependencias en Dynamo
    • Desarrollo para Dynamo
      • Introducción
      • Caso real de Zero-Touch (nodo de rejilla)
      • Ejecución de secuencias de comandos de Python en nodos Zero-Touch (C#)
      • Conceptos avanzados de Zero-Touch
      • Personalización avanzada de nodos de Dynamo
      • Uso de tipos COM (interoperabilidad) en paquetes de Dynamo
      • Caso real de NodeModel (interfaz de usuario personalizada)
      • Actualización de paquetes y bibliotecas de Dynamo para Dynamo 2.x
      • Actualización de paquetes y bibliotecas de Dynamo para Dynamo 3.x
      • Extensiones
      • Definición de la organización de paquetes personalizados para Dynamo 2.0+
      • Interfaz de línea de comandos de Dynamo
      • Integración de Dynamo
      • Desarrollo para Dynamo for Revit
      • Publicar un paquete
      • Compilar un paquete desde Visual Studio
      • Extensiones como paquetes
    • Solicitudes de incorporación de cambios
    • Expectativas de las pruebas
    • Ejemplos
  • Apéndice
    • Preguntas frecuentes
    • Programación visual y Dynamo
    • Recursos
    • Notas de la versión
    • Paquetes útiles
    • Archivos de ejemplo
    • Mapa de integración de anfitriones
    • Descargar PDF
    • Métodos abreviados de teclado de Dynamo
Powered by GitBook
On this page
Edit on GitHub
Export as PDF
  1. Guía de introducción para desarrolladores
  2. Desarrollo para Dynamo

Interfaz de línea de comandos de Dynamo


  -o, -O, --OpenFilePath        Instruct Dynamo to open a command file and run the commands it contains at 
                                this path, this option is only supported when run from DynamoSandbox

  -c, -C, --CommandFilePath     Instruct Dynamo to open a command file and run the commands it contains at 
                                this path, this option is only supported when run from DynamoSandbox                      

  -v, -V, --Verbose             Instruct Dynamo to output all evaluations it performs to an XML file at this path

  -g, -G, --Geometry            Instruct Dynamo to output geometry from all evaluations to a JSON file at this path

  -h, -H, --help                Get some help

  -i, -I, --Import              Instruct Dynamo to import an assembly as a node library. This argument should be a 
                                file path to a single.dll - if you wish to import multiple dlls - list the dlls 
                                separated by a space: -i 'assembly1.dll' 'assembly2.dll'

  --GeometryPath                Relative or absolute path to a directory containing ASM. When supplied, instead of 
                                searching the hard disk for ASM, it will be loaded directly from this path

  -k, -K, --KeepAlive           Keepalive mode, leave the Dynamo process running until a loaded extension shuts it 
                                down

  --HostName                    Identify Dynamo variation associated with the host

  -s, -S, --SessionId           Identify Dynamo host analytics session id

  -p, -P, --ParentId            Identify Dynamo host analytics parent id

  -x, -X, --ConvertFile         When used in combination with the 'O' flag, opens a .dyn file from the specified 
                                path and converts it to .json. The file will have the .json extension and be 
                                located in the same directory as the original file

  -n, -N, --NoConsole           Don't rely on the console window to interact with CLI in Keepalive mode

  -u, -U  --UserData            Specify user data folder to be used by PathResolver with CLI

  --CommonData                  Specify common data folder to be used by PathResolver with CLI

  --DisableAnalytics            Disables analytics in Dynamo for the process lifetime

  --CERLocation                 Specify the crash error report tool located on the disk

  --ServiceMode                 Specify the service mode startup

¿Por qué?

Es posible que desee controlar Dynamo desde la línea de comandos por diversos motivos, entre los que se incluyen:

  • Automatizar muchas ejecuciones de Dynamo

  • Probar los gráficos de Dynamo (consulte también -c al utilizar Dynamo Sandbox)

  • Ejecutar una secuencia de gráficos de Dynamo en un orden específico

  • Escribir archivos por lotes que ejecuten varias líneas de comandos

  • Escribir otro programa para controlar y automatizar la ejecución de los gráficos de Dynamo y realizar operaciones interesantes con los resultados de esos cálculos

¿Qué?

La interfaz de línea de comandos (DynamoCLI) es un complemento de DynamoSandbox. Se trata de una utilidad de línea de comandos para DOS/terminal diseñada para facilitar la ejecución de Dynamo mediante argumentos de línea de comandos. En su primera implementación, no se ejecuta de forma independiente, debe ejecutarse desde la carpeta donde residen los archivos binarios de Dynamo, ya que depende de los mismos DLL principales que Sandbox. No puede interoperar con otras versiones de Dynamo.

Hay cuatro formas de ejecutar CLI: desde un indicador DOS, desde archivos por lotes DOS y como un acceso directo del escritorio de Windows cuya ruta se modifica para incluir los indicadores de línea de comandos especificados. La especificación del archivo DOS puede ser completa o relativa y también se admiten las unidades asignadas y la sintaxis de URL. También puede construirse con Mono y ejecutarse en Linux o Mac desde el terminal.

Los paquetes de Dynamo son compatibles con la utilidad, pero no se pueden cargar nodos personalizados (dyf), solo gráficos independientes (dyn).

En las pruebas preliminares, la utilidad CLI admite versiones localizadas de Windows y puede especificar argumentos filespec con caracteres ASCII superiores.

Se puede acceder a CLI a través de la aplicación DynamoCLI.exe. Esta aplicación permite a un usuario o a otra aplicación interactuar con el modelo de evaluación de Dynamo mediante una llamada a DynamoCLI.exe con una cadena de comandos. Los resultados podrían presentar el siguiente aspecto:

C:\Program Files\Dynamo\Dynamo Core\[Dynamo Version]\DynamoCLI.exe -o "C:\someReallyCoolDynamoFile.Dyn"

Este comando le indicará a Dynamo que abra el archivo especificado en C:\someReallyCoolDynamoFile.Dyn sin dibujar ninguna IU y que lo ejecute. Dynamo se cerrará cuando el gráfico haya terminado de ejecutarse.

Novedad en la versión 2.1: la aplicación DynamoWPFCLI.exe. Esta aplicación admite todo lo que admite la aplicación DynamoCLI.exe, con la opción Geometría (-g) adicional. La aplicación DynamoWPFCLI.exe solo está disponible para Windows.

Notas importantes

  • El método preferido para interactuar con DynamoCLI es a través de una interfaz de solicitud de comandos.

  • En este momento, deberá ejecutar DynamoCLI desde su ubicación de instalación en la carpeta [Versión de Dynamo]. La CLI necesita acceso a los mismos archivos .dll que Dynamo, por lo que no se debe mover.

  • Debería poder ejecutar gráficos que estén abiertos en ese momento en Dynamo, pero esto puede provocar efectos secundarios no deseados.

  • Todas las rutas de archivos son totalmente compatibles con DOS, por lo que las rutas relativas y completas deberían funcionar, pero asegúrese de escribirlas entre comillas, "C:ruta\a\archivo.dyn".

  • Actualmente, si no se encuentran errores, la CLI simplemente se cerrará una vez completada la ejecución.

¿Cómo?

-o puede abrir Dynamo señalando a un archivo .dyn en el modo sin interfaz gráfica ("headless") que ejecutará el gráfico.

    C:\Program Files\Dynamo\Dynamo Core\[Dynamo Version]\DynamoCLI.exe -o "C:\someReallyCoolDynamoFile.Dyn"

-v puede utilizarse cuando Dynamo se ejecuta en el modo sin interfaz gráfica ("headless") cuando se ha utilizado -o para abrir un archivo; este indicador iterará todos los nodos del gráfico y volcará sus valores de salida a un simple archivo XML. Como el indicador --ServiceMode puede forzar a Dynamo a ejecutar varias evaluaciones de gráficos, el archivo de salida contendrá los valores de cada evaluación que se produzca.

    C:\Program Files\Dynamo\Dynamo Core\[Dynamo Version]\DynamoCLI.exe -o "C:\someReallyCoolDynamoFile.Dyn" -p "C:\aFileWithPresetsInIt.dyn" --ServiceMode "all" -v "C:\output.xml"

El archivo de salida XML presentaría el formato:

    <evaluations>
        <evaluation0>
            <Node guid="e2a6a828-19cb-40ab-b36c-cde2ebab1ed3">
                <output0 value="str" />
            </Node>
            <Node guid="67139026-e3a5-445c-8ba5-8a28be5d1be0">
                <output0 value="C:\Users\Dale\state1.txt" />
            </Node>
            <Node guid="579ebcb8-dc60-4faa-8fd0-cb361443ed94">
                <output0 value="null" />
            </Node>
        </evaluation0>
        <evaluation1>
            <Node guid="e2a6a828-19cb-40ab-b36c-cde2ebab1ed3">
                <output0 value="str" />
            </Node>
            <Node guid="67139026-e3a5-445c-8ba5-8a28be5d1be0">
                <output0 value="C:\Users\Dale\state2.txt" />
            </Node>
            <Node guid="579ebcb8-dc60-4faa-8fd0-cb361443ed94">
                <output0 value="null" />
            </Node>
        </evaluation1>
    </evaluations>

-g puede utilizarse cuando Dynamo se ejecuta en el modo sin interfaz gráfica ("headless") cuando se ha utilizado -o para abrir un archivo; este indicador generará el gráfico y volcará la geometría resultante en un archivo JSON.

    C:\Program Files\Dynamo\Dynamo Core\[Dynamo Version]\DynamoWPFCLI.exe -o "C:\someReallyCoolDynamoFile.Dyn" -g "C:\geometry.json"

El archivo de geometría JSON presentaría el siguiente formato:

 TBD - Work in progress

-h permite obtener una lista de las posibles opciones.

    C:\Program Files\Dynamo\Dynamo Core\[Dynamo Version]\DynamoCLI.exe -h

El indicador -i puede utilizarse varias veces para importar varios montajes que el gráfico que está intentando abrir requiere para ejecutarse.

    C:\Program Files\Dynamo\Dynamo Core\[Dynamo Version]\DynamoCLI.exe -o "C:\someReallyCoolDynamoFile.Dyn" -i"a.dll" -i"aSecond.dll"

El indicador -l puede utilizarse para ejecutar Dynamo con una configuración regional diferente. Sin embargo, por lo general, la configuración regional no afecta a los resultados del gráfico.

    C:\Program Files\Dynamo\Dynamo Core\[Dynamo Version]\DynamoCLI.exe -o "C:\someReallyCoolDynamoFile.Dyn" -l "de-DE"

El indicador --GeometryPath puede utilizarse para dirigir DynamoSandbox o la CLI a un conjunto específico de archivos binarios ASM. Utilícelo de la siguiente forma:

    C:\Program Files\Dynamo\Dynamo Core\[Dynamo Version]\DynamoSandbox.exe --GeometryPath "\pathToGeometryBinaries\"

O

    C:\Program Files\Dynamo\Dynamo Core\[Dynamo Version]\DynamoSandbox.exe --GeometryPath "\pathToGeometryBinaries\"

El indicador -k permite mantener el proceso de Dynamo en ejecución hasta que una extensión lo cierre.

    C:\Program Files\Dynamo\Dynamo Core\[Dynamo Version]\DynamoCLI.exe -k

El indicador --HostName puede utilizarse para identificar la variación de Dynamo asociada al anfitrión.

    C:\Program Files\Dynamo\Dynamo Core\[Dynamo Version]\DynamoCLI.exe --HostName "DynamoFormIt"

O

    C:\Program Files\Dynamo\Dynamo Core\[Dynamo Version]\DynamoSandbox.exe --HostName "DynamoFormIt"

El indicador -s permite identificar el ID de la sesión de análisis del anfitrión de Dynamo.

    C:\Program Files\Dynamo\Dynamo Core\[Dynamo Version]\DynamoCLI.exe -s [HostSessionId]

El indicador -p permite identificar el ID principal de análisis del anfitrión de Dynamo.

    C:\Program Files\Dynamo\Dynamo Core\[Dynamo Version]\DynamoCLI.exe -p "RVT&2022&MUI64&22.0.2.392"
PreviousDefinición de la organización de paquetes personalizados para Dynamo 2.0+NextIntegración de Dynamo

Last updated 1 month ago

DynamoCLI es una nueva funcionalidad que actualmente está en proceso de desarrollo. Por el momento, la CLI solo carga un subconjunto de las bibliotecas estándar de Dynamo, por lo que tenga esto en cuenta si un gráfico no se ejecuta correctamente. Estas bibliotecas se especifican .

aquí