buscador diacronico Documentation

buscador diacronico Documentation
Publicación 1.0
ProLNat@GE
07 de November de 2016
Índice general
1. Instalación
1.1. Prerequisitos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
1.2. Dependencias . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
1.3. Despliegue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
3
3
3
3
2. Web
5
3. API
3.1. Tipos de búsqueda . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
7
7
4. Soporte
9
5. Licencia
11
I
II
buscador diacronico Documentation, Publicación 1.0
Se trata de un sistema que permite buscar y visualizar los cambios léxicos de decenas de miles de palabras del castellano a lo largo del tiempo, concretamente en el eje temporal 1900-2009, utilizando como fuente de datos las representaciones semánticas construidas con los n-gramas de Google en español (45 mil millones). El usuario busca por una
palabra y un período de tiempo (entre 1 y N años) y el sistema devuelve el sentido de la palabra en cada año del rango
buscado. El sentido de una palabra se representa por el conjunto de palabras más similares en términos semánticos y
distribucionales. Por ejemplo, la palabra “cáncer“ está estrechamente vinculada en 1910 con “tuberculosis“ y “sífilis“
pero ya en 1960 los términos más próximos son “tumor“ y “carcinoma“.
La entrada del sistema es una estructura de datos en la que las palabras están asociadas mediante grados de similaridad
(Coseno) con otras palabras y por año. Estos datos fueron generados recientemente por el equipo ProLNat@GE (Pablo
Gamallo, Marcos Garcia) a través de técnicas y módulos de Procesamiento del Lenguaje Natural. Específicamente,
efectuamos el procesamiento semántico de 45 mil millones de n-gramas, disponibles después del escaneo de más de
1 millón de libros del proyecto “Google Books“. El procesamiento semántico consiste en transformar los n-gramas
en matrices distribucionales ‘palabra-contexto’. Se generó una matriz por año, donde cada palabra es un vector de
contextos. Finalmente, se calcula la similaridad entre vectores (palabras) y se selecciona, para cada palabra, las 20
más similares por año. En total, se generó una estructura de datos de más de más de 300M, que es la entrada del
demostrador.
El explorador diacrónico se puede usar de dos formas. Accediendo a la web o através de su API.
Índice general
1
buscador diacronico Documentation, Publicación 1.0
2
Índice general
CAPÍTULO 1
Instalación
1.1 Prerequisitos
Hay que aclarar que el explorador diacrónico obtiene los datos de similaridades entre palabras de una base de datos
MongoDB. Por lo tanto, es necesario que tengas un servidor de Mongo activo y accesible como fuente de datos.
Además, el explorador parte de que existen las carpetas clouds y cache, así como los archivos tasks y log. La ruta a los
mismos se pasa como argumento en la ejecución.
1.2 Dependencias
En segundo lugar, el explorador diacrónico se apoya en varias librerías para lograr alguna de sus funcionalidades.
Para facilitar la instalación de las mismas se incluye en la raíz del proyecto un fichero requirements.txt en el formato
adecuado para poder importarlas directamente con el comando pip.
pip install -r requirements.txt
1.3 Despliegue
El explorador está contruído en dos partes diferenciadas, por un lado la parte servidor, que es la encargada de consultar
la fuente de datos, procesarlos y formatearlos y la interfaz web, que simplemente consulta los datos proporcionados
por el servidor.
Para lanzar el servidor, nos situaremos dentro de la carpeta services y ejecutaremos el fichero main.py (pasando
como argumento la ruta en la que se encuentran los archivos necesarios). Esto levantará el servidor de CherryPy y
se conectará contra una base de datos MongoDB con los parámetros por defecto. En este momento, tendremos el
servidor levantado en http://localhost:8080/, por tanto ya podríamos hacer consultas, pasando los parámetros en la url,
por ejemplo: http://localhost:8080/busca/simple/fumar/1905/1910
cd services python main.py /ruta/archivos/proyecto
Para ejecutar la interfaz web debemos de contar con un servidor con PHP habilitado. Una vez lo tengamos, simplemente será necesario acceder a index.php para poder usar el sistema de consulta.
3
buscador diacronico Documentation, Publicación 1.0
4
Capítulo 1. Instalación
CAPÍTULO 2
Web
Se puede acceder al explorador pinchando en el siguiente enlace. Este portal brinda una forma de acceder a los datos proporcionados por la propia API. Para ello se apoya en la conocida biblioteca ‘ Highcharts
<http://www.highcharts.com/>‘_ para la representación de datos.
Por defecto, las búsquedas que se realizan son las denominadas búsquedas simples, en el período comprendido de
2005 a 2009. Tanto el tipo de búsqueda como el período de tiempo pueden ser cambiados si pulsamos en el icono de
búsqueda avanzada.
5
buscador diacronico Documentation, Publicación 1.0
6
Capítulo 2. Web
CAPÍTULO 3
API
La API está disponible mediante peticiones HTTP y no necesita ningún tipo de identificación, por lo tanto se puede acceder desde el mismo navegador. Las peticiones son de la forma
http://tec.citius.usc.es/buscador-diacronico/busca/tipo/palabra/añoInicio/añoFin.
Expliquemos que significa cada parte de la petición:
‘‘http://tec.citius.usc.es/buscador-diacronico/busca/‘‘ Es la base de la ruta, y en ningún caso cambiará.
tipo Hace referencia al tipo de búsqueda que se desea realizar, estos pueden verse detallados más abajo en la sección
Tipos de búsqueda.
palabra Es la palabra que se desea buscar. En el caso de la búsqueda de pares, se introducirán dos palabras separadas
mediante dos “-” seguidos.
añoInicio Es el año en el que se desea iniciar la consulta. Este año está incluído en los resultados.
añoFin Es el año en el que se desea finaliza la consulta. Este año está incluído en los resultados.
Por lo tanto, un ejemplo de petición para el tipo simple sería: http://tec.citius.usc.es/buscadordiacronico/busca/simple/fumar/1900/1901. La estructura de los resultados varia en función del tipo de consulta
realizada.
3.1 Tipos de búsqueda
Actualmente, el explorador da soporte a cuatro tipos diferentes de búsqueda:
simple Con esta búsqueda se obtienen las 20 palabras con una similaridad media más alta en el período de años
especificado para la palabra buscada. Los resultados se presentan en forma de un array compuesto por objetos,
todos ellos constan de dos atributos. El valor de la similaridad, definido por y, y el nombre de la palabra, definido
por name.
pares Si hacemos una búsqueda para encontrar la similariad entre pares de palabras, es necesario introducir las dos
palabras separadas por dos “-” consecutivos. El resultado de la consulta es un array conformado a su vez por
diferentes arrays en los que el primer elemento es el año, mientras que el segundo es el nivel de similaridad entre
el par de palabras en dicho año.
historico En este caso, obtendremos los datos de los índices de similaridad a través de los años para las palabras que
se relacionan con el término buscado. Es similar al método de búsqueda simple, pero seleccionando todas las
palabras en lugar de las 20 primeras y teniendo en cuenta el valor de similaridad en cada año en lugar de una
media. Los datos son devueltos en formato JSON. Cada atributo corresponde con otro JSON, que cuenta con
tres atributos, name, indicando el nombre de la palabra, visible, que valerá true o false en función de si la palabra
está entre las tres con mayor índice de similaridad, y, por último, data, que es otro array de objetos. Estes objetos
7
buscador diacronico Documentation, Publicación 1.0
denotan la similaridad en un año, y para ello tienen dos atributos, x, que corresponde al año e y que corresponde
a la similaridad.
nube Este tipo de búsqueda servirá para generar una imagen formada a partir de las palabras con mayor grado de
similiaridad. Se recibe como resultado la ruta de ésta.
transitiva Esta búsqueda se basa en la propiedad transitiva. Para clarificar esto imaginemos una estructura de árbol,
en el primer nivel estaría la raíz, es decir la palabra buscada, mientras que en el segundo nivel estarían las 20
palabras con un nivel de similaridad más alto. Por otro lado tendríamos un tercer nivel, formado por las palabras
que son similares a las del segundo nivel. Usando la propiedad transitiva, la palabra del primer nivel tendría
un grado de similariad con las palabras del 3 nivel, calculado mediante la suma de los grados de similariad y
aplicando una normalización de los resultados; obteniendo así valores entre 0 y 100 para la similaridad transitiva.
8
Capítulo 3. API
CAPÍTULO 4
Soporte
Si encuentra algún problema, póngase en contacto con nosotros enviando un email a pablo.gamallo@usc.es
9
buscador diacronico Documentation, Publicación 1.0
10
Capítulo 4. Soporte
CAPÍTULO 5
Licencia
El proyecto se encuentra bajo licencia GNUv3.
11