# El gestor de extensiones de SEXTANTE

# Introducción

El gestor de extensiones es el elemento principal de la interfaz gráfica de usuario para el control de las extensiones, y uno de los mas usados en el trabajo diario. Este gestor muestra todos los algoritmos disponibles de análisis geográfico agrupados en bloques (de acuerdo con el tipo de análisis que se lleven a cabo)para así facilitar su empleo y manejo. Desde el gestor de algoritmos puede ejecutarse una extensión o un proceso por lotes basado en un algoritmo.

Dependiendo de los datos a utilizar en el SIG, se podrá o no ejecutar un determinado algoritmo. Cuando hay suficientes datos para que el algoritmo pueda ser ejecutado, el nombre es mostrado en negro. De lo contrario, es mostrado en gris.

La parte inferior del gestor de extensiones presenta un cuadro de texto para poder buscar una determinada extensión con el botón Buscar. Para reducir el número de algoritmos mostrados en el gestor y hacer más fácil la búsqueda de la extensión que se quiere ejecutar, se debe escribir cualquier palabra o frase en el cuadro de texto y hacer clic en el botón de búsqueda. SEXTANTE buscará los ficheros de ayuda asociados a cada algoritmo y mostrará sólo aquellos algoritmos que incluyen la palabra o frase en sus correspondientes ficheros de ayuda. Para mostrar todas las extensiones de nuevo en el gestor, basta hacer una búsqueda con una cadena de texto vacía.

También encontrarás un botón para acceder al diálogo de configuración de SEXTANTE, en el cual podrás ajustar los valores de algunos parámetros del programa.

El significado de estos parámetros lo iremos viendo a lo largo de las siguientes secciones, según corresponda.

Para ejecutar un algoritmo, haz doble clic en el nombre del mismo.

# El cuadro de diálogo del algoritmo

Si en el gestor de extensiones se hace doble clic sobre el nombre de una extensión aparece la ventana de ejecución del algoritmo correspondiente, similar siempre en su diseño a la mostrada a continuación (en este caso, se trata de la ventana de la extensión Coste acumulado anisotrópico).

Este dialogo muestra una colección de los valores de entrada que necesita el algoritmo para ser ejecutado con éxito.

Por una parte, encontramos una pestaña principal, denominada Parámetros, en la que debemos seleccionar los datos de entrada de la extensión antes de que ésta efectúe los análisis pertinentes. Los parámetros aparecen todos ellos en filas, mostrándose en el lado izquierdo el nombre del parámetro en cuestión, y en el derecho el valor asignado al mismo.

En algunas extensiones encontraremos una pestaña con estructura fija denominada Salida raster. Esta pestaña aparece en aquellas extensiones que generan como resultado alguna capa raster, y permite al usuario especificar la extensión y el tamaño de celda que desee para dicho resultado.

Además, en la ventana de ejecución de cada extensión encontraremos siempre el botón de ayuda contextual que nos muestra la información disponible relativa a la extensión, de cara a poder sacar a ésta el mayor provecho posible. En ella se explica con detalle el análisis desarrollado por la extensión, así como el significado de cada uno de los parámetros de entrada.

Veamos, a continuación, con más detalle el contenido de estas dos pestañas y el botón de ayuda contextual.

## La pestaña Parámetros

El número de parámetros depende, como es lógico, de la extensión en sí y sus requerimientos, pero la estructura es similar en todos los casos. Estos parámetros pueden ser de alguno de los siguientes tipos:

