STAPLE - STAAD-III Ambiente del Lenguaje deAplicacin de Programacin

Esta seccin est diseada para proporcionar una visin general dela funcionalidad de STAPLE. ste consta de un grupo de comandosbasados en el lenguaje ingls que pueden ser usados para crear unarchivo script. El archivo script es un archivo de texto que puedeser creado utilizando cualquier editor de texto. El ambienteSTAAD-III proporciona un poderoso editor de texto que puede serusado para crear y editar archivos script.

El archivo script puede ser entonces ejecutado desde el ambienteSTAAD-III para accesar y extraer informacin necesaria de la basede datos de la ejecucin despus de que un anlisis es realizado. Lainformacin extrada puede ser posteriormente procesada por elarchivo 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 ambienteSTAAD-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 1010

Todas las salidas del archivo script pueden ser visualizadas,mostradas en pantalla, ploteadas e impresas utilizando las opcionesdel ambiente STAAD-III. Si el archivo script es parte de unarchivo de entrada, entonces la salida es integrada con la salida deSTAAD-III.

Para ejecutar un archivo script desde una versin STAAD-III(DOS), utilice el botn SCRIPT de la pantalla principal. Consultelas figuras siguientes para mayores detalles.

Press This Button toinvoke script

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

Script file commands

Ejemplo de salida de archivo script.

Esta seccin de la documentacin describe en detalle los comandose instrucciones de STAPLE. El usuario utiliza un formato delenguaje de comandos para comunicar comandos al programa.Estos comandos son utilizados para:

Iniciar y terminar un segmento de comandos de STAPLE paracrear 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 sondescritas en la seccin 3.1. Esto es seguido en la seccin 3.2, condescripciones detalladas de los comandos disponibles.

Note que los archivos script pueden ser llamados desde el ambienteSTAAD-III. La salida generada puede ser visualizada, ploteada oimpresa 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 decomandos STAPLE. Primero se discuten los elementos del lenguajey despus se describe en detalle el formato del lenguaje decomandos.

10.1.1 Elementos de los Comandos

a) Nmeros Enteros: Nmeros enteros son nmeros escritos sinpunto decimal. Estos nmeros son designados como i1, i2, etc.,y no deben contener punto decimal. Los Signos (+ o -) sonpermitidos al frente de estos nmeros. Si el signo es omitido,se asume que es positivo (+).

b) Nmeros de Punto Flotante: Estos son nmeros reales quepueden contener una porcin decimal. Estos nmeros sondesignados como f1, f2, etc. Los Valores pueden tener un puntodecimal y/o un exponente.

Ejemplo

5055.32 0.73 -8.9 7325E3 -3.4E-6

Cuando el signo es omitido, se asume que es positivo (+).Tambin note que el punto decimal puede ser omitido, si laporcin decimal del nmero es cero.

c) Alfanumricos: Estos son caracteres que son usados paraconstruir los nombres de los datos, ttulos o comandos. No senecesitan comillas para encerrarlos a menos que se especifiquelo contrario.

d) Datos Repetitivos: Datos numricos repetitivos pueden serproporcionados utilizando el siguiente formato:

n * fdonde n = nmero de veces que los datos tienen que serrepetidos

f = datos numricos, ya sea enteros o de puntoflotante

10.1.2 Formatos de los Comandos

a) Entrada de formato libre: Todos los comandos de STAPLEestn en un estilo de formato libre. Los elementos de datos deentrada deben estar separados por espacios o por comas de losotros elementos de entrada. Nunca se necesitan comillas paraseparar ninguna palabra alfabtica como datos, comandos ottulos.

b) Comentarios de Entrada: Para documentar un archivo scriptde 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 lneacon el comando es mandada al archivo de salida pero no esprocesada por el programa.

Ejemplo

FOR LOAD 1 3* FOLLOWING CALCULATIONS FOR LOAD 1 AND 3WRITE REACT FY MZ

c) El Significado del Subrayado en el Manual: Los Formatosexactos de los comandos se describen en las siguientessecciones. Muchas palabras en los comandos y en los datospueden ser abreviadas. La palabra completa se da en ladescripcin del comandos, con la parte realmente requerida (laabreviacin) subrayada.

Por ejemplo, si la palabra MEMBER es usada en un comando,solamente la porcin MEMB necesita ser especificada. Es claropara otros que lean la salida si toda la palabra es utilizada,pero un usuario experimentado puede desear utilizar lasabreviaturas.

d) El significado de Corchetes y Parntesis: En algunosformatos de comandos hay corchetes que encierran un nmerode alternativas, que son distribuidas verticalmente. Una y solouna de estas alternativas puede ser seleccionada. Sin embargo,varias de las alternativas listadas pueden ser seleccionadas siun asterisco (*) es localizado fuera de los corchetes.

Ejemplo

XY YZ XZ

