KaroSpace: a rapid-access framework for interactive exploration of multi-sample spatial omics data

KaroSpace es un marco de acceso rápido y agnóstico a pipelines que permite la exploración interactiva de datos de ómicas espaciales multiespecimen y multimodales, superando las limitaciones computacionales y de software propietario mediante un diseño ligero y flexible.

Lo esencial

Imagina que tienes un mapa del tesoro increíblemente detallado de un tejido biológico (como un cerebro o un pulmón). Este mapa no solo te dice dónde están las "islas" (las células), sino que también te dice qué "idioma" (genes) están hablando y qué "herramientas" (proteínas) están usando.

El problema es que estos mapas son tan gigantes y complejos que, hasta ahora, solo los expertos con supercomputadoras y software costoso podían navegar por ellos. Si querías compartir tu mapa con un colega, tenía que ser como enviar una caja de mudanza llena de archivos pesados y confusos.

KaroSpace es la solución a este problema. Es como un "traductor mágico y portátil" que convierte esos mapas biológicos gigantescos en una página web interactiva y sencilla que cualquiera puede abrir en su navegador, sin instalar nada.

Aquí te explico cómo funciona usando analogías cotidianas:

1. El Problema: El "Archivador Gigante"

Antes, explorar datos espaciales era como intentar buscar una aguja en un pajar, pero el pajar estaba en un edificio cerrado al que solo tenías acceso con una llave especial (software propietario). Además, si querías comparar dos pajar diferentes (dos muestras de tejido), tenías que sacar todo el contenido de ambos, mezclarlos en una mesa gigante y esperar horas a que alguien organizara todo.

2. La Solución: KaroSpace, el "Kiosco de Noticias Interactivo"

KaroSpace toma esos datos complejos y los convierte en un kiosco digital (un archivo HTML) que puedes enviar por correo electrónico o subir a una web.

• Sin servidores, solo magia: A diferencia de otros sistemas que necesitan un "centro de control" (servidor) para funcionar, KaroSpace es como un libro de cuentos mágico que se abre solo en tu computadora. No necesitas internet para verlo una vez que lo tienes, ni necesitas pagar licencias caras.
• El "KaroSpaceBuilder": Imagina que tienes una caja de herramientas (un programa para Mac, Windows o Linux). Metes tus datos brutos (el archivo .h5ad, que es como la materia prima de la biología) en la caja, le das al botón "Crear", y ¡zas! Te devuelve un mapa interactivo listo para usar.

3. ¿Qué puedes hacer con este "Kiosco"?

Una vez que abres el mapa de KaroSpace en tu navegador, tienes superpoderes:

• La Vista de "Agujero de Bala" (Zoom): Puedes ver el tejido completo y luego hacer zoom hasta ver una sola célula, como si usaras una lupa mágica.
• El "Varita Mágica" (Magic Wand): Si ves una zona del tejido que te interesa (por ejemplo, un tumor), puedes dibujar un círculo alrededor de ella con el ratón. El sistema automáticamente te dice: "Oye, dentro de este círculo hay 500 células de este tipo y 200 de aquel otro".
• El "Control Deslizable" (Slider): Imagina que tienes dos mapas transparentes uno encima del otro. Con un deslizador, puedes ver cómo cambia la expresión de un gen mientras te mueves por el tejido, o comparar dos condiciones diferentes (como un tejido sano vs. uno enfermo) en el mismo espacio.
• El "Vecino del Barrio" (Hops): Puedes hacer clic en una célula y preguntar: "¿Quién vive al lado?". El sistema te muestra a los vecinos directos, los vecinos de los vecinos, etc., para entender cómo se comunican las células.

4. ¿Por qué es tan importante?

Hasta ahora, los científicos publicaban sus descubrimientos en papel, pero nadie podía "tocar" los datos para verificarlos o hacer nuevos descubrimientos.

KaroSpace cambia las reglas del juego:

• Es como enviar un PDF, pero interactivo: Puedes compartir tu investigación con un colega en otro país, y ellos pueden explorar tus datos exactamente como tú lo hiciste, sin necesidad de instalar programas raros.
• Funciona con millones de células: Ha sido probado con mapas que tienen millones de puntos (células), desde cerebros de ratones hasta pulmones humanos, y sigue funcionando rápido.
• Es para todos: Desde el biólogo experto hasta el estudiante curioso, cualquiera puede entrar, hacer clic y empezar a entender la biología espacial.

En resumen

KaroSpace es como convertir una biblioteca de libros antiguos y polvorientos en una biblioteca digital interactiva donde puedes pasar las páginas, subrayar, hacer zoom y compartir el libro con un solo clic. Hace que la biología espacial, que antes era un territorio exclusivo para unos pocos, se convierta en un paisaje abierto donde todos pueden explorar y descubrir nuevos secretos de la vida.

Resumen técnico

Resumen Técnico: KaroSpace

1. El Problema
Las tecnologías de ómica espacial han permitido mapear la organización molecular y celular en tejidos con alta resolución. Sin embargo, la exploración interactiva de estos datos enfrenta barreras significativas:

