UNIVERSIDAD NACIONAL DE INGENIERÍA

FACULTAD DE INGENIERÍA CIVIL

MAESTRÍA EN INGENIERÍA HIDRÁULICA

CURSO DE HIDROLOGÍA AVANZADA

Alumno: Diego Manuel Morales Morales

Profesor: Dr. Ing. Walter Obando Licera

Asunto: Manual de Uso del Programa «Stochastic Analysis, Modeling, and Simulation
(SAMS)».

INDICE

Pág.

1 INTRODUCCIÓN A SAMS 1

2 PROCEDIMIENTO PARA OBTENER UNA SERIE SINTETICA 2

2.1 Confiigurar los registros históricos 2

2.1.1 Mensual (Seasonal) 2

2.1.2 Anuales (Annual) 3

2.2 Importar una serie histórica 4

2.3. Obtener una serie sintética 7

1 INTRODUCCIÓN A SAMS

Se llama datos sintéticos, o también, serie sintética, a la construcción de una serie de datos
que difiere de una natural (es decir, de una serie observada), pero que, a la vez, conserva
ciertas propiedades de esa serie natural1. Vale indicar que «la secuencia generada se
construye de tal manera que los eventos individuales tengan la misma probabilidad de
ocurrencia que tienen en la secuencia observada»2.

Los procesos estocáticos, dentro del campo de la estadística y probabilidades, permiten

construir series sintéticas. Por esta propiedad, es posible aplicar los procesos estocásticos a
los datos hidrologicos, y a esta apicación se le llama hidrología estocástica 3.

Con la llegada de la computación, fue posible hacer los cálculos de la hidrología estocástica
rápidamente, mediante software4. Para el presente caso, se expone el uso del software SAMS.

SAMS es el acrónimo de la denominación, en palabras inglesas, Stochastic Analysis, Modeling,

and Simulation. SAMS es un programa informático, que tiene como objetivo «el análisis
estocástico, el modelado y la simulación de series de tiempo hidrológicas»5. Cabe hacer la

1 Cf. Linsey, Kohler, y Paulhus. Hidrología para ingenieros. p. 311.

2 Linsey, Kohler, y Paulhus. Hidrología para ingenieros. p. 311.
3 Cf. Ibíd. p. 311, 312.
4 Cf. Sveinsson, Salas, Lane, y Frevert. Stochastic Analysis, Modeling, and Simulation (SAMS) Version
2007 USER's MANUAL. Technical Report No. 11. Colorado State University. p. 3. El documento se
encuentra publicado en internet, y se puede obtener mediante el enlace siguiente:
http://projects-web.engr.colostate.edu/Sams-CSU-USBR/SAMS/Resources/SAMS2007_User_Manual.pdf
5 Cf. Id. p. 1.

1
observación de que SAMS no está construido para la predicción hidrológica, porque su objetivo
principal es la generación de datos sintéticos6.

El programa SAMS puede descargarse gratuitamente desde la página web de la Colorado

State University: http://www.sams.colostate.edu/download.html. El programa, una vez
descargado, aparece en pantalla haciendo doble clic al archivo SAMS 2007 cuya extensión es
.exe.

2 PROCEDIMIENTO PARA OBTENER UNA SERIE SINTÉTICA

Para producir una serie sintética debe considerarse una serie histórica dada. En lo siguiente se
expone un procedimiento para obtener los archivos que serán procesados por el programa
SAMS, tanto para el caso de un serie de datos de históricos anuales como para históricos
mensuales.

2.1 Configurar los registros históricos

Los registros de las series históricas deberán estar contenidos en un archivo de extenisión
«.dat», porque el programa SAMS importa archivos de extensión «.dat». Un archivo de
extensión «.dat» viene junto con el programa SAMS, y este puede editarse (o editarse copias)
con la serie histórica de interés; la edición puede realizarse con programas como wordpad ó
bloc de notas. En los siguientes numerales (2.1.1 y 2.1.2) se especifíca cómo han de editarse si
los datos de la serie son Mensuales o Anuales.