En ejemplo anterior, el usuario debe hacer una decisin entreXY 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 ( ), queencierran una porcin de un comando indican que la parteencerrada es opcional. La presencia o ausencia de esta parteafecta el significado del comando, tal como es explicado en ladescripcin del comando en particular.

Ejemplo

WRITE FORCE (MEMBER) type - list

En la lnea anterior, la palabra MEMBER es opcional. Ningnnmero de miembro ser escrito si esta palabra no es usada.

e) Separador de Datos Mltiples: Datos mltiples pueden serproporcionados en una sola lnea si estn separados por unpunto y coma (;). Una restriccin estriba en que comandosconsecutivos no pueden ser separados por un punto y coma.Deben aparecer en lneas separadas.

f) Lista de Datos: En algunas descripciones de comandosSTAPLE, la palabra "list" es utilizada para identificar una listade nodos, miembros/elementos o casos de carga. El formato deuna lista puede ser definida como sigue:

* i1, i2, i3....... list = i1 TO i2 (BY i3)

X or Y or Z

La palabra TO significa todos los enteros desde el primero (i1)

hasta e inclusive el segundo (i2). La expresin BY y el nmero

que le sigue (i3) significa que los nmeros de miembros tienen

que ser generados desde i1 hasta i

2 en incrementos de i

3 i.e., i

1,

i1+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 algunasocasiones la lista puede ser muy larga para caber en una lnea,en cuyo caso la lista puede ser continuada en la siguiente lneaescribiendo un guin precedido por un espacio en blanco.Tambin note que una lista puede solamente ser continuada yno 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 paraelementos de listas es utilizado cuando los elementos de la listano continuarn. La marca de continuacin es colocada en unaposicin incorrecta. Debe ser colocada despus del nmero 10.El ejemplo siguiente muestra otro error posible . El guin debeaparecer 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 deSTAPLE. Todos los archivos script de STAPLE deben empezar coneste comando.

Formato General:

START SCRIPT LANGUAGE

Descripcin

Los comandos STAPLE son llamados utilizando el comandoSTART SCRIPT. Este comando es tpicamente seguido por otroscomandos STAPLE. Finalmente, el script STAPLE se termina conel comando END SCRIPT. Los archivos script de STAPLE puedenser independientes o parte de un archivo de entrada de STAAD-III.Note que el archivo script de STAPLE puede ser colocado encualquier parte del archivo de entrada de STAAD-III. Sin embargo,si el archivo script es colocado antes del comando PERFORMANALYSIS, entonces los resultados del anlisis puede no estardisponibles para un proceso posterior. Similarmente, si el archivoscript de STAPLE est siendo utilizado independientemente, elanlisis de STAAD-III debe ser realizado antes de utilizar elarchivo script para post-proceso.

10.2.2 Especificacin UNIT

Objetivo

Este comando permite al usuario especificar o cambiar las unidadesde 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 DNSdenota decaNewtons. Las unidades restantes se explican pors mismas.

Descripcin

El comando UNIT puede ser especificado cualquier nmero deveces en el archivo script. Se asume que todos los datos estnconforme a la ultima especificacin de unidades anterior a ellos.

Tambin note que la unidad de entrada para ngulos es siempregrados. Sin embargo, la unidad de salida para rotacin de nodos(en desplazamiento de nodos ) es radianes. Para toda salida, lasunidades son claramente especificadas por el programa.

Ejemplo

UNIT KIP FTFOR MEMB 1 TO 3..

Ejemplo

UNIT CM KNFOR JOINT 10 15WRITE COORD JOINT..

Ejemplo

UNIT CM KIPFOR MEMB 15 25..

Notas

Note que se permite mezclar y comparar entre sistemas de unidadesdiferentes (Imperial, Mtrico, SI etc.).

10.2.3 El comando OPEN

Objetivo

Este comando es utilizado para crear un archivo externo a travsdel lenguaje script STAPLE. El archivo externo creado puede

contener datos estructurales relevantes en un formato definidopor 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 creadoespecificado por el usuario.

Descripcin

Este comando necesita ser usado cada vez que un archivo externoes creado usando el lenguaje script STAPLE. Tpicamente, estecomando es seguido por los comandos FOR, WRITE, FORMAT ySORT que son utilizados para escribir los datos relevantes alarchivo 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 sonrequeridos. Este comando trabaja en conjunto con el comandoCLOSE para crear un ciclo.

Formato General

JOINT FOR MEMBER item-list

SUPPORT LOAD

...CLOSE

donde,item-list = lista de los elementos relevantes para los cualesinformacin es requerida.

Descripcin

Con el comando FOR, el usuario puede especificar un elemento enparticular (nodo, miembro, apoyo, carga) para el cual lainformacin es requerida. La item-list asociada le permite alusuario especificar una lista numrica para el elemento enparticular.

Note que comandos FOR sucesivos pueden ser usados paraespecificar ms de un elemento. Por ejemplo, si se requierendesplazamiento de nodos para un cierto nmero de casos de carga,dos comandos FOR sucesivos, uno para nodos y el otro para cargaspueden ser usados.

El ciclo FOR-CLOSE contiene tpicamente comandos SORT y/oWRITE para accesar y escribir datos al archivo externo. Lasdescripciones para estos comandos estn disponibles en lassecciones siguientes.

Cada ciclo FOR-CLOSE debe ser cerrado por un comando CLOSE.Note que un comando CLOSE puede ser usado para cerrarcomandos FOR mltiples.

Ejemplo

FOR SUPPORT 1 2FOR LOAD 1 3WRITE REACT FX FY MZFORMAT = REACTION, 3F10.2CLOSE

El ejemplo anterior ilustra el uso del ciclo FOR-CLOSE. Elsegmento script sencillo esta diseado para extraer reacciones deapoyos 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 direccionesglobales X y Y y el momento de reaccin respecto al eje global Z,respectivamente. Para detalles en el uso de las especificacionesWRITE y FORMAT, consulte las ltimas secciones de estadocumentacin. Note que el ciclo FOR-CLOSE es cerrado pormedio de un comando CLOSE.

10.2.5 Los Comandos WRITE y FORMAT

Objetivo

Estos comandos son utilizados para escribir datos estructuralesespecificados por el usuario(desplazamientos, fuerzas, propiedades,reacciones, etc.,) para elementos especificados (nodos, miembros,cargas, apoyos) en un archivo externo que es abierto (ver detallesdel comando OPEN en la seccin 3.2.3) para ese objetivo. Elcomando WRITE es inmediatamente seguido por un comandoFORMAT que especifica el formato de la escritura de datos. Estoscomandos son explicados en las siguientes sub-secciones.

10.2.5.1 Comandos WRITE

Escritura de Encabezados

WRITE HEADERFORMAT=

donde = texto que aparecer como encabezado

Descripcin

Un encabezado es un ttulo que permite la identificacin de datosque ser guardado en el archivo de datos para ese objetivo. Porejemplo, digamos que deseamos escribir las reacciones en apoyosdebidas al caso de carga asociado con la carga debida a viento.

Ejemplo

WRITE HEADERFORMAT=Support Reactions due to Wind Loading

Escritura de Coordenadas de Nodos

WRITE COORD (JOINT )FORMAT=*

En la sintaxis anterior, la palabra COORD significa coordenadas denodos. Si la palabra JOINT, es proporcionada (es opcional),instruir a STAAD-III a escribir el nmero de nodos para loscuales 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 laespecificacin list del comando FORMAT.

Ejemplo

WRITE COORD JOINTFORMAT=I4, 3F10.2

Escritura de Incidencias de Miembros

WRITE MINC (MEMB )FORMAT=*

En la sintaxis anterior, la palabra MINC significa incidencias demiembros. La palabra MEMB, si es dada (es opcional), instruir aSTAAD-III a escribir el nmero de miembro para el los valoresestn siendo escritos.

* Ver la seccin section 3.2.5.2 para obtener informacin en laespecificacin FORMAT.

Ejemplo

WRITE MINC MEMBFORMAT=I4, 2X, I5, 2X, I5

Escritura de Propiedades de Miembros

WRITE PROP (MEMB) (NAME) type-listFORMAT=*

* AX AY AZ IX IY

type-list = IZ SZ SY B D TF TW

En la sintaxis anterior, la palabra PROP significa propiedades demiembros. La palabra MEMB, si es proporcionada (es opcional),instruir a STAAD-III a escribir el nmero de miembro para el cuallos valores estn siendo escritos. La palabra NAME significa ladesignacin de la propiedad de ese miembro. (W12X26, L20204son ejemplos de names.) Los elementos en la type-list son:

AX = rea de la seccin transversalAY = rea Cortante en el eje local YAZ = rea Cortante en el eje local ZIX = Constante TorsionalIY = Momento de Inercia con respecto al eje local YIZ = Momento de Inercia con respecto al eje local ZSZ = Mdulo de la Seccin con respecto al eje ZSY = Mdulo de la Seccin con respecto al eje local YB = 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 PatnTW = Espesor del Alma

* Ver la seccin 3.2.5.2 para obtener informacin acerca de laespecificacin FORMAT.

Ejemplo

WRITE MEMB NAMEFORMAT=I5, 2X, A16WRITE PROP AX IZFORMAT=2F10.2

Escritura de Relajamientos de Miembros

WRITE RELE (MEMB)FORMAT=*

En la sintaxis anterior, la palabra RELE significa relajamiento demiembros. Si la palabra MEMB, es proporcionada (es opcional),instruir a STAAD-III para que escriba los nmeros de miembrospara los cuales los valores estn siendo escritos. La condicin derelajamiento de miembros es representada en la forma de lossmbolos 0 o 1 en la salida. 0 indica un relajamiento mientras 1indica la posicin fija de un grado de libertad. Las condiciones derelajamiento son representadas por 6 smbolos para el inicio delmiembro y 6 para el final del miembro.

* Ver la seccin 3.2.5.2 para obtener informacin sobre laespecificacin FORMAT.

Ejemplo

WRITE RELEASE MEMBFORMAT=I5, 2X, 12I1

Escritura de Reacciones en Apoyos y Desplazamientosde Nodos

REACT WRITE (JOINT) (LOAD) type-list

DISPL

FORMAT=*

* FX FY

type-list = FZ MX MYMZ

Descripcin

En la sintaxis anterior, la palabra REACT significa reacciones deapoyos y DISPL significa desplazamientos de Nodos. La palabraJOINT, si es proporcionada (es opcional), instruir al programapara que escriba el nmero de nodo para el cual las reacciones olos 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 decaso de carga para el cual las reacciones o los valores dedesplazamientos estn siendo escritos.

En la type-list mostrada anteriormente,

FX = X-translacin para DISPL, Fuerza en la direccin X paraREACT

FY = Y-translacin para DISPL, Fuerza en la direccin Y paraREACT

FZ = Z-translacin para DISPL, Fuerza en la direccin Z paraREACT

MX = Rotacin sobre el eje X para DISPL, Momento sobre eje Xpara REACT

MY = Rotacin sobre el eje Y para DISPL, Momento sobre el ejeY para REACT

MZ = Rotacin sobre el eje Z para DISPL, Momento sobre eje Zpara REACT

* Ver la seccin 3.2.5.2 para obtener informacin en laespecificacin FORMAT.

Ejemplo

WRITE REACT JOINT LOAD FY MZFORMAT=2I5, 2F10.2

Escritura de Fuerzas en los Extremos de Miembros

WRITE FORCE (MEMB) (LOAD) type-listFORMAT=*

* FX1 FY1 FZ1 MX1 MY1

type-list = MZ1 FX2 FY2 FZ2 MX2 MY2 MZ2

Descripcin

En la sintaxis anterior, la palabra FORCE significa fuerzas enextremos de miembros. La palabra MEMB, si es dada, (esopcional) instruir a STAAD-III para que escriba el nmero demiembro para el cual los valores estn siendo escritos.Similarmente, la palabra LOAD, si es dada (es opcional), instruira STAAD-III para que escriba el nmero de caso de carga para elcual los valores estn siendo escritos.

En la type-list anterior, todas las variables que terminan en 1representan valores de las fuerzas en los extremos de los miembrosen el primer nodo( nodo inicial) del miembro. Por ejemplo, FX1significa la fuerza axial en el nodo inicial, MY1 significa el

momento flexionante sobre el eje Y en el punto inicial. Todas lasvariables que terminan con 2 representan valores de las fuerzasen los extremos de los miembros en el segundo nodo (nodo final)del miembro. Por ejemplo, FY2 significa la fuerza cortante a lolargo del eje local Y en el nodo final, MZ2 significa el momentoflexionante con respecto al eje Y en el nodo final

* Ver la seccin 3.2.5.2 para obtener informacin en laespecificacin FORMAT.

Ejemplo

WRITE FORCE MEMB LOAD FZ1 MX2FORMAT=2I5, 2F10.2

Escritura de Fuerzas en Secciones de Miembros yDesplazamientos de Miembros

BMO WRITE (MEMB) (LOAD) type-list

SDI

FORMAT=*

* FX FY

type-list = FZ MX MY MZ

En la sintaxis anterior, la palabra BMO significa fuerzas ensecciones de miembros. La palabra SDI significa desplazamientosde secciones de miembros. Los valores son obtenidos para los dosextremos mas once secciones intermedias. La palabra MEMB, si esdada (es opcional), instruir a STAAD-III para que escriba elnmero del elemento para el cual los valores estn siendo escritos.Similarmente, la palabra LOAD, si es dada (es opcional), instruira STAAD-III para que escriba el nmero de caso de carga para elcual 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 siendoescrito es SDI, entonces FX, FY y FZ se refiere a la translacin X,translacin Y y translacin Z respectivamente de la seccinespecifica. Similarmente, MX, MY y MZ se refieren al momentotorsional, momento con respecto el eje local Y, y momento conrespecto el eje local Z si el elemento que est siendo escrito esBMO. Si el elemento siendo escrito es SDI, entonces MX, MY yMZ se refieren a la rotacin con respecto el eje local X, rotacincon respecto el eje local Y, y rotacin con respecto al eje local Zrespectivamente de la seccin especifica.

Ejemplo

WRITE BMO MEMB LOAD FY MZFORMAT=2I5, 2F9.2

