PARA EL MODELAMIENTO, ANALISIS

AUTOMATIZADO DE
EXTENSION
Y DISENO
RESERVORIOS CIRCULARES EN SAP2000
XVII CONGRESO NACIONAL DE INGENIERIA CIVIL - XVII CONIC 2009
Ing. Edmundo Canchari Gutierrez

1.

Introducci
on

En la actualidad se ha llegado a un nivel en la que es poco probable evitar la convivencia constante

con las aplicaciones en todos los campos de la Ingeniera, esto se debe a las grandes facilidades que
ofrecen para modelar situaciones reales en muy corto tiempo ademas de estar siempre implementados
con los metodos numericos de u
ltima generacion para cada proposito. Sap2000 es un programa
general producido y mantenido por la empresa Computer and Structures inc en la que se encuentra
un ambiente comodo para la creaci
on del modelo, analisis y dise
no de estructuras; ademas cuenta
desde la versi
on 11.0.0 con su Interfaz de Programaci
on para aplicaciones (Application Programming
Interface API), lo que hace posible acceder al programa desde aplicaciones externas con la finalidad
de implementar extensiones dependiendo de las necesidades de cada usuario.
Con fines de la correcta utilizaci
on de la API y Sap2000 es necesario tener un conocimiento
suficiente del Metodo de los Elementos Finitos, distinguir las ventajas e inconvenientes de este metodo
aproximado, los argumentos requeridos y la adecuada interpretacion de los resultados; adem
as
es necesario tener una experiencia amplia en cuanto al uso del programa. Es necesario tambien
comprender los fundamentos de programacion orientado a objetos, estando en este nivel es posible
interactuar con Sap2000 creando aplicaciones externas.
La Interfaz de Programaci
on para Aplicaciones de Sap2000 se puede utilizar desde cualquier lenguaje de programaci
on que sea capaz de implementar una interfaz, entre estos lenguajes de programacion se tiene: Visual Basic para Aplicaciones (VBA), Visual Basic .net, Visual C++, Visual C#, Java,
Intel Visual Fortran v9, etc. En el presente trabajo se programara desde el lenguaje de programaci
on
Visual C# por ser un lenguaje orientado a objetos y estar completamente integrado con la plataforma
.NET

2.

Resumen

En el presente trabajo se aprovecha la Interfaz de Programaci

on para Aplicaciones de Sap2000
v14.0.0 Trial Edition creando una extensi
on desde el lenguaje de programacion Visual C#, juntamente
con el entorno de desarrollo integrado Microsoft Visual Studio 2008 Express Edition con la finalidad
de automatizar los procedimientos en la creacion del modelo, el analisis y dise
no de reservorios
circulares de concreto armado.
Para esta estructura tpica el usuario final solamente definira los argumentos generales de la
estructura: dimensiones, cargas, calidad del material, propiedades del suelo y las consideraciones para
generar la funci
on de la aceleraci
on pseudo espectral para tanques ademas de definir la discretizaci
on
para el analisis mediante el metodo de los elementos finitos; luego, la extension sera el encargado
de modelar la estructura: estableciendo los materiales utilizados, los elementos estructurales(la
c
upula, viga circular si se considera, cilindro, y la base), los tipos de cargas, los tipos de an
alisis,
las combinaciones de cargas y las consideraciones en la masa de la estructura para el an
alisis
dinamico, las condiciones de contorno, asignacion de las cargas, etc. Todo sin intervencion del usuario,
los resultados deben ser consultados en el mismo entorno de Sap2000 que la extension crear
a y
ejecutara autom
aticamente, se considera el efecto hidrodinamico en el reservorio, las recomendaciones
del Reglamento Nacional de Edificaciones [1] y de la American Concrete Institute (A.C.I 350.3-01 y

A.C.I350.3R-01) [2].
Es necesario para que la extensi
on creada DARC(Extensi
on para la creaci
on del modelo, An
alisis
y Dise
no Automatizado de Reservorios Circulares en Sap2000 ) funcione sin inconvenientes debe estar
instalado el NET Framework 3.5 en la computadora donde se ejecutara.