- Una capa raster, a seleccionar de entre todas las disponibles en la aplicación SIG que se este usando.
- Una capa vectorial, a seleccionar de entre todas las disponibles en la aplicación SIG que se este usando.
- Una tabla, a seleccionar de entre todas las incluidas en la aplicación SIG que se este usando.
- Un método o función, a seleccionar de entre los que se proponen para el parámetro en cuestión.
- Un valor numérico, a introducir en una caja de texto.
- Una cadena de texto.
- Un campo, a elegir de entre los contenidos en la tabla de atributos de una capa vectorial seleccionada en otro parámetro de la extensión, o bien de una tabla aislada seleccionada igualmente en otro parámetro.
- Una banda, a elegir de entre las contenidas en una capa raster seleccionada en otro parámetro de la extensión. Tanto en éste como en el anterior parámetro, las opciones entre las cuales elegir varían en función de cuál sea el valor asignado al parámetro del que dependen.
- Una lista de elementos, que pueden ser capas raster, bandas de capas raster, capas vectoriales o tablas, a elegir de entre todos los disponibles en la aplicación SIG que se este usando. En este caso, el valor del parámetro en el lado derecho presenta un botón, que al ser pulsado muestra la ventana con todos los elementos entre los cuales elegir. A continuación puede verse un ejemplo para la selección de una serie de capas raster y la ventana que se muestra al hacer clic sobre el botón asociado.
- Un archivo o un directorio de disco.
- Un punto de la vista, especificando sus coordenadas (coordenadas X e Y). También puede hacerse clic sobre el botón situado a la derecha de las cajas de texto y seleccionar alguno de los puntos capturados mediante el capturador de coordenadas. Esta es una herramienta adicional que encontrarás junto a las demás herramientas de SEXTANTE, y que te permite capturar las coordenadas de un punto sobre un mapa. Simplemente selecciónala, haz clic sobre un mapa o vista de tu SIG, y las coordenadas del punto sobre el que has pinchado quedaran almacenadas
- Una tabla a editar por el usuario. Esto es útil para casos en los que se necesite información tabular tales como núcleos de filtrado o tablas de asignación, entre otros. En la siguiente figura puedes ver un ejemplo.

  Dependiendo del algoritmo, pueden añadirse o eliminarse nuevas filas, mientras que en otros el número de éstas es fijo.

Si has ejecutado alguna otra vez este mismo algoritmo (bien durante esta sesión de trabajo o en una anterior), encontrarás en la parte inferior un nuevo componente.

Haciendo clic en los botones a derecha e izquierda, puedes recuperar automáticamente los valores asignados a los parámetros del algoritmo en esas ejecuciones anteriores, haciendo así mas fácil rellenar los campos necesarios. Por defecto, la ventana se rellena con los valores de la ultima ejecución. No solo se cambian los valores de la pestaña de parámetros, sino también los de la pestaña de salida raster utilizados en dicha ejecución. A continuación veremos el significado de los campos de esa pestaña.

## La pestaña Salida raster

La pestaña Salida raster aparece en aquellas extensiones que generan como resultado alguna capa raster, y permite al usuario especificar la extensión y el tamaño de celda que desee para dicho resultado.

A diferencia de la mayoría de los SIG donde es obligatorio que las capas de entrada tengan el mismo tamaño de celda y extensión para el análisis, en SEXTANTE las capas no tienen que tener necesariamente unas mismas características. Las características de la capa de salida se definen en esta pestaña y SEXTANTE realiza el correspondiente remuestreo y genera una capa acorde con lo especificado

Por supuesto, es deber del usuario no hacer mal uso de esta funcionalidad y aplicar unos ciertos conocimientos cartográficos a fin de evitar resultados muy «aparentes» pero carentes por completo de sentido y rigurosidad (por ejemplo, se puede seleccionar un tamaño pequeño de celda para una capa raster resultante, pero si las capas de entrada que se han usado no tienen una buena resolución el resultado no será geográficamente riguroso).

La pestaña Salida raster presenta las siguientes opciones:

- Ajustar a datos de entrada. Se puede dar un ajuste automático, que es el establecido por defecto, que garantiza un resultado coherente con la práctica cartográfica, y que es realizado por la extensión en función de los datos de entrada.

- Definida por el usuario. Se puede introducir manualmente un conjunto de coordenadas y un tamaño de celda. Esta opción es útil en diferentes supuestos. Por ejemplo, con un MDE de una provincia, con un tamaño de celda de 25 m, se quiere generar una nueva capa con la pendiente de tan solo un municipio, no de toda la provincia, y que además el tamaño de celda sea de 50 m.

- Utilizar extensión de la vista. Dependiendo de la aplicación SIG que se este usando, esta opción permite tomar los valores de extensión de la capa resultante de una de las vistas existentes.

- Utilizar extensión de otra capa. La extensión de una capa puede ser definida según las características de otra capa, incluso si la capa no es usada como capa de entrada en el algoritmo. Si la capa seleccionada es vectorial, el tamaño de celda tendrá que escribir manualmente (ya que las capas vectoriales no tiene asociado un tamaño de celda)

En caso de no optar por el ajuste automático, el único control que se realiza es comprobar que la capa a crear no tiene un tamaño excesivo que pueda ser producto de un error en la introducción de coordenadas o tamaño de celda. En caso de que la capa sea muy voluminosa, se mostrará al usuario un cuadro de diálogo como el siguiente, para que confirme que efectivamente ésa es la capa que desea crear.

