Visualizador y verificador Web de grafos UNL

Visualizador y verificador
Web de grafos UNL
- Manual de usuario -
1

REQUISITOS
- Tener instalado JRE 1.4 (Java Runtime Enviroment) o superior en el equipo.
- Disponer de un navegador WEB (Para ejecutar la aplicación desde un navegador
WEB).
Para comprobar si tiene JRE instalado en el equipo:
http://www.java.com/es/download/installed.jsp
Para descargar la última versión de JRE:
http://www.java.com/es/download
Funcionalidad de la aplicación
Con esta aplicación se puede:
• Cargar documentos UNL con mas de una oración en el formato que se indica.
• Navegar por las Oraciones o frases de un documento de texto con expresiones
UNL.
• Visualizar y editar el grafo correspondiente a una Expresión UNL
• Verificar que las Expresiones UNL de un documento de texto son
sintácticamente correctas.
• Visualizar los errores de una expresión UNL.
• Corregir en modo texto o gráfico las expresiones UNL detectadas como
incorrectas.
• Convertir el grafo que se está visualizando en la Expresión UNL
correspondiente.
• Guardar el documento UNL ya corregido en un directorio de su máquina.
2

Inicio de la aplicación
GUÍA DE USO
Al activar el vinculo aparece una pantalla como la siguiente (recomendamos vivamente
leer primero el manual de usuario)
1. UNL Parser and Viewer (Click to download UNL Parser and Viewer)
• Se descargará en algún directorio de su máquina el archivo vvunl.zip.
• Descomprima su contenido en cualquier lugar de su máquina
• A continuación haga doble click en el archivo vvunl.jar
Pantalla principal
La aplicación muestra la siguiente pantalla principal desde la que se manejará la
aplicación. A continuación se detallan cada uno de los botones o las zonas en las que se
trabaja.
3

Text Area
Cuadro de texto en el que se escribe o se copia la expresión UNL que se desea verificar
y visualizar. (si utiliza la opción de copiar y pegar)
Error Area
Cuadro de texto en el que se muestran los errores encontrados en la expresión UNL
durante la verificación.
Line: Column
Aquí se muestra la línea y la columna en la que se encuentra el cursor en el Área de
Expresión.
Verification Result
Aquí se muestra el resultado de la verificación.
Text to Graph
Mediante este botón se verifica la expresión UNL escrita en el Área de Expresión y se
visualiza el grafo correspondiente.
Graph to Text
Mediante este botón se convierte el grafo que se esta visualizando en la expresión UNL
correspondiente.
4

UNL Graph Area
Área en la que se visualiza el grafo
Selected Node/Arc
Aquí se muestra la etiqueta del nodo o del arco seleccionado en el grafo.
Edit
Mediante este botón se edita el valor de la etiqueta del nodo o del arco seleccionado en
el grafo.
Expand/Collapse
Mediante este botón se expande y se contrae el nodo seleccionado en el grafo si dicho
nodo es un nodo que representa un Scope.
Zoom in
Mediante este botón se amplia el tamaño del grafo.
Zoom out
Mediante este botón se disminuye el tamaño del grafo.
Open
Se selecciona un fichero para cargar su contenido
Save
Se selecciona un fichero para cargar el contendido de Text Area en él.
Sentence
Se visualiza la frase que corresponde con el grafo Unl que se muestra en Unl Graph
Area. Si se pincha en el menú se puede acceder a cada una de las Sentence que hay en el
documento introducido.
Nº Sentence
Se visualiza en numero de la Sentence dentro del documento introducido
Next Sentence
Se accede a la siguiente Sentence de la mostrada del documento, en caso de existir.
Previous Sentence
Se accede a la Sentence anterior de la mostrada del documento, en caso de existir.
5

