Public documents
- Project sheet
- Usuario
- Desarrollador
- Versiones
Project sheet
Project identifier:
gvsig-educa
Project title :
Aplicación gvSIG con fines educativos.
Project short description
gvSIG Educa es una personalización de gvSIG Desktop con fines educativos. Esta versión de gvSIG se desarrolla para ser incluida en las XO, computadoras entregadas a niños y adolescentes que forman parte del programa OLPC.
Incluye un módulo para el diseño flexible de juegos mediante los cuales se podrá aprender geografía, y un módulo de ejecución de los mismos. La configuración de cada juego se hace a través de un wizard en donde el maestro o profesor puede configurar parámetros con la cartografía a utilizar, las preguntas a hacer, las opciones de acierto u error, etc. También incluye un procedimiento para la importación/exportación de juegos, de forma que facilite su intercambio y reaprovechamiento.
License
GPL v2.
Sources
Task Manager
Usuario
Mapas temáticos
Introducción
Warning
Fill with a little introduccion of the project
Requerimientos
Warning
Fill with a list of functional requeriments of this proyects
Instalación
Warning
Fill with the installation instruction of the project
Instrucciones
Warning
Fill with the project instrucctions of use.
Creditos
Warning
Fill with the credits to include in the manual
Juegos y ejercicios
Introducción
Warning
Fill with a little introduccion of the project
Requerimientos
Warning
Fill with a list of functional requeriments of this proyects
Instalación
Warning
Fill with the installation instruction of the project
Instrucciones
Warning
Fill with the project instrucctions of use.
Creditos
Warning
Fill with the credits to include in the manual
Desarrollador
Introduction
Warning
Fill with a description of the development organization
Análisis funcional
Requisitos funcionales
Company: | DiSiD Technologies S.L. |
---|---|
Author: | Cèsar Ordiñana |
Copyright: | 2011 (C) Asociación gvSIG |
Introducción
Este documento recoge propuesta de requisitos para el proyecto gvSIG Educa
Definición de requisitos
Conjunto de cartografía, leyendas y simbología contenida en un único fichero autocontenido, de modo que sea fácil compartir entre distintas instalaciones.
Se compondrá de dos partes:
Note
Prioridad ALTA
Permitirá realizar la visualización de mapas temáticos por parte del usuario. Seleccionando uno de los previamente instalados, se abrirá automáticamente una vista especial con el mapa temático seleccionado.
La instalación se realizará a través del gestor de complementos de gvSIG, por lo que podrán ser descargados desde Internet, así como distribuidos junto con el propio instalable de la aplicación, de forma similar a como se hace con los plugins en gvSIG 2.0.
Actualmente el gestor de complementos sólo soporta un único enlace de descarga de complementos a través de Internet. Dado que los mapas temáticos estarán muy centrados en una zona geográfica (país o continente), será conveniente añadir como funcionalidad adicional el soporte para varios enlaces de descarga.
Esto permitirá, por ejemplo en el caso de Batoví, que mantengan su propio repositorio de mapas temáticos descargables a través de Internet. Hay que tener en cuenta que, en realidad, el repositorio sólo es necesario que albergue el índice de complementos disponibles, pudiendo estar albergados éstos en distintos servidores. Por ejemplo, distintas entidades podrían participar creando mapas temáticos y distribuyéndolos a través de sus propios servidores, pero siendo responsabilidad del proyecto Batoví el mantener el índice general de todos los mapas disponibles.
Los mapas temáticos se instalarán en forma de archivo comprimido, de forma que el visualizador, cuando lo necesite, desplegará en un directorio temporal el mapa temático para que esté accesible en ejecución. De esta forma los datos originales del mapa temático siempre sean los mismos, sin que les afecte posibles cambios que pudiera realizar el usuario mediante el resto de herramientas de gvSIG u otras herramientas SIG.
La visualización se realizará, salvo que se contemple otra opción más adecuada, como un nuevo tipo de documento en gvSIG. El usuario podrá elegir, de la lista de mapas temáticos previamente instalados, cuál desea visualizar. Esto abrirá automáticamente dicho mapa como un nuevo documento con su vista y simbología correspondientes.
La visualización de los mapas temáticos ofrecerá algunas de las herramientas disponibles en una vista normal de gvSIG, sin permitir edición. Queda por definir cuáles de dichas herramientas se mostrarán u ocultarán al usuario.
El visualizador deberá permitir a los estudiantes salvar su trabajo en cualquier momento y continuar en la siguiente sesión. Eso permitirá que paren cuando suene el timbre del recreo, y continuar a la clase siguiente desde donde quedaron. Esto permitirá también realizar actividades que requieran un trabajo previo de campo con gvSIG y uno posterior en el aula.
Note
Prioridad ALTA
Mantendrá la definición de los mapas temáticos como un documento más del proyecto. Esto permitirá la generación y regeneración de los mapas de forma sencilla.
La creación de un nuevo mapa temático se realizará importando el estado de una vista ya existente, cargado sus capas y configuración directamente.
El editor permitirá definir las opciones de exportación como:
- Extensión límite de los datos a exportar: podremos limitar los datos que se incluirán a un subconjunto de datos limitados por un recuadro.
- Filtro de datos de cada capa: Podremos limitar los datos que se incluirá por cada capa dependiendo de un filtro basado en sus datos.
El editor debería almacenar toda esta información como metadatos (rutas de origen de archivos, capa original, parámetros de fuentes de datos) de forma que se puede volver a generar el fichero final de la misma forma en cada generación/compilación.
Finalmente el editor tendrá una opción de generará/compilará el fichero final.
El fichero generado/compilado será:
- Fichero comprimido (zip) con extructura de directorios predefinida.
- Contendrá un XML principal con la descriptición y detalles de el mapa temático.
- Los datos cartográficos originales en formato de archivo serán incluidos tal cuál en dicho fichero comprimido. Por simplificar podemos limitar el tipo de datos soportados a archivo. En posteriores versiones se puede añadir el soporte para orígenes de datos remotos (base de datos, WFS, WMS, etc.) que deberán ser exportados a un formato en archivo a definir. También se puede contemplar la opción de ser incluidos tal cuál, indicando al usuario del mapa temático de alguna forma que necesitará acceso a los servicios incluidos.
- Se admitirán también datos raster, aunque habrá que estudiar posibles limitaciones de formatos a soportar, ya que actualmente la carga de datos raster recae en librerías nativas, y habrá que ver si están disponibles en las distribuciones a preparar.
- Los recursos serán adjuntados en directorio predefinido.
- Se podrá instalar como un addon en gvSIG.
Como funcionalidad adicional, el gestor de mapas temáticos proporcionará una opción que permita convertir un mapa temático en un documento vista normal de gvSIG, lo que permitirá su edición y regeneración posterior como mapa temático. Así cualquiera podrá actualizar y generar nuevas versiones de un mapa temático.
Los juegos o ejercicios se tratarán como un caso particular de mapa temático, ya que necesitan una cartografía sobre la que funcionar. De esta forma, les aplica como base todo lo comentado anteriormente, siendo considerados como mapas temático con funcionalidad.
Algunos tipos de juegos o ejercicios a soportar serán:
Localización de topónimos por selección de formas geográficas: al alumno se le dice que seleccione una geometría a partir de alguno de sus datos relacionados. Dicho dato podrá ser textual (ej: un nombre), una imagen (ej: una bandera de un departamente, un escudo de un municipio, una imagen de una zona característica de una ciudad, etc.). Para este último caso se empleará en lo posible la funcionalidad existente en gvSIG del hipervínculo.
La geometría podrá ser puntual (ej: un punto de interés), una línea (ej: un río) o un polígono (un municipio).
Note
Prioridad ALTA
- El inverso del anterior, es decir, seleccionando una geometría del mapa temático, el alumno deberá indicar algún dato significativo, como por ejemplo el nombre.
Note
Prioridad MEDIA
- Al alumno se le indica que tiene que poner en la posición correcta una determinada geometría (línea o polígono). Para ello tendrá un mapa guía de fondo a un nivel de detalle menor que el que se le pide que localice (por ejemplo, se le propone que localice departamentos y se le proporciona el contorno de Uruguay solamente). Para este juego podría ser interesante tener niveles de dificultad gracias a poder rotar, escalar y trasladar las formas geométricas a localizar.
Note
Prioridad BAJA
- El alumno será capaz de marcar en la vista geográfica un punto objetivo a alcanzar mediante la guía de la posición que provea un GPS externo a su computadora. Con ese punto definido en la vista, y la traza del GPS conectado a gvSIG el alumno será capaz de llegar a la posición del punto objetivo. El caso más típico de juego es el de la búsqueda de un tesoro.
Note
Prioridad BAJA. Para esto los dispositivos XO necesitan incorporar antena GPS o soporte bluetooth para poder emplear antenas GPS externas, además de tener soporte para el demonio gpsd.
- Ejercicios de edición de hipervínculos: por ej. poder tomar una foto o un video (las XO lo permiten) y vincularlo a un mapa, ubicándolo en la posición (geográfica) que corresponda.
Note
Prioridad BAJA.
El soporte a juegos y ejercicios en gvSIG se compondrá a su vez de dos partes:
Permitirá elegir el juego a poner en marcha de la lista de los juegos instalados previamente. Los juegos, al igual que los mapas temáticos, se podrán instalar a través del gestor de complementos de gvSIG.
Una vez seleccionado el juego, se abrirá automáticamente una vista especial con el mapa temático del juego y se iniciarán las preguntas correspondientes.
Note
Priodidad ALTA
Para incentivar al alumno de cara a la realización de nuevos intentos, se dará la posibilidad de guardar los resultados de cada ejercicio, con la puntuación obtenida, el nombre del jugador, etc.
Note
Prioridad BAJA
Al igual que en el caso de los mapas temáticos, los juegos también podrán guardarse para poder continuar en una sesión posterior.
Note
Prioridad ALTA
La creación de un juego se realizará de forma similar a la creación de un mapa temático, incluyendo además una serie de parámetros adicionales a definir por los maestros y profesores como:
- Pregunta a realizar.
- Cantidad de selecciones hasta acertar.
- Posibles respuestas cuando el alumno acierta. (A DEFINIR)
- Posibles respuestas cuando el alumno falla. (A DEFINIR)
- Colores de pintado de geometrías en aciertos y en fallos.
- Etc.
Queda por definir a nivel técnico un mecanismo general que permita realizar de forma sencilla distintos tipos de ejercicios y juegos, a ser posible que permita crear más tipos de juegos que los planteados.
También queda por definir cómo se realizarán las preguntas al alumno.
Hay que intentar evitar que el alumno automatice las respuestas. Por ej. si un ejercio sea ubicar Brasil, la primera vez tendrá que usar los conocimientos que aprendió pero a la segunda ya habrá aprendido la respuesta y lo hará automáticamente; es lo que sucede en aplicaciones del tipo http://reachtheworld.org/geogames/index.html). Para ello, en la definición del juego se podrá configurar una opción que haga que el dato sobre el que se realiza la pregunta sea aleatorio dentro del conjunto de datos seleccionados. Por ejemplo, si el alumno tiene que ubicar 5 países, que en cada ejecución del ejercicio aparezcan 5 países aleatoriamente.
Otro tema a tener en cuenta es el manejo del tiempo en el desarrollo de las actividades. Las mismas no deben ser muy complejas y/o extensas ya que un docente que tiene como máximo 80 min. de clase (siempre y cuando no descontemos minutos por las llegadas tarde, el pasado de la lista, acomodarse en los bancos, posibles recreos en el medio del módulo, etc) debe en esos minutos redondear una actividad o al menos dejar plasmado un contenido central en la misma, y actividades para seguir luego, ya sea en el transcurso de otra clase (la cual puede ser en algunos casos, dentro de 7 días) o como tarea domiciliaria. Para ello en la configuración del juego se podrán definir el nº de aciertos o elementos sobre los que trabajar, de forma que se puedan ajustar a una duración determinada a criterio del diseñador del juego. Además estará la opción de guardar el estado de un juego o ejercicio para poder continuar en otro momento.
Note
Prioridad BAJA
La geografía tiene mucho de toponimia y memorización que se debe trabajar y la parte de Juegos resulta super entretenido para los alumnos más cuando se los motiva en una sana competencia entre ellos. Para ello interesaría conseguir en la medida de lo posible alguna de las siguientes funcionalidades:
- Visualizar varios jugadores en una especie de "red" entre las Xo en el gvSIG, compartiendo información sobre los resultados de los juegos y ejercicios.
- Elaborar trabajos de contrucción de gvSIG de forma conjunta.
El problema radica en que es un tema complejo que requerirá probablemente bastante tiempo de desarrollo, pues gvSIG no lleva de base ningún soporte para trabajo en equipo. En cualquier caso se añade esta idea como un punto más para tenerlo en cuenta si en algún momento se puede abordar.
Note
Prioridad ALTA
Aunque las funcionalidades a desarrollar estarán disponibles para ser instaladas en un gvSIG 2.0 oficial, será conveniente preparar una personalización del interfaz de usuario orientado al tipo de usuario final, en este caso niños y profesores:
Dicha personalización, usando las opciones de gvSIG que permite para ello, tendrá en cuenta lo siguiente:
- Reducir el número de funcionalidades disponibles (plugins instalados) y ocultar herramientas en la visualización de mapas temáticos y juegos. De las herramientas habituales en la vista de gvSIG, se elegirán aquellas que se consideren adecuadas al uso en cuestión, permitiendo un uso más sencillo de cara a los niños.
- Opciones de menus y barras de botones simplificados. Se puede preparar un tema de gvSIG que incluya botones más grandes y fáciles de usar por niños. Además se puede estudiar la conveniencia de sustituir los menus de gvSIG por barras de botones desplegables, o algún otro mecanismo más vistoso y sencillo.
- Desarrollar interfaces que en la medida de lo posible permitan al usuario aprender la herramienta mientras avanza.
Note
Prioridad ALTA
Se generarán instalables con las mínimas funcionalidades imprescindibles. gvSIG tiene muchas funcionalidades y opciones, habría que preparar un instalable con sólo aquellas que se consideren necesarias para la visualización de mapas temáticos y juegos. Eso además teniendo en cuenta las limitaciones de memoria y espacio de los dispositivos en los que se instalará la aplicación.
También se pueden preparar diversos instalables, según el curso o la edad de los niños a los que vaya destinada la instalación, in cluyendo los mapas temáticos y juegos correspondientes.
Para ello se emplearán los mecanismos que proporciona gvSIG 2.0 para, sobre una instalación básica común, generar un instalable con los complementos que se quiera.
Documentación del proyecto
En el proyecto se elaborará la siguiente documentación:
Manual que permita a los formadores la creación de mapas temáticos y juegos o ejercicios, así como la preparación y distribución de los mismos.
Note
Prioridad ALTA
Incluirá la documentación necesaria para que un alumno pueda instalar nuevos mapas temáticos y juegos, así como su puesta en marcha y demás opciones asociadas.
Note
Prioridad ALTA
Se preparará documentación de análisis, así como un manual para el desarrollador, que facilite usar o extender la funcionalidad de gvSIG Educa. Todo ello siguiendo las directrices del proyecto gvSIG de cara a ser un proyecto oficial de nivel completo.
Note
Prioridad ALTA
Grandes tareas
Company: | DiSiD Technologies S.L. |
---|---|
Author: | Cèsar Ordiñana |
Copyright: | 2011 (C) Asociación gvSIG |
Tareas
Note
Después de cada tarea aparece entre paréntesis las tareas que deben ser realizadas previamente. Las que no tienen ninguna serán las tareas que pueden ser abordadas desde un principio. Si aparece sólo un número, quiere decir que depende de todas las tareas de ese apartado.
1.1 Coordinación de los distintos grupos de trabajo.
1.2 Preparar estructura de documentos del espacio de colaboración en el portal gvsig.org.
1.3 Preparar estructura de subproyectos en el gestor de proyectos.
2.1 Desarrollar visualizador de mapas temáticos.
2.2 Desarrollar instalación de mapas temáticos sobre el gestor de complementos. (2.1)
2.3 Desarrollar generador de mapas temáticos.
2.4 Preparar o definir ubicación de cartografía a emplear en los mapas temáticos y juegos.
2.5 Preparar conjunto de mapas temáticos básicos. (2.1, 2.2, 2.3, 2.4)
2.6 Manual del formador para mapas temáticos. (2.3)
2.7 Manual del alumno para mapas temáticos. (2.1, 2.2)
2.8 Documentación de desarrollo.
2.9 Testeo. (2.1, 2.2, 2.3)
3.1 Desarrollar visualizador de juegos y ejercicios. (2.1)
3.2 Desarrollar instalación de juegos y ejercicios sobre el gestor de complementos. (3.1)
3.3 Desarrollar generador de juegos y ejercicios. (2.3)
3.4 Soporte para juegos de localización de topónimos por selección de formas geográficas. (3.1, 3.3)
3.5 Preparar conjunto de juegos básicos de localización de topónimos por selección de formas geográficas. (3.4, 3.11)
3.6 Soporte para juegos de localización de formas geográficas por selección de topónimos. (3.1, 3.3)
3.7 Preparar conjunto de juegos básicos de localización de formas geográficas por selección de topónimos. (3.6, 3.11)
3.8 Manual del formador para juegos y ejercicios. (2.3)
3.9 Manual del alumnos para juegos y ejercicios. (2.1, 2.2)
3.10 Documentación de desarrollo.
3.11 Preparar o definir ubicación de cartografía a emplear en los mapas temáticos y juegos.
3.12 Testeo. (3.1, 3.2, 3.3)
4.1 Soporte para juegos de ubicación de geometrías en posición correcta. (3.1, 3.3)
4.2 Preparar conjunto de juegos básicos de ubicación de geometrías en posición correcta. (4.1)
4.3 Soporte para juegos tipo búsqueda del tesoro. (3.1, 3.3)
4.4 Preparar conjunto de juegos básicos de búsqueda del tesoro. (No tengo claro del todo esto, porque imagino que serían con cartografía local a cada colegio). (4.3)
4.5 Soporte para ejercicios de edición de hipervínculos. (3.1, 3.3)
4.6 Preparar conjunto de ejercicios básicos de edición de hipervínculos. (4.6)
4.7 Soporte para juegos en red, compartiendo información sobre los resultados de los juegos y ejercicios. (3.1, 3.3)
4.8 Soporte para edición (trabajos de construcción) de gvSIG de forma conjunta. (4.7)
4.9 Manual del formador para juegos y ejercicios. (Actualizar para cada nuevo tipo de juego o ejercicio)
4.10 Manual del alumnos para juegos y ejercicios. (Actualizar para cada nuevo tipo de juego o ejercicio)
4.11 Documentación de desarrollo. (Se realizará durante el desarrollo de cada parte).
4.12 Testeo. (4.1, 4.3, 4.5, 4.7, ... Cada uno se puede probar cuando esté terminado)
5.1 Nuevo skin de gvSIG que ofrezca opciones de menús y barras de botones simplificados.
5.2 Nuevo tema de gvSIG para el proyecto Batoví.
5.3 Reducir funcionalidades y ocultar herramientas en la visualización de mapas temáticos, juegos y ejercicios. (2)
5.5 Documentación de desarrollo.
5.6 Testeo. (5.1, 5.2, 5.3)
6.1 Preparar instalable con soporte para mapas temáticos y algunos mapas temáticos básicos. (2)
6.2 Preparar instalable que añada al anterior juegos y ejercicios. (3)
6.3 Preparar instalable que añada al anterior juegos y ejercicios adicionales. (4)
6.3 Preparar repositorio dónde alojar mapas temáticos, juegos, etc. instalables desde el gestor de complementos.
6.4 Distribuir e instalar en los cebalitas.
6.5 Documentación de desarrollo, instalación, preparación de instalables y distribución.
6.6 Testeo.
7.1 Formación a formadores. (6.1, 6.2)
Context
Warning
Fill with a description and diagram of how the development fit in the gvSIG model.
Developers overview
Warning
Fill with a description and diagram of the main compoments or subsistems of our development.
Componets overview
Thematic Map
Introduction
This component try to solve share and distribution of cartographic data between gvSIG installations. This share must be in a compact, self-contained way to make it easy for users.
The date will be generated in a single file which will contains all resources needed to show data like generator user see the Map (data, legend, symbology). This files could be installed in target gvSIG installation directly or from a remote repository (in the same way that do it gvSIG's extension manager).
Thematic map is a read only files. This will be generated by a tool which will store Thematic map compilation information in a gvSIG project, so compilation process can be repeated after any source cartographic data's changes.
Context
Components description:
- ThematicMap.lib: Library which contains all logical component.
- ThematicMap.swing: Swing components that uses library.
- ThematicMap.plugin.view: gvSIG integration component with Thematic Map's visualization.
- ThematicMap.plugin.editor: gvSIG integration component with creation and editing of Thematic Map.
General View
Components description:
- Package Lib: Thematic Map Logic components
- ThematicMapLocator: Locator for library services.
- ThematicMapManager: Library Manager. Can list Thematics Maps from a folder, create new empty map compilation information and map compilator.
- ThematicMap: Contains Thematic Map's information and methods to manage it. Uses fmap libraries to load resources (layers, legends and symbology).
- ThematicMapCompilation: Contains all information needed to compile a Thematic Map. Uses fmap libraries to identify resources which must be packaged in final file.
- ThematicMapCompiler: Component which can generate a Thematic Map file from compilation information.
- Package Swing: User Interface components
- ThematicMapUILocator: Locator for swing components of the library.
- ThematicMapUIManager: Library user interface Manager. Creates view
- ThematicMapViewer: Swing component which can show a Thematic Map.
- ThematicMapCompilationEditor: Swing Component which allow edit a Thematic Map compilation information.
- Package plugin.viewer: gvSIG's plugin to View Thematic Map
- ThematicMapDocumentManager: gvSIG's document manager which creates documents to store information in application.
- ThematicMapViewerWindow: gvSIG's IWindow which shows a Thematic Map.
- ThematicMapDocument: gvSIG's project document which stores information of a Thematic Map.
- ThematicMapViewerExtension: Extension which register Thematic Map gvSIG's document and handles most important actions about it.
- Package plugin.editor: gvSIG's plugin to create and edit Thematic Map.
- ThematicMapEditorManager: Services to create and update ThematicMapDocument.
- CompilationListener: Listener used in some ThematicMapEditorManager services.
- ThematicMapEditorLocator: Locator of ThematicMapEditorManager.
- ThematicMapEditorExtension: Extension which register actions to ThematicMapDocument which allows to create and modify it.
ThematicMap
This interface gets access to all data from the Thematic Map to show it in a Viewer and all information about creator and contents.
ThematicMapCompilation
This interface allow to collect all information to generate or compile a Thematic Map. This not only includes cartographic data but information about creation, version, description, etc...
ThematicMapCompiler
This interface provides methods to generate a file which will contain all cartographic data and creation information. This is based on a ThematicMapCompilation. Uses fmap to identify all resources to store in file to guarantee target user show cartographic data exactly as source.
ThematicMapLocator
Locator to get the ThematicMapManager instance.
ThematicMapManager
Manager which provides this services:
- Gets all ThematicMap form a specified folder.
- Creates instances of ThematicMapCompilation.
- Creates instances of ThematicMapCompiler.
ThematicMapCompilationEditor
Swing component which show a wizard to manage ThematicMapCompilation data.
This is a Mock-up of wizard steps:
Note
The Step 2 is optional. Using editor plugin this is not used because it uses gvSIG's View document information
ThematicMapUILocator
Locator of ThematicMapUIManager instance.
ThematicMapUIManager
Manager which provides this services:
- Creates ThematicMapView from a ThematicMap.
- Creates ThematicMapCompilationEditor from a ThematicMapCompilation.
ThematicMapViewer
Swing component which shows the cartographic data from a ThematicMap into a MapControl. This map will be register all common tool of a MapControl (Zoom, Pam, etc...).
ThematicMapDocument
gvSIG's project document which stores information of a open Thematic Map.
Also, this stores information about which gvSIG's View document used for generate the ThematicMap (if editor plugin is installed).
Can generate a ThematiMapCompilation instance in base of ThematicMap to edit or re-generate the Map.
ThematicMapDocumentManager
Manager which register project document of the plugin.
ThematicMapViewerWindow
Andami's Window which shows a Thematic Map
ThematicMapViewerExtension
Andami's Extension which register ThematicMapDocumentManager and actions for Thematic Map visualization.
ThematicMapEditorExtension
Andami's Extension which registers ThematicMapDocument action to allow to create it from a gvSIG's View document.
ThematicMapEditorManager
Manager which offers services to create and update ThematicMapDocument from a gvSIG's View document. Also allows to generate gvSIG's add-on manager files to distribute a ThematicMap.
All extension and actions register in this add-on uses this Manager to perform the operations.
CompilationListener
Interface used in some ThematicMapEditorManager services to notify the operation result.
ThematicMapEditorLocator
Locator of ThematicMapEditorManager instance.
Planes de test
Planes de Test
Estos son los planes de test de los plugins de los Mapas Temáticos:
Branches
TODO
Tags
TODO
Batoví
Introducción
En este apartado describiremos los componentes que se han desarrollado para poder tener un paquete de instalación de gvSIG en los OLPC del proyecto Ceibal de Uruguay.
Contexto
Los equipos este proyecto tienen las siguientes características:
- Sistema Operativo Sugar:
- Linux basado en Fedora 11
- Escritorio propio, con apariencia sencilla y escritorio pre-configurados.
- Las aplicaciones integradas se llaman Activity y, normalmente, están implementadas sobre python (pyGTK o pyGame).
- Las instalación no tienen acceso a la cuenta del usuario root ni posibilidad de usar el sudo.
- Hardware. Existen dos modelos:
- 1Gb de Ram y 8 Gb de disco
- 256Mb de Ram y 1 Gb de disco
Ante esto hay solventar estos problemas:
- Maquina virtual: Al no tener la posibilidad de instalar el paquete de OpenJDK se requiere tener instalada la Actividad Java 2
- Instalación: Para integrar el sistema se han preparado scripst de Shell que automatizan, a partir de una instalación estándar de gvSIG de linux, la generación de un fichero .xo con gvSIG listo para instalar en los equipos.
- Interface: Las pantallas de los equipos son a 1200x900 pero en un tamaño muy pequeño, eso hace que el interface de gvSIG estándar sea muy incomodo de usar (fuente minúscula, iconos pequeños). Se ha creado un Skin que, junto a unos procesos del empaquetado de la instalación, intenta minimizar este problema.
- Recursos limitados: En el equipo pequeño no ha sido posible arrancar gvSIG, por lo que se ha preparado una aplicación mas pequeña que permite visualizar e instalar mapas temáticos.
- Soporte Raster: Las librerías usadas por el sistema operativo son bastante antiguas y no son compatibles con el soporte básico de raster para linux de gvSIG. Ha sido necesario preparar una versión compatible con Fedora 11.
Este proyecto se ha dividido en las siguientes partes:
- batovi activity: Scripts y recursos necesario para generar un Activity a partir de una instalación de gvSIG
- batovi app: Plugins de gvSIG preparados para su uso en la instalación de los OLPC
- batovi mapViewer: Aplicación visor de mapas temáticos.
Batoví activity
Este proyecto contiene los script y los recursos necesarios para genera un fichero .xo, que son los usados para empaquetar un Activity para el Sistema Operativo Sugar.
En el directorio podemos encontrar documentación sobre como realizar el proceso, así como recomendaciones sobre los paquetes a incluir en el gvSIG que se use como base del Activity.
El directorio base del proyecto se puede encontrar en org.gvsig.educa.batovi/${version}/org.gvsig.educa.batovi/org.gvsig.educa.batovi.activity del repositorio.
Los script de generación están desarrollados usando bash por lo que deben ser ejecutado en un sistema Unix-like.
Los principales scripts son:
- prepare-bundle.sh: crea un directorio target con lo necesario para generar un Activity
- generate-bundle.sh: crea el fichero .xo dentro de target a partir de lo generado por el script prepare-bundle.sh.
El proceso está divido en dos para facilitar la inclusión de otro elementos al paquete.
Para más información consultar el fichero LEEME.txt del directorio.
Acciones post-install
La clase de python preparada para gestionar la Activity dispone de un mecanismo de post-install que se ejecuta únicamente antes del primer arranque de gvSIG dentro del dispositivo. Las funcionalidades que soporta son:
- Copia de archivos al directorio de usuario de gvSIG.
- Copia de archivos al directorio de usuario.
- Ejecución de scripts.
Estas acciones se pueden preparar justo después de la ejecución del script prepare-bundle.sh, añadiendo elementos en los subdirectorios de target/Batovi.activity/post-install. Para más información consultar el archivo README.rst de dicho directorio o el fuente de la actividad skeleton/GvSIGActivity.py.
Copia, si no existiese previamente, archivos al directorio $HOME/gvSIG del equipo instalado.
Para usar esta característica sólo es necesario copiar los archivos, con la estructura que debe quedar dentro de directorio destino, dentro del directorio target/Batovi.activity/post-install/user-gvsig-home.
Este mecanismo es el usado para instalar los mapas temáticos que se desean incluir en la instalación
Copia, si no existiese previamente, archivos al directorio $HOME del equipo instalado.
Para usar esta característica sólo es necesario copiar los archivos, con la estructura que debe quedar dentro de directorio destino, dentro del directorio target/Batovi.activity/post-install/user-home.
Ejecuta script, ya sean .sh o .py antes de la primera ejecución de la aplicación.
Para usar esta característica sólo es necesario copiar los scripts, dentro del directorio target/Batovi.activity/post-install/scripts.
Antes de ejecutar los scripts serán establecidas las siguientes variables de entorno:
- GVSIG_HOME: Ruta al directorio donde se encuentra el directorio base de gvSIG (donde se encuentra el gvSIG.sh)
- GVSIG_ACTIVITY: Ruta al directorio raíz de la actividad
- JAVA_HOME: Ruta el directorio donde se encuentra la máquina virtual
Batoví app
Dentro de este componente se encuentran aquellos plugíns de gvSIG desarrollados específicamente para mejorar la experiencia de usuario en los equipos OLPC.
Ahora mismo, únicamente con tiene un plugin de tipo Skin org.gvsig.educa.batovi.app.skin
El directorio raíz del componente es /org.gvsig.educa.batovi/${version}/org.gvsig.educa.batovi/org.gvsig.educa.batovi.app dentro del repositorio del proyecto.
org.gvsig.educa.batovi.app.skin
Plugin que modifica la ventana principal de gvSIG para eliminar su decoración (aprovechando mejor el espacio de la pantalla) y abrir todas la ventanas de la aplicación con un tamaña maximizado (o casi).
El directorio del proyecto es /org.gvsig.educa.batovi/${version}/org.gvsig.educa.batovi/org.gvsig.educa.batovi.app/org.gvsig.educa.batovi.app.skin dentro del repositorio del proyecto.
Batoví mapViewer
Esta aplicación surge al no poder arrancar la aplicación gvSIG entera en los equipos con menos recursos.
La aplicación, con una estética muy integrada en Sugar, permite instalar y visualizar mapas temáticos generados en un gvSIG estándar.
Dispone de herramientas de:
- Encuadre
- Zoom
- Medición
- Área
- Información
Este componente se divide en dos:
El directorio raíz del componente está en org.gvsig.educa.batovi/${version}/org.gvsig.educa.batovi/org.gvsig.educa.batovi.mapviewer del repositorio del proyecto.
Aplicación
Aplicación de java. Está basada en el módulo main de los mapa temáticos, ajustada a las necesidades del proyecto.
El directorio de la aplicación está en org.gvsig.educa.batovi/${version}/org.gvsig.educa.batovi/org.gvsig.educa.batovi.mapviewer/org.gvsig.educa.batovi.mapviewer del repositorio del proyecto.
Generador de activity
Contiene, al igual que Batobi activity, los scripts y recursos necesario para crear una actividad a partir de la compilación de la aplicación.
Sus características son similares a las de Batobi activity.
Requiere tener compilada previamente la parte de aplicación.
Para más información ver el fichero LEEME.rst del directorio.
El directorio se encuentra en org.gvsig.educa.batovi/${version}/org.gvsig.educa.batovi/org.gvsig.educa.batovi.mapviewer/org.gvsig.educa.batovi.mapviewer.activity dentro del repositorio del proyecto.
Versiones
Mapas temáticos
Version 1.0.0
Checklist
Check list
Deliverable | Requirements | Comments | Status |
---|---|---|---|
Project sheet | Pending review | ||
Project identifier | ---> Pending review | ||
Project title | ---> Pending review | ||
Short description project | ---> Pending review | ||
License | ---> Pending review | ||
Contacts | Pending review | ||
Main contact | ---> Pending review | ||
Technical contact | ---> Pending review | ||
Sources library plugins | Pending review | ||
Public access to the source code | ---> Pending review | ||
Strings in english | ---> Pending review | ||
Dependency report | Pending review | ||
Project dependences | ---> Pending review | ||
Dependency Tree | ---> Pending review | ||
Licenses | ---> Pending review | ||
Dependency Repository Locations | ---> Pending review | ||
README (readme-libs , readme-plugins ), LEEME (leeme-libs, leeme-plugins ) | Pending review | ||
README.txt in source code | ---> Pending review | ||
Introduction | ---> Pending review | ||
Version information | ---> Pending review | ||
Build instructions | ---> Pending review | ||
Packaging instructions | ---> Pending review | ||
Internazionalization notes | ---> Pending review | ||
Public access to package tools | ---> Pending review | ||
User manual | Not recieved | ||
Introduction | ---> Not recieved | ||
Requeriments | ---> Not recieved | ||
Installation | ---> Not recieved | ||
Instructions for use | ---> Not recieved | ||
Credits | ---> Not recieved | ||
Test plan | Pending review | ||
Test plan | ---> Pending review | ||
Analysis documentation | Pending review | ||
Introduction | ---> Pending review | ||
Context | ---> Pending review | ||
Developers overwiew | ---> Pending review | ||
Components overview | ---> Pending review |
Status values:
- Done
- Being reviewed
- Rejected
- Not recieved
Project dependencies
Juegos y ejercicios
Version 0.1.0
Checklist
Check list
Deliverable | Requirements | Comments | Status |
---|---|---|---|
Project sheet | Not recieved | ||
Project identifier | ---> Not recieved | ||
Project title | ---> Not recieved | ||
Short description project | ---> Not recieved | ||
License | ---> Not recieved | ||
Contacts | Not recieved | ||
Main contact | ---> Not recieved | ||
Technical contact | ---> Not recieved | ||
Sources | Not recieved | ||
Public access to the source code | ---> Not recieved | ||
Strings in english | ---> Not recieved | ||
Dependency report (description3 , template3) | Not recieved | ||
Project dependences | ---> Not recieved | ||
Dependency Tree | ---> Not recieved | ||
Licenses | ---> Not recieved | ||
Dependency Repository Locations | ---> Not recieved | ||
README, README_es (description1, template1 ) | Not recieved | ||
README.txt in source code | ---> Not recieved | ||
Introduction | ---> Not recieved | ||
Version information | ---> Not recieved | ||
Build instructions | ---> Not recieved | ||
Packaging instructions | ---> Not recieved | ||
Internazionalization notes | ---> Not recieved | ||
Public access to package tools | ---> Not recieved | ||
User manual | Not recieved | ||
Introduction | ---> Not recieved | ||
Requeriments | ---> Not recieved | ||
Installation | ---> Not recieved | ||
Instructions for use | ---> Not recieved | ||
Credits | ---> Not recieved | ||
Test plan | Not recieved | ||
Test plan | ---> Not recieved | ||
Analysis documentation (description2) | Not recieved | ||
Introduction | ---> Not recieved | ||
Context | ---> Not recieved | ||
Developers overwiew | ---> Not recieved | ||
Components overview | ---> Not recieved |
Status values:
- Done
- Being reviewed
- Rejected
- Not recieved
Project dependencies
The following is a list of compile dependencies for this project. These dependencies are required to compile and run the application:
Artifact | Version | Type |
---|---|---|
The following is a list of runtime dependencies for this project. These dependencies are required to run the application:
Artifact | Version | Type |
---|---|---|
The following is a list of test dependencies for this project. These dependencies are only required to compile and run unit tests for the application:
Artifact | Version | Type |
---|---|---|
- Unknown:
- GPL Version 2:
- GPL Version 3:
- The Apache Software License, Version 2.0:
Artifact | Location |
---|---|
Batoví
Versión 1.0.0
Checklist
Check list
Deliverable | Requirements | Comments | Status |
---|---|---|---|
Project sheet | Pending review | ||
Project identifier | ---> Pending review | ||
Project title | ---> Pending review | ||
Short description project | ---> Pending review | ||
License | ---> Pending review | ||
Contacts | Pending review | ||
Main contact | ---> Pending review | ||
Technical contact | ---> Pending review | ||
Sources | Pending review | ||
Public access to the source code | ---> Pending review | ||
Strings in english | ---> Pending review | ||
Dependency report | Pending review | ||
Project dependences | ---> Pending review | ||
Dependency Tree | ---> Pending review | ||
Licenses | ---> Pending review | ||
Dependency Repository Locations | ---> Pending review | ||
readme , leeme | Pending review | ||
README.txt in source code | ---> Pending review | ||
Introduction | ---> Pending review | ||
Version information | ---> Pending review | ||
Build instructions | ---> Pending review | ||
Packaging instructions | ---> Pending review | ||
Internazionalization notes | ---> Pending review | ||
Public access to package tools | ---> Pending review | ||
User manual | Not recieved | ||
Introduction | ---> Not recieved | ||
Requeriments | ---> Not recieved | ||
Installation | ---> Not recieved | ||
Instructions for use | ---> Not recieved | ||
Credits | ---> Not recieved | ||
Analysis documentation | Pending review | ||
Introduction | ---> Pending review | ||
Context | ---> Pending review | ||
Developers overwiew | ---> Pending review | ||
Components overview | ---> Pending review |
Status values:
- Done
- Being reviewed
- Rejected
- Not recieved
Project dependencies
Consultar el resumen de los proyectos: