Oedipus — Guía de uso
1. Qué es Oedipus
Oedipus es una herramienta de consulta y análisis determinista sobre el grafo documental de ArtixGraph. Su unidad estructural básica es el subgrafo documental: un hub y todas las ramas documentales que llegan a él, expandidas recursivamente mientras los nodos intermedios sean también hubs.
Oedipus no copia ni materializa esos subgrafos. Trabaja sobre una representación compartida del grafo y calcula las selecciones y análisis a demanda.
La aplicación separa deliberadamente tres tareas:
- Consulta: decidir qué subgrafos cumplen las condiciones.
- Análisis: decidir qué población analizar, cómo agruparla y qué contar.
- Interpretación: pedir al modelo de lenguaje una lectura orientativa de un resultado ya calculado de forma determinista.
El modelo de lenguaje no decide qué datos pertenecen al resultado ni recalcula las cifras.
2. Consulta: seleccionar subgrafos
La vista Consulta permite construir el filtro que determina qué subgrafos entran en el análisis.
2.1. Subgrafos de
El campo Subgrafos de fija la entidad raíz. Cada resultado de la selección corresponde a un subgrafo cuyo hub raíz pertenece a esa entidad.
2.2. Condiciones
Cada condición contiene, según proceda:
- entidad;
- relación semántica opcional;
- atributo;
- operador;
- valor o valores.
Todas las condiciones de primer nivel son obligatorias. Si se añaden varias condiciones independientes, pueden ser satisfechas por nodos distintos del mismo subgrafo.
2.3. Grupos
Un grupo exige que todas sus condiciones sean satisfechas por el mismo nodo de la entidad elegida para el grupo.
Por ejemplo, dos condiciones independientes sobre actores pueden ser cumplidas por dos actores distintos. Si esas mismas condiciones se colocan dentro de un grupo de actor, debe existir un único actor que cumpla ambas.
2.4. Relaciones
La relación es opcional. Cuando se selecciona, la condición no sólo exige que exista un nodo con el atributo indicado, sino que ese nodo participe en la relación semántica seleccionada con la orientación indicada.
Oedipus conserva la firma semántica completa de la relación: origen, relación y destino.
3. Operadores
Los operadores disponibles dependen del tipo real del campo.
Existencia
- existe: el atributo está presente, incluso si su valor es nulo;
- no existe: el atributo no está presente;
- tiene valor: el atributo está presente y no es nulo;
- no tiene valor: el atributo está presente con valor nulo.
Igualdad
- igual / distinto: comparación normalizada, insensible a mayúsculas y acentos;
- es exactamente / no es exactamente: comparación literal;
- está en / no está en: comparación contra una lista de valores.
Texto
- contiene / no contiene: comprueba si el texto contiene la expresión indicada usando la normalización de Oedipus.
Orden y rango
Cuando el campo lo permite:
- menor que;
- menor o igual que;
- mayor que;
- mayor o igual que;
- entre;
- no entre.
4. Sugerencias de valores
En los operadores de valor simple y de rango para los que resulta útil, Oedipus consulta los valores reales existentes en el grafo mientras se escribe.
Las sugerencias son opcionales: el usuario puede elegir una coincidencia o continuar escribiendo libremente.
Ejemplo: si un campo contiene valores como Titularidad privada y Titularidad mixta (pública/privada), al escribir privada Oedipus puede ofrecer ambos valores.
Las sugerencias:
- proceden de los valores reales del campo seleccionado;
- son insensibles a mayúsculas y acentos en la búsqueda;
- no modifican la semántica del operador;
- no obligan a seleccionar una opción.
Los operadores que trabajan con listas múltiples mantienen su editor específico.
5. Navegación con teclado
Los formularios de consulta y análisis siguen un orden de tabulación estable y explícito.
Al pulsar Tab, el foco avanza por los controles en su orden lógico. Con Mayús + Tab se recorre el orden inverso.
Cuando una selección provoca que Oedipus reconstruya dinámicamente una parte del formulario, la aplicación conserva el contexto de foco para evitar que el teclado vuelva al principio de la página.
Los diálogos, como el editor de listas o el formulario del propósito de investigación, tienen su propio orden de tabulación.
6. Validar y crear la selección
Validar consulta comprueba que la especificación construida es coherente.
Analizar selección ejecuta la consulta sobre el grafo y crea un espacio de trabajo temporal con:
- los subgrafos raíz seleccionados;
- el contexto documental completo;
- las evidencias exactas que hicieron cumplir cada condición o grupo.
La validación no sustituye a la ejecución: una consulta puede ser estructuralmente válida y seleccionar cero subgrafos.
7. Diseñar el análisis
Una vez creada la selección, la vista Análisis permite definir qué se quiere medir sin alterar el filtro original.
7.1. Población analítica
Según la consulta, pueden estar disponibles distintas poblaciones:
- Subgrafos seleccionados: los hubs raíz;
- Todos los nodos de los subgrafos seleccionados: contexto documental completo;
- Nodos testigo del filtro: nodos concretos que hicieron verdadera una condición o grupo;
- Cadenas testigo del filtro: cadenas documentales concretas asociadas a la evidencia.
La elección de población determina qué significa una observación y qué recuentos son válidos.
7.2. Agrupar por
Las agrupaciones definen las dimensiones del resultado.
Cada dimensión puede situarse en:
- Filas de la tabla pivot;
- Columnas de la tabla pivot.
Los campos compatibles se descubren a partir del catálogo semántico y de la población seleccionada.
7.3. Recuentos
Oedipus permite, según la población:
- contar subgrafos distintos;
- contar nodos distintos;
- contar observaciones.
Un mismo análisis puede incluir varios recuentos.
7.4. Estadística descriptiva de los recuentos
Las estadísticas se aplican a los recuentos calculados, no a campos numéricos arbitrarios.
Entre las operaciones disponibles están:
- suma;
- mínimo;
- máximo;
- media;
- mediana;
- varianza;
- desviación estándar;
- percentil.
Cada estadística queda asociada explícitamente al recuento sobre el que se calcula.
8. Tabla pivot
Si existen dimensiones, Oedipus puede construir una tabla pivot.
El usuario elige qué recuento ocupa las celdas principales. Las agrupaciones se reparten entre filas y columnas.
La tabla muestra también las estadísticas seleccionadas para todos los recuentos a los que pertenecen, aunque el recuento de una estadística no sea el utilizado como valor principal de las celdas.
Las combinaciones sin observaciones se representan con cero cuando la medida es un recuento. Las estadísticas se calculan sobre la matriz completa, incluidos esos ceros cuando corresponda.
9. Resultados y tablas virtualizadas
Las tablas de resultados y pivot usan una cuadrícula virtualizada.
No hay paginación visual: el usuario puede desplazarse de forma continua por todas las filas y columnas disponibles.
La virtualización afecta únicamente al renderizado del navegador. No limita los datos del análisis:
- las visualizaciones reciben el resultado completo;
- los exportadores reciben el resultado completo;
- el digest determinista para la interpretación procesa todas las filas y todas las celdas pertinentes.
10. Visualizaciones
Oedipus propone sólo tipos de gráfico compatibles con la estructura del resultado.
Según las dimensiones y medidas pueden aparecer, entre otros:
- barras;
- barras agrupadas;
- líneas;
- área;
- ranking;
- histograma;
- caja y bigotes;
- violín;
- mapa de calor;
- matriz de burbujas.
Cuando el resultado contiene coordenadas compatibles, puede ofrecerse también un mapa.
Las visualizaciones no recalculan ni reagrupan de manera arbitraria el resultado analítico.
11. Exportar
La acción Exportar ZIP prepara un paquete de investigación que puede contener:
- definición humana de la consulta;
- especificación JSON de la consulta;
- definición humana del análisis;
- especificación JSON del análisis;
- tabla de resultados;
- tabla pivot, cuando existe;
- formatos JSON, CSV y XLSX;
- imágenes de gráficos;
- imagen del mapa, cuando existe.
El objetivo es conservar tanto los datos como la definición reproducible que los produjo.
12. Interpretación con modelo de lenguaje
La acción Interpretar resultados solicita primero el propósito de la investigación.
Ese texto orienta:
- la búsqueda académica;
- la interpretación del resultado.
No modifica la consulta ni los cálculos deterministas.
12.1. Cobertura de los datos
Antes de llamar al modelo, Oedipus procesa determinísticamente el 100 % de las filas y, cuando existe pivot, el 100 % de las celdas.
El modelo recibe:
- cardinalidades exactas;
- cobertura exacta;
- estadísticas deterministas;
- información semántica;
- una selección acotada de ejemplos o valores cuando el tamaño completo no cabe razonablemente en una petición.
Cuando una lista enviada al modelo no es exhaustiva, se marca expresamente como tal.
12.2. Continuaciones
Si el modelo alcanza su límite de generación antes de completar la explicación, Oedipus solicita automáticamente una continuación.
Durante esa espera se muestra un estado visible, por ejemplo:
- esperando la continuación del modelo;
- reintentando la conexión;
- reconectando.
La bibliografía no se muestra hasta que la respuesta queda certificada como completa.
13. Bibliografía académica
Oedipus utiliza SearXNG exclusivamente con los motores académicos configurados.
La pertinencia se controla en dos niveles:
- la consulta real del usuario determina si una fuente puede ser admitida;
- el propósito de investigación y el diseño analítico sólo ayudan a ordenar fuentes que ya son pertinentes.
Por tanto, compartir términos laterales —por ejemplo territorio, género o edad— no basta para que una publicación ajena al tema real de la consulta sea incorporada.
Si no se recuperan fuentes suficientemente pertinentes, Oedipus lo indica en lugar de completar la bibliografía con resultados web generales.
14. Interpretar correctamente los resultados
Conviene distinguir siempre:
- selección: qué subgrafos cumplen el filtro;
- población: qué unidades del contexto seleccionado se analizan;
- dimensión: cómo se agrupan;
- recuento: qué se cuenta;
- estadística: cómo se resume la distribución de un recuento.
Una cifra sólo debe interpretarse conociendo esas cinco decisiones.
La explicación del modelo de lenguaje es orientativa. Las cifras, cardinalidades y matrices deterministas de Oedipus son la referencia para cualquier comprobación cuantitativa.
15. Ayuda y documentación
La entrada Ayuda del menú principal abre esta documentación en una nueva pestaña en /documentation.
El cambio de idioma de Oedipus no altera los datos ni las consultas; sólo afecta a la interfaz y a la lengua solicitada para la interpretación.