Cómo usar SEQUENZA

Sequenza es un complemento de Revit que extrae datos de secuencia constructiva de un modelo de edificio y los exporta como archivos CSV listos para importar en Navisworks TimeLiner y 3ds Max para simulación de construcción 4D.

Botones de un vistazo

Los tres botones aparecen en el panel Sequenza de la pestaña Complementos de la cinta de opciones. Sólo están activos cuando un proyecto de Revit está abierto; están deshabilitados dentro de los editores de familias.

Botón	Etiqueta en la cinta	Qué hace
Generate Files	Generate Files	Abre el cuadro de configuración, valida el modelo, escribe parámetros compartidos en los elementos y exporta tres archivos CSV de salida.
Edit Sorting	Edit Sorting	Abre el editor de ordenación donde puedes cambiar el orden de la secuencia constructiva para cualquier grupo y designar un elemento ancla ORI.
Setup Guide	Setup Guide	Muestra una guía paso a paso para importar los archivos CSV exportados en Navisworks TimeLiner.

Antes de comenzar

Abre el proyecto de Revit que contiene el modelo de edificio que deseas simular.
Confirma que el modelo tenga al menos un nivel definido.
Confirma que el modelo contiene al menos un elemento en una categoría compatible (consulta la tabla de Categorías de elementos compatibles).
Confirma que Navisworks y la utilidad de exportación NWC están instalados si planeas usar la salida para simulación 4D en Navisworks.
Confirma que tienes acceso de escritura a %APPDATA%\Autodesk\Revit\Addins\{RevitYear}\ — aquí se guardan los archivos de salida.
Cierra cualquier otra sesión activa del mismo modelo. Escribir parámetros compartidos mientras otro usuario ejecuta la herramienta sobre el mismo modelo producirá conflictos.
Desagrupa cualquier grupo de Revit que contenga elementos que quieras incluir en la simulación. Los elementos agrupados se excluyen automáticamente.

Flujo de trabajo principal

Generate Files              Edit Sorting              Setup Guide
       |                          |                         |
Abrir cuadro de configuración          Cargar grupos de          Abrir guía paso a paso
Seleccionar categorías          parámetro SIMULATION          guía Navisworks
Establecer fecha de inicio                    |
       |                  Elegir método de ordenación
Validar modelo            Establecer ancla ORI
       |                          |
Escribe parámetros compartidos       Aplicar y cerrar
SIMULATION, SIM_PART      Escribe SIM_PART
LO_Level, LO_Building     y SIM_ORI
       |
Exportar archivos CSV
  Simulations Identification.csv
  Simulations Components.csv
  MaxScript_Animation.csv
  MaxScript_Animation_Template.ms
  SimulationConfig.json
       |
Abrir carpeta de salida

Ejecuta Generate Files primero en cada nuevo proyecto. Ejecuta Edit Sorting después para ajustar el orden de la secuencia antes de volver a ejecutar Generate Files para producir los CSV finales.

Escenarios

Escenario 1: Primer simulación en un proyecto nuevo

Contexto: El modelo está completo hasta el Nivel 3. No existen aún parámetros de Sequenza en el modelo.

Haz clic en Generate Files en el panel Sequenza de la pestaña Complementos.
En el cuadro de configuración, establece la Fecha de inicio del proyecto según el inicio previsto de obra.
Revisa la lista de categorías. El cuadro muestra solo las categorías presentes en la vista activa. Desmarca las que aún no se han modelado — por ejemplo, desmarca Mobiliario si no hay familias de muebles colocadas.
Haz clic en Generate simulation.
Sequenza valida el modelo. Si la validación es correcta, escribe los parámetros compartidos SIMULATION, SIM_PART, LO_Level, LO_Building y SIM_ORI en cada elemento de las categorías seleccionadas.
Se generan tres archivos CSV y una plantilla MaxScript en la carpeta de salida.
En el cuadro de diálogo de éxito, revisa el número de elementos y las estadísticas de resolución de ubicación, luego haz clic en Abrir carpeta de salida para verificar los archivos.
Abre la Setup Guide y sigue los ocho pasos para importar Simulations Identification.csv en Navisworks TimeLiner y ejecutar la animación 4D.

Resultado esperado: Todos los elementos en las categorías seleccionadas tienen parámetros compartidos escritos. Los tres archivos CSV están presentes en la carpeta de salida y listos para importar en Navisworks.

Escenario 2: Actualizar la simulación tras añadir nuevos niveles

Contexto: Se han añadido tres niveles adicionales al modelo desde la última ejecución. Los archivos CSV existentes están desactualizados y no reflejan la nueva estructura.

