STAPLE - STAAD-III Ambiente del Lenguaje de Aplicacin de Programacin

Seccin

10

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.

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 t invoke script

Script file commands

Para ejecutar un archivo script desde STAAD-III para Windows, utilice la funcin apropiada del men FILE. Consulte las siguientes figuras por detalles.

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 5E3 -3.4E-6 -8.9 732

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: * list =

i 1 , i 2 , i 3 ....... 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: * UNIT

length-unit force-unit INCHES FEET or FT CM METER MMS DME KM KIP POUND KG MTON NEWTON KNS MNS DNS

length-unit =

force-unit =

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

FOR

JOINT MEMBER SUPPORT LOAD

item-list

. .. 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 AY AZ IX IY IZ SZ SY B rea de la seccin transversal rea Cortante en el eje local Y rea Cortante en el eje local Z Constante Torsional Momento de Inercia con respecto al eje local Y Momento de Inercia con respecto al eje local Z Mdulo de la Seccin con respecto al eje Z Mdulo de la Seccin con respecto al eje local Y 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

WRITE REACT DISPL (JOINT) (LOAD) type-list

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

WRITE BMO (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

SORT

REACTION 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 typelist 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 Xmin Xmax Ymin Ymax Xmin: Xmax: Lmite mnimo X especificado como nmero real Lmite mximo X especificado como nmero re al

Ymin: Ymin:

Lmite mnimo Y especificado como nmero real 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 Xmax) Y: Y posicin especificada como un nmero real (Y min Y Ymax) Es extremadamente importante notar que (Xmin X Xmax) (Ymin Y Ymax) 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 X1 Y1 X2 Y2 donde, (X1,Y1) es el punto inicial de la lnea (X2,Y2) es el punto final del la lnea Es extremadamente importante notar que (Xmin X1 Xmax) (Xmin X2 Xmax) (Ymin Y1 Ymax)

(Ymin Y2 Ymax) Ejemplo

LINE 500 750 1000 3500

RECTANGLE
Objetivo Este comando dibuja un rectngulo en el color actual del marcador. Sintaxis RECTANGLE X1 Y1 X2 Y2 donde, (X1,Y1) es un punto esquina del rectngulo (X2,Y2) es la esquina contraria del rectngulo Es extremadamente importante notar que: (Xmin X1 Xmax) (Xmin X2 Xmax) (Ymin Y1 Ymax) (Ymin Y2 Ymax) Ejemplo
RECT 500 400 1000 2500

RFILL
Objetivo Este comando dibuja un rectngulo y lo llena con el color actual del marcador Sintaxis RFILL X1 Y1 X2 Y2 donde, (X1,Y1) es un punto esquina del rectngulo (X2,Y2) es la esquina contraria del rectngulo Es extremadamente importante notar que (Xmin X1 Xmax) (Xmin X2 Xmax) (Ymin Y1 Ymax) (Ymin Y2 Ymax) Ejemplo
RFILL 500 400 1000 2500

POLYGON
Objetivo Este comando dibuja un polgono generalizado en el color actual del marcador Sintaxis POLYGON N X1 Y1 X2 Y2 .. Xi,Yi .. Xn Yn N: No. de vrtices del polgono (Un nmero entero) (Xi,Yi): Coordenadas del i esimo vrtice del polgono Es extremadamente importante notar que (Xmin Xi Xmax) (Ymin Yi Ymax) 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 X1 Y1 X2 Y2 .. Xi,Yi .. Xn,Yn N: No. de vrtices del polgono (Un nmero entero) (Xi,Yi): Coordenadas del i esimo vrtice del po lgono

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 (Xmin X Xmax) (Ymin Y Ymax)

Ejemplo
CIRCLE 2500 3500 1800