2.1.1 Mensuales

Al abrir un archivo de extensión «.dat» mediante bloc de notas, y al editar los registros de
interés se debe respetar el siguiente orden de declaraciones:
station
1 LIMA_X
2 LIMA_Y

tot_num_stats 2
Years 3
Seasonal 12

Station 1
Station_id LIMA_X
Duration 2001 2003
10.2 35.0 14.9 12.4 24.7 30.3 19.1 4.2 3.2 2.9 5.3 20.9
14.8 19.3 8.9 6.8 7.9 19.1 44.5 57.7 16.1 4.8 11.5 23.0
48.5 19.0 29.1 6.2 21.5 21.0 55.8 20.4 6.0 4.4 2.0 17.3

Station 2
Station_id LIMA_Y
Duration 2001 2003
6.6 27.8 13.5 11.7 23.3 29.2 18.3 8.3 1.1 0.4 3.5 14.4
12.3 19.2 8.5 7.9 7.1 22.4 45.8 52.0 14.2 3.6 8.9 18.4
39.2 25.3 28.5 5.8 20.9 22.1 54.3 21.5 4.4 0.5 0.2 10.9

Como se ve, se empieza escribiendo station, línea seguida abajo, se escribe la relación de
estaciones que serán consideradas; para nuestro ejemplo: LIMA_X y LIMA_Y (antes de cada
nombre de estación se debe especificar un número de identificación: 1, y 2).

6 Cf. Id. p. 2.

2
Pasando a un siguiente párrafo: se escribe tot_num_stats y seguidamente se escribe el número
de estaciones, en este caso 2 (LIMA_X y LIMA_Y), en la siguiente línea se escribe Years y
seguidamente el número de años que corresponde (en el presente caso 3); en la siguiente línea
se escribe Seasonal y seguidamente el número de ciclos, que para nuestro caso los ciclos son
meses del año (12).

En el siguiente párrafo se designa la estación que será desarrollada: Station 1, asimismo, en la

siguiente línea se designa el nombre de la estación escribiendo previamente Station_id,
seguida de la estación en particular: LIMA_X, linea abajo se escribe Duration se deja un espacio
y el intervalo de años, es decir se escribe el primer año y el último año de la serie histórica
(para este ejemplo 2001 2003; observar que los años están separados con un espacio).
Finalmente, linea seguida abajo, en el mismo párrafo se escriben la serie de datos históricos,
en orden: mes a mes registrados en grupos de doce, y para pasar de año se pasa a la línea
inferior.

Si hubiera una estación más (en este caso LIMA_Y), se sigue el mismo procedimiento descrito
para LIMA_X, pero en otro párrafo.

Evidentemente, los registros aquí mencionados ( LIMA_X y LIMA_Y) solo disponen de 3 años de
registros, y solo sirven para ejemplificar las operatividad del programa en este primer paso para
obtener una serie sintética.

Se sugiere trabajar el orden y configuración en hoja electrónica (por ejemplo excel) y luego
copiar y pegar el tipeo al archivo «.dat» que está siendo editado mediante un bloc de notas.

2.1.2 Anuales

La edición o configuración del archivo con extensión «.dat» debe seguir el siguiente formato:
station
1 AREQUIPA_M
2 AREQUIPA_N

tot_num_stats 2
Years 4
Annual

Station 1
Station_id AREQUIPA_M
Duration 1992 1995
183.1
234.4
251.2
156.2

Station 2
Station_id AREQUIPA_N
Duration 1992 1995
158.1
220.3
233.6
134.7

Notar que los dos primeros párrafos están destinados a declarar las propiedades del conjunto
de estaciones incluidoas en el archivo (también puede ser de una sola estación).

Primer párrafo: en la primera línea se escribe station, líneas abajo y por delante un número de
identificación en orden empezando con 1 se escriben las estaciones que serán incluidas en el
archivo.