Haz clic en Generate Files.
En el cuadro de configuración, ajusta la Fecha de inicio del proyecto si el cronograma de obra se ha actualizado.
Confirma que todas las categorías requeridas siguen seleccionadas, incluyendo cualquier nueva presente en los nuevos niveles.
Haz clic en Generate simulation.
Sequenza revalida el modelo, detecta todos los niveles (incluidos los nuevos), escribe los parámetros compartidos en cada elemento de los nuevos niveles y sobrescribe los archivos CSV existentes.
En Navisworks, elimina la fuente de datos anterior, vuelve a importar el Simulations Identification.csv actualizado y reconstruye la jerarquía de tareas.

Resultado esperado: Los archivos CSV ahora incluyen todos los niveles. La simulación de Navisworks cubre todo el alto del modelo actualizado.

Escenario 3: Cambiar el orden de la secuencia constructiva de un grupo estructural

Contexto: La estructura del Nivel 2 debe secuenciarse desde el núcleo estructural hacia el exterior, en vez de por ID de elemento. La secuencia predeterminada no refleja esto.

Haz clic en Generate Files y realiza una generación estándar para asegurar que todos los parámetros de SIMULATION están actualizados.
Haz clic en Edit Sorting.
En el panel de Grupos a la izquierda, selecciona Level 2_StructuralFraming.
En el panel derecho, abre el desplegable Método de ordenación y selecciona ProximityToORI.
En la lista central de elementos, localiza el elemento en el núcleo estructural. Selecciónalo.
Haz clic en Set as ORI anchor. El elemento queda marcado como [ORI] en rojo y se mueve a la posición 1 de la lista.
Confirma que la secuencia ahora irradia desde el ancla revisando los colores de gradiente en la lista —el elemento en la posición 1 es el más brillante y la posición N la más oscura.
Haz clic en Guardar grupo.
Repite los pasos 3–8 para cualquier otro nivel que requiera el mismo tratamiento.
Haz clic en Aplicar y cerrar. Sequenza escribe los valores SIM_PART y SIM_ORI actualizados en el modelo.
Haz clic en Generate Files de nuevo para regenerar los archivos CSV con el nuevo orden aplicado.

Resultado esperado: El archivo Simulations Components.csv refleja la secuencia desde el núcleo para el armazón estructural del Nivel 2. Navisworks TimeLiner animará la construcción irradiando desde el núcleo.

Escenario 4: Exportación sólo estructural para revisión de avance

Contexto: El cliente requiere una animación sólo estructural para una reunión de revisión de programa. Las categorías de MEP y acabados arquitectónicos no deben aparecer en la simulación.

Haz clic en Generate Files.
En el cuadro de configuración, haz clic en Deselect All para limpiar la lista completa de categorías.
Marca solo las siguientes categorías: StructuralFoundations, StructuralColumns, StructuralFraming, Floors, Roofs y Walls.
Confirma la fecha de inicio y haz clic en Generate simulation.
Sequenza valida el modelo solo usando las categorías seleccionadas. Solo los elementos en esas categorías reciben parámetros actualizados.
Los tres archivos CSV generados contienen solo datos estructurales.
Importa Simulations Identification.csv en Navisworks como de costumbre.

Resultado esperado: La simulación 4D muestra sólo las categorías estructurales seleccionadas. Los elementos MEP y arquitectónicos están ausentes de los archivos CSV y no aparecerán en TimeLiner.

Tipos de estado de validación

Cada ejecución de generación produce un resultado de validación. El tipo de resultado determina si la generación puede continuar.

Estado	Significado	Acción requerida
Error crítico	No puede continuar la generación. La condición listada debe resolverse antes de ejecutar la exportación.	Soluciona el problema y ejecuta Generate Files de nuevo.
Advertencia	La generación puede continuar, pero se encontró una condición que puede afectar la calidad de la salida. Sequenza muestra un cuadro de confirmación antes de continuar.	Revisa la advertencia. Haz clic en Sí para continuar o en No para cancelar.
Info	Informativo solamente. No requiere acción y la generación continúa automáticamente.	Ninguna.

Errores críticos comunes

Mensaje	Solución
El modelo no tiene niveles definidos. Se requiere al menos un nivel para la simulación 4D.	Crea al menos un nivel en el proyecto Revit antes de ejecutar Sequenza.
No se encontraron elementos procesables en el modelo.	Coloca al menos un elemento en una categoría compatible. Asegúrate que esos elementos no estén dentro de grupos de Revit.
La configuración es nula.	Cierra y vuelve a abrir Revit, luego ejecuta Generate Files otra vez.

Advertencias comunes

Mensaje	Significado
X elementos no se pudieron asignar automáticamente a un nivel.	Esos elementos no tienen un parámetro de nivel directo. Sequenza intenta resolverlo por bounding-box y elemento anfitrión. El diálogo de éxito muestra la tasa de resolución por estrategia.
El modelo contiene N elementos — la exportación puede tardar varios minutos.	Normal para modelos grandes. No cierres Revit durante la generación.
La duración estimada del proyecto supera 1 año.	El cronograma calculado según número de elementos y días laborables supera los 12 meses. Revisa la fecha de inicio y confirma que el cronograma sea correcto.

Métodos de ordenación