* See the section 3.2.5.2 for information on the FORMATspecification.

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 deun nmero que describe el nmero de dgitos aplicable para elvalor de esa variable. Por ejemplo, para escribir el nodonmero 10781 (que es un entero de cinco dgitos), use laespecificacin FORMAT.

Ejemplo

FORMAT=I5

Si el descriptor de edicin del nmero entero es ms grandeque el nmero de dgitos en ese nmero, el nmero serimpreso alineado a la derecha (espacios vacos sern colocadosa la izquierda del nmero). De manera similar, si el descriptorde edicin es ms pequeo que el nmero de dgitos en esenmero, asteriscos sern impresos en vez del nmero.

2) Descriptor de Edicin para espacios vacos

Para la escritura de espacios vacos, especifique el valor de nseguidos por la letra X. Por ejemplo, para escribir 2 espaciosvacos,

Ejemplo

FORMAT=2X

Si usted desea imprimir ms de un entero separado porespacios vacos utilizando un solo comando format, separe losdescriptores con comas. Por ejemplo, un entero de 3 dgitosseguido de 2 espacios vacos seguidos de 7 dgitos enteros sonescritos 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 usadaseguida de un nmero a seguida por un punto decimal seguidopor un nmero b. El nmero a es igual al nmero de dgitosantes del decimal ms el nmero de dgitos antes del decimalmas uno. El nmero b es igual al nmero de dgitos despusdel decimal. Si el nmero es uno negativo, asegrese que a eslo suficientemente grande para contar con el signo menostambin. 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 grandeque el nmero de dgitos en ese nmero, el nmero serimpreso alineado a la derecha (espacios vacos sern colocadosa la izquierda del nmero). De manera similar, si el descriptorde Edicin es ms pequeo que el nmero de dgitos en esenmero, asteriscos sern impresos en vez del nmero. Si usteddesea imprimir ms de un nmero decimal separado porespacios vacos utilizando un solo comando format, separe losdescriptores con comas. Por ejemplo, los nmeros 273.654 y -980.1 separados por 2 espacios vacos son escritos utilizandola especificacin FORMAT.

Ejemplo

FORMAT=F7.3,2X,F6.1

Si usted desea imprimir nmeros decimal y enteros y espaciosvacos utilizando un solo comando format, separe losdescriptores con comas. Por ejemplo, los nmeros 273.654,400, -980.1 y 15 separados por 2 espacios vacos entre cadanmero 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 deun entero utilizando un solo comando format, use el nmeroapropiado (que representa cuanto de esos valores estnpresentes) antes de la especificacin F o I. Por ejemplo, los

nmeros 100, 120, 135, 621.4, 786.3, 809.5 pueden ser escritosusando el siguiente formato.

Ejemplo

FORMAT=3I5,3F7.1

Note que al usar I5, estamos utilizando la habilidad delprograma para asignar 2 espacios vacos antes de tres dgitosenteros para nuestra ventaja debido a que ahora no tenemos quepreocuparnos por especificar los espacios vacos.Similarmente, seleccionando un formato F7.1 cuando el totalde dgitos incluyendo el punto decimal es solo 5, estamos enposibilidades de obtener 2 espacios en blanco entre losnmeros decimales tambin.

4) Descriptor de Edicin de Caracteres

Para la escritura de caracteres o cadenas de caracteres, utilicela letra A seguida de un nmero de caracteres en la cadena. Elnmero de caracteres en la cadena es igual al nmero de letrasms el nmero de espacios vacos. Por ejemplo, la palabraSUPPORT contiene 7 caracteres. La expresin MATFOUNDATION contiene 14 caracteres.

Ejemplo

FORMAT=A27

10.2.6 El Comando SORT

Objetivo

El comando SORT debe ser proporcionado antes del comandoWRITE para especificar los parmetros de acuerdo a cual de losvalores deseados de salida debe ser ordenado. El comando SORTes seguido inmediatamente por un comando WRITE que especificalos 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 especificacinanterior y la type-list asociada con ellos.

a) BY : Las opciones REACT, DISPL o FORCE siempre tienenque ser seguidas por esta palabra

b) ABS : Esta opcin deber ser usada si la ordenacin se har deacuerdo a valores absolutos. Por favor vea los ejemplossiguientes que muestran el uso de esta opcin.

c) - : Esta opcin que es un signo menos, si es colocadainmediatamente antes del nombre de la variable (vea la type-list siguiente para la lista de nombres de variables) significaque la ordenacin se har basada en el orden descendente devalores implicando que el valor ms grande (Valor absolutoms grande si la opcin ABS es especificada; valor algebraicoms grande si la opcin ABS no es especificada) vendrprimero y el valor ms pequeo vendr al final. Si el signomenos no es especificado, la ordenacin se har basndose enel orden ascendente de valores.

d) REACTIONFX FY

type-list = FZ MXMY MZ

Ejemplo

SORT REACT BY ABS FY