3
Segundo párrafo: se escribe tot_num_stat y seguidamente dejando un espacio se escribe el
número de estaciones. Línea abajo se escribe Years y dejando un espacio se escribe el número
de años de la serie de datos históricos (en el ejemplo es 4). Línea abajo se escribe Annual.

Los siguientes párrafos se usan para especificar la serie de datos correspondientes a cada
estación. Así por ejemplo para la estación 1, se escrbe Station 1 en la fila debajo se escribe
Station_id y dejando un espacio en blanco se escribe el nombre de la estación
correspondiente (para el ejemplo AREQUIPA_M). Línea abajo se escribe Duration y dejando un
espacio en blanco se escribe el primera año de la serie histórica, y dejando otro espacio en
blanco, el último año de la serie histórica (para el ejemplo 1992 1995).

Se reitera que los registros aquí mencionados ( AREQUIPA_M y AREQUIPA_N) solo disponen de 4
años de registros, y solo sirven para ejemplificar las operatividad del programa.

De igual forma que para las series mensuales, se sugiere trabajar el orden y configuración en
hoja electrónica (por ejemplo excel) y luego copiar y pegar el tipeo al archivo «.dat» que está
siendo editado mediante un bloc de notas.

2.2 Importar una serie histórica

Al hacer doble clic en el archivo SAMS2007 (cuya extensión es .exe) aparece la pantalla
principal del programa (Fig. 1):
Fig. 1.

Figura 1: Pantalla Principal del Programa SAMS.

Desde la pantalla principal, al hacer clic en el íco nuevo (fig.2), se abre un proyecto nuevo.
Fig. 2

Fig. 2 Ícono de archivo nuevo.

4
La pantalla de SAMS queda del siguiente modo (Fig. 3):
Fig 3

Fig 3: pantalla de SAMS luego de dar clic en archivo nuevo

Luego dar clic en el menú File y dar clic en import Flow File (Fig. 4):

Fig. 4

Fig. 4

5
Se abre un cuadro de diálogo siguiente (Fig 5.), seleccionar la carpeta donde están ubicados
los archivos «.dat» de interés y luego seleccionar el archivo de las series históricas con las que
se trabajará.
Fig. 5

Fig. 5

En este caso se selecciona el archivo «yak-ann.dat», que es un conjunto de series anuales de

2 estaciones, con una longitud de registro de 48 años. Luego de dar clic en abrir; la pantalla de
SAMS queda del siguiente modo (Fig. 6):
Fig. 6

Fig. 6

6
2.3 Crear un archivo de SAMS

Al hacer clic en el ícono de guardar (el ícono de guardar aparece en la fig. 7):
Fig.7

Fig. 7

Aparace la siguiente ventana de diálogo (Fig. 8). Se selecciona la carpeta donde se guardará el
archivo de SAM (en nuestro caso será la carpeta “SAMS”) y el nombre de archivo que en este
caso le daremos es SAMS4, este archivo se creará con la extensión «.sam».
Fig. 8

Fig. 8

2.4 Obtener una serie sintética

Después de guardar el archivo, Se puede hacer clic en la siguiente secuencia: Fit Model,
Annual Data, Univariate, ARMA (p, q). Ver figura 9

Fig. 9

Fig. 9

7
Al final de dicha secuencia se obtiene el siguiente cuadro de diálogo (Fig.10)
Fig. 10

Fig. 10

Para seleccionar la stación, se hace clic en el botón Select Station(s) de este último cuadro de
diálogo (Fig. 11):
Fig. 11

Fig. 11

Luego aparece la siguiente ventana de diálogo (Fig. 12), se selecciona una estación en
particular, por ejemplo la estación 1. Se hace clic en Add y luego en Apply.

Fig. 12

Fig 12

8
Como siguiente paso, en la ventana previa, se da clic en Standarize data, opción: Yes. En el
orden del modelo AR se selecciona para este caso, 1, y en el orden de MA, 0 (Fig, 13).
Fig.13

Fig.13

Asimismo, hacemos clic en Method of Moments, y clic en Fit Model. Finalmente se hace clic en
Close.