1. Cargar un fchero UNL
Existen tres maneras de introducir texto UNL en la herramienta para posteriormente
verificar y visualizar su contenido.
a. Seleccionar Fichero
Pulsando el botón Open ( ) se puede seleccionar un fichero
almacenado en la máquina. El sistema cargará su contenido en ”Text
Area” (ver formato en el cuadro de abajo de esta página)
b. Copiar y Pegar Texto
Se puede copiar el contenido de un fichero y pegar en el área de texto.
c. Edición de Texto
Editar directamente las expresiones UNL en el “Text Area” como si de
un editor de texto se tratara.
El tipo de contenido con el que la herramienta trabaja, puede ser o bien una única
expresión UNL o un documento con expresiones UNL separadas por las etiquetas [S] y
[/S].
La estructura de las dos modalidades es la siguiente:
Tipo 1
Tipo 2
{unl}
(Ver : “Contenido de expresión UNL”)
{/unl}
[D]
[S]
{org: XXX}
Frase
{/org}
{unl}
(Ver : “Contenido de expresión UNL”)
{/unl}
[/S]
…..
[S]
{org: XXX}
Frase
{/org}
{unl}
(Ver : “Contenido de expresión UNL”)
{/unl}
[/S]
…..
[/D]
Nota: Las etiquetas [D] y {/org} son opcionales
6

Contenido de expresión UNL
Las expresiones UNL pueden expresarse de la siguiente forma:
Tipo 1
Tipo 2
Tipo 3
Tipo 4
{unl}
[W]
[/W]
{/unl}
{unl}
[W]
[/W]
...
{/unl}
{unl}
...
{/unl}
{unl}
[W]
{ | }
...
[/W]
[R]
...
[/R]
{/unl}
Nota: La herramienta respeta la semántica de las expresiones UNL definidas en
Universal Networking Language.
7

2. Guardar Texto.
Una vez hechas las operaciones de revisión de un texto UNL si se desea guardar el
nuevo fichero ya corregido hay dos maneras de hacerlo:
a. Seleccionar Fichero destino
Pulsando el botón Save ( ) se puede seleccionar un fichero
almacenado en la máquina o crear uno nuevo donde almacenar el
contenido de “Text Area”.
b. Copiar y Pegar Texto
Se puede copiar el contenido de “Text Area” pulsado la siguiente
combinación de botones:
1. Pulsar la combinación de teclas Ctrl+A dentro de la zona “Text Area”
para seleccionar todo el texto almacenado.
2. Dentro de Text Area pulsar Ctrl+C. Se copiará el contenido
seleccionado.
3. A continuación crear un fichero de texto nuevo en cualquier lugar de
su máquina.
4. Abrir el archivo y pegar el contenido que se ha copiado. A
continuación salvar el fichero.
8

3. Verificación del contenido
Una vez cargada la expresión o documento con expresiones que se desean verificar en el
Área de Expresión (el cuadro de texto bajo la pestaña UNL Expression) hay que hacer
click en el botón Text to Graph ( ).
Si se encuentran errores o warnings al verificar la expresión, en el Área de Mensajes (el
cuadro de texto bajo la pestaña Error Messages) se muestra una lista de los errores y/o
warnings encontrados.
Si se encuentran errores el grafo no se dibuja
Los errores que se pueden encontrar al analizar la expresión son los siguientes:
- 1. Se encuentran errores sintácticos en la expresión UNL.
- 2. Dos Universal Words iguales se definen con distintos atributos.
- 3. Dos Universal Words distintas se definen con el mismo .
- 4. Se hace referencia a un Scope no definido.
- 5. Se hace referencia a un no definido.
- 6. Se define mas de un @entry para un Scope.
Los warnings que se pueden encontrar al analizar la expresión son los siguientes:
- 1. Se encuentra texto a continuación de “{/unl}”.
- 2. Se encuentra un desconocido, es decir una cadena que se puede
aceptar como pero que no forma parte de los
definidos en las especificaciones del UNL.
9

