Dxf2opensees

Descripcin General:

Dxf2opensees es un programa ejecutable elaborado en Microsoft Visual Studio que sirve como herramienta
para la modelacin de estructuras en OpenSees.

Fue desarrollado en el Instituto de Ingeniera de la Universidad Nacional Autnoma de Mxico por el Dr. Juan
Jos Prez-Gaviln Escalante como una adaptacin del programa dxf2SAP 2014, el cual funciona como una
interfaz entre AutoCAD y Sap2000.

Debido a que el programa OpenSees an no cuenta con una interfaz grfica, resulta un poco complicado el
anlisis y modelacin de estructuras de mediana y gran altura. Este problema se vuelve an ms complejo
cuando se hacen anlisis mediante elemento finito, ya que el nmero de elementos puede ser tan grande que
resulta casi imposible procesar todos los elementos en un archivo de texto, el cual puede ser muy vulnerable a
mltiples errores numricos (conectividad, propiedades mecnicas y dinmicas, continuidad, etc.).

Aunque ya existen algunos programas con interfaz grfica que utilizan OpenSees para el procesamiento y
anlisis (Build-X, GiD+OpenSees, CICsMIC) an son programas de recin lanzamiento, por lo que pueden ser
propensos a algunos errores.

El objetivo fundamental del programa dxf2opensees es contar con una herramienta para el procesamiento de
estructuras en OpenSees, mediante la exportacin de un archivo de AutoCAD el cual se genera con ciertos
parmetros descritos a detalle ms adelante, entre los que destacan la geometra y cargas gravitacionales.

El archivo de AutoCAD se guarda con extensin .dxf para poder ser ledo por el programa dxf2opensees y
genere un archivo de texto con la geometra de la estructura principalmente, que fcilmente puede ser guardado
con extensin .tcl, para finalmente ser procesado en OpenSees.

A pesar de la gran ayuda que brinda esta herramienta, aun es necesario definir ciertos parmetros para los
anlisis a realizar (sistema de ecuaciones, restricciones, integrador, test de convergencia, entre otros); que
comparados con la geometra de la estructura, resultan solo una pequea parte (aunque fundamental) en cuanto
al tamao del archivo tcl que contiene todo el anlisis de la estructura.

Debido a que dxf2OpenSees fue diseado exclusivamente para modelar estructuras de mampostera con
aislamiento de base, tiene algunas limitaciones en cuanto a la compatibilidad de los materiales y elementos
disponibles en OpenSees, reducindolo a unos pocos elementos y materiales descritos a continuacin:

Elementos Barra:

Elastic Beam Column Element

Elastic Timoshenko Beam Column Element

Elementos Shell:

Quad Element
Shell Element

Secciones:

Elastic Membrane Plate Section

Elastic Section

Materiales:

Elastic Isotropic Material

Aisladores de base:

Elastomeric Bearing (Plasticity) Element

Elastomeric Bearing (Bouc-Wen) Element
Flat Slider Bearing Element
Single Friction Pendulum Bearing Element
TFP Bearing
Triple Friction Pendulum Element
MultipleShearSpring Element
KikuchiBearing Element
YamamotoBiaxialHDR Element
ElastomericX
LeadRubberX
HDR
RJ-Watson EQS Bearing Element
FPBearingPTV

Programacin:

Se presenta una breve descripcin de las consideraciones tomadas por el autor para la generacin del cdigo,
las cuales deben seguirse al momento de generar el archivo .dxf en AutoCAD para un correcto funcionamiento
del programa.

Para una comprensin satisfactoria de este trabajo, se recomienda tener conocimientos bsicos en el manejo de
AutoCAD y OpenSees.

Generacin de Nodos:

Se utiliza la convencin de los ejes globales establecida por default en AutoCAD (X Y Z):

El programa numera los nodos en orden ascendente (menor a mayor) de la siguiente forma:

Primero toma los nodos que tengan la coordenada menor en el eje global vertical Z, despus los compara y
toma los que tengan una componente menor en el eje global Y, por ultimo numera el nodo que tenga la menor
magnitud en el eje X y as sucesivamente. Este arreglo tiene ventajas al momento de procesar los nodos en la
base de una estructura y cada nivel, por ejemplo, facilitar el manejo de restricciones, diafragmas rgidos,
recorders, entre otros.

Nota: En AutoCAD es comn que los vrtices de elementos conectados entre s no estn perfectamente unidos,
por lo que se generan nodos distintos aunque visiblemente tengan las mismas coordenadas. Por esto se maneja
una tolerancia de 1x10-3 centmetros y as evitar tener nodos repetidos. Por lo tanto es recomendable utilizar las
unidades de longitud en centmetros.
Diafragmas:

Para definir un diafragma rgido basta con crear una figura con el comando polyline en el plano XY en la altura
del nivel deseado. Lo que hace dxf2OpenSees es tomar como nodos esclavos, todos los que estn a la misma
altura del plano de la figura creada y restringir los grados de libertad con los de un nodo maestro creado por el
programa, dejando libre los desplazamientos en X y Y, adems del giro alrededor del eje Z. El programa toma
el promedio de las coordenadas de los nodos esclavos para definir el nodo maestro.

Se recomienda que la figura sea un rectngulo o tenga la forma del corte en el plano horizontal del nivel de la
estructura. El usuario debe crear un layer con el nombre Diafragma en el que estn todas estas figuras,
independientemente del nmero de diafragmas que se crean, solo es necesario generar un layer que contenga a
todos ellos.

Elementos Barra:

Layer

Para definir un elemento barra existen dos tipos de elementos compatibles con dxf2OpenSees: Elastic Beam
Column y Elastic Timoshenko Beam Column, los cuales se definen en AutoCAD nombrando el layer al que
pertenecen estos elementos con los nombres de los comandos tal como se definen en OpenSees. Ejemplo:
ElasticBeamColumn y ElasticTimoshenkoBeam.

Conectividad

Estos elementos se generan en AutoCAD con el comando Polyline, estn compuestos por un nodo inicial y uno
final, los cuales definen la conectividad del elemento en dxf2OpenSees, es decir, el programa genera la
conectividad tal como se dibuja el elemento en AutoCAD. En caso de dos barras unidas en el mismo eje, es
necesario dibujar una barra con polyline y volver a ejecutar el comando para la segunda barra.

Seccin Transversal

Cuando se tienen barras con distinta seccin transversal, se sigue un procedimiento similar al de asignacin de
masas en los nodos, solo que ahora se agrega un nmero al final del nombre del layer correspondiente a la
seccin. Ejemplo: ElasticBeamColumn1, ElasticBeamColumn2, ElasticBeamColumn3.

Nota: Para mayor facilidad en el manejo de diferentes secciones, se recomienda utilizar diferente color de layer
para diferenciar visualmente los diferentes tipos. Cabe aclarar que el programa define los parmetros del
comando del elemento con las mismas variables por default que maneja OpenSees, por lo que no produce
valores numricos, los cuales deben ser especificados por el usuario en un archivo de texto por separado. Este
archivo puede ser fcilmente programable en Excel, con el fin de automatizar el clculo de los mismos. La
transformacin geomtrica del elemento debe ser definida por el usuario.

Elementos Shell:

Para generar un elemento Shell se utilizan poli lneas, las cuales deben tener cuatro puntos que debern ser
dibujados en sentido anti horario tal como se maneja en OpenSees.

El layer de estos elementos debe ser nombrado ShellMITC4. Para el manejo de distintas secciones debe
asignarse un color diferente a cada una de ellas. De esta forma, el programa generara automticamente una
seccin a los elementos con el mismo color.

Nota: El color utilizado en AutoCAD debe tener un nmero de RGB, por lo que se recomienda utilizar los
colores en la seccin indexColors. Para distinguir las diferentes secciones, en el comando de seccin del archivo
de texto se especifica el numero RGB, por lo que se recomienda al usuario tener a la mano este nmero.
Aisladores:

