Teseo — Manual de usuario
1. Qué es Teseo
Teseo es una aplicación para explorar las relaciones contenidas en un grafo documental.
Permite:
- buscar nodos por su nombre o por sus atributos;
- consultar toda la información asociada a un nodo;
- localizar geográficamente los nodos que contienen información espacial;
- reconstruir y visualizar los subgrafos documentales en los que participa un nodo;
- estudiar sus coocurrencias con otros nodos;
- navegar gráficamente por las relaciones;
- exportar datos y representaciones gráficas en varios formatos.
La interfaz está disponible en español e inglés.
2. Idioma
El selector de idioma aparece en la cabecera de la aplicación.
Están disponibles:
- Español
- English
Teseo recuerda en el navegador el último idioma seleccionado.
Si todavía no existe una preferencia guardada, intenta utilizar el idioma del navegador cuando sea español o inglés. En otro caso utiliza español.
El idioma puede cambiarse en cualquier momento sin perder la vista en la que se está trabajando.
3. Estado del corpus
La página inicial muestra el apartado Estado del corpus.
Cuando el grafo está disponible se muestran:
- Nodos: número total de nodos.
- Aristas válidas: número de relaciones utilizables.
- Relaciones: número de tipos de relación.
- Tipos de atributo: número de atributos distintos.
- Generado: fecha de generación del corpus.
- Carga inicial: tiempo empleado en cargar el grafo.
El estado Disponible indica que Teseo puede realizar consultas.
Si el servicio o el corpus no están accesibles se muestra No disponible.
4. Buscar nodos
La búsqueda es el punto de entrada principal de Teseo.
Texto de búsqueda
Introduzca el término que desea localizar, por ejemplo:
Pablo Ruiz Picasso
Málaga
museo
Las búsquedas no distinguen entre mayúsculas y minúsculas ni entre caracteres con o sin tilde o diacríticos.
Por ejemplo:
Málaga
malaga
MÁLAGA
se consideran equivalentes.
Campo
Determina dónde se realizará la búsqueda.
Etiqueta
Busca exclusivamente en el nombre o etiqueta principal del nodo.
Es la opción predeterminada.
Cualquier atributo
Busca el texto en cualquiera de los atributos del nodo.
Atributo concreto
Permite seleccionar uno de los atributos existentes en el corpus y buscar únicamente dentro de él.
Al seleccionar esta opción aparece el campo Atributo.
La lista de atributos se obtiene directamente del grafo.
Coincidencia
Teseo ofrece cuatro operadores.
Contiene
El término puede aparecer en cualquier posición.
Ejemplo:
Picasso
puede encontrar:
Pablo Ruiz Picasso
Exacta
El contenido completo debe coincidir con el término buscado.
Empieza por
El valor debe comenzar por el texto introducido.
En la lista (IN)
Permite buscar simultáneamente varios valores exactos.
Los valores pueden separarse mediante comas o puntos y coma:
Pablo Ruiz Picasso; Joan Miró, Salvador Dalí
Cada elemento se compara como una coincidencia exacta. Los valores vacíos o repetidos se ignoran.
Tipo de entidad
Permite restringir la búsqueda a un determinado tipo de nodo.
La opción Todos los tipos no aplica ninguna restricción.
Los tipos disponibles se obtienen directamente del corpus, por lo que pueden variar con sus datos.
Por página
Puede elegirse el número de resultados mostrados:
- 25
- 50
- 100
Buscar
Ejecuta la consulta.
Limpiar
Borra la búsqueda actual, los filtros y los resultados mostrados.
5. Resultados de búsqueda
Los resultados se presentan en una tabla con:
- NID: identificador único del nodo.
- Etiqueta: nombre del nodo.
- Tipo: tipo de entidad.
- Atributos: resumen de sus atributos.
- Acciones: operaciones disponibles.
Cuando es aplicable, el texto buscado aparece resaltado en los resultados.
Abrir un nodo
Pulse sobre su etiqueta para acceder a su ficha completa.
Subgrafos
La acción Subgrafos permite ir directamente a los subgrafos documentales que contienen ese nodo.
6. Paginación
Cuando existen más resultados de los que caben en una página aparecen los controles:
- Primera
- Anterior
- Siguiente
- Última
También se muestran:
Resultados X–Y de Z
Página X de Y
La búsqueda y la página actual quedan reflejadas en la dirección del navegador.
Por ello pueden utilizarse normalmente:
- el botón Atrás;
- el botón Adelante;
- la recarga de la página;
- una URL correspondiente a una búsqueda determinada.
7. Ficha de un nodo
La ficha contiene la información completa de un nodo.
En la cabecera se muestran:
- etiqueta;
- tipo de entidad;
- NID.
A continuación aparece la tabla Atributos, con dos columnas:
Atributo | Valor
Los atributos con varios valores muestran todos ellos.
Desde la ficha están disponibles dos operaciones principales:
Extraer y visualizar subgrafos
Reconstruye todos los subgrafos documentales que contienen el nodo.
Calcular coocurrencias
Localiza otros nodos que comparten subgrafos documentales con el nodo seleccionado.
8. Información geográfica
Cuando Teseo reconoce coordenadas entre los atributos de un nodo, la ficha incorpora automáticamente una sección Localización.
Incluye:
- mapa de OpenStreetMap;
- latitud y longitud;
- enlace Abrir en OpenStreetMap.
Las propias coordenadas de la tabla de atributos enlazan con el mapa de la ficha.
Teseo reconoce además atributos geográficos equivalentes a:
- país;
- región, comunidad, provincia o estado;
- ciudad, localidad o municipio;
- sede o lugar de celebración.
Estos valores se convierten en enlaces a Nominatim / OpenStreetMap, utilizando cuando es posible el resto del contexto geográfico del nodo para precisar la búsqueda.
El mapa solo aparece cuando existen coordenadas reconocibles.
9. Subgrafos documentales
Un subgrafo documental representa una estructura documental completa relacionada con el nodo seleccionado.
Teseo sigue las relaciones del grafo hasta localizar los centros o raíces documentales correspondientes y reconstruye después sus cadenas completas.
La expansión puede atravesar varios niveles y controla los ciclos del grafo.
Resumen
La vista muestra cuatro cifras:
- Coincidencias
- Subgrafos
- Nodos
- Aristas
Subgrafos encontrados
La tabla contiene:
- NID raíz
- Nodo raíz
- Incluye por
El nodo raíz puede abrirse directamente pulsando sobre su etiqueta.
Incluye por indica el NID del nodo o nodos cuya coincidencia hizo que esa raíz documental formara parte de la extracción.
Cuando existen muchos subgrafos se muestran paginados, 50 por página, mediante los controles Anterior y Siguiente.
10. Representación gráfica de subgrafos
Debajo de la lista aparece una representación interactiva WebGL.
La leyenda distingue:
- Nodo buscado
- Raíz de subgrafo
- Otros nodos
Navegación
En el grafo puede:
- arrastrar para desplazar la vista;
- utilizar la rueda para ampliar o reducir;
- pulsar sobre un nodo para abrir su ficha.
Controles
La barra superior dispone de:
- Ampliar
- Reducir
- Restablecer vista
Mientras el grafo se está preparando, sus controles permanecen desactivados.
11. Exportar subgrafos
La misma barra permite exportar la extracción completa.
JSON
Exporta los datos del subgrafo en formato JSON.
CSV (ZIP)
Genera la información tabular en CSV dentro de un archivo ZIP.
XLSX
Genera un libro de Microsoft Excel.
SVG
Exporta una representación vectorial del grafo.
Es el formato recomendado cuando la imagen debe editarse posteriormente o imprimirse a gran tamaño.
PNG 2×
Genera una imagen PNG a resolución 2×.
PNG 3×
Genera una imagen PNG a resolución 3×.
Durante el proceso se muestra el estado Generando la exportación… y, al terminar, Exportación generada.
12. Coocurrencias
Dos nodos coocurren cuando comparten al menos un subgrafo documental.
La vista de coocurrencias parte siempre de un nodo seleccionado.
Grupos de coocurrencia
Los nodos coocurrentes se agrupan por la relación mediante la cual entran en la cadena documental.
Para cada grupo se muestra:
- nombre de la relación;
- número de nodos;
- acción Ver coocurrentes.
Es importante interpretar correctamente este dato: el grupo describe la relación con la que el nodo coocurrente participa en la cadena, no necesariamente una relación directa entre ese nodo y el nodo seleccionado.
Lista de coocurrentes
Al abrir un grupo se muestran:
- Nodo
- Coocurrencias
El número de coocurrencias indica cuántas estructuras compartidas se han encontrado.
La lista se ordena inicialmente por número de coocurrencias, de mayor a menor.
Las cabeceras Nodo y Coocurrencias son interactivas:
- pulse una cabecera para ordenar por ella;
- vuelva a pulsarla para invertir el orden.
Los nombres de los nodos son enlaces a sus fichas.
Cuando la lista es extensa aparecen Anterior y Siguiente.
13. Red de coocurrencia
Teseo genera también una representación gráfica de todas las coocurrencias del nodo.
Cada pareja de nodos aparece conectada mediante una única arista agregada que resume las relaciones que comparten.
La red permite:
- desplazamiento mediante arrastre;
- zoom con la rueda;
- abrir la ficha de un nodo pulsándolo.
Dispone también de:
- Ampliar
- Reducir
- Restablecer vista
14. Exportar coocurrencias
La red de coocurrencia admite las mismas familias de exportación:
- JSON
- CSV (ZIP)
- XLSX
- SVG
- PNG 2×
- PNG 3×
Las exportaciones de datos incluyen el conjunto de nodos coocurrentes sin limitarlo al grupo que se esté visualizando en ese momento.
15. Flujo de trabajo recomendado
Un uso habitual de Teseo puede resumirse así:
- Buscar una persona, institución, exposición, lugar u otro nodo.
- Abrir su ficha para comprobar sus datos y atributos.
- Utilizar Extraer y visualizar subgrafos para estudiar su contexto documental.
- Pulsar nodos del grafo para continuar la exploración.
- Utilizar Calcular coocurrencias para descubrir otros nodos presentes en las mismas estructuras.
- Ordenar los coocurrentes por frecuencia para detectar las asociaciones más repetidas.
- Exportar los datos o el gráfico cuando sea necesario conservarlos o analizarlos externamente.
16. Cómo interpretar las cadenas documentales
Las aristas de Teseo representan conexiones hacia un centro documental.
De forma simplificada, una estructura puede tener esta forma:
actor → obra → catálogo → exposición
Teseo puede recorrer esas relaciones hasta alcanzar el centro correspondiente y reconstruir después el conjunto documental completo.
Por ello un nodo puede:
- pertenecer a varios subgrafos;
- aparecer mediante cadenas de distinta longitud;
- compartir diferentes subgrafos con otro nodo;
- coocurrir varias veces con el mismo nodo.
La unidad fundamental no es únicamente la relación directa entre dos nodos, sino la estructura documental completa en la que participan.
17. Navegación
Teseo utiliza navegación interna sin recargar completamente la aplicación.
Puede utilizar normalmente:
- enlaces entre nodos;
- Volver;
- Volver a la búsqueda;
- Volver a la ficha del nodo;
- botones Atrás y Adelante del navegador.
La ficha de un nodo, sus subgrafos y sus coocurrencias tienen direcciones propias, por lo que pueden recargarse directamente.
18. Problemas habituales
No aparecen resultados
Pruebe a:
- comprobar el campo elegido;
- cambiar Exacta por Contiene;
- eliminar la restricción de tipo de entidad;
- comprobar que, al usar Atributo concreto, se ha seleccionado un atributo.
IN no devuelve lo esperado
IN realiza comparaciones exactas.
Utilice:
valor 1; valor 2; valor 3
o:
valor 1, valor 2, valor 3
No aparece el mapa
La ficha solo genera el mapa cuando el nodo contiene coordenadas reconocibles.
El grafo todavía no responde
Espere hasta que el indicador cambie de Preparando… a Lista.
No hay coocurrencias
Significa que Teseo no ha encontrado otros nodos que compartan subgrafos documentales con el nodo seleccionado dentro del corpus actual.
Teseo
Exploración relacional del grafo documental