El comando anterior significa que los valores de la reaccin deapoyo FY deben ser ordenados basndose en el ordenascendente de sus valores absolutos. El grupo de datos para laordenacin consiste de los valores de la reaccin de apoyos FYde todos los nodos de soporte especificados en la lista FORms reciente y los casos de carga especificados en la lista FORms reciente.

Ejemplo

SORT REACT BY -MX

El comando anterior significa que los valores de reacciones enapoyos MX deben ser ordenados basndose en el ordendescendente de sus valores algebraicos. El conjunto de datosconsiste en los valores de las reaccione en apoyos MX de todoslos nodos de apoyo especificados en la lista For ms reciente ylos 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 enapoyos FX debern ser ordenados en base al orden descendente

de sus valores absolutos. El conjunto de datos para laordenacin consta de los valores de reaccin en apoyos FX detodos los nodos de apoyo especificados en la lista FOR msreciente y los casos de carga especificados en la lista FOR msreciente.

e) DISPLACEMENTS (DESPLAZAMIENTOS)

FX FY

type-list = FZ MXMY MZ

Ejemplo

SORT DISPL BY ABS -FY

El comando anterior significa que los valores de la translacinY deben ser ordenados en base al orden descendente de susvalores absolutos. El conjunto de datos para la ordenacinconsta de valores de la traslacin Y de todos los nodosespecificados en la lista FOR ms reciente y los casos de cargaespecificados en la lista FOR ms reciente.

Ejemplo

SORT DISPL BY MX

El comando anterior significa que los valores de rotacin Xrotation deben ser ordenados en base al orden ascendente desus valores algebraicos. El conjunto de datos para laordenacin consta de los valores de rotacin X de todos losnodos especificados en la lista FOR ms reciente y los casos decarga especificados en la lista FOR ms reciente.

Ejemplo

SORT DISPL BY -FZ

El comando anterior significa que los valores de rotacin Zdeben ser ordenados en base al orden descendente de susvalores algebraicos. El conjunto de datos para la ordenacinconsiste de los valores translacin Z de todos los nodosespecificados en la lista FOR ms reciente y los casos de cargaespecificados 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 1representan los valores de las fuerzas en extremos en el primernodo (nodo inicial) del miembro. Por ejemplo, FX1 significa lafuerza axial en el nodo inicial, MY1 significa el momentoflexionante con respecto al eje local Y en el nodo inicial.Todas las variables que terminan en 2 representan valores enlos extremos de miembros en el segundo nodo (nodo final) delmiembro. Por ejemplo, FY2 significa la fuerza cortante a lolargo del eje local Y en el nodo final, MZ2 representa elmomento 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 largodel eje local Z en el nodo inicial debe ser ordenado en base alorden descendente de sus valores absolutos. El conjunto dedatos consiste en la fuerza cortante a lo largo del eje local Z enel nodo inicial de todos los miembros especificados en la msreciente lista FOR list y los casos de carga especificados en lams 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 losmiembros deben de ser ordenados en base al orden ascendentede sus valores algebraicos. El conjunto de datos para laordenacin consiste en el momento torsional en el nodo finalde todos los miembros especificados en la ms reciente listaFOR list y los casos de carga especificados en la ms recientelista FOR.

10.2.7 El Comando EXECUTE

Objetivo

El comando EXECUTE proporciona medios, por medio de loscuales el usuario puede ejecutar un programa que l ha creadoespecficamente para sus necesidades.

Formato General

EXECUTE program-name

Ejemplo

Asumamos que deseamos crear un archivo llamadoREACTION.DAT utilizando STAPLE, el cual contendr lasreacciones en los apoyos del anlisis de un archivo de entradaSTAAD-III. Tambin asumamos que el usuario ha creado su propioprograma llamado TRAPFOOT.EXE el cual puede disear unacimentacin de forma trapezoidal utilizando los datos contenidosen el archivo REACTION.DAT. El siguiente ejemplo ilustra lasecuencia de comandos requerida para realizar la tarea explicada.

PERFORM ANALYSISPRINT JOINT DISPLACEMENTSSECTION 0.35 0.55 0.83 ALLPRINT SECTION DISPLACEMENTSSTART SCRIPT LANGUAGEUNIT FEET KIPOPEN FILE REACTION.DATFOR SUPPORT 10FOR LOAD 6 7 8WRITE REACTION JOINT FY MX MZFORMAT=I5,3F8.2CLOSEEXECUTE TRAPFOOT.EXEEND SCRIPT LANGUAGEFINISH

Veamos a continuacin los comandos en el ejemplo anterior:

PERFORM ANALYSISPRINT JOINT DISPLACEMENTSSECTION 0.35 0.55 0.83 ALLPRINT SECTION DISPLACEMENTS