Estos elementos se utiliza el comando polyline de AutoCAD y basta con generar una poli lnea de 2 puntos, la
cual debe estar en un layer con el nombre correspondiente al tipo de aislador que se quiera utilizar. En la
siguiente tabla se presentan los aisladores disponibles en OpenSees y los respectivos nombres con los que deben
ser nombrados los layer en AutoCAD:

Elementos en OpenSees Nombre del layer

Elastomeric Bearing (Plasticity) Element elastomericBearingPlasticity
Elastomeric Bearing (Bouc-Wen) Element elastomericBearingBoucWen
Flat Slider Bearing Element flatSliderBearing
Single Friction Pendulum Bearing singleFPBearing
Element
TFP Bearing TFP
Triple Friction Pendulum Element TripleFrictionPendulum
MultipleShearSpring Element multipleShearSpring
KikuchiBearing Element KikuchiBearing
YamamotoBiaxialHDR Element YamamotoBiaxialHDR
ElastomericX ElastomericX
LeadRubberX LeadRubberX
HDR HDR
RJ-Watson EQS Bearing Element RJWatsonEqsBearing

Como se menciona anteriormente, el programa generara todos los parmetros en variables tal y como se
manejan en OpenSees. Para el caso de los elementos de friccin, automticamente se generan modelos de
friccin y se asignan al elemento. El modelo de friccin generado por default es el de Coulomb.

Nota: Se recomienda dibujar el elemento de abajo hacia arriba con el fin de que el nodo inicial de cada elemento
este en la base y puedan manejarse las restricciones con mayor facilidad.

Patterns:

Un pattern se define en un layer nombrado Pattern seguido del nmero de etiqueta que define al mismo.
Ejemplo: Pattern1, Pattern2, Pattern3.

Las cargas pueden asignarse de dos formas: cargas puntuales en los nodos y cargas distribuidas en los elementos
barra. Para esto es necesario crear un bloque en AutoCAD con uno de los siguientes nombres que dependen de
la direccin de la carga:

Carga puntual en un nodo.

FX: Agrega una fuerza en la direccin X

FXn: Agrega una fuerza en la direccin X con magnitud negativa
FY: Agrega una fuerza en la direccin Y
FYn: Agrega una fuerza en la direccin Y con magnitud negativa
FZ: Agrega una fuerza en la direccin Z
FZn: Agrega una fuerza en la direccin Z con magnitud negativa

Nota: Es necesario que el punto de insercin del bloque coincida con el nudo al que es asignada la carga.
La magnitud de la carga estar definida por la escala del bloque, y deber manejarse en unidades de
toneladas. Por ejemplo, para definir una carga de 250 kilos, la escala del bloque deber ser 0.25.
 Carga distribuida en un elemento barra.

En este caso el nombre del bloque ser wZ, el cual agrega una carga distribuida en direccin
del eje local z del elemento.

Nota: Es necesario que el punto de insercin del bloque coincida con el nudo intermedio (midpoint) de la
barra a la que es asignada la carga. La magnitud de la carga estar definida por la escala del bloque, y
deber manejarse en unidades de toneladas por metro. Por ejemplo, para definir una carga de 250 kgf/m,
la escala del bloque deber ser 0.25.

Consistencia de Unidades

La consistencia de unidades de fuerza es ms flexible cuando solo se trabaja con cargas puntales en los nodos,
ya que solo se manejan unidades de fuerza que no dependen de otros factores. Cuando esta unidad de fuerza es
convertida a masa se divide entre la gravedad con unidades en cm/s2.

Un problema ms sensible se presenta al trabajar con cargas distribuidas ya que al ser convertidas a masa se
divide tambin entre la gravedad (cm/s2) solo que multiplicada por un factor de conversin de 100 para pasar
de ton/m a ton/cm. Por lo tanto, en este caso, es fundamental manejar unidades de ton/m en el archivo de
AutoCAD.

Este problema podra evitarse si se manejaran unidades de ton/cm para cargas distribuidas en el archivo de
AutoCAD. Sin embargo, estas unidades son poco amigables para el usuario, ya que en problemas comunes de
la prctica profesional se trabajaran con al menos 3 o 4 decimales. Por esta nica razn, se hizo esta
consideracin en el manejo de unidades.

