STAPLE - STAAD-III Ambiente del Lenguaje de

Aplicacin de Programacin
Esta seccin est diseada para proporcionar una visin general de
la funcionalidad de STAPLE. ste consta de un grupo de comandos
basados en el lenguaje ingls que pueden ser usados para crear un
archivo script. El archivo script es un archivo de texto que puede
ser creado utilizando cualquier editor de texto. El ambiente
STAAD-III proporciona un poderoso editor de texto que puede ser
usado para crear y editar archivos script.
El archivo script puede ser entonces ejecutado desde el ambiente
STAAD-III para accesar y extraer informacin necesaria de la base
de datos de la ejecucin despus de que un anlisis es realizado. La
informacin extrada puede ser posteriormente procesada por el
archivo script para:
Ejecutar el programa del usuario.
Realizar operaciones de ordenar/buscar
Crear una salida de acuerdo a sus necesidades utilizando
formatos del usuario
Crear interfases hacia otro software.
Realizar cualquier otra operacin de post-proceso.
Ejecucin de archivos script
Los archivos script pueden ser ejecutados dentro del ambiente
STAAD-III como sigue.
Como un archivo independiente.
Como parte de un archivo de entrada de STAAD-III.
Como parte del archivo de entrada STAAD-III utilizando el
enunciado CALL para llamar un archivo externo script.
Seccin Seccin
10 10
Todas las salidas del archivo script pueden ser visualizadas,
mostradas en pantalla, ploteadas e impresas utilizando las opciones
del ambiente STAAD-III. Si el archivo script es parte de un
archivo de entrada, entonces la salida es integrada con la salida de
STAAD-III.
Para ejecutar un archivo script desde una versin STAAD-III
(DOS), utilice el botn SCRIPT de la pantalla principal. Consulte
las figuras siguientes para mayores detalles.
Press This Button to
invoke script
Para ejecutar un archivo script desde STAAD-III para Windows,
utilice la funcin apropiada del men FILE. Consulte las siguientes
figuras por detalles.
Script file commands
Ejemplo de salida de archivo script.
Esta seccin de la documentacin describe en detalle los comandos
e instrucciones de STAPLE. El usuario utiliza un formato de
lenguaje de comandos para comunicar comandos al programa.
Estos comandos son utilizados para:
Iniciar y terminar un segmento de comandos de STAPLE para
crear el archivo script.
Abrir un archivo externo especificado por el usuario.
Accesar informacin relevante estructural guardada dentro del
archivo de base de datos(archivo .DBS) de STAAD-III
Escribir datos relevantes en un formato requerido al archivo
externo.
Ejecutar programas externos.
Crear salidas grficas.
El formato de lenguaje de comandos y las convenciones son
descritas en la seccin 3.1. Esto es seguido en la seccin 3.2, con
descripciones detalladas de los comandos disponibles.
Note que los archivos script pueden ser llamados desde el ambiente
STAAD-III. La salida generada puede ser visualizada, ploteada o
impresa utilizando las opciones del ambiente de STAAD-III.
10.1 Convenciones del Lenguaje de Comandos
STAPLE
Esta seccin describe los elementos y convenciones del lenguaje de
comandos STAPLE. Primero se discuten los elementos del lenguaje
y despus se describe en detalle el formato del lenguaje de
comandos.
10.1.1 Elementos de los Comandos
a) Nmeros Enteros: Nmeros enteros son nmeros escritos sin
punto decimal. Estos nmeros son designados como i
1
, i
2
, etc.,
y no deben contener punto decimal. Los Signos (+ o -) son
permitidos al frente de estos nmeros. Si el signo es omitido,
se asume que es positivo (+).
b) Nmeros de Punto Flotante: Estos son nmeros reales que
pueden contener una porcin decimal. Estos nmeros son
designados como f
1
, f
2
, etc. Los Valores pueden tener un punto
decimal y/o un exponente.
Ejemplo
5055.32 0.73 -8.9 732
5E3 -3.4E-6
Cuando el signo es omitido, se asume que es positivo (+).
Tambin note que el punto decimal puede ser omitido, si la
porcin decimal del nmero es cero.
c) Alfanumricos: Estos son caracteres que son usados para
construir los nombres de los datos, ttulos o comandos. No se
necesitan comillas para encerrarlos a menos que se especifique
lo contrario.
d) Datos Repetitivos: Datos numricos repetitivos pueden ser
proporcionados utilizando el siguiente formato:
n * f
donde n = nmero de veces que los datos tienen que ser
repetidos
f = datos numricos, ya sea enteros o de punto
flotante
10.1.2 Formatos de los Comandos
a) Entrada de formato libre: Todos los comandos de STAPLE
estn en un estilo de formato libre. Los elementos de datos de
entrada deben estar separados por espacios o por comas de los
otros elementos de entrada. Nunca se necesitan comillas para
separar ninguna palabra alfabtica como datos, comandos o
ttulos.
b) Comentarios de Entrada: Para documentar un archivo script
de STAPLE, la opcin para hacer comentarios est disponible.
Los comentarios pueden ser incluidos al dar un asterisco (*)
como el primer caracter no vaco de cualquier lnea. La lnea
con el comando es mandada al archivo de salida pero no es
procesada por el programa.
Ejemplo
FOR LOAD 1 3
* FOLLOWING CALCULATIONS FOR LOAD 1 AND 3
WRITE REACT FY MZ
c) El Significado del Subrayado en el Manual: Los Formatos
exactos de los comandos se describen en las siguientes
secciones. Muchas palabras en los comandos y en los datos
pueden ser abreviadas. La palabra completa se da en la
descripcin del comandos, con la parte realmente requerida (la
abreviacin) subrayada.
Por ejemplo, si la palabra MEMBER es usada en un comando,
solamente la porcin MEMB necesita ser especificada. Es claro
para otros que lean la salida si toda la palabra es utilizada,
pero un usuario experimentado puede desear utilizar las
abreviaturas.
d) El significado de Corchetes y Parntesis: En algunos
formatos de comandos hay corchetes que encierran un nmero
de alternativas, que son distribuidas verticalmente. Una y solo
una de estas alternativas puede ser seleccionada. Sin embargo,
varias de las alternativas listadas pueden ser seleccionadas si
un asterisco (*) es localizado fuera de los corchetes.
Ejemplo
XY
YZ

