Retrosantander es un experimento personal de Jaime Gómez-Obregón con los archivos fotográficos históricos de varias instituciones. El objetivo es aplicar los nuevos algoritmos de visión artificial y las capacidades de las modernas interfaces de usuario web para explorar formas innovadoras de poner estos archivos a disposición de la ciudadanía.
En esta conferencia (en Sevilla, en marzo de 2023) para la Asociación de Archiveros de Andalucía comparto mi visión y peripecia en este proyecto.
Apliqué por primera vez estas ideas al fondo fotográfico que publicaba en su sitio web el Centro de Documentación de la Imagen de Santander (CDIS), entidad dependiente del Ayuntamiento de Santander. La reacción del Ayuntamiento fue cerrar el sitio web del CDIS y retirar su archivo fotográfico de internet. Esto supuso el final de Retrosantander, a los pocos días de haber nacido.
El proyecto sigue desplegado en retrosantander.com, aunque por la razón expresada las fotografías ya no están disponibles. Este vídeo resume los cómos y porqués de esta frustrada iniciativa personal con el patrimonio fotográfico municipal de mi ciudad.
Para la posteridad queda la detallada autopsia que hice del difunto portal del CDIS.
Descartada la resignación, decidí seguir el experimento con el Fondo Fotográfico Jesús Elósegui, digitalizado entre 2002 y 2006 por la Sociedad de Ciencias Aranzadi y publicado con licencia abierta por la Diputación Foral de Gipuzkoa.
Así he podido continuar en retrogipuzkoa.com lo que inicié en Retrosantander. En este hilo Twitter he explicado mis razones.
Retrogipuzkoa captó la atención de la Diputación Foral de Gipuzkoa, que me ha permitido y animado a extender mi proyecto con la colección de Jesús Elósegui al resto de colecciones contenidas en su portal GureGipuzkoa («nuestra Guipúzcoa»).
Nace así una nueva versión de GureGipuzkoa, resultado de conectar todas las colecciones del portal de la Diputación con la herramienta que he ido construyendo y refinando para explorar estos archivos fotográficos.
Aparte he escrito la documentación sobre el scraping a guregipuzkoa.eus.
-
Búsqueda instantánea. A diferencia de la mayoría de los archivos, las búsquedas no se cursan en el servidor sino directamente en el navegador del usuario. Para este fin se envía el índice completo de las colecciones fotográficas al navegador del usuario. Así se pueden obtener resultados instantáneos de las búsquedas al tiempo que se teclea. Esto impone la limitación de que no se pueda buscar en todas las colecciones simultáneamente.
-
Visión artificial. He pasado las fotografías de los archivos por el servicio Amazon Rekognition, de visión artificial. Los ficheros JSON resultantes están alojados en el subdirectorio
detailsde cada proyecto, y son requeridos por la interfaz de usuario cuando este amplía una fotografía. -
Visor dinámico. [TBD].
-
Multicolección. [TBD].
-
Cartografía. El proyecto GureGipuzkoa ilustra la utilización de un mapa vectorial interactivo de la provincia, lo que hace posible vincular fotografías a municipios y mostrar todas las fotografías de uno.
-
Soporte multilingüe. El programa implementa una interfaz de usuario traducible. Se incorporan tres: castellano, inglés y euskera.
Este repositorio es multiproyecto, y en la actualidad aloja tres proyectos:
-
Retrosantander, desplegado en retrosantander.com: proyecto frustrado por la retirada del archivo del CDIS por parte del Ayuntamiento de Santander.
-
Retrogipuzkoa, desplegado en retrogipuzkoa.com.
-
GureGipuzkoa, desplegado en guregipuzkoa.com y actualmente en desarrollo. No confundir con guregipuzkoa.eus, que es el portal original de la Diputación Foral de Gipuzkoa que guregipuzkoa.com pretende superar.
La arquitectura de la aplicación, por lo tanto, pretende servir a múltiples archivos fotográficos desde una misma base de código común y extensible.
El programa determina qué proyecto servir en función del nombre del host. Para desarrollar en local es preciso, por lo tanto, añadir las entradas necesarias a /etc/hosts. Por ejemplo:
127.0.0.1 retrosantander retrogipuzkoa guregipuzkoa
Para iniciar el entorno de desarrollo basta instalar las dependencias y arrancar el servidor web invocando el script de package.json correspondiente al proyecto que se desea servir:
npm install
npm run retrogipuzkoaLa variable de entorno $PROJECT determina qué proyecto se servirá.
El stack tecnológico es deliberadamente minimalista y está basada en estándares W3C: web components, shadow DOM, HTML5, CSS y JavaScript (ES6). Parte del reto ha sido elaborar complementamente a medida todos los componentes, de forma que no hay dependencias externas, ni tampoco un backend o una base de datos.
El directorio .vscode aporta configuración para VS Code, incluyendo la definición de las tareas para arrancar los proyectos. Una de las tareas corre automáticamente al abrir VS Code, arrancando el servidor web de desarrollo con un proyecto.
El código se adhiere al formato conferido por Prettier con los mínimos ajustes configurados en la clave prettier del fichero package.json.
Con cada push a la rama main se lanza el despliegue de todos los proyectos en Netlify. Allí hay tantos sitios configurados como proyectos alberga este repositorio.
Todos los sitios en Netlify son idénticos y están conectados a este mismo repositorio. Cada uno tiene una variable de entorno PROJECT asignada al proyecto correspondiente; esto es, retrosantander, retrogipuzkoa o guregipuzkoa.
Adicionalmente, la aplicación sabe qué proyecto servir por el nombre del host desde el que es servida. Por ejemplo, cuando el nombre del host es retrogipuzkoa.com, retrogipuzkoa.localhost o retrogipuzkoa, se sirve el archivo fotográfico y las personalizaciones correspondientes a Retrogipuzkoa. Esto se discierne en app.js.
-
Retrosantander. No tengo permiso del CDIS del Ayuntamiento de Santander para servir el archivo fotográfico del CDIS. Por esta razón Retrosantander solicita los archivos directamente al servidor web del CDIS. Cuando el Ayuntamiento ha retirado este servidor y todo el archivo, Retrosantander ha dejado de poder brindarte acceso a él.
-
Retrogipuzkoa. La colección fotográfica explorable desde Retrogipuzkoa es servida directamente por el portal guregipuzkoa.eus, operado por la Diputación Foral de Gipuzkoa.
-
GureGipuzkoa. He obtenido permiso de la Diputación para copiar y distribuir el archivo fotográfico del portal guregipuzkoa.eus, que es distribuido por la Diputación con licencia Creative Commons. Yo he descargado (scraping) y copiado en Amazon S3 este archivo (fotografías y metadatos), y mi portal guregipuzkoa.com lo sirve desde ahí y no desde guregipuzkoa.eus como sucede en Retrogipuzkoa.
Utilizo Amazon Web Services (AWS) para almacenar y servir (Amazon S3) el archivo fotográfico de GureGipuzkoa y como servicio de visión artificial (Amazon Rekognition).
En este repositorio incluyo el script necesario para descargar las fotografías y metadatos del portal guregipuzkoa.eus (scraping), optimizar el tamaño de las fotografías convirtiéndolas al formato WEBP, cargarlas a Amazon S3 y aplicar sobre ellas los comandos proporcionados por Amazon Rekognition y obtener y procesar sus respuestas.
Las operaciones sobre los servicios AWS requieren de una cuenta de AWS y un fichero local con las credenciales y configuración del usuario de AWS.
En una instalación macOS:
-
~/.aws/config[default] region = us-east-1
-
~/.aws/credentiales[default] aws_access_key_id = <YOUR_ACCESS_KEY_ID> aws_secret_access_key = <YOUR_SECRET_ACCESS_KEY>
El script toma las credenciales y configuración de estos ficheros locales privados, de tal manera que así no hay riesgo de incorporarlas accidentalmente al repositorio ni necesidad de establecerlas en variables de entorno.
Este proyecto es software libre y se distribuye bajo la licencia GNU AFFERO GENERAL PUBLIC LICENSE versión 3.
Esto significa que puedes utilizar este programa para usos personales o comerciales, modificarlo a tu gusto y distribuirlo libremente. Pero al hacerlo tú también debes publicar el código fuente con tus aportaciones, distribuirlo bajo la misma licencia y preservar la información sobre la autoría original.
Para esto último debes mantener en tu sitio web, en un lugar discreto pero visible, una mención a Jaime Gómez-Obregón como autor original y un enlace a https://github.com/JaimeObregon/retrosantander/.
Si deseas que sea yo mismo quien adapte este programa al archivo fotográfico de tu entidad, quizá puedas contratarme: https://twitter.com/JaimeObregon.