3.

Objetivos
Crear una extensi
on para Sap2000 con la finalidad de automatizar los procedimientos de la
creacion del modelo, an
alisis y dise
no de reservorios circulares de concreto armado.
Mostrar la utilidad de la Interfaz de Programaci
on para Aplicaciones (Application Programming
Interface A.P.I) de Sap2000 creando una aplicacion concreta.
Aprovechar las ventajas de los lenguajes de programacion orientado a objetos en la creaci
on de
aplicaciones para la ingeniera.

4.

Metodologa o Desarrollo

Para el desarrollo de la extensi

on se utiliza el editor Microsoft Visual Studio 2008 Express Edition,
con el lenguaje de programaci
on Visual C#, desde la cual se integra la Interfaz de Programaci
on para
Aplicaciones de Sap2000. Desde este punto, con las ordenes adecuadas, todos los metodos que soporte
la interfaz del programa Sap2000 est
an libres para Visual C# a disposicion para ser utilizados como
si de sus propias
ordenes se tratase. La documentacion completa con ejemplos para cada orden se
encuentra en su manual SAP2000 API Documentation [3].

4.1.

Visual Studio

Lo que Microsoft nos ofrece con Visual Studio 2008 Express Edition es un entorno de desarrollo
de u
ltima generaci
on, conjuntamente con el compilador de uno de los lenguajes de programacion m
as
avanzados que existe en la actualidad, Visual C#. Las versiones express son de distribucion gratuita.
El desarrollo del programa se realiza desde este editor.

4.2.

Visual C#

Es un lenguaje moderno, potente, flexible y orientado a objetos. C# combina las mejores ideas de
lenguajes como C, C++ y Java [4] . En Visual C# es necesario distinguir los siguientes conceptos.
4.2.1.

Clase

Una clase es una colecci

on de c
odigo y de variables, las clases gestionan el estado en forma de
variables que contienen, y comportamientos, en forma de los metodos que contienen. Sin embargo una
clase es solo una plantilla desde donde se crean objetos.
4.2.2.

Objeto

Visual C# es un lenguaje orientado a objetos, los objetos son instancias de una clase.
4.2.3.

Interfaz

Una interfaz de C# es un conjunto de firmas de metodos, propiedades, eventos o indizadores

agrupadas con un nombre com
un. Las interfaces funcionan como conjunto de funcionalidades definidas
que pueden implementarse en una clase o estructura de Visual C#.

Figura 1: Sub men

u Agregar Referencia
4.2.4.

Espacio de Nombre

Sirven de ayuda para organizar colecciones de clases en agrupaciones logicas.

4.3.

Sap2000 v14.0.0

Programa general para crear el modelo, el analisis y dise

no de estructuras.
4.3.1.

Interfaz de Programaci
on para Aplicaciones de Sap2000

Sap2000 utiliza la tecnologa COM de Microsoft para obtener un Software con arquitectura abierta
y programable por el ingeniero. Se ha definido lo que es una interfaz en la seccion 4.2.3.
4.3.2.

Instalaci
on API Sap2000

La Interfaz de Programaci
on para Aplicaciones de Sap2000 se instala por defecto con cualquier
distribucion desde su versi
on 11.0.0.
4.3.3.

Utilidad para qu
e sirve?

Ahora es posible ampliar las capacidades de Sap2000 mediante programas creados por sus usuarios,
definiendo estructuras parametrizadas o repetitivas, generando una norma de dise
no especfica, etc.
Las posibilidades son ilimitadas.

4.4.

Programando en Visual C# con API Sap2000

Seguidamente se realiza una descripcion general para integrar la Interfaz de Programaci