La pantalla principal de SAMS queda establecida como sigue (Fig. 14):

Fig. 14

Fig.14

9
El siguiente paso con el objetivo de obtener las series sintéticca anual de esta serie de esta
estación es pasar al menú Generates series, luego, Generate Using Current Model (Fig. 15).

Fig. 15

Fig 15

Al dar clic a esta última opción se obtien el siguiente cuadro de diálogo (Fig. 16):

Fig. 16

Fig. 16

10
En esta última ventana se puede determinar la longitud de la Serie (Length of Series), y el
número de series (Number of Series), y el valor semilla (Initial Seed). Se dará los siguientes
valores (respectivamente): 50, 1, y 10. Asimismo, en la casilla de Guardar (Save) se dará clic
en ambos cuadros (Save Generated y Save Statistics of all Generated Data).

Al dar clic en estas dos casillas, aparecen correspondientemente las siguientes ventanas (Fig.
17 y Fig. 18):
Fig. 17

Fig. 17

Fig. 18

Fig. 18

Efectivamente, al verificar los archivos stat_1a.txt y ann_1.txt (Fig. 19 y Fig. 20), los parámetros
estadísticos y la serie sintética se encuentra generada en estos archivos.
Fig. 19

Fig. 19

11
 Fig. 20

Fig. 20

Los siguientes datos son los obtenidos en los mencionados archivos:

% SAMS4.sam
% Station 1 : KEECHELUS_RESERVOIR
% Statistics of Generated Annual Data
% Number of Traces : 1
% Length of Trace : 50
% Starting Seed : 10
%
% Format
%Nr. 1
MEAN 247.027
STDEV 56.0755
SKEW -0.193294
MIN 96.9211
MAX 361.844
ACF(1) 0.0954573
ACF(2) -0.117836
ACF(3) 0.138994
ACF(4) 0.184469
ACF(5) -0.0256825
DEMAND_LEVEL 242.931
LONGEST_DROUGHT 6
MAX_DEFICIT 322.573
LONGEST_SURPLUS 12
MAX_SURPLUS 490.768
STORAGE_CAPACITY 338.202
RESCALED_RANGE 8.7027
HURST_K 0.67217

12
La Serie sintética es la siguiente (en orden podemos observar el nombre del archivo, la
estación y su nombre, el tipo de datos -Anuales-, el numero de trazos -1- y la longitud de trazo
-50-, asimismo, el valor semilla de partida -10-):

% SAMS4.sam
% Station 1 : KEECHELUS_RESERVOIR
% Generated Annual Data
% Number of Traces : 1
% Length of Trace : 50
% Starting Seed : 10
% Trace #1
96.9211
293.308
286.165
279.701
187.912
176.729
224.197
166.751
171.775
207.65
318.138
261.837
180.525
301.924
303.865
246.748
319.699
262.261
244.646
247.58
274.752
324.536
311.229
303.301
265.401
226.962
294.059
163.026
258.231
272.996
183.907
194.435
202.287
237.43
183.465
214.079
361.844
205.578
225.174
315.238
269.172
192.749
196.869
279.009
295.466
179.682
264.115
286.326
353.023
238.666

13
El programa SAMS también permite observar la serie sintética de manera gráfica, mediante la
opción Generate Series, y la secuencia: Compare, y Statics (Fig. 21):
Fig 21

Fig. 21

Al dar clic en Statics, aparece la siguiente ventana de diáligo (Fig. 22):

Fig. 22

Fig. 22

Al seleccionar la opción Time Series, de la última ventana de diálogo, y al dar clic en SHOW.
Da como resultado la gráfica de comparación entre la serie histórica y la serie sintética (Fig 23):
Fig. 23

Fig. 23

14
SAMS también da la opción de insertar una grilla y copiar la imagen como un mapa de Bits,
cuando se seleccionar Plot Properties, Copy To Clipboard, As Bitmap (Imagen 24):
Imagen 24

Imagen 24

El resultado es una imagen como la que se muestra a continuación (Imagen 25):

Imagen 25

Imagen 25

15