• Complejidad y Volumen: Los conjuntos de datos son cada vez más grandes y complejos, abarcando múltiples muestras, condiciones y modalidades.
• Limitaciones de Software: La exploración efectiva está restringida por cuellos de botella computacionales y la dependencia de infraestructuras de software propietarias o de código cerrado.
• Falta de Interoperabilidad: Las herramientas existentes (como Vitessce, TissUUmaps o CellxGene) a menudo carecen de soporte nativo para la exploración de múltiples muestras y multimodalidad, o dependen de servidores backend que dificultan el intercambio transparente de datos y la colaboración.

2. Metodología
KaroSpace es un marco de trabajo diseñado para la exploración centrada en células (o píxeles/matriz de captura) de datos de ómica espacial multi-muestra y multi-modalidad. Su metodología se basa en los siguientes pilares:

• Enfoque "Serverless" (Sin Servidor): A diferencia de las soluciones tradicionales, KaroSpace convierte objetos de datos espaciales preprocesados (formato .h5ad de Scanpy o Seurat) en un único archivo HTML autocontenido. Esto elimina la necesidad de un servidor backend, mejorando la portabilidad y la capacidad de compartir datos.
• Pipeline de Exportación:
  • Entrada: Acepta archivos .h5ad que contienen coordenadas espaciales 2D (adata.obsm["spatial"]), identificadores de sección de tejido y metadatos.
  • Procesamiento: Extrae coordenadas, metadatos, capas de color y vectores de expresión génica. Aplica técnicas de optimización como la serialización de matrices numéricas grandes en arrays tipados codificados en Base64 y el uso de codificación dispersa (sparse) para genes con alta fracción de ceros.
  • Análisis Integrado: Calcula automáticamente estadísticas de composición vecinal (si existe un gráfico de conectividad espacial) y genes marcadores óptimos utilizando pruebas t-test (scanpy.tl.rank_genes_groups).
• Interfaz de Usuario (Frontend):
  • Implementada con HTML, CSS y JavaScript vanilla (sin frameworks pesados).
  • Soporta vistas de múltiples muestras (vista de cohorte) y vistas detalladas por muestra.
  • Incluye herramientas interactivas: selección de polígonos ("magic wand"), anotación manual de regiones de tejido (exportable a JSON), visualización de vecindarios ("Hops"), y un deslizador de variables para comparar dos variables opuestas simultáneamente en el mismo contexto espacial.
• Herramientas de Acceso:
  • API de Python: Para usuarios programadores.
  • KaroSpaceBuilder: Una aplicación de escritorio (disponible para macOS, Windows, Linux) con interfaz gráfica (GUI) que simplifica la creación de visores sin necesidad de escribir código.

3. Contribuciones Clave

• Exploración Multi-Muestra Nativa: Permite comparar directamente múltiples muestras y condiciones en una sola interfaz, algo que a menudo falta en las herramientas comerciales.
• Soporte Multi-Plataforma y Multi-Modalidad: Funciona con una amplia gama de tecnologías de ómica espacial, incluyendo:
  • Transcriptómica: Xenium, MERFISH, Visium HD, Open-ST, HybISS, CosMx.
  • Proteómica: CODEX.
  • Multi-ómica: DBiT-seq (ARN + ATAC).
• Portabilidad y Compartición Transparente: Al generar un solo archivo HTML, facilita la distribución de datos masivos sin depender de infraestructuras de hosting complejas.
• Escalabilidad: Ha demostrado capacidad para manejar conjuntos de datos con millones de células (ej. MERFISH con >6.8 millones de células).

4. Resultados
Los autores validaron KaroSpace generando visores interactivos para una diversidad de conjuntos de datos (Tabla 1 del artículo), que incluyen:

• Escala: Desde tejidos pequeños hasta muestras completas de ratón y humano con cientos de miles a millones de células.
• Tamaño de Archivo: Los reportes generados oscilan entre ~23 MB y ~500 MB, dependiendo del número de genes y células.
• Rendimiento: La carga es rápida en navegadores como Chrome. Se nota una mayor latencia en Safari debido a la dependencia de renderizado basado en Canvas, lo cual se identifica como un área de optimización futura.
• Funcionalidad: Se demostró exitosamente la capacidad de filtrar por covariables, visualizar la expresión génica, realizar anotaciones manuales y exportarlas de nuevo al objeto AnnData original para análisis posteriores.

5. Significado e Impacto
KaroSpace representa un cambio de paradigma hacia la accesibilidad inmediata y la colaboración abierta en la biología espacial.

• Democratización: Permite que la comunidad científica explore datos complejos sin barreras técnicas de infraestructura.
• Flujo de Trabajo Colaborativo: Facilita la generación de hipótesis y el análisis colaborativo al permitir compartir datos completos e interactivos de manera sencilla.
• Complemento a Flujos Existentes: No reemplaza los flujos de trabajo computacionales existentes, sino que los complementa proporcionando una capa de visualización e interpretación rápida y transparente.
• Futuro: A medida que los datos de ómica espacial sigan escalando, KaroSpace ofrece una solución práctica para visualizar y entender mecanismos biológicos relevantes en un contexto espacial, expandiendo el rango de usuarios capaces de interpretar estos datos.

El código fuente y los visores interactivos generados están disponibles públicamente en GitHub y en el portal web karospace.se.