Estos son comandos normales de STAAD-III de los cuales ustedest familiarizado con los que aparecen en los archivos de entradade STAAD-III. Los comandos anteriores tienen la intencin derealizar el anlisis, impresin de los desplazamientos de los nodos,e impresin de los desplazamientos de secciones en las posiciones0.35L, 0.55L y 0.83L de cada miembro donde L significa lalongitud del miembro.

START SCRIPT LANGUAGE

Esto inicia el segmento de entrada asociado con los comandos parael proceso del archivo script desde el interior del archivo deentrada de STAAD-III.

UNIT FEET KIP

Las unidades para la lectura/escritura de datos estn definidas enpies y Kips.

OPEN FILE REACTION.DAT

El comando anterior es una instruccin para que STAAD-III abraun archivo llamado REACTION.DAT. Las reacciones en losapoyos sern guardadas en este archivo. Este ser un archivoASCII.

FOR SUPPORT 101FOR LOAD 6 7 8WRITE REACTION JOINT FY MX MZFORMAT=I5,F8.2,2F9.2

Los comandos anteriores ordenan a STAAD-III que escriba losvalores del nombre de nodo ( 101), los valores de las reacciones

FY, MX y MZ al archivo REACTION.DAT. Estos datos serescrita para los casos de carga 6, 7 y 8. Los datos sern escritosutilizando la siguiente especificacin format:

JOINT (I5) : Un entero de 5 dgitos (Debido a que el nmero denodo es 101, un formato de cinco dgitos significardos espacios vacos seguidos por los dgitos 1, 0 y 1)

FY (F8.2) : Un nmero real con dos dgitos despus del puntodecimal y 5 dgitos antes del punto decimal.

MX (F9.2) : Un nmero real con dos dgitos despus del puntodecimal y seis dgitos antes del punto decimal.

MZ (F9.2) : Un nmero real con dos dgitos antes del puntodecimal 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 esespecificado 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 comandoanterior.

10.2 8 El Comando CALL

Objetivo

Asumamos que hay ciertos comandos script estndar que el usuariodesea especificar en cada ejecucin del archivo de entrada enSTAAD-III. Por ejemplo, el usuario puede desear utilizar la opcinSTAPLE para imprimir los valores de las reacciones de los apoyosa un archivo estndar llamado REACTION.DAT para cadaestructura analizada a travs de STAAD-III. Esto requerir que elusuario escriba estos comandos (el comando START SCRIPTLANGUAGE, el comando FOR SUPPORT, el comando FORLOAD, el comando WRITE, el comando FORMAT, el comandoCLOSE, etc.) en cada archivo de entrada de STAAD-III del cuallos resultados del anlisis son deseados. En vez de eso, el usuariopuede crear un archivo de texto (para beneficio de nuestro ejemplollammoslo REACTION.SPL donde SPL es la abreviacin descript language file, archivo de lenguaje script) que contengasolamente los comandos script, y use el comando CALL parainformar a STAAD que los comandos script que el usuario deseaespecificar estn el en archivo REACTION.SPL. En otras palabras,el comando CALL proporciona medios por los cuales el usuariopuede especificar los comandos script por medio de un archivoexterno en vez de por medio del archivo de entrada de STAAD-III.

Las ventajas principales de esto son: 1) El usuario puede tener unconjunto estndar de comandos script en solo un archivo y debido aeso evitar la escritura de ellos una y otra vez para todos losarchivos de entrada STAAD-III. En cualquier proyecto, el tiempo yesfuerzo que ser invertido en asegurarse que toda la informacinrelevante del anlisis es recuperada. Es ms fcil manejar un soloarchivo, propiamente construido, un archivo script bien pensadoque perder el tiempo escribiendo los comandos script en cadaarchivo de STAAD-III que usted analice. Esto puede significarmenos frustracin y considerables ahorros de tiempo y dinero alargo plazo. Permite la modificacin y la estandarizacin de

comandos script de acuerdo a las necesidades especificas delusuario.

Formato General

CALL script-file-name

Ejemplo

Asumamos que un archivo script estndar llamado REACTION.SPLcontiene los siguientes comandos script.

START SCRIPT LANGUAGEUNIT FEET KIPOPEN FILE REACTION.DATFOR SUPPORT ALLFOR LOAD ALLWRITE REACTION JOINT FY MX MZFORMAT=I5,3F8.2CLOSEEND SCRIPT LANGUAGE

Los datos contenidos en el archivo de entrada STAAD-III sercomo sigue:

PERFORM ANALYSISPRINT JOINT DISPLACEMENTSPRINT MEMBER FORCESSECTION 0.2 0.45 0.73 MEMB 8 19PRINT SECTION FORCES LIST 8 19START SCRIPT LANGUAGECALL REACTION.SPLEND SCRIPTPLOT STRESS FILEPLOT MODE FILEFINISH

Note que el archivo REACTION.SPL debe estar en el mismodirectorio 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 delarchivo script debe ser terminado y que otros comandos de STAAD-IIIseguirn..

