Conjunto de programas para la simulación de escenarios económicos para ser
ejecutados por línea de comandos.

1- Índice de este archivo:

  1- Índice                                       - Linea 4.
  2- Dependencias                                 - Línea 14.
  3- Códigos fuentes de los programas principales - Línea 23.
  4- Compilación                                  - Línea 38.
  5- Ejecución                                    - Línea 50.
  6- Generación de gráficos                       - Línea 85.
  7- Añadir módulo Python en el sistema MIV       - Línea 91.

2- Dependencias para compilación:
- Biblioteca Aleph-w versión 1.2b.
- Biblioteca nana V2.5-12
- GSL
- GMP
- libpq5
- libxml++2.6-2


3- Códigos fuentes de los programas principales:

graph_builder.C: contiene el código fuente del programa que lee un archivo xml
                 con las raíces de la red productiva deseada para construir el
                 grafo.

simulator.C: contiene el código fuente del programa que permite ejecutar la
             simulación de los escenarios dados (incremento y decremento de
             producción).

svg_sigesic_builder.C: contiene el código fuente con la implementación de una
                       función que recibe parámetros para hacer la construcción
                       de una red productiva. Esta función fue creada con la
                       finalidad de hacer un "binding" para python.

4- Compilación:

Para compilar a cada uno de los programas se ejecutan los siguientes comandos:
  - make gb: compila graph_builder.C generando el ejecutable graph_builder.
  - make sim: compila simulator.C generando el ejecutable simulator.
  - make python: compila svg_sigesic_builder.C generando el módulo para python
                 _svg_sigesic_builder.so.
  - make all: compila todos los programas.
  - make clean: elimina archivos de compilación y respaldo tales como .o y ~.
  - make clean-all ejecuta un clean y además elimina todos los archivos con
                   extensión .svg y los ejecutables.

5- Ejecución

Para construir un grafo a partir de las raíces se ejecuta graph_builder con
el comando:
./graph_builder xml_roots_file_name xml_output_file_name dot_output_file_name
                db_server_info_file_name

Donde xml_roots_file_name: es el archivo xml que contiene las raíces de la red.
      xml_output_file_name: es el nombre del archivo de salida en el que el
                            programa escribirá el grafo construido.
      dot_output_file_name: es el nombre del archivo dot para generar la imagen
                            del grafo que va a escribir el programa.
      db_server_info_file_name: Archivo con la información del servidor de base
                                de datos al cual se debe conectar el programa
                                para construir el grafo. El archivo es opcional,
                                por omisión usará un archivo llamado dbserver.

Para ejecutar una simulación se ejecuta el siguiente comando:
./simulator xml_input_file_name xml_output_file_name dot_output_file_name
            db_server_info_file_name

Donde xml_input_file_name: es el archivo xml que contiene el grafo original con
                           los parámetros de simulación.
      xml_output_file_name: es el nombre del archivo de salida en el que el
                            programa escribirá el grafo alterado por la
                            simulación.
      dot_output_file_name: es el nombre del archivo dot para generar la imagen
                            del grafo alterado que va a escribir el programa.
      db_server_info_file_name: Archivo con la información del servidor de base
                                de datos al cual se debe conectar el programa
                                para buscar sugerencias de productores en el
                                caso de la simulación de incremento de
                                producción. El archivo es opcional,
                                por omisión usará un archivo llamado dbserver.

6- Generación de gráficos:

Para generar un gráfico a partir de un dot se ejecuta el comando:
dot -T(formato) archivo.dot -o archivo.formato
donde formato puede ser: svg, png, pdf, etc.

7- Añadir módulo Python en el sistema MIV
Para agregar el módulo python al sistema MIV deben tomarse los archivos
svg_sigesic_builder.py y _svg_sigesic_builder.so y ubicarlos en el directorio
extapps/chains del sistema.

Cualquier duda o sugerencia al autor de este archivo:

Alejandro J. Mujica - amujica en cenditel punto gob punto ve