Redacta entrada OpenSees con IA — luego pruébala con un solver y un humano

Por qué importa

OpenSees es un motor determinista: dado un modelo de entrada, aplica los métodos numéricos que elegiste. Un modelo de lenguaje no es ese motor. El patrón útil es estrecho. Deja que un chat redacte boilerplate. Deja que una persona sea dueña de la mecánica. Deja que OpenSees corra. Deja que un segundo método discuta el resultado.

Si te saltas al humano o la comprobación independiente, tienes composición tipográfica, no análisis estructural.

Requisitos previos

Deberías poder declarar, sin un chatbot:

• qué cinemática quieres (ndm / ndf);
• qué se supone que hacen los apoyos;
• si la pregunta es estática, de autovalores o de historia en el tiempo;
• cómo se vería una comprobación independiente para una versión recortada del mismo problema.

Si esas respuestas faltan, no generes Tcl ni Python todavía. Lee primero un tutorial de primer modelo elástico y una referencia de dinámica. Este artículo asume esa secuencia. No enseña OpenSees desde cero.

Idea central

Trata el modelo como tres artefactos con autores distintos:

Artefacto	Quién lo produce	Qué significa «listo»
Comandos en borrador	Sugerencia opcional de IA	Compila como texto, no como verdad
Modelo de análisis	Humano	Geometría, secciones, restricciones y opciones de análisis coinciden con la mecánica pretendida
Resultado	OpenSees	Una corrida reproducible con un log guardado
Evidencia	Humano + método independiente	Un desacuerdo se notaría

El motor nunca revisa el prompt. El prompt nunca integra las ecuaciones de movimiento.

Un esqueleto pedagógico — incompleto a propósito

El bloque de abajo no es un modelo de diseño. Se omiten varios objetos esenciales para que no se confunda con un archivo listo. Úsalo como recordatorio de lo que mira un revisor, no como algo a analizar y sellar.

# ILLUSTRATIVE SKELETON — not a complete model and not a design.
# Fill every omitted object yourself. Then run OpenSees. Then check independently.

from openseespy.opensees import *

wipe()
model("basic", "-ndm", 2, "-ndf", 3)

# Human must define: units, node coordinates, masses, materials,
# sections, geometric transformation, elements, constraints, and loads.

# Example of a checkable declaration (values are placeholders, not recommendations):
# node(1, 0.0, 0.0)
# fix(1, 1, 1, 1)

# After the human owns the model:
# eigen(nModes) or static analyze(...)
# print or recorder output for the quantities you will check by another method

Un archivo generado que «se ve completo» es más peligroso que este esbozo. Completitud de sintaxis no es completitud de mecánica.

Lista humana antes del primer analyze

Trabaja esta lista sobre el archivo editado, no sobre la transcripción del chat.

1. Unidades. Un sistema, escrito arriba del archivo. Gravedad, densidad y fuerza deben coincidir. Los borradores de IA a menudo mezclan milímetros, metros y kips.
2. Cinemática. Bidimensional frente a tridimensional; cercha frente a viga frente a cascarón. ndf debe coincidir con el tipo de elemento que crees que usaste.
3. Geometría. Coordenadas de nodos de tu plano o de una geometría de estudio reducido que puedas dibujar a mano. No aceptes vanos inventados.
4. Restricciones. Apoyos que coincidan con el mecanismo pretendido. Vigila fijaciones faltantes (modos de cuerpo rígido) y liberaciones accidentales.
5. Elementos y transformación. elasticBeamColumn no es una rótula de fibra. Linear no es PDelta ni Corotational. El nombre generado suele ser la física equivocada.
6. Masa (si hay dinámica). Qué está concentrada, qué es consistente, si se pretende masa rotacional, si la masa está en el GDL correcto. Autovalores sin masa son un problema distinto del que preguntaste.
7. Cargas y patrones. Dirección, combinación y si hay gravedad. Una comprobación de deriva estática sin gravedad es un modelo distinto de una comprobación P-Delta.
8. Análisis. Autovalor frente a estático frente a transitorio; integrador; prueba de convergencia. Una corrida que da avisos de analyze es información, no una molestia a esconder.
9. Salida. No puedes validar una cantidad que no registraste.

