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

Dit artikel introduceert KaroSpace, een snel toegankelijk en lichtgewicht framework dat interactieve verkenning van multi-steekproef ruimtelijke omics-data mogelijk maakt door computatieknelpunten en afhankelijkheid van propriëtaire software te overwinnen.

De kern

KaroSpace: De "Google Maps" voor je cel-kaarten

Stel je voor dat je een gigantische stad hebt, maar dan niet gemaakt van gebouwen en straten, maar van miljarden levende cellen. In de medische wereld proberen wetenschappers al lang om deze stad in kaart te brengen. Ze willen weten: Welke cellen zitten waar? Wat doen ze? En hoe praten ze met elkaar?

Vroeger was dit als een raadsel zonder puzzelstukjes. Nu hebben we nieuwe technologieën die deze cellen kunnen fotograferen en hun "taal" (genen) kunnen lezen. Maar hier zit het probleem: de foto's zijn zo groot en complex, dat ze vaak vastlopen in de computer of alleen met dure, gespecialiseerde software te bekijken zijn. Het is alsof je een prachtige kaart hebt, maar alleen met een sleutel van een heel specifiek slot kunt openen.

Wat is KaroSpace dan?

De onderzoekers van het Karolinska Institutet in Zweden hebben KaroSpace bedacht. Je kunt KaroSpace zien als een slimme, draagbare vertaler die die enorme, ingewikkelde cel-data omzet in iets dat iedereen kan begrijpen: een interactieve website.

Hier is hoe het werkt, vergeleken met alledaagse dingen:

1. De "Magische Converter" (Van Data naar Website)

Stel je voor dat je een enorme, zware koffer vol met losse foto's en aantekeningen hebt (de wetenschappelijke data). KaroSpace pakt die koffer, vouwt alles netjes op en verpakt het in één enkele, lichte HTML-bestand (een webpagina).

• Het mooie ervan: Je hoeft geen zware server of dure software te installeren. Je opent gewoon die webpagina in je browser (zoals Chrome of Safari), en poef, daar is je hele dataset. Het is alsof je een zware koffer hebt omgezet in een postkaart die je direct kunt versturen naar een vriend.

2. De "Draadloze Telefoon" (Multi-sample)

Vaak hebben wetenschappers data van verschillende proefpersonen of verschillende weefsels. KaroSpace laat je al deze "steden" naast elkaar zien.

• De analogie: Stel je voor dat je een dashboard hebt met meerdere camera's. Je kunt schakelen tussen de camera van de longen, de camera van de hersenen en de camera van de darmen. Je kunt zelfs twee camera's naast elkaar zetten en met een schuifbalk (een "magic wand") door het weefsel wrijven om te zien hoe de cellen veranderen.

3. De "Luchtfoto met Zoom" (Interactief)

In KaroSpace kun je inzoomen tot op het niveau van één enkele cel.

• De analogie: Het is als Google Maps, maar dan voor je lichaam. Je kunt inzoomen op een specifieke wijk (een weefselgebied), en dan op een specifiek huisje (een cel). Je kunt zien welke buren er om die cel wonen (de "Hops"-functie) en of ze dezelfde "taal" spreken (dezelfde genen hebben).
• Je kunt ook zelf lijnen trekken om gebieden af te bakenen (bijvoorbeeld: "Hier begint de tumor"), en die opslaan om later verder mee te werken.

4. Waarom is dit zo belangrijk?

Vroeger was het delen van deze data als het delen van een zware, onleesbare database. Iedereen had dezelfde dure sleutel nodig.
Met KaroSpace is het als het delen van een YouTube-video. Iedereen kan het openen, iedereen kan erin rondkijken, en niemand hoeft een dure computer te hebben.

• Snelheid: Het werkt direct, zonder wachttijd.
• Samenwerking: Een wetenschapper in Zweden kan een bestand sturen naar een collega in Brazilië, en die kan het direct openen en er direct onderzoek naar doen.
• Grootte: Het kan zelfs omgaan met datasets van miljoenen cellen (zoals een hele stad in één keer bekijken), wat voorheen onmogelijk was zonder dat de computer vastliep.

Kortom:
KaroSpace haalt de "muren" weg rondom complexe wetenschappelijke data. Het maakt het mogelijk dat niet alleen de experts, maar ook studenten, artsen en geïnteresseerden direct kunnen zien wat er in onze cellen gebeurt, alsof ze door een raam naar een levende stad kijken. Het versnelt de ontdekking van nieuwe medicijnen en ziektebegrippen, omdat iedereen sneller en makkelijker samen kan werken.

Technische samenvatting

Probleemstelling

Ruimtelijke 'omics'-technologieën (spatial omics) maken het mogelijk om moleculaire en cellulaire organisatie in weefsels met hoge resolutie in kaart te brengen. Ondanks de snelle groei van deze datasets, die steeds complexer worden en meerdere monsters, condities en modaliteiten omvatten, blijft de interactieve exploratie ervan een groot probleem.

• Beperkingen: Bestaande tools zijn vaak afhankelijk van proprietaire software, hebben backend-servers nodig (wat de portabiliteit beperkt), of zijn niet ontworpen voor het gelijktijdig vergelijken van meerdere monsters.
• Huidige oplossingen: Commerciële viewers bieden diepe inspectie van één monster, maar missen vaak native ondersteuning voor multi-sample en multi-modaliteit. Open-source tools zoals Vitessce of CellxGene zijn vaak embedding-gericht (bijv. UMAP) en hebben beperkte ruimtelijke functionaliteit of vereisen zware infrastructuur.
• De noodzaak: Er is behoefte aan een lichtgewicht, platformonafhankelijk framework dat grote datasets direct in een webbrowser kan visualiseren zonder serverafhankelijkheid, zodat data eenvoudig gedeeld en geïnterpreteerd kan worden.