- 3. Se encuentra un desconocido, es decir una cadena que se
puede aceptar como pero que no forma parte de los
definidos en las especificaciones del UNL.
- 4. Se encuentra una Relación repetida.
- 5. Existen Scopes definidos en la expresión que no están referenciados.
- 6. No se ha definido un @entry para algún Scope.
- 7. El grafo correspondiente a la expresión es disjunto.
En los errores 1, 2, 3, 4 y 5 y en los warnings 1, 2, 3 y 4 se incluye la línea y columna
en la que se ha encontrado el error o el warning.
En el caso de introducir más de una expresión UNL, además de la verificación de cada
una de las expresiones tal y como se ha explicado anteriormente, se analizará la
estructura del documento introducido. Los errores que se pueden dar son por la ausencia
de alguna de las etiquetas [S], [/S].
10

4. Visualizar el grafo correspondiente a una Expresión
UNL
Cargar, escribir o copiar (Ctrl.+V) la expresión que se desea visualizar en el Área de
Expresión (el cuadro de texto bajo la pestaña UNL Expression) y hacer click en el
botón Text to Graph.
Una expresión UNL es el texto encerrado entre las etiquetas {unl} y {/unl} ambas
etiquetas inclusive.
Los nodos representan Universal Words y Scopes. Los nodos que representan
Universal Words se representan con forma de elipse y los nodos que representan Scopes
se representan con forma rectangular. Las flechas etiquetadas entre nodos representan
las relaciones que existen entre Universal Words y/o Scopes:
Las etiquetas de los nodos que representan Universal Words o Scopes definidos con el
atributo .@entry se muestran en color rojo.
Interactuar con el grafo
Para mover un nodo se selecciona dicho nodo (hacer click en el nodo) y se arrastra hasta
la posición deseada.
Los nodos que representan Scopes se pueden visualizar contraídos o expandidos. Para
11

expandir o contraer un Scope se selecciona el nodo que se quiere contraer o expandir
(hacer click en el nodo) y se hace click en el botón Expand/Collapse( ).
Para seleccionar un nodo expandido (Scope expandido) se debe hacer click en un nodo
interior al Scope sucesivamente hasta que el Scope al que pertenece quede seleccionado.
- Scope contraído:
- Scope expandido:
12

Para editar la etiqueta de un nodo o un arco se debe seleccionar el nodo o el arco que se
desea editar y hacer click en el botón Edit Label( ).
Si se quiere editar un nodo, al hacer click en el botón Edit Label se abre una ventana en
la que se pueden editar los valores de la Universal Word que componen la etiqueta del
nodo:
Si se quiere editar un arco, al hacer click en el botón Edit Label se abre una ventana en
la que se pueden editar el valor de la Relación que compone la etiqueta del arco:
El botón Accept guarda los cambios y cierra la ventana.
El botón Cancel cierra la ventana sin guardar los cambios.
13

Seleccionar grafos UNL
Sólo se pueden seleccionar otros grafos UNL si se han verificado más de una expresión
UNL. En ese caso se puede seleccionar cualquiera de los grafos correspondientes a las
expresiones introducidas. Esta acción se puede realizar de dos maneras:
1. Flechas de navegación ( y ): Se accede al grafo siguiente y al anterior del
mostrando
2. Seleccionar una desde el menú donde se muestran las Oraciones.
14

5. Convertir el grafo que se está visualizando a la
expresión UNL correspondiente
Si se desea convertir el grafo que se está visualizando en la expresión UNL
correspondiente se debe hacer click en el botón Graph to Text ( ). En el cuadro de
texto bajo la pestaña UNL Expresión (Área de Expresión) se escribe la expresión
obtenida a partir del grafo.
No se realiza ninguna verificación de la expresión obtenida a partir del grafo. Si el
usuario desea asegurarse de que la expresión obtenida es correcta se debe hacer clic en
el botón Text to Graph.
6. Salir de la aplicación
Cerrar la ventana principal (hacer click en la X situada en la esquina superior derecha).
15