Formato General

END SCRIPT LANGUAGE

Ejemplo

CHECK CODE ALLSTART SCRIPT LANGUAGE....FOR LOAD 6 7 8WRITE REACTION JOINT FY MX MZFORMAT=I5,3F8.2CLOSEEND SCRIPT LANGUAGE

10.3 Comandos Grficos en STAPLE

Objetivo

STAPLE proporciona un poderoso conjunto de comandos grficos quepermiten al usuario generar grficas profesionales de salida por medio desus programas. Los comandos grficos pueden ser utilizados como:

parte de programas del usuario que son llamados utilizando unarchivo script.

parte de un archivo script.

Los comandos grficos STAPLE son similares en naturaleza a loslenguajes grficos estndar en la industria como el HPGL. Estos poderososcomandos permiten al usuario generar grficas de calidad como parte de lasalida sin tener la necesidad de aprender programacin complicada degrficos. Note que los comandos STAPLE pueden ser usados como partede los programas del usuario. Cuando se estn ejecutando utilizando unarchivo script basado en STAPLE, estos archivos generan salida que puedeser visualizada, ploteada, impresa utilizando las opciones del ambienteSTAAD-III.

La siguiente seccin explica los comandos grficos o de dibujo soportadospor STAPLE.

DEFINE

Objetivo

Este comando establece lmites de dibujo definidas por el usuario en lasdirecciones X y Y.

Sintaxis

DEFINE Xmin Xmax Ymin Ymax

Xmin: Lmite mnimo X especificado como nmero realXmax: Lmite mximo X especificado como nmero real

Ymin: Lmite mnimo Y especificado como nmero realYmin: Lmite mximo Y especificado como nmero real

Los valores especificados para estas variables sern usados como la basepara el rea de dibujo. El programa traducir automticamente estosnmeros para que se acomoden dentro del ancho de 1024X768 de laresolucin de la pantalla o un tamao de papel 8.5in X 11in..

Origen de coordenadas se asume que es la esquina inferior izquierda de lapantalla.. El eje X va de izquierda a derecha de la pantalla. El eje Y vadesde 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

: 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 ( Xmin X Xmax)Y: Y posicin especificada como un nmero real (Ymin 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 entrepuntos 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 delmarcador

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 delmarcador

Sintaxis

POLYGON NX1 Y1X2 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 8100 0200 0300 100300 200200 300100 3000 2000 100

FILL

Objetivo

Este comando dibuja un polgono generalizado y lo llena con el coloractual del marcador.

Sintaxis

FILL NX1 Y1X2 Y2..Xi,Yi..

Xn,Yn

N: No. de vrtices del polgono (Un nmero entero)(Xi,Yi): Coordenadas del i esimo vrtice del polgono

Ejemplo

FILL 8100 0200 0300 100300 200200 300100 3000 2000 100

SIZE

Objetivo

Este comando define el tamao actual del texto.

Sintaxis

SIZE

: Valor real especificado por el usuario que representa el tamaodel texto. El tamao es medido en el sistema de coordenadasespecificado por el usuario.

El valor definido para el tamao (SIZE) del texto debe estar acorde con loslmites del rea de dibujo definido en el comando DEFINE descritoanteriormente. El valor por omisin de SIZE es 80. Esto puede serinterpretado como que 80 caracteres entrarn en la pantalla lo cual estconforme a las pantallas normales de texto. Por lo tanto, un valor menor de80 (como 20) significa que el tamao de texto ser mayor (debido a quesolo 20 caracteres entrarn en la pantalla). De esta manera, un valor mayorque 80 significa que el tamao del texto ser ms pequeo que elcorrespondiente a tamao 80.

Ejemplo

SIZE 70

ANGLE

Objetivo

Este comando define la orientacin del texto con respecto al eje local X.

Sintaxis

ANGLE

: La orientacin de Texto en grados con respecto al eje X

El ngulo es medido de acuerdo a la regla de la mano derecha, quesignifica que un ngulo positivo es medido en el mismo sentido que un arcoque 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 delmarcador en el tamao actual del texto y color de marcador.

Sintaxis

TEXT=

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 circuloR: Radio del circulo

Es extremadamente importante notar que

(Xmin X Xmax)(Ymin Y Ymax)

Ejemplo

CIRCLE 2500 3500 1800

STAPLE - STAAD-III Ambiente del Lenguaje de Aplicacin de ProgramacinConvenciones del Lenguaje de Comandos STAPLEElementos de los ComandosFormatos de los Comandos

Comandos STAPLEInicio de STAPLEEspecificacin UNITEl comando OPENEl Comando FORLos Comandos WRITE y FORMATComandos WRITEEspecificacin FORMATEl Comando SORTEl Comando EXECUTEEl Comando CALLEl Comando END SCRIPT LANGUAGE

Comandos Grficos en STAPLE