Si el modelo de lenguaje rellenó cualquiera de estos sin una fuente a la que puedas señalar, borra esa parte y escríbela tú.

Para qué sirve el solver

Después de la lista, corre OpenSees (u OpenSeesPy) sobre el archivo del que el humano es dueño. Guarda:

• la entrada que realmente corriste (no el primer borrador generado);
• la versión del intérprete y, si la rastreas, el build de OpenSees;
• logs, incluidos avisos;
• los resultados concretos que comprobarás (periodos, reacciones, un desplazamiento en un nodo nombrado).

Esa corrida es un cálculo determinista del modelo que suministraste. No es prueba de que el modelo sea la estructura, y no es una verificación de norma.

Evidencia de validación (el paso que la IA no puede dar)

Elige una comprobación que no reutilice el mazo generado:

• Reduce el problema a un SDOF o a un pórtico de un vano que puedas resolver con el método de rigideces o una frecuencia de libro.
• Compara periodos elásticos o desplazamientos estáticos con un segundo modelo independiente (otro motor, o un archivo OpenSees mucho más simple que escribiste tú).
• Para teoría de dinámica y cómo se ve un comportamiento modal «razonable» en sistemas lineales, usa una referencia como Chopra — como teoría, no como sustituto de tus números.

El acuerdo a tres dígitos con una paráfrasis de chatbot de tu propia salida no es independiente. Si los dos métodos discrepan, no creas en ninguno hasta entender el modelo.

Errores habituales

• Pedir «escribe un edificio 3D en OpenSees» y tratar el archivo como un gemelo digital.
• Dejar el boilerplate generado de wipe() / model() intacto mientras el resto del archivo describe un ndm distinto.
• Usar materiales no lineales porque el prompt dijo «pushover», y luego leer el desplazamiento del primer paso como si fuera lineal.
• Saltar amortiguamiento de Rayleigh, fuente de masa o restricciones, y luego comparar periodos con una fórmula aproximada de norma como si eso fuera validación.
• Publicar un notebook que llama a una API de Tcl y nunca muestra un diff humano.

Limitaciones

OpenSees es un marco de análisis de investigación y profesional con una librería grande de elementos. Este artículo no documenta esa librería, no selecciona elementos para diseño sísmico y no aborda interacción suelo-estructura, estrategia de no linealidad geométrica ni evaluación basada en desempeño.

El esqueleto está incompleto a propósito. Cualquier número que obtengas al rellenarlo es tu cálculo, no el de este sitio.

Los modelos de lenguaje seguirán mejorando en sintaxis. La sintaxis es la parte barata. Unidades, cinemática pretendida y comprobaciones independientes siguen siendo caras. Esos costos no desaparecen porque el borrador llegó más rápido.

Contexto profesional

Un modelo OpenSees reproducible puede ser documentación excelente de un análisis, si una persona competente es dueña de él. Sigue sin sustituir la norma de diseño que rige el proyecto, y no es un sello. Los estudiantes deberían usar este flujo para aprender lo fácil que es obtener un modelo fluido y equivocado. Los profesionales deberían mantener los borradores de IA fuera del conjunto firmado hasta que la lista y la comprobación independiente existan en el archivo del proyecto.

Referencias

• Documentación de OpenSees — opensees.github.io/OpenSeesDocumentation.
• OpenSeesPy — sigue la documentación del intérprete y de comandos que viene con la versión que realmente corres. Los nombres de comando y los valores por defecto cambian; no confíes en una ruta de import generada sin comprobar esa versión.
• Chopra, A. K. Dynamics of Structures. Material de comprobación independiente para dinámica lineal, no un sustituto de tus números de OpenSees.

Evaluación y limitaciones

Trata las notas siguientes como contexto de evaluación, no como un cálculo o una revisión verificados.

Juzga un flujo OpenSees asistido por IA por artefactos, no por la fluidez del archivo generado: una entrada de la que un humano es dueño, un log del solver y una comprobación independiente (cálculo a mano de orden reducido, frecuencias de libro o un segundo modelo). Si falta cualquiera, sigues teniendo una sugerencia. Esta página no verifica OpenSees, OpenSeesPy ni ningún prompt.