on para
Aplicaciones de Sap2000 en el entorno de desarrollo integrado Microsoft Visual Studio, especficamente
programando en el lenguaje Visual C#, para lo cual es necesario crear una aplicaci
on windows.
4.4.1.

Integrar API Sap2000 a Visual Studio

Desde la ventana Explorador de Soluciones, haciendo click derecho sobre el proyecto creado, elegir
del men
u emergente Agregar referencia... como muestra la Figura 1. Luego, se muestra la ventana
Agregar referencia, entre las opciones elegir la pesta
na etiquetada COM, entre los muchos componentes
existentes en la lista elija Sap2000 como indica la Figura 2.

Figura 2: Ventana Agregar Referencia

Agregando esta referencia, se le indica a Microsoft Visual C# que queremos trabajar con la Interfaz Sap2000.SapObject, en este punto Microsoft Visual Studio 2008 Express Edition se encargar
a de
integrar absolutamente todos su contenido de la Interfaz Sap2000.SapObject.
4.4.2.

Implementar Interfaz de Sap2000 en un Objeto

Para utilizar las

ordenes que contiene la interfaz se opta por implementarlo en un objeto desde el
lenguaje de programaci
on Microsoft Visual C#, desde este punto es visible los metodos de la interfaz
a traves del objeto. El siguiente programa muestra la manera de implementar la interfaz de Sap2000
en un objeto de Visual C#.
1
2
3
4

// Implementa l a i n t e r f a z de Sap2000 a un o b j e t o
Sap2000 . SapObject SapObjeto ;
// i n i c i a l i z a e l o b j e t o
SapObjeto = new Sap2000 . SapObject ( ) ;

4.4.3.

Accediendo al objeto que implementa la interfaz

El objeto que contendr

a la interfaz se debe declarar de modo que sea visible en todo el proyecto,
mediante codigo deberemos referirnos a este objeto para todos los propositos. Creado el objeto que
contiene la aplicaci
on, el siguiente paso es proporcionarle un archivo Sap2000 correspondiente, puede
ser inicializando un nuevo archivo o apoderandose de uno existente. Se tratara ambas alternativas.
4.4.4.

Inicializando un archivo nuevo

Es posible desde Visual C# inicializar el programa Sap2000, el siguiente programa inicializa un

nuevo entorno en Sap2000 y dibuja un muro en su espacio modelo, asignando propiedades por defecto.
1
2
3
4
5
6
7
8
9
10
11

private void cmdOpenSap2000 Click ( object s e n d e r , EventArgs e )

