Programa para el cálculo de los ángulos asociados a la geometría de iluminación y observación de la escena SAC-C MMRS

...

programa angulos.exe es un programa para ejecución en línea de comandos. Es el que realiza los cálculos y genera el archivo de salida con los resultados. El otro programa, angulosgui es la interfaz gráfica para el programa anterior, permite la selección del archivo de entrada y de salida.

IMPORTANTE: actualmente la interfaz gráfica (angulosgui) es un programa en versión preliminar (beta). Para su correcto funcionamiento requiere las librerías gráficas QT (el KDE las incluye). Por este motivo no se asegura su correcto funcionamiento en cualquier máquina. Esto no es un gran inconveniente, ya que este programa no es indispensable para el funcionamiento del programa para el cálculo de ángulos (angulos.exe). Cuando esté disponible la versión definitiva, será puesta en la página de descarga de los programas.

4 Uso y formas de operación

4.1 Consideraciones generales

El programa consta de dos archivos ejecutables: angulos.exe es una aplicación ejecutable desde la línea de comandos que realiza el cálculo de ángulos. angulosgui.exe (windows) o angulosgui (linux) es una aplicación que se ejecuta desde el entorno gráfico y tiene la función de brindar una interfaz gráfica para el programa.

4.2 Windows

4.2.1 Ejecución del programa desde línea de comandos

Para ello es necesario abrir una terminal (o ventana de DOS). Luego se debe cambiar al directorio en el que fue copiado el programa, en nuestro ejemplo C:\AngulosMMRS\, como se muestra en la siguiente figura:

Antes de correr el programa se debe copiar el archivo con los datos de entrada, que generalmente será el archivo egeo_loc.txt contenido en el CD de distribución de imágenes SAC-C MMRS, en un directorio del disco local. Se recomienda utilizar el mismo directorio en el que está instalado el programa. Esto es necesario ya que el programa, durante su ejecución, genera archivos temporales en el mismo directorio en que se encuentra el archivo de entrada, si el mismo estuviera en el CD-ROM el programa no podría ejecutarse correctamente.

Para correr el programa basta con ejecutar el siguiente comando:

C:\AngulosMMRS\angulos.exe

o lo que es equivalente desde el directorio de trabajo (en el que está instalado el programa) se ejecuta el comando:

angulos.exe

o directamente

angulos (sin incluir la extensión .exe)

De esta forma comienza a correr el programa, mostrando al usuario el progreso de la ejecución en la terminal.

Esta forma de ejecutar el programa es la forma por defecto, es decir que el programa utiliza parámetros por defecto para su ejecución.

Existe otra forma, que es la forma personalizada, en la cual es posible indicarle al programa ciertos parámetros. Las posibilidades son:

angulos.exe [-h] [-i archivo_entrada] [-o archivo_salida]

Los corchetes [] indican que los argumentos son opcionales.

-h indica al programa que muestre en la terminal un texto de ayuda. Es una ayuda elemental que contiene esta misma descripción.

-i archivo_entrada especifica el nombre del archivo con los datos de entrada. Por defecto este archivo es egeo_loc.txt.

-o archivo_salida especifica el nombre de archivo en el que se guardarán los datos calculados. Por defecto este archivo es egeo_loc_ang.txt.

De esta forma con el marcador –i es posible indicarle al programa un nombre de archivo de entrada diferente, además puede estar ubicado en un directorio diferente. De manera similar, con el marcador –o se le indica un nombre (y directorio) diferente para el archivo de salida.

A continuación se muestra un ejemplo de ejecución del programa:

al finalizar la ejecución se verá en la terminal un mensaje como el siguiente:

Luego en el directorio de trabajo, que en nuestro ejemplo es C:\AngulosMMRS\, se encontrará el archivo salida.txt, el cual contiene los ángulos correspondientes a cada uno de los puntos del archivo egeo_loc.txt.

Descripción de la geometría del sensor:

http://ggt.conae.gov.ar/sac_c/geometria.htm

Descripción del formato de egeo_loc.txt en:

http://ggt.conae.gov.ar/sac_c/f-egeoloc.htm

4.2.2 Ejecución del programa desde la interfaz gráfica

La interfaz gráfica permite una interacción más “amigable” con el programa. Para ejecutarla existen dos posibilidades, una es desde la terminal, corriendo el comando C:\AngulosMMRS\angulosgui.exe (o solamente angulosgui.exe desde el mismo directorio de trabajo), y la otra es haciendo doble clic con el botón del mouse sobre el ícono del programa desde una ventana del Explorador de Windows abierta en el directorio de instalación.

Al ejecutarse, se desplegará una ventana como la siguiente:

a través de la cual es posible elegir la ubicación y el nombre de los archivos de entrada y salida para el programa de cálculo de ángulos. Nuevamente, si no se le especifica ningún nombre al programa (dejando los parámetros de la ventana tal como aparecen), éste utilizará los parámetros por defecto.

Si se opta por seleccionar otra ubicación para los archivos de entrada y salida, al presionar el botón se abre un cuadro de diálogo donde se puede navegar para elegir el archivo de entrada:

De la misma forma para el archivo de salida, presionando se puede elegir la ubicación y el nombre del mismo:

Una vez realizada la elección