Para manejar otras unidades de fuerza se recomienda modificar el factor del pattern (default=1.0) en el archivo
de salida .dat por el factor de conversin para las unidades deseadas. Ejemplo: Para convertir a kilogramos (1
ton=1000 kg) pattern Plain 1 1 -fact 1000.

Time Series

El programa genera un time series por default de tipo constante con factor de carga de 1.0 el cual puede ser
fcilmente modificado por otro tipo deseado.

Nota: Es importante sealar que independientemente de que existan dos o ms patterns en algn anlisis, a
todos estos se les aplica el mismo time series.

En la siguiente tabla, se presenta un resumen de las unidades que debe manejar el usuario antes mencionadas y
explicadas para que exista consistencia entre ellas:

Fuerza
Carga Carga Longitud
Distribuida Puntual
Unidad Ton/m Ton cm

Masas en los nodos:

La asignacin de masas en los nodos se realiza mediante los patterns generados en AutoCAD, basta con agregar
la letra m al final del nombre del layer correspondiente a cada pattern deseado para que al ejecutar el
programa, automticamente convierta las cargas en unidad de masa y la asigne a los nodos. Ejemplo:
Pattern1m, Pattern2, Pattern3m.

Para tomar en cuenta la masa de los elementos, los tipos de elementos manejados en dxf2OpenSees tienen la
opcin de asignar la magnitud de la masa como parmetro, por lo que solo es necesario transformar las masas
asignadas en los nodos.
Nota: Al momento de transformar las cargas asignadas a masas, es fundamental que las unidades manejadas
por el usuario sean consistentes con las del programa, debido a que el factor de conversin tiene unidades de
aceleracin en cm/s2 y de fuerza en toneladas.

Generacin de Recorders:

Dxf2OpenSees tiene la opcin de agregar un recorder de elementos en un nivel.

En el archivo de AutoCAD se genera un bloque con el nombre ERecorder, el cual debe estar en un plano
determinado, de manera que el programa tomara todos los elementos que se encuentran en el plano del bloque
y generara un recorder con estos elementos en el archivo .dat. El bloque deber encontrarse en un layer llamado
ERecorder, seguido del nmero de etiqueta del mismo, en caso de querer manejar distintos recorders en el
archivo. Ejemplo: ERecorder1, ERecorder2.

Este recorder tendr por default el argumento force, el cual puede ser fcilmente modificado si se desea
manejar otro argumento. El propsito de este recorder designado por el autor fue el obtener elementos
mecnicos en muros de algn nivel, por lo que resulta una herramienta muy til para estos casos.

Generacin del Archivo .dxf:

A continuacin se presenta una pequea gua paso a paso con los requerimientos para generar el archivo dxf en
AutoCAD y como generar el archivo de texto en dxf2opensees.

Para generar el archivo en dxf basta con abrir AutoCAD

Ejecucin del Programa:

El programa se ejecuta en el procesador de comandos de Windows (CMD):

Ubicar el directorio donde se encuentra el programa y ejecutarlo junto con el archivo .dxf de la siguiente forma:
Ya ejecutado el programa, se genera un archivo de texto .dat con las caractersticas de la estructura antes
definidas para ser procesado en OpenSees. Adems en la ventana de comando se despliega el nmero de nodos,
elementos y cargas generados:

Una vez generado el archivo .dat se agregan los parmetros requeridos para los anlisis deseados y se hacen las
modificaciones correspondientes para finalmente ser guardado con formato tcl y ser ejecutado en OpenSees.

Recomendaciones:

Indicar desde AutoCAD las unidades de fuerza y longitud en las que se trabajara.
Restringir todos los nodos que estn a la altura de la base de la estructura.
Generar una transformacin geomtrica por default para los elementos barra.
Generar algunos parmetros por default para el anlisis gravitacional y dinmico.
Aumentar el nmero de elementos compatibles con los disponibles en OpenSees.

Cualquier duda, comentario o sugerencia dirigirse con el autor del programa: el Dr. Juan Jos Prez Gaviln
Escalante al correo jjpge@pumas.iingen.unam.mx o al correo rruizs@iingen.unam.mx.