XZ

En ejemplo anterior, el usuario debe hacer una decisin entre
XY o YZ o XZ.
Ejemplo
* FX
FY

FZ

Aqu el usuario puede escoger uno, dos o todos los de la lista
(FX, FY y FZ) en cualquier orden. Los Parntesis ( ), que
encierran una porcin de un comando indican que la parte
encerrada es opcional. La presencia o ausencia de esta parte
afecta el significado del comando, tal como es explicado en la
descripcin del comando en particular.
Ejemplo
WRITE FORCE (MEMBER) type - list
En la lnea anterior, la palabra MEMBER es opcional. Ningn
nmero de miembro ser escrito si esta palabra no es usada.
e) Separador de Datos Mltiples: Datos mltiples pueden ser
proporcionados en una sola lnea si estn separados por un
punto y coma (;). Una restriccin estriba en que comandos
consecutivos no pueden ser separados por un punto y coma.
Deben aparecer en lneas separadas.
f) Lista de Datos: En algunas descripciones de comandos
STAPLE, la palabra "list" es utilizada para identificar una lista
de nodos, miembros/elementos o casos de carga. El formato de
una lista puede ser definida como sigue:
* i
1
, i
2
, i
3
.......
list = i
1
TO i
2
(BY i
3
)

X or Y or Z

La palabra TO significa todos los enteros desde el primero (i
1
)
hasta e inclusive el segundo (i
2
). La expresin BY y el nmero
que le sigue (i
3
) significa que los nmeros de miembros tienen
que ser generados desde i
1
hasta i
2
en incrementos de i
3
i.e., i
1
,
i
1
+i
3
, i
1
+2*i
3
, i
1
+3*i
3
, etc. hasta pero sin exceder i
2
. Si BY i
3
se
omite, el incremento ser definido como uno. En algunas
ocasiones la lista puede ser muy larga para caber en una lnea,
en cuyo caso la lista puede ser continuada en la siguiente lnea
escribiendo un guin precedido por un espacio en blanco.
Tambin note que una lista puede solamente ser continuada y
no cualquier otro tipo de datos.
Ejemplo
FOR MEMB 10 17 23 -
25 TO 28
es lo mismo que:
FOR MEMB 10 17 23 25 TO 28
Error Posible:
FOR MEMB -
10 17 23 25 TO 28
En el ejemplo anterior, la marca de continuacin para
elementos de listas es utilizado cuando los elementos de la lista
no continuarn. La marca de continuacin es colocada en una
posicin incorrecta. Debe ser colocada despus del nmero 10.
El ejemplo siguiente muestra otro error posible . El guin debe
aparecer antes del nmero 25.
Error Posible:
Ejemplo
FOR MEMB 10 17 23 25 TO -
28
10.2 Comandos STAPLE
10.2.1 Inicio de STAPLE
Objetivo
Este comando se usa para iniciar un grupo de comandos de
STAPLE. Todos los archivos script de STAPLE deben empezar con
este comando.
Formato General:
START SCRIPT LANGUAGE
Descripcin
Los comandos STAPLE son llamados utilizando el comando
START SCRIPT. Este comando es tpicamente seguido por otros
comandos STAPLE. Finalmente, el script STAPLE se termina con
el comando END SCRIPT. Los archivos script de STAPLE pueden
ser independientes o parte de un archivo de entrada de STAAD-III.
Note que el archivo script de STAPLE puede ser colocado en
cualquier parte del archivo de entrada de STAAD-III. Sin embargo,
si el archivo script es colocado antes del comando PERFORM
ANALYSIS, entonces los resultados del anlisis puede no estar
disponibles para un proceso posterior. Similarmente, si el archivo
script de STAPLE est siendo utilizado independientemente, el
anlisis de STAAD-III debe ser realizado antes de utilizar el
archivo script para post-proceso.
10.2.2 Especificacin UNIT
Objetivo
Este comando permite al usuario especificar o cambiar las unidades
de longitud o fuerza para la salida o entrada.
Formato General:
* length-unit
UNIT

force-unit

INCHES
FEET or FT
CM
length-unit = METER
MMS
DME

KM

KIP
POUND
KG
force-unit = MTON
NEWTON
KNS
MNS

DNS

Note:
DME denota Decametros. MNS denota mega Newtons y DNS
denota decaNewtons. Las unidades restantes se explican por
s mismas.
Descripcin
El comando UNIT puede ser especificado cualquier nmero de
veces en el archivo script. Se asume que todos los datos estn
conforme a la ultima especificacin de unidades anterior a ellos.
Tambin note que la unidad de entrada para ngulos es siempre
grados. Sin embargo, la unidad de salida para rotacin de nodos
(en desplazamiento de nodos ) es radianes. Para toda salida, las
unidades son claramente especificadas por el programa.
Ejemplo
UNIT KIP FT
FOR MEMB 1 TO 3
.
.
Ejemplo
UNIT CM KN
FOR JOINT 10 15
WRITE COORD JOINT
.
.
Ejemplo
UNIT CM KIP
FOR MEMB 15 25
.
.
Notas
Note que se permite mezclar y comparar entre sistemas de unidades
diferentes (Imperial, Mtrico, SI etc.).
10.2.3 El comando OPEN
Objetivo
Este comando es utilizado para crear un archivo externo a travs
del lenguaje script STAPLE. El archivo externo creado puede
contener datos estructurales relevantes en un formato definido
por el usuario.
servir como un archivo de entrada para un programa externo.
Formato General
OPEN FILE file-name
donde,
file-name = nombre del archivo que necesita ser creado
especificado por el usuario.
Descripcin
Este comando necesita ser usado cada vez que un archivo externo
es creado usando el lenguaje script STAPLE. Tpicamente, este
comando es seguido por los comandos FOR, WRITE, FORMAT y
SORT que son utilizados para escribir los datos relevantes al
archivo en un formato requerido.
10.2.4 El Comando FOR
Objetivo
El comando FOR es utilizado para especificar elementos (nodos,
miembros, apoyos, cargas) para los que los datos estructurales son
requeridos. Este comando trabaja en conjunto con el comando
CLOSE para crear un ciclo.
Formato General
JOINT
FOR MEMBER item-list
SUPPORT