{
// d e c l a r a v a r i a b l e t i p o Sap2000
Sap2000 . SapObject SapObjeto ;
long r e t ;
// i n i c i a l i z a r l a v a r i a b l e d e l t i p o Sap2000
SapObjeto = new Sap2000 . SapObject ( ) ;
// i n i c i a l i z a l a a p l i c a c i o
n
SapObjeto . A p p l i c a t i o n S t a r t ( Sap2000 . e U n i t s . kgf m C , true , Prueba ) ;
// c r e a e i n i c i a l i z a e l e s p a c i o modelo de sap2000
r e t = SapObjeto . SapModel . I n i t i a l i z e N e w M o d e l ( Sap2000 . e U n i t s . kgf m C ) ;

// d i b u j a una muro
r e t = SapObjeto . SapModel . F i l e . NewWall ( 3 , 3 , 3 , 3 , true , prueba ) ;

12
13
14

4.4.5.

Apoderarse de un Archivo Existente

Otra alternativa muy frecuente es cuando mediante codigo se quiere apoderar de un modelo
Sap2000 existente y que este en ejecuci
on, a modo de prueba, el programa culmina mostrando un
mensaje del tipo de unidades actual utilizado.
1
2
3
4
5
6
7
8
9
10
11
12

private void cmdCaptureSap2000 Click ( object s e n d e r , EventArgs e )

{
// debe e x i s t i r un a r c h i v o sap2000 e j e c u t a
ndose actualmente
Sap2000 . SapObject SapObjeto ;
// e s t a a c c i o
n s e apodera autom
a ticamente de un a r c h i v o e x i s t e n t e
SapObjeto = new Sap2000 . SapObject ( ) ;
// muestra l a s u n i d a d e s de medida a c t u a l d e l e s p a c i o modelo
Sap2000 . e U n i t s MyUnits ;
MyUnits = SapObjeto . SapModel . G e t P r e s e n t U n i t s ( ) ;
s t r i n g a = La unidad de medida a c t u a l e s : + MyUnits . T o S t r i n g ( ) ;
MessageBox . Show ( a , APISap2000 , MessageBoxButtons .OK) ;
}

4.4.6.

Cerrando la Aplicaci
on

Otro procedimiento habitual cuando se manipula programas desde aplicaciones externas, es cerrar el programa mediante c
odigo, para el objeto del tipo Sap2000 la forma correcta de terminar la
aplicacion es con las
ordenes adecuadas como se muestra.
1
2
3
4
5
6
7
8
9
10
11

private void c m d C l o s e s a p 2 0 0 0 C l i c k ( object s e n d e r , EventArgs e )

{
// debe e x i s t i r un a r c h i v o sap2000 en e j e c u c i o
n
Sap2000 . SapObject SapObjeto = new Sap2000 . SapObject ( ) ;
// c i e r r a l a a p l i c a c i
on
SapObjeto . A p p l i c a t i o n E x i t ( f a l s e ) ;
// d e j a s i n c o n t e n i d o a l e s p a c i o modelo
SapObjeto . SapModel = null ;
// d e j a s i n c o n t e n i d o a l o b j e t o c r e a d o
SapObjeto = null ;
}

4.4.7.

La Funci
on M
agica

Finalmente, el programa debe ser capaz de decidir adecuadamente una u otra alternativa, seg
un
sea el caso, el programa siguiente cumple esta funcion.
1
2
3
4
5
6
7
8
9
10
11
12

private void cmdEvaluarSap2000 Click ( object s e n d e r , EventArgs e )

{
Sap2000 . SapObject SapObjeto = new Sap2000 . SapObject ( ) ;
bool D i a n o s t i c o ;
s t r i n g mensaje ;
D i a n o s t i c o = SapObjeto . v i s i b l e ( ) ;
i f ( Dianostico )
mensaje = No s e e j e c u t a Sap2000 ;
else
mensaje = Se e j e c u t a Sap2000 ;
MessageBox . Show ( mensaje , API Sap2000 , MessageBoxButtons .OK) ;
}

4.5.

Descripci
on del Programa DARC

DARC(Extensi
on para la creaci
on del Modelo, Analisis y Dise
no Automatizado de Reservorios
Circulares en Sap2000) es una extensi
on para Sap2000 v14.0.0, escrito en el lenguaje de programaci
on
Visual C# integrado con la API Sap2000 desde el Microsoft Visual Estudio. Realizar una descripci
on
completa de la programaci
on y el c
odigo fuente de la aplicacion no esta al alcance del presente documento, la utilidad de la extensi
on se explicara con un ejemplo de aplicacion. la seccion transversal y
dimensiones generales de un reservorio circular tpico muestra la Figura 3.
CUPULA

1.5

VIGA CIRCULAR
6.2
CILINDRO
0.5

VOLADO
BASE

8.5
16.5

Figura 3: Secci
on transversal reservorio circular
Cuando se inicia DARC muestra la ventana principal de la Figura 4, dispone de una interface para
el usuario amigable e intuitiva, conteniendo campos suficientes para la recepcion de los argumentos
generales de la estructura que est
an debidamente ordenados en 03 pesta
nas.

Figura 4: Ventana principal de la extension

4.5.1.

Geometra del Reservorio

En la ventana principal, la pesta

na etiquetada con General es para especificar las dimensiones
generales del reservorio, donde:
Se debe especificar la flecha y espesor de la c
upula. para la estructura mostrada en la Figura 3
la flecha es 1.5m y el espesor 0.1m
Las consideraciones de la viga circular en la estructura es opcional, se debe especificar la base y
la altura de la viga circular. Para la estructura mostrada la base es 0.30m y altura 0.6m
La altura y el espesor del cilindro, indicar de igual manera el borde libre considerado en el
cilindro. En la estructura actual el espesor es 0.15m, altura total considerando la altura de la
viga circular es 6.20m y el borde libre 1.0m
Las dimensiones de la base como se indica en la Figura 3. Diametro interior 8.5m con un espesor
de 0.25m, el di
ametro total exterior 16.5m con un espesor de 0.5m y la longitud del volado 0.5m
4.5.2.

Divisi
on de los Elementos Estructurales

La pesta
na etiquetada con Division(FEM) de la ventana principal mostrada en la Figura 3 es
para establecer la discretizaci
on de la estructura para su posterior analisis mediante el Metodo de los
Elementos Finitos, se debe especificar:
1. Direccion angular(general): donde se debe especificar el n
umero de divisiones en la direcci
on
angular para toda la estructura, por defecto esta establecido en 36 divisiones, en este caso se
realiza una divisi
on cada 10o sexagesimales.
2. Direccion radial(c
upula): para establecer el n
umero de divisiones en la direccion radial, del radio
de la c
upula. por defecto considera 12 divisiones.
3. Direccion axial(cilindro): establece el n
umero de divisiones en la direccion axial del cilindro. Por
defecto est
a considerado 8 divisiones.
4. Direccion radial(base): establece el n
umero de divisiones en la direccion radial del radio de la
base, que coincide con el radio del cilindro. Por defecto esta considerado 12 divisiones.
5. Direccion radial(volado): para especificar el n
umero de divisiones en la direccion radial del volado.
Por defecto est
a considerado 2 divisiones.
Es necesario que el n
umero de divisiones establecidos en cualquier direccion debe ser como mnimo
igual a dos.
4.5.3.

Propiedades y Cargas

La pesta
na etiquetada con Propiedades y cargas de la ventana principal mostrada en la Figura 3
es para establecer:
Sobrecarga en la c
upula.
Altura enterrada del reservorio, esta caracterstica es opcional pudiendo activarse o desactivar
desde el menu Herramientas, por defecto se considera un altura enterrada de 5.0m y el peso
especfico del suelo 1800 kgf
m3
El modulo de balastro del suelo, que se asigna a los elementos estructurales que forman la base,
kgf
por defecto es 2030.25 cm
3
la resistencia a la compresi
on del concreto.
Finalmente, los par
ametros para generar la funcion de la aceleracion pseudo espectral para
tanques.
7

4.5.4.

Ejecuci
on de la Extensi
on

El programa verifica en lo posible los argumentos establecidos por el usuario, mostrando informacion necesaria convenientemente, a
un as, los datos generales deben ser coherentes con los de una
estructura real. Luego de establecer los argumentos generales, desde el men
u Herramientas elegir el
sub men
u Analizar en Sap2000 como muestra la Figura 5.

Figura 5: Ventana principal, men

u herramientas
La extension por defecto inicializa un reservorio apoyado y sin considerar la viga circular en la
union de la c
upula y el cilindro, si se desea considerar la viga circular en la estructura y/o considerar
como un reservorio enterrado se deben activar las opciones desde el men
u Herramientas como se
muestra en la Figura 5. Para cerrar Sap2000 elegir desde el men
u Herramientas el sub men
u Cerrar
Sap2000 y para abandonar el programa elegir el sub men
u Salir. Si todos los argumentos establecidos
son adecuados el DARC inicia con el dise
no de la estructura en Sap2000, para este fin realiza los
siguientes procedimientos:
Realiza los c
alculos necesarios para modelar el efecto hidrodinamico sobre el reservorio.
Inicializa Sap2000 v14.0.0 como un archivo nuevo, estableciendo su espacio modelo como un
archivo en blanco.
Define las propiedades de los materiales utilizados para dise
nar la estructura: el concreto y el
acero de refuerzo.
Define los elementos estructurales; la c
upula es considerado como un elemento shell(c
ascara)
en su formulaci
on como membrana, la viga circular es considerado como un elemento cascara
gruesa, igualmente el cilindro del reservorio y las bases y volado que forman la fundacion de la
estructura.
Define los enlaces nodales para modelar el efecto de la masa convectiva (efecto hidrodinamico)
sobre la estructura.
Define los patrones nodales para generar las cargas por presion del lquido y el empuje lateral
ocasionado por el suelo.
Genera la funci
on de la aceleraci
on pseudo espectral para tanques [5]. El nombre de la funci
on
con que es exportado es ZICS.
Define los casos de carga: la carga por peso propio(CM), sobrecarga (CV), carga por presion del
lquido(CL), carga por presi
on del empuje lateral del suelo(CE).
Define los casos de an
alisis: se a
nade a los ya existentes e analisis modal y analisis por respuesta
espectral; todos los an
alisis se definen en el rango lineal.
...
Finalmente, prepara el modelo para el analisis, los grados de libertad y ordena a Sap2000 que
inicie con el an
alisis y dise
no de la estructura entera.
8

5.

Resultados

Todos los resultados (desplazamientos, reacciones en los apoyos, esfuerzos, fuerzas u

ltimas de dise
no, los refuerzos) ser
an consultados en el mismo entorno de Sap2000 de manera habitual, dado que el
programa solamente automatiza los procedimientos habituales para crear el modelo, analisis y dise
no
de la estructura tpica. El reservorio circular es analizado completamente en un solo modelo: la c
upula,
la viga circular, el cilindro y la base de fundacion. La Figura 6 muestra el modelo generado por la
extension sin intervenci
on del usuario y la Figura 7 muestra los esfuerzos en el cilindro, la c
upula y la
base.

Figura 6: Modelo del reservorio generado por DARC

Figura 7: Esfuerzos en el cilindro, c

upula y la base
Para obtener los aceros de refuerzo solamente se debe consultar a Sap2000, la extension configura
las opciones de dise
no para los elementos estructurales, en la Figura 8 muestra los refuerzos ocasionados
9

por la presion est

atica del lquido, refuerzos en la direccion circunferencial y axial(correspondiente a
la direccion 1 y 2 de la orientaci
on local para cada elemento finito que conforma el cilindro y la viga
circular).

Figura 8: Refuerzos en el cilindro y la viga circular

6.

Conclusiones
En el presente trabajo se logra crear una extension para Sap2000, que automatiza los procedimientos en la creaci
on del modelo, analisis y dise
no de una estructura tpica.
Gracias a la extensi
on se logra analizar la estructura entera para distintas discretizaciones del
dominio completo con facilidad, lo que permite evaluar la convergencia de los resultados.
La Interfaz de Programaci
on para Aplicaciones de Sap2000 se puede utilizar desde cualquier
lenguaje de programaci
on que sea capaz de implementar una interfaz.

Bibliografa
[1] Institulo de la Construcci
on y Gerencia. Reglamento nacional de edificaciones. 2006.
[2] American Concrete institute. Seismic desing of liquid containing concrete structures. Reported by
ACI Comittee 350.
[3] Computers and Inc Structures. Sap2000 API Documentation, 2008.
[4] Jason Beres Pierre Boutquin y Meeta gupta Jeff ferguson, Brian Patterson. La biblia de c#. Anaya
Multimedia, 2003.
[5] Ing. Julian Meja Z
un
iga Mag. Ing. Jose Acero Martnez. Analisis dinamico de reservorios, superficiales, circulares y rectangulares. Congreso Nacional de Ingeniera Civil, Libro de Ponencias,
Ayacucho 2005.

10