Aunque esta pestaña tiene una forma fija, admite en ocasiones una pequeña modificación: en aquellos módulos que producen resultados en formato raster pero no toman ninguna capa raster como entrada, no es posible realizar el ajuste automático, por lo que esta opción no existe. En tal caso, es obligatorio ir a esta pestaña y especificar las características de salida raster deseadas.

## Objetos de datos generados por los algoritmos de SEXTANTE

Los algoritmos de SEXTANTE generan los siguientes tipos de objetos de salida:

- Una capa raster.
- Una capa vectorial.
- Una tabla.
- Un resultado gráfico (curva, diagrama de barras, etc.).
- Un resultado en texto en formato HTML.

Las capas y tablas pueden ser salvados como un fichero permanente en disco, donde debe introducirse, en el cuadro de texto, la ruta donde se guardará el archivo, o seleccionarla haciendo clic en el botón a su derecha y empleando el cuadro de diálogo que aparece. Si no escribes nada en la ruta del fichero se usará un fichero temporal.

Los formatos de los datos de salida depende de la aplicación SIG en la que SEXTANTE se esta ejecutando. A continuación se cita una lista de algunos de los formatos soportados hasta la fecha:

- gvSIG: shp, dxf, tif, asc
- OpenJUMP: shp, tif
- uDig: shp, tif

Para seleccionar un formato determinado, elegir la extensión del fichero correspondiente. El formato se establece automáticamente en función de la extensión del fichero.

Se puede seleccionar en la ventana de configuración (recuerda que puedes acceder a ella mediante el botón en la parte inferior derecha del gestor de extensiones) una carpeta por defecto para resultados. Si introduces un nombre de fichero sin ruta (por ejemplo `salida.shp`, ese resultado se almacenara con ese nombre en la carpeta por defecto. Busca en el apartado ``Carpetas'' dentro de la ventana de configuración y encontraras una caja de texto donde poder establecer la ruta por defecto para resultados.

Otro ajuste que puedes hacer relativo a los resultados de tipo capa o tabla es la corrección automática de nombres. Encontrarás un check box en la la pestaña ``General''. Si lo activas, SEXTANTE sustituirá automáticamente todos los caracteres no estándar (vocales acentuadas, corchetes, paréntesis, eñes...) que aparezcan en los nombres de los objetos resultantes de ejecutar un algoritmo. Esto te evitará muchos problemas si después quieres emplear esos objetos en otros algoritmos como la calculadora de mapas o, especialmente, si trabajas con la interfaz en línea de comandos.

Ademas de capas y tablas, SEXTANTE puede generar tambien resultados gráficos y de texto. Ésts son almacenados en memoria y se muestran al terminar la ejecución del algoritmo en una nueva ventana, denominada Resultados. Este ventana almacena los resultados de los algoritmos ejecutados en la sesión actual y puede mostrarse en cualquier momento usando el botón Resultados. Los resultados gráficos pueden guardarse como una imagen en formato `.png`, y los textos como ficheros `.HTML`. Para ello, hay que hacer clic en el botón derecho del ratón y seleccionar la opción Guardar elemento.

# Ayuda contextual

Cada algoritmo de SEXTANTE tiene su correspondiente ayuda contextual, con objeto de que todo usuario pueda extraer de cada módulo el mayor provecho posible. Para ver la ayuda contextual de una extensión, debe hacerse clic en el botón de ayuda que se encuentra en la parte inferior de la ventana de ejecución del algoritmo.

Fundamentalmente, se describe lo que hace el algoritmo, los parámetros de entrada que se necesitan y la salida de información geográfica, alfanumérica o textos y gráficas que éste genera. Pero la ventana de ayuda contextual no sólo contiene información de cada algoritmo, sino también de cada elemento de la interfaz gráfica de usuario de SEXTANTE. Se puede ver esta información en la parte superior izquierda del árbol de navegación.

Los ficheros de ayuda asociados a cada algoritmo son almacenados como ficheros XML y pueden ser editados usando el gestor de ayuda contextual. Para ello, haz clic con el botón derecho en el nombre del algoritmo en la ventana de la ayuda contextual y selecciona la opción Editar ayuda.

La ventana de edición de ayuda está estructurada en dos paneles. En el panel de la izquierda encontramos una lista con todos los parámetros necesarios para documentar una determinada extensión: información, parámetros de entrada y salidas que genera la extensión. En el panel de la derecha podemos escribir el contenido de la ayuda contextual y añadir imágenes si se considera oportuno.