LOAD

.
..
CLOSE
donde,
item-list = lista de los elementos relevantes para los cuales
informacin es requerida.
Descripcin
Con el comando FOR, el usuario puede especificar un elemento en
particular (nodo, miembro, apoyo, carga) para el cual la
informacin es requerida. La item-list asociada le permite al
usuario especificar una lista numrica para el elemento en
particular.
Note que comandos FOR sucesivos pueden ser usados para
especificar ms de un elemento. Por ejemplo, si se requieren
desplazamiento de nodos para un cierto nmero de casos de carga,
dos comandos FOR sucesivos, uno para nodos y el otro para cargas
pueden ser usados.
El ciclo FOR-CLOSE contiene tpicamente comandos SORT y/o
WRITE para accesar y escribir datos al archivo externo. Las
descripciones para estos comandos estn disponibles en las
secciones siguientes.
Cada ciclo FOR-CLOSE debe ser cerrado por un comando CLOSE.
Note que un comando CLOSE puede ser usado para cerrar
comandos FOR mltiples.
Ejemplo
FOR SUPPORT 1 2
FOR LOAD 1 3
WRITE REACT FX FY MZ
FORMAT = REACTION, 3F10.2
CLOSE
El ejemplo anterior ilustra el uso del ciclo FOR-CLOSE. El
segmento script sencillo esta diseado para extraer reacciones de
apoyos FX, FY y MZ en apoyos 1 y 2 para casos de carga 1 y 3.
FX, FY y MZ denotan las fuerzas de reaccin en las direcciones
globales X y Y y el momento de reaccin respecto al eje global Z,
respectivamente. Para detalles en el uso de las especificaciones
WRITE y FORMAT, consulte las ltimas secciones de esta
documentacin. Note que el ciclo FOR-CLOSE es cerrado por
medio de un comando CLOSE.
10.2.5 Los Comandos WRITE y FORMAT
Objetivo
Estos comandos son utilizados para escribir datos estructurales
especificados por el usuario(desplazamientos, fuerzas, propiedades,
reacciones, etc.,) para elementos especificados (nodos, miembros,
cargas, apoyos) en un archivo externo que es abierto (ver detalles
del comando OPEN en la seccin 3.2.3) para ese objetivo. El
comando WRITE es inmediatamente seguido por un comando
FORMAT que especifica el formato de la escritura de datos. Estos
comandos son explicados en las siguientes sub-secciones.
10.2.5.1 Comandos WRITE
Escritura de Encabezados
WRITE HEADER
FORMAT=<header>
donde <header> = texto que aparecer como encabezado
Descripcin
Un encabezado es un ttulo que permite la identificacin de datos
que ser guardado en el archivo de datos para ese objetivo. Por
ejemplo, digamos que deseamos escribir las reacciones en apoyos
debidas al caso de carga asociado con la carga debida a viento.
Ejemplo
WRITE HEADER
FORMAT=Support Reactions due to Wind Loading
Escritura de Coordenadas de Nodos
WRITE COORD (JOINT )
FORMAT=<list>*
En la sintaxis anterior, la palabra COORD significa coordenadas de
nodos. Si la palabra JOINT, es proporcionada (es opcional),
instruir a STAAD-III a escribir el nmero de nodos para los
cuales los valores estn siendo escritos. Todas las tres coordenadas
(X, Y, y Z) sern escritas.
* Ver la seccin 3.2.5.2 para obtener informacin acerca de la
especificacin list del comando FORMAT.
Ejemplo
WRITE COORD JOINT
FORMAT=I4, 3F10.2
Escritura de Incidencias de Miembros
WRITE MINC (MEMB )
FORMAT=<list>*
En la sintaxis anterior, la palabra MINC significa incidencias de
miembros. La palabra MEMB, si es dada (es opcional), instruir a
STAAD-III a escribir el nmero de miembro para el los valores
estn siendo escritos.
* Ver la seccin section 3.2.5.2 para obtener informacin en la
especificacin FORMAT.
Ejemplo
WRITE MINC MEMB
FORMAT=I4, 2X, I5, 2X, I5
Escritura de Propiedades de Miembros
WRITE PROP (MEMB) (NAME) type-list
FORMAT=<list>*
* AX
AY
AZ
IX
IY
type-list = IZ
SZ
SY
B
D
TF
TW
En la sintaxis anterior, la palabra PROP significa propiedades de
miembros. La palabra MEMB, si es proporcionada (es opcional),
instruir a STAAD-III a escribir el nmero de miembro para el cual
los valores estn siendo escritos. La palabra NAME significa la
designacin de la propiedad de ese miembro. (W12X26, L20204
son ejemplos de names.) Los elementos en la type-list son:
AX = rea de la seccin transversal
AY = rea Cortante en el eje local Y
AZ = rea Cortante en el eje local Z
IX = Constante Torsional
IY = Momento de Inercia con respecto al eje local Y
IZ = Momento de Inercia con respecto al eje local Z
SZ = Mdulo de la Seccin con respecto al eje Z
SY = Mdulo de la Seccin con respecto al eje local Y
B = Ancho del patn, o ancho de la seccin transversal
rectangular (Dimensin paralela al eje local Z)
D = Peralte de la seccin transversal, o peralte de la seccin
transversal rectangular (Dimensin paralela al eje local Y)
TF = Espesor del Patn
TW = Espesor del Alma
* Ver la seccin 3.2.5.2 para obtener informacin acerca de la
especificacin FORMAT.
Ejemplo
WRITE MEMB NAME
FORMAT=I5, 2X, A16
WRITE PROP AX IZ
FORMAT=2F10.2
Escritura de Relajamientos de Miembros
WRITE RELE (MEMB)
FORMAT=<list>*
En la sintaxis anterior, la palabra RELE significa relajamiento de
miembros. Si la palabra MEMB, es proporcionada (es opcional),
instruir a STAAD-III para que escriba los nmeros de miembros
para los cuales los valores estn siendo escritos. La condicin de
relajamiento de miembros es representada en la forma de los
smbolos 0 o 1 en la salida. 0 indica un relajamiento mientras 1
indica la posicin fija de un grado de libertad. Las condiciones de
relajamiento son representadas por 6 smbolos para el inicio del
miembro y 6 para el final del miembro.
* Ver la seccin 3.2.5.2 para obtener informacin sobre la
especificacin FORMAT.
Ejemplo
WRITE RELEASE MEMB
FORMAT=I5, 2X, 12I1
Escritura de Reacciones en Apoyos y Desplazamientos
de Nodos
REACT
WRITE (JOINT) (LOAD) type-list
DISPL
FORMAT=<list>*
* FX
FY
type-list = FZ
MX
MY
MZ
Descripcin
En la sintaxis anterior, la palabra REACT significa reacciones de
apoyos y DISPL significa desplazamientos de Nodos. La palabra
JOINT, si es proporcionada (es opcional), instruir al programa
para que escriba el nmero de nodo para el cual las reacciones o
los desplazamientos de los nodos estn siendo escritos.
Similarmente, la palabra LOAD, si es proporcionada (es opcional),
instruir al programa STAAD-III para que escriba el nmero de
caso de carga para el cual las reacciones o los valores de
desplazamientos estn siendo escritos.
En la type-list mostrada anteriormente,
FX = X-translacin para DISPL, Fuerza en la direccin X para
REACT
FY = Y-translacin para DISPL, Fuerza en la direccin Y para
REACT
FZ = Z-translacin para DISPL, Fuerza en la direccin Z para
REACT
MX = Rotacin sobre el eje X para DISPL, Momento sobre eje X
para REACT
MY = Rotacin sobre el eje Y para DISPL, Momento sobre el eje
Y para REACT
MZ = Rotacin sobre el eje Z para DISPL, Momento sobre eje Z
para REACT
* Ver la seccin 3.2.5.2 para obtener informacin en la
especificacin FORMAT.
Ejemplo
WRITE REACT JOINT LOAD FY MZ
FORMAT=2I5, 2F10.2
Escritura de Fuerzas en los Extremos de Miembros
WRITE FORCE (MEMB) (LOAD) type-list
FORMAT=<list>*
* FX1
FY1
FZ1
MX1
MY1
type-list = MZ1
FX2
FY2
FZ2
MX2
MY2
MZ2
Descripcin
En la sintaxis anterior, la palabra FORCE significa fuerzas en
extremos de miembros. La palabra MEMB, si es dada, (es
opcional) instruir a STAAD-III para que escriba el nmero de
miembro para el cual los valores estn siendo escritos.
Similarmente, la palabra LOAD, si es dada (es opcional), instruir
a STAAD-III para que escriba el nmero de caso de carga para el
cual los valores estn siendo escritos.
En la type-list anterior, todas las variables que terminan en 1
representan valores de las fuerzas en los extremos de los miembros
en el primer nodo( nodo inicial) del miembro. Por ejemplo, FX1
significa la fuerza axial en el nodo inicial, MY1 significa el
momento flexionante sobre el eje Y en el punto inicial. Todas las
variables que terminan con 2 representan valores de las fuerzas
en los extremos de los miembros en el segundo nodo (nodo final)
del miembro. Por ejemplo, FY2 significa la fuerza cortante a lo
largo del eje local Y en el nodo final, MZ2 significa el momento
flexionante con respecto al eje Y en el nodo final
* Ver la seccin 3.2.5.2 para obtener informacin en la
especificacin FORMAT.
Ejemplo
WRITE FORCE MEMB LOAD FZ1 MX2
FORMAT=2I5, 2F10.2
Escritura de Fuerzas en Secciones de Miembros y
Desplazamientos de Miembros
BMO
WRITE (MEMB) (LOAD) type-list
SDI
FORMAT=<list>*
* FX
FY
type-list = FZ
MX
MY
MZ
En la sintaxis anterior, la palabra BMO significa fuerzas en
secciones de miembros. La palabra SDI significa desplazamientos
de secciones de miembros. Los valores son obtenidos para los dos
extremos mas once secciones intermedias. La palabra MEMB, si es
dada (es opcional), instruir a STAAD-III para que escriba el
nmero del elemento para el cual los valores estn siendo escritos.
Similarmente, la palabra LOAD, si es dada (es opcional), instruir
a STAAD-III para que escriba el nmero de caso de carga para el
cual los valores estn siendo escritos. En la type-list anterior, FX,
FY y FZ se refieren a la fuerza axial, cortante en Y, y cortante en Z
si el elemento que est siendo escrito BMO. Si el elemento siendo
escrito es SDI, entonces FX, FY y FZ se refiere a la translacin X,
translacin Y y translacin Z respectivamente de la seccin
especifica. Similarmente, MX, MY y MZ se refieren al momento
torsional, momento con respecto el eje local Y, y momento con
respecto el eje local Z si el elemento que est siendo escrito es
BMO. Si el elemento siendo escrito es SDI, entonces MX, MY y
MZ se refieren a la rotacin con respecto el eje local X, rotacin
con respecto el eje local Y, y rotacin con respecto al eje local Z
respectivamente de la seccin especifica.
Ejemplo
WRITE BMO MEMB LOAD FY MZ
FORMAT=2I5, 2F9.2
* See the section 3.2.5.2 for information on the FORMAT
specification.
10.2.5.2 Especificacin FORMAT
Objetivo
Define el formato en el cual los datos son escritos al archivo.
Sintaxis
FORMAT=list
donde list es la lista de Descriptores de Edicin.
Los siguientes descriptores de edicin son vlidos:
1) Descriptor de Edicin para enteros
Para la escritura de variables enteras, use la letra I seguida de
un nmero que describe el nmero de dgitos aplicable para el
valor de esa variable. Por ejemplo, para escribir el nodo
nmero 10781 (que es un entero de cinco dgitos), use la
especificacin FORMAT.
Ejemplo
FORMAT=I5
Si el descriptor de edicin del nmero entero es ms grande
que el nmero de dgitos en ese nmero, el nmero ser
impreso alineado a la derecha (espacios vacos sern colocados
a la izquierda del nmero). De manera similar, si el descriptor
de edicin es ms pequeo que el nmero de dgitos en ese
nmero, asteriscos sern impresos en vez del nmero.
2) Descriptor de Edicin para espacios vacos
Para la escritura de espacios vacos, especifique el valor de n
seguidos por la letra X. Por ejemplo, para escribir 2 espacios
vacos,
Ejemplo
FORMAT=2X
Si usted desea imprimir ms de un entero separado por
espacios vacos utilizando un solo comando format, separe los
descriptores con comas. Por ejemplo, un entero de 3 dgitos
seguido de 2 espacios vacos seguidos de 7 dgitos enteros son
escritos utilizando la especificacin FORMAT.
Ejemplo
FORMAT=I3,2X,I7
3) Descriptor de Edicin para Nmeros Decimales
Para la escritura de nmeros decimales, la letra F es usada
seguida de un nmero a seguida por un punto decimal seguido
por un nmero b. El nmero a es igual al nmero de dgitos
antes del decimal ms el nmero de dgitos antes del decimal
mas uno. El nmero b es igual al nmero de dgitos despus
del decimal. Si el nmero es uno negativo, asegrese que a es
lo suficientemente grande para contar con el signo menos
tambin. Por ejemplo, para escribir el nmero 327.86,
escribimos,
Ejemplo
FORMAT=F6.2
Para escribir el nmero -45376.483, escribimos,
Ejemplo
FORMAT=F10.3
Si el descriptor de Edicin del nmero decimal es ms grande
que el nmero de dgitos en ese nmero, el nmero ser
impreso alineado a la derecha (espacios vacos sern colocados
a la izquierda del nmero). De manera similar, si el descriptor
de Edicin es ms pequeo que el nmero de dgitos en ese
nmero, asteriscos sern impresos en vez del nmero. Si usted
desea imprimir ms de un nmero decimal separado por
espacios vacos utilizando un solo comando format, separe los
descriptores con comas. Por ejemplo, los nmeros 273.654 y -
980.1 separados por 2 espacios vacos son escritos utilizando
la especificacin FORMAT.
Ejemplo
FORMAT=F7.3,2X,F6.1
Si usted desea imprimir nmeros decimal y enteros y espacios
vacos utilizando un solo comando format, separe los
descriptores con comas. Por ejemplo, los nmeros 273.654,
400, -980.1 y 15 separados por 2 espacios vacos entre cada
nmero son escritos usando la especificacin FORMAT.
Ejemplo
FORMAT=F7.3,2X,I3,2X,F6.1,2X,I2
Si usted desea imprimir ms de un nmero decimal y/o ms de
un entero utilizando un solo comando format, use el nmero
apropiado (que representa cuanto de esos valores estn
presentes) antes de la especificacin F o I. Por ejemplo, los
nmeros 100, 120, 135, 621.4, 786.3, 809.5 pueden ser escritos
usando el siguiente formato.
Ejemplo
FORMAT=3I5,3F7.1
Note que al usar I5, estamos utilizando la habilidad del
programa para asignar 2 espacios vacos antes de tres dgitos
enteros para nuestra ventaja debido a que ahora no tenemos que
preocuparnos por especificar los espacios vacos.
Similarmente, seleccionando un formato F7.1 cuando el total
de dgitos incluyendo el punto decimal es solo 5, estamos en
posibilidades de obtener 2 espacios en blanco entre los
nmeros decimales tambin.
4) Descriptor de Edicin de Caracteres
Para la escritura de caracteres o cadenas de caracteres, utilice
la letra A seguida de un nmero de caracteres en la cadena. El
nmero de caracteres en la cadena es igual al nmero de letras
ms el nmero de espacios vacos. Por ejemplo, la palabra
SUPPORT contiene 7 caracteres. La expresin MAT
FOUNDATION contiene 14 caracteres.
Ejemplo
FORMAT=A27
10.2.6 El Comando SORT
Objetivo
El comando SORT debe ser proporcionado antes del comando
WRITE para especificar los parmetros de acuerdo a cual de los
valores deseados de salida debe ser ordenado. El comando SORT
es seguido inmediatamente por un comando WRITE que especifica
los nombres de los valores que formarn parte de la salida.
Formato General
REACTION
SORT DISPLACEMENT BY (ABS) (-)type-list