Método	Cómo secuencia los elementos	Es mejor usar cuando
ElementId	Orden ascendente por ID de elemento de Revit. Estable y reproducible entre ejecuciones.	No se necesita preferencia espacial específica. Es el predeterminado para todos los grupos.
ProximityToORI	Distancia 3D desde el elemento ancla ORI hacia afuera. El elemento más cercano a ORI se construye primero.	La construcción irradia desde un núcleo, punto de entrada o arranque estructural.
XYZPrint	Recorre de izquierda a derecha (X primero), luego de adelante hacia atrás (Y), luego de abajo hacia arriba (Z).	Construcción fila por fila y piso por piso, de izquierda a derecha.
YXZPrint	Recorre de adelante hacia atrás (Y primero), luego de izquierda a derecha (X), luego de abajo hacia arriba (Z).	Construcción por crujía donde la profundidad es la dirección principal.
ZXYPrint	Recorre de abajo hacia arriba (Z primero), luego de izquierda a derecha (X), luego de adelante hacia atrás (Y).	Construcción nivel por nivel con prioridad en columnas y filas.
ZYXPrint	Recorre de abajo hacia arriba (Z primero), luego de adelante hacia atrás (Y), luego de izquierda a derecha (X).	Construcción nivel por nivel con prioridad en la profundidad.

El ancla ORI aplica a todos los métodos. Para ProximityToORI define el origen hacia fuera. Para todos los métodos print, el elemento en ORI se coloca en la posición 1 y el orden global de los ejes continúa desde ahí — los elementos que aparecerían antes de ORI en el recorrido se reubican al final de la secuencia.

Categorías de elementos compatibles

Categoría	Uso típico en modelo constructivo
StructuralFoundations	Cimentaciones aisladas, zapatas corridas, cabezales de pilotes
StructuralColumns	Columnas de hormigón o acero
StructuralFraming	Vigas, tirantes, viguetas, cerchas
Floors	Losas de hormigón, forjados colaborantes
Roofs	Elementos de cubierta planos o inclinados
Walls	Muros portantes y tabiques
Doors	Familias de puertas insertadas en muros
Windows	Familias de ventanas insertadas en muros
Ceilings	Falsos techos suspendidos o directos
CurtainPanels	Paneles y vidrios de muro cortina
PipeCurves	Recorridos de tubería de fontanería
DuctCurves	Conductos de HVAC
Conduit	Circuitos de tubo eléctrico
CableTray	Bandejas portacables
PipeAccessory	Accesorios, válvulas y uniones de tubería
DuctAccessory	Accesorios y compuertas de conductos
MechanicalEquipment	Unidades de tratamiento de aire, fan coils, bombas
ElectricalEquipment	Cuadros, transformadores, interruptores
PlumbingFixtures	Lavabos, inodoros, duchas
LightingFixtures	Luminarias y artefactos de iluminación
LightingDevices	Interruptores, tomas, sensores
GenericModels	Familias personalizadas y contenido BIM genérico
Furniture	Familias de mobiliario suelto
FurnitureSystems	Puestos de trabajo modulares, particiones de sistemas
SpecialityEquipment	Equipos especiales o personalizados

Los elementos dentro de grupos de Revit se excluyen automáticamente y se contabilizan en el total de elementos omitidos que se muestra en la cabecera del diálogo Edit Sorting.

Consejos

Ejecuta Generate Files de nuevo después de cada sesión de Edit Sorting. Los archivos CSV no se actualizan automáticamente cuando cambias el orden de la secuencia o la ancla ORI.
Usa la vista previa en vivo en Edit Sorting para confirmar que los colores de gradiente en Revit coincidan con los de la lista. El elemento con el color más brillante en la lista aparece igual de brillante en la vista — esto es intencional y confirma la sincronía.
En Edit Sorting, haz clic en Pick from view para seleccionar una ancla ORI cliqueando directamente un elemento en la vista de Revit en lugar de buscarlo en la lista.
Modelos grandes con más de 5.000 elementos pueden tardar dos o tres minutos en generarse. Deja la ventana de Revit activa y no cambies de vista durante el proceso.
Si elementos aparecen como no resueltos en el diálogo de éxito, verifica que no estén dentro de grupos, y que tengan geometría (no puede calcularse la bounding box para elementos sin geometría visible).
Después de renombrar niveles en Revit, ejecuta Generate Files de nuevo. Los valores SIM_PART escritos en los elementos incluyen el nombre del nivel y quedarán obsoletos tras un cambio de nombre.
El archivo SimulationConfig.json escrito en la carpeta de salida es un registro legible de la configuración utilizada en cada ejecución. Guárdalo junto con los CSV para fines de auditoría.
El archivo MaxScript_Animation_Template.ms es un punto de partida listo para usar en 3ds Max. Edita la sección de mapeo de nombres si tu geometría importada utiliza una convención distinta a la de los nombres de elementos en el CSV.

Sequenza — Cómo usar