Methodologie

KaroSpace is een framework dat is ontworpen om voorverwerkte ruimtelijke 'omics'-data (meestal in het AnnData-formaat) om te zetten in een zelfstandige, interactieve HTML-viewer.

1. Data Input en Constructie:

   • De invoer is een .h5ad-bestand (uit Scanpy of Seurat).
   • Het systeem vereist 2D-ruimtelijke coördinaten (adata.obsm["spatial"]) en een identificator voor weefselsecties.
   • Als aanwezig, wordt een UMAP-visualisatie (adata.obsm["X_umap"]) gekoppeld.

2. Exportpijplijn en Optimalisatie:

   • Data-extractie: KaroSpace haalt cellulaire coördinaten, metadata en gen-expressievectoren op.
   • Compressie: Om de bestandsgrootte te verkleinen en laadtijden te verkorten, worden grote numerieke arrays (coördinaten, kleuren, grafiekranden) gesequenced als Base64-gecodeerde typed arrays.
   • Gen-encoding: Genen worden gecomprimeerd als dichte of sparse arrays; bij een hoge fractie nullen wordt automatisch gekozen voor sparse encoding.
   • Downsampling: Optionele downsampling per sectie is mogelijk om de browserbelasting te beperken.

3. Analyse en Grafieken:

   • Als een nabijheidsgrafiek (spatial_connectivities) beschikbaar is, berekent KaroSpace automatisch statistieken over de samenstelling van buurcellen en enrichment-scores (via permutatietesten).
   • Marker-genen worden berekend met scanpy.tl.rank_genes_groups (t-test).

4. Interactieve Viewer (Frontend):

   • De output is een statische HTML-bestand dat in elke moderne browser werkt (geen backend-server nodig).
   • Functies: Zoomen, panteren, polygon-based selectie (lasso-tool), "Magic wand" voor automatische aggregatie van celcompositie, en handmatige annotatie van weefselregio's (exporteerbaar als JSON).
   • Vergelijking: Een "Variable slider" stelt gebruikers in staat om twee variabelen (bijv. annotatie vs. genexpressie) simultaan te vergelijken in dezelfde ruimtelijke context.
   • Hops: Visualisatie van buurcellen op drie verschillende "hop"-niveaus.

5. Implementatie en Tools:

   • KaroSpaceBuilder: Een desktop GUI (voor macOS, Windows, Linux) die gebruikers helpt bij het configureren en exporteren van viewers zonder code te hoeven schrijven.
   • Webportaal: Een lichtgewicht statische webapplicatie (hosted op Cloudflare Pages/R2) die een registry van datasets beheert en de viewers faciliteert.

Belangrijkste Resultaten

Het team heeft KaroSpace getest op een zeer diverse reeks ruimtelijke 'omics'-datasets, variërend in grootte, technologie en soort:

• Diversiteit: Ondersteuning voor DBiT (RNA/ATAC), CODEX (proteïne), MERFISH, Xenium, Visium HD, CosMx, HybISS en Open-ST.
• Schaalbaarheid: De tool kan omgaan met datasets van miljoenen cellen (bijv. MERFISH datasets met >6,8 miljoen cellen).
• Bestandsgrootte: Ondanks de grote datasets zijn de gegenereerde HTML-rapporten relatief compact (varieerend van ~23 MB tot ~497 MB), wat deeltbaarheid vergemakkelijkt.
• Prestaties: De viewers laden snel in Chrome. Er is echter een prestatieverschil opgemerkt in Safari, dat trager is vanwege de zware afhankelijkheid van Canvas-rendering.
• Toepassing: De tool is succesvol gebruikt voor het visualiseren van complexe biologische scenario's, zoals acute longletsel, fibrose, kanker (long, pancreas) en embryonale ontwikkeling.

Significantie en Bijdragen

KaroSpace biedt een unieke oplossing voor de huidige uitdagingen in de ruimtelijke biologie:

1. Onmiddellijke Toegankelijkheid: Door het verwijderen van de afhankelijkheid van backend-servers en het gebruik van zelfstandige HTML-bestanden, kunnen onderzoekers data direct delen en bekijken zonder complexe installaties.
2. Multi-sample Exploratie: Het is een van de weinige tools die native ondersteuning biedt voor het vergelijken van meerdere monsters en modaliteiten binnen één interface.
3. Transparantie en Reproductibiliteit: De tool ondersteunt transparante data-deling en maakt het mogelijk voor een bredere gemeenschap (ook buiten de bio-informatica) om complexe ruimtelijke data te interpreteren.
4. Hypothesegeneratie: Door de interactieve aard (annotatie, selectie, vergelijking) stimuleert KaroSpace het genereren van nieuwe biologische hypotheses en samenwerking.

Conclusie:
KaroSpace vult een cruciale lacune in de ruimtelijke 'omics'-workflow door een brug te slaan tussen zware computationele verwerking en gebruiksvriendelijke, interactieve visualisatie. Het democratiseert de toegang tot grote ruimtelijke datasets en stelt onderzoekers in staat om sneller inzichten te winnen in de biologische organisatie van weefsels.