FORCE

Descripcin
A continuacin estn las explicaciones para cada especificacin
anterior y la type-list asociada con ellos.
a) BY : Las opciones REACT, DISPL o FORCE siempre tienen
que ser seguidas por esta palabra
b) ABS : Esta opcin deber ser usada si la ordenacin se har de
acuerdo a valores absolutos. Por favor vea los ejemplos
siguientes que muestran el uso de esta opcin.
c) - : Esta opcin que es un signo menos, si es colocada
inmediatamente antes del nombre de la variable (vea la type-
list siguiente para la lista de nombres de variables) significa
que la ordenacin se har basada en el orden descendente de
valores implicando que el valor ms grande (Valor absoluto
ms grande si la opcin ABS es especificada; valor algebraico
ms grande si la opcin ABS no es especificada) vendr
primero y el valor ms pequeo vendr al final. Si el signo
menos no es especificado, la ordenacin se har basndose en
el orden ascendente de valores.
d) REACTION
FX
FY
type-list = FZ
MX
MY

MZ

Ejemplo
SORT REACT BY ABS FY
El comando anterior significa que los valores de la reaccin de
apoyo FY deben ser ordenados basndose en el orden
ascendente de sus valores absolutos. El grupo de datos para la
ordenacin consiste de los valores de la reaccin de apoyos FY
de todos los nodos de soporte especificados en la lista FOR
ms reciente y los casos de carga especificados en la lista FOR
ms reciente.
Ejemplo
SORT REACT BY -MX
El comando anterior significa que los valores de reacciones en
apoyos MX deben ser ordenados basndose en el orden
descendente de sus valores algebraicos. El conjunto de datos
consiste en los valores de las reaccione en apoyos MX de todos
los nodos de apoyo especificados en la lista For ms reciente y
los casos de carga especificados en la lista FOR ms reciente.
Ejemplo
SORT REACT BY ABS -FX
El comando anterior significa que los valores de reaccin en
apoyos FX debern ser ordenados en base al orden descendente
de sus valores absolutos. El conjunto de datos para la
ordenacin consta de los valores de reaccin en apoyos FX de
todos los nodos de apoyo especificados en la lista FOR ms
reciente y los casos de carga especificados en la lista FOR ms
reciente.
e) DISPLACEMENTS (DESPLAZAMIENTOS)
FX
FY
type-list = FZ
MX
MY

MZ

Ejemplo
SORT DISPL BY ABS -FY
El comando anterior significa que los valores de la translacin
Y deben ser ordenados en base al orden descendente de sus
valores absolutos. El conjunto de datos para la ordenacin
consta de valores de la traslacin Y de todos los nodos
especificados en la lista FOR ms reciente y los casos de carga
especificados en la lista FOR ms reciente.
Ejemplo
SORT DISPL BY MX
El comando anterior significa que los valores de rotacin X
rotation deben ser ordenados en base al orden ascendente de
sus valores algebraicos. El conjunto de datos para la
ordenacin consta de los valores de rotacin X de todos los
nodos especificados en la lista FOR ms reciente y los casos de
carga especificados en la lista FOR ms reciente.
Ejemplo
SORT DISPL BY -FZ
El comando anterior significa que los valores de rotacin Z
deben ser ordenados en base al orden descendente de sus
valores algebraicos. El conjunto de datos para la ordenacin
consiste de los valores translacin Z de todos los nodos
especificados en la lista FOR ms reciente y los casos de carga
especificados en la lista FOR ms reciente.
f) MEMBER END FORCES
FX1
FY1
FZ1
MX1
MY1
type-list = MZ1
FX2
FY2
FZ2
MX2
MY2
MZ2
En la anterior type-list, todas las variables que terminan en 1
representan los valores de las fuerzas en extremos en el primer
nodo (nodo inicial) del miembro. Por ejemplo, FX1 significa la
fuerza axial en el nodo inicial, MY1 significa el momento
flexionante con respecto al eje local Y en el nodo inicial.
Todas las variables que terminan en 2 representan valores en
los extremos de miembros en el segundo nodo (nodo final) del
miembro. Por ejemplo, FY2 significa la fuerza cortante a lo
largo del eje local Y en el nodo final, MZ2 representa el
momento flexionante sobre el ele local Z en el nodo final.
Ejemplo
SORT FORCE BY ABS -FZ1
El comando anterior significa que la fuerza cortante a lo largo
del eje local Z en el nodo inicial debe ser ordenado en base al
orden descendente de sus valores absolutos. El conjunto de
datos consiste en la fuerza cortante a lo largo del eje local Z en
el nodo inicial de todos los miembros especificados en la ms
reciente lista FOR list y los casos de carga especificados en la
ms reciente lista FOR.
Ejemplo
SORT DISPL BY MX2
El comando anterior significa que el momento torsional
(momento con respecto al eje local X) en el nodo final de los
miembros deben de ser ordenados en base al orden ascendente
de sus valores algebraicos. El conjunto de datos para la
ordenacin consiste en el momento torsional en el nodo final
de todos los miembros especificados en la ms reciente lista
FOR list y los casos de carga especificados en la ms reciente
lista FOR.
10.2.7 El Comando EXECUTE
Objetivo
El comando EXECUTE proporciona medios, por medio de los
cuales el usuario puede ejecutar un programa que l ha creado
especficamente para sus necesidades.
Formato General
EXECUTE program-name
Ejemplo
Asumamos que deseamos crear un archivo llamado
REACTION.DAT utilizando STAPLE, el cual contendr las
reacciones en los apoyos del anlisis de un archivo de entrada
STAAD-III. Tambin asumamos que el usuario ha creado su propio
programa llamado TRAPFOOT.EXE el cual puede disear una
cimentacin de forma trapezoidal utilizando los datos contenidos
en el archivo REACTION.DAT. El siguiente ejemplo ilustra la
secuencia de comandos requerida para realizar la tarea explicada.
PERFORM ANALYSIS
PRINT JOINT DISPLACEMENTS
SECTION 0.35 0.55 0.83 ALL
PRINT SECTION DISPLACEMENTS
START SCRIPT LANGUAGE
UNIT FEET KIP
OPEN FILE REACTION.DAT
FOR SUPPORT 10
FOR LOAD 6 7 8
WRITE REACTION JOINT FY MX MZ
FORMAT=I5,3F8.2
CLOSE
EXECUTE TRAPFOOT.EXE
END SCRIPT LANGUAGE
FINISH
Veamos a continuacin los comandos en el ejemplo anterior:
PERFORM ANALYSIS
PRINT JOINT DISPLACEMENTS
SECTION 0.35 0.55 0.83 ALL
PRINT SECTION DISPLACEMENTS
Estos son comandos normales de STAAD-III de los cuales usted
est familiarizado con los que aparecen en los archivos de entrada
de STAAD-III. Los comandos anteriores tienen la intencin de
realizar el anlisis, impresin de los desplazamientos de los nodos,
e impresin de los desplazamientos de secciones en las posiciones
0.35L, 0.55L y 0.83L de cada miembro donde L significa la
longitud del miembro.
START SCRIPT LANGUAGE
Esto inicia el segmento de entrada asociado con los comandos para
el proceso del archivo script desde el interior del archivo de
entrada de STAAD-III.
UNIT FEET KIP
Las unidades para la lectura/escritura de datos estn definidas en
pies y Kips.
OPEN FILE REACTION.DAT
El comando anterior es una instruccin para que STAAD-III abra
un archivo llamado REACTION.DAT. Las reacciones en los
apoyos sern guardadas en este archivo. Este ser un archivo
ASCII.
FOR SUPPORT 101
FOR LOAD 6 7 8
WRITE REACTION JOINT FY MX MZ
FORMAT=I5,F8.2,2F9.2
Los comandos anteriores ordenan a STAAD-III que escriba los
valores del nombre de nodo ( 101), los valores de las reacciones
FY, MX y MZ al archivo REACTION.DAT. Estos datos ser
escrita para los casos de carga 6, 7 y 8. Los datos sern escritos
utilizando la siguiente especificacin format:
JOINT (I5) : Un entero de 5 dgitos (Debido a que el nmero de
nodo es 101, un formato de cinco dgitos significar
dos espacios vacos seguidos por los dgitos 1, 0 y 1)
FY (F8.2) : Un nmero real con dos dgitos despus del punto
decimal y 5 dgitos antes del punto decimal.
MX (F9.2) : Un nmero real con dos dgitos despus del punto
decimal y seis dgitos antes del punto decimal.
MZ (F9.2) : Un nmero real con dos dgitos antes del punto
decimal y seis dgitos antes del punto decimal.
CLOSE
El comando CLOSE termina el ciclo FOR-CLOSE.
EXECUTE TRAPFOOT.EXE
El comando para ejecutar el programa TRAPFOOT.EXE es
especificado en la lnea anterior.
END SCRIPT LANGUAGE
El comando significa el fin del proceso del archivo script.
FINISH
La ejecucin STAAD3 es terminada con la ayuda del comando
anterior.
10.2 8 El Comando CALL
Objetivo
Asumamos que hay ciertos comandos script estndar que el usuario
desea especificar en cada ejecucin del archivo de entrada en
STAAD-III. Por ejemplo, el usuario puede desear utilizar la opcin
STAPLE para imprimir los valores de las reacciones de los apoyos
a un archivo estndar llamado REACTION.DAT para cada
estructura analizada a travs de STAAD-III. Esto requerir que el
usuario escriba estos comandos (el comando START SCRIPT
LANGUAGE, el comando FOR SUPPORT, el comando FOR
LOAD, el comando WRITE, el comando FORMAT, el comando
CLOSE, etc.) en cada archivo de entrada de STAAD-III del cual
los resultados del anlisis son deseados. En vez de eso, el usuario
puede crear un archivo de texto (para beneficio de nuestro ejemplo
llammoslo REACTION.SPL donde SPL es la abreviacin de
script language file, archivo de lenguaje script) que contenga
solamente los comandos script, y use el comando CALL para
informar a STAAD que los comandos script que el usuario desea
especificar estn el en archivo REACTION.SPL. En otras palabras,
el comando CALL proporciona medios por los cuales el usuario
puede especificar los comandos script por medio de un archivo
externo en vez de por medio del archivo de entrada de STAAD-III.
Las ventajas principales de esto son: 1) El usuario puede tener un
conjunto estndar de comandos script en solo un archivo y debido a
eso evitar la escritura de ellos una y otra vez para todos los
archivos de entrada STAAD-III. En cualquier proyecto, el tiempo y
esfuerzo que ser invertido en asegurarse que toda la informacin
relevante del anlisis es recuperada. Es ms fcil manejar un solo
archivo, propiamente construido, un archivo script bien pensado
que perder el tiempo escribiendo los comandos script en cada
archivo de STAAD-III que usted analice. Esto puede significar
menos frustracin y considerables ahorros de tiempo y dinero a
largo plazo. Permite la modificacin y la estandarizacin de
comandos script de acuerdo a las necesidades especificas del
usuario.
Formato General
CALL script-file-name
Ejemplo
Asumamos que un archivo script estndar llamado REACTION.SPL
contiene los siguientes comandos script.
START SCRIPT LANGUAGE
UNIT FEET KIP
OPEN FILE REACTION.DAT
FOR SUPPORT ALL
FOR LOAD ALL
WRITE REACTION JOINT FY MX MZ
FORMAT=I5,3F8.2
CLOSE
END SCRIPT LANGUAGE
Los datos contenidos en el archivo de entrada STAAD-III ser
como sigue:
PERFORM ANALYSIS
PRINT JOINT DISPLACEMENTS
PRINT MEMBER FORCES
SECTION 0.2 0.45 0.73 MEMB 8 19
PRINT SECTION FORCES LIST 8 19
START SCRIPT LANGUAGE
CALL REACTION.SPL
END SCRIPT
PLOT STRESS FILE
PLOT MODE FILE
FINISH
Note que el archivo REACTION.SPL debe estar en el mismo
directorio que el archivo de entrada de STAAD-III.
10.2.9 El Comando END SCRIPT LANGUAGE
Objetivo
Este comando es requerido para transmitir a STAAD-III que el proceso del
archivo script debe ser terminado y que otros comandos de STAAD-III
seguirn..
Formato General
END SCRIPT LANGUAGE
Ejemplo
CHECK CODE ALL
START SCRIPT LANGUAGE
.
.
.
.
FOR LOAD 6 7 8
WRITE REACTION JOINT FY MX MZ
FORMAT=I5,3F8.2
CLOSE
END SCRIPT LANGUAGE
10.3 Comandos Grficos en STAPLE
Objetivo
STAPLE proporciona un poderoso conjunto de comandos grficos que
permiten al usuario generar grficas profesionales de salida por medio de
sus programas. Los comandos grficos pueden ser utilizados como:
parte de programas del usuario que son llamados utilizando un
archivo script.
parte de un archivo script.
Los comandos grficos STAPLE son similares en naturaleza a los
lenguajes grficos estndar en la industria como el HPGL. Estos poderosos
comandos permiten al usuario generar grficas de calidad como parte de la
salida sin tener la necesidad de aprender programacin complicada de
grficos. Note que los comandos STAPLE pueden ser usados como parte
de los programas del usuario. Cuando se estn ejecutando utilizando un
archivo script basado en STAPLE, estos archivos generan salida que puede
ser visualizada, ploteada, impresa utilizando las opciones del ambiente
STAAD-III.
La siguiente seccin explica los comandos grficos o de dibujo soportados
por STAPLE.
DEFINE
Objetivo
Este comando establece lmites de dibujo definidas por el usuario en las
direcciones X y Y.
Sintaxis
DEFINE X
min
X
max
Y
min
Y
max
X
min
: Lmite mnimo X especificado como nmero real
X
max
: Lmite mximo X especificado como nmero re al
Y
min
: Lmite mnimo Y especificado como nmero real
Y
min
: Lmite mximo Y especificado como nmero real
Los valores especificados para estas variables sern usados como la base
para el rea de dibujo. El programa traducir automticamente estos
nmeros para que se acomoden dentro del ancho de 1024X768 de la
resolucin de la pantalla o un tamao de papel 8.5in X 11in..
Origen de coordenadas se asume que es la esquina inferior izquierda de la
pantalla.. El eje X va de izquierda a derecha de la pantalla. El eje Y va
desde el fondo hasta la parte superior de la pantalla.
Ejemplo
DEFINE 0 6500 0 4000
COLOR
Objetivo
Este comando define el color del marcador.
Sintaxis
COLOR <color>
<color> : Cadena de texto que define color.
Colores Vlidos: NEGRO(BLACK),AZUL( BLUE), VERDE(GREEN),
CYAN, ROJO(RED), MAGENTA, CAF(BROWN), BLANCO(WHITE),
GRIS(GRAY), LBLUE, LGREEN, LCYAN, LRED, LMAGENTA,
AMARILLO(YELLOW) y LWHITE
Ejemplo
COLOR LMAGENTA
MOVE
Objetivo
Este comando mueve el marcador a un posicin especificada por el usuario.
Sintaxis
MOVE X Y
X: X posicin especificada como un nmero real ( X
min
X X
max
)
Y: Y posicin especificada como un nmero real (Y
min
Y Y
max
)
Es extremadamente importante notar que
(X
min
X X
max
)
(Y
min
Y Y
max
)
Ejemplo
MOVE 500 2500
LINE
Objetivo
Este comando dibuja una lnea con el color del marcador actual entre
puntos especificados por el usuario
Sintaxis
LINE X
1
Y
1
X
2
Y
2
donde,
(X
1
,Y
1
) es el punto inicial de la lnea
(X
2
,Y
2
) es el punto final del la lnea
Es extremadamente importante notar que
(X
min
X
1
X
max
)
(X
min
X
2
X
max
)
(Y
min
Y
1
Y
max
)
(Y
min
Y
2
Y
max
)
Ejemplo
LINE 500 750 1000 3500
RECTANGLE
Objetivo
Este comando dibuja un rectngulo en el color actual del marcador.
Sintaxis
RECTANGLE X
1
Y
1
X
2
Y
2
donde,
(X
1
,Y
1
) es un punto esquina del rectngulo
(X
2
,Y
2
) es la esquina contraria del rectngulo
Es extremadamente importante notar que:
(X
min
X
1
X
max
)
(X
min
X
2
X
max
)
(Y
min
Y
1
Y
max
)
(Y
min
Y
2
Y
max
)
Ejemplo
RECT 500 400 1000 2500
RFILL
Objetivo
Este comando dibuja un rectngulo y lo llena con el color actual del
marcador
Sintaxis
RFILL X
1
Y
1
X
2
Y
2
donde,
(X
1
,Y
1
) es un punto esquina del rectngulo
(X
2
,Y
2
) es la esquina contraria del rectngulo
Es extremadamente importante notar que
(X
min
X
1
X
max
)
(X
min
X
2
X
max
)
(Y
min
Y
1
Y
max
)
(Y
min
Y
2
Y
max
)
Ejemplo
RFILL 500 400 1000 2500
POLYGON
Objetivo
Este comando dibuja un polgono generalizado en el color actual del
marcador
Sintaxis
POLYGON N
X
1
Y
1
X
2
Y
2
..
X
i
,Y
i
..
X
n
Y
n
N: No. de vrtices del polgono (Un nmero entero)
(X
i
,Y
i
): Coordenadas del i esimo vrtice del polgono
Es extremadamente importante notar que
(X
min
X
i
X
max
)
(Y
min
Y
i
Y
max
)
Ejemplo
POLYG 8
100 0
200 0
300 100
300 200
200 300
100 300
0 200
0 100
FILL
Objetivo
Este comando dibuja un polgono generalizado y lo llena con el color
actual del marcador.
Sintaxis
FILL N
X
1
Y
1
X
2
Y
2
..
X
i
,Y
i
..
X
n
,Y
n
N: No. de vrtices del polgono (Un nmero entero)
(X
i
,Y
i
): Coordenadas del i esimo vrtice del polgono
Ejemplo
FILL 8
100 0
200 0
300 100
300 200
200 300
100 300
0 200
0 100
SIZE
Objetivo
Este comando define el tamao actual del texto.
Sintaxis
SIZE <value>
<value>: Valor real especificado por el usuario que representa el tamao
del texto. El tamao es medido en el sistema de coordenadas
especificado por el usuario.
El valor definido para el tamao (SIZE) del texto debe estar acorde con los
lmites del rea de dibujo definido en el comando DEFINE descrito
anteriormente. El valor por omisin de SIZE es 80. Esto puede ser
interpretado como que 80 caracteres entrarn en la pantalla lo cual est
conforme a las pantallas normales de texto. Por lo tanto, un valor menor de
80 (como 20) significa que el tamao de texto ser mayor (debido a que
solo 20 caracteres entrarn en la pantalla). De esta manera, un valor mayor
que 80 significa que el tamao del texto ser ms pequeo que el
correspondiente a tamao 80.
Ejemplo
SIZE 70
ANGLE
Objetivo
Este comando define la orientacin del texto con respecto al eje local X.
Sintaxis
ANGLE <value>
<value>: La orientacin de Texto en grados con respecto al eje X
El ngulo es medido de acuerdo a la regla de la mano derecha, que
significa que un ngulo positivo es medido en el mismo sentido que un arco
que viaja del eje X al eje Y a lo largo del primer cuadrante.
Ejemplo
ANGLE 45
TEXT
Objetivo
Para escribir una cadena de texto empezando en la posicin actual del
marcador en el tamao actual del texto y color de marcador.
Sintaxis
TEXT=<user specified string>
Ejemplo
TEXT=Foundation for Turbo Generator
CIRCLE
Objetivo
Este comando dibuja un crculo con el color actual del marcador
Sintaxis
CIRCLE X Y R
donde,
(X,Y): Posicin del centro del circulo
R: Radio del circulo
Es extremadamente importante notar que
(X
min
X X
max
)
(Y
min
Y Y
max
)
Ejemplo
CIRCLE 2500 3500 1800