$$\rightleftharpoonup{xx}$$
$$\longleftharp{xx}$$,
$$\longrightharp{xx}$$,
Na de succesvolle uitvoering van de workflow worden verschillende tabellen en figuren gegenereerd, zoals aangegeven in figuur 2. Figuren worden in de map /figures geplaatst (Figuur 6, Figuur 7, Figuur 8, Aanvullende Figuur 1, Aanvullende Figuur 2, Aanvullende Figuur 3, Aanvullende Figuur 4) en tabellen worden in de opgegeven map /resultaten geplaatst.
Als de uitvoering van de workflow niet lukt, kan dit voornamelijk te wijten zijn aan: technische fouten die bijvoorbeeld worden veroorzaakt door onvoldoende geheugen (vooral in de eerste stap waar een grote dataset met één cel wordt geladen), onjuist geformatteerde gegevens (bijv. niet-overeenkomende sample_id kolommen tussen datasets) of onjuiste specificaties in de configuratiebestanden (bijv. het uitsluiten van te veel functies). In dit geval verschijnt er meestal een foutmelding in het Jupyter-notebook-script tijdens de uitvoering en worden er geen plots en gegevens gegenereerd. Het wordt aanbevolen om de standaardconfiguratiebestanden te gebruiken zoals gegenereerd tijdens de uitvoering van het script en alleen specifieke parameters te wijzigen zoals beschreven in het protocol.
Een succesvolle uitvoering wordt aangegeven door het genereren van de resulterende plots en tabellen, en elke stap zal aanvullende informatie onthullen over de gegevens en de belangrijkste variantiepatronen die erin besloten liggen. Toch zal niet noodzakelijkerwijs elke uitvoering biologisch bruikbare en interpreteerbare resultaten opleveren. Vaak worden de gegevens gekenmerkt door grote technische effecten en verschillende verdelingen, waarmee rekening moet worden gehouden in de stap 'Data Pre-Processing and Harmonization' of in het 'MOFA9-model ' (dat het ook mogelijk maakt om verschillende verdelingen voor de invoergegevenstypen te specificeren) om de variatie van de gegevens te kunnen extraheren die de onderliggende biologische processen weerspiegelt.
Binnen de gepresenteerde workflow kunnen verschillende multi-omische datasets als input worden gebruikt. Momenteel accepteert de workflow het populaire .h5ad-bestandsformaat voor enkelcellige gegevens en een zeer algemeen .csv bestandsformaat voor alle andere datasets als invoer (Afbeelding 3). Het is gebruikelijk dat verschillende omic-datasets zeer verschillende bestandsindelingen hebben. Om de uitvoering van de workflow niet te beperken tot specifieke bestandsformaten, wordt .csv als een zeer algemeen formaat gebruikt. Daarom kunnen allerlei verschillende omics-datasets worden gebruikt als input voor de workflow, maar moeten deze eerst worden geconverteerd naar het bijbehorende .csv-formaat zoals aangegeven in figuur 3 voordat ze binnen deze workflow worden gebruikt. Dit kan worden voorbereid met behulp van een spreadsheet of omic-specifieke software. Om de verschillende omics-datasets voor te verwerken, zijn er verschillende opties beschikbaar binnen de workflow om verschillende voorverwerkings- en normalisatiestappen (bijv. aanpassing van de bibliotheekgrootte, logtransformatie, standaardisering van monsterkwantielen) toe te passen op de verschillende invoerdatasets door het 02_Pre_Processing_Configs.csv - en 02_Pre_Processing_Configs_SC.csv-bestand te configureren (Figuur 2). Desalniettemin zijn de beschikbare opties hier voornamelijk gebaseerd op de specifieke inputgegevens die beschikbaar zijn in de hier gepresenteerde dataset (scRNA-seq, cytokine-assay, proteomics, prime-seq). In het geval dat andere omics/gegevenstypen worden gebruikt, kan het nodig zijn om aanvullende omic-specifieke normalisatiestappen toe te passen volgens bestaande best practices. In dit geval kunnen de gegevens in een reeds voorbewerkte vorm aan de workflow worden overgedragen en samen met de andere datasets worden geïntegreerd zonder verdere voorbewerkingsstappen toe te passen. In veel gevallen is het toepassen van de stap Feature Wise Quantile Normalization nuttig om de verdeling van alle gegevenstypen af te stemmen op een normale verdeling en om de downstreamanalyse tussen de verschillende invoerfuncties beter vergelijkbaar en compatibel te maken met de modelspecificatie van Gaussiaanse ruis.
Tijdens de uitvoering van de workflow worden verschillende plots en outputs gegenereerd die het proces van gegevensintegratie en de daaropvolgende biologische downstream-interpretatie ondersteunen. Voor scRNA-seq-gegevens geeft de grafiek in FIG01_Amount_of_Cells_Overview (figuur 6) aan welke celtypen mogelijk te weinig cellen per monster en celtype bevatten om een genexpressiesignaal betrouwbaar te meten, terwijl voor latere analyses de gemiddelde waarde over alle cellen van een celtype per monster wordt gebruikt als een expressieschatting (psedobulk-benadering). In deze use-case sluiten we celtypen uit die in de meeste monsters minder dan drie cellen hebben.
De variantie-decompositiegrafiek FIG03_Overview_Variance_Decomposition (Figuur 7, aanvullende figuur 1) kan aangeven hoe goed de verschillende gegevensbronnen integreren en hoeveel van de variantie in de verschillende gegevensbronnen wordt gedeeld en uniek is voor elke gegevensbron. Het testen van verschillende voorbewerkingsstrategieën op de hier gebruikte dataset laat bijvoorbeeld zien dat het verwijderen van de Feature Wise Quantile-normalisatiestap uit de voorverwerking leidt tot latente factoren die meer gericht zijn op specifieke gegevensweergaven en de integratie van de proteomische gegevens met de andere gegevensbronnen vermindert. Dit is te zien in de verminderde hoeveelheid verklaarde variantie (aanvullende figuur 1B). Het uitvoeren van het MOFA-model zonder enige filtering van functies of zonder normalisatie leidt tot minder gedeelde variantie tussen de verschillende weergaven die door de latente factoren worden vastgelegd (aanvullende figuur 1C). Dit geeft aan dat latente factoren voornamelijk specifieke technische effecten van het gegevenstype weerspiegelen. Daarnaast kan het MOFA9-model zelf ook waarschuwingen retourneren in geval van slecht voorbewerkte gegevens. Een voorbeeld van een dergelijke waarschuwing wordt weergegeven in aanvullende figuur 1 voor de alternatieve voorverwerkingsconfiguraties MI_v2 en MI_v3 (de specifieke voorbeeldconfiguratiebestanden worden opgeslagen in de gekloonde GitHub-opslagplaats in de map config_examples ).
Bovendien kunnen de resultaten na het uitvoeren van het MOFA-model worden geëvalueerd in verschillende stroomafwaartse analyses door de factor te associëren met bekende biologische meta-informatie over de monsters, evenals technische en andere verstorende covariabelen (04_Downstream_Factor_Analysis) om de waarschijnlijke oorzaak te identificeren voor de variatie die door de factoren wordt vastgelegd. Als een van de factoren van de MOFA-modellen bijvoorbeeld sterk geassocieerd is met een van de technische covariabelen (zoals batchinformatie), kan dit erop wijzen dat deze factor eerder technische variatie binnen de gegevens vastlegt in plaats van biologische variatie.
Om de biologische interpretatie in het deel van de stroomafwaartse analyse te verfijnen, worden hier een aantal bevindingen op basis van de inputdataset (een meer verfijnde interpretatie is te vinden in de oorspronkelijke publicatie11) uiteengezet. In de eerste stap konden we vaststellen dat we met de toegepaste voorbewerkingsstrategie verschillende factoren vinden die variantie vastleggen tussen meerdere celtypen, maar ook over andere omics-gegevenstypen (Figuur 7A). Factor 2 legt bijvoorbeeld variantie vast in de klinische invoerkenmerken en in verschillende celtypen van de scRNA-seq-dataset. Door de eerste drie factoren te associëren met relevante klinische covariabelen zoals 'CRP' en 'CK' (Figuur 7B) en de verschillen in factorwaarden voor de verschillende subgroepen van patiënten te onderzoeken: 'Controle (inclusief CCS en niet-CCS) vs. 'ACS' gemeten op de verschillende tijdstippen (TP1-TP4) (Figuur 7C), vinden we ook dat Factor2 significant associeert met de 'CK'-waarde en Factor3 met de 'CRP'-waarde. Tegelijkertijd vertonen 'ACS'-monsters op TP1 en TP2 (die de acute fase van de immuunrespons op een hartinfarct (MI) weerspiegelen) een toename van factorwaarden in vergelijking met 'Control'- en latere tijdstipsmonsters (TP3/TP4). CK is een bekende marker van myocardiale schade en wordt doorgaans gekenmerkt door verhoogde waarden bij TP1/TP2, vergelijkbaar met het patroon dat door Factor2 is vastgelegd.
Om inzicht te krijgen in de biologische processen die Factor2 vormgeven, evalueren we de belangrijkste kenmerken van de factor door te kijken naar de tabel met functiegewichten die door het model wordt gegenereerd (03_Weight_Data.csv). Als we de top 1% van functies met de hoogste absolute weging op de factor analyseren, vinden we voornamelijk CD4. TCM en CD14. Mono-afgeleide kenmerken zijn oververtegenwoordigd in vergelijking met hun totale aantal invoerkenmerken (Figuur 8A), wat aangeeft dat deze celtypen zeer relevant zijn in het ontstekingsproces na MI (OPMERKING: in het geval dat er geen functiegewijze kwantitatieve normalisatie werd toegepast in de voorverwerking, kunnen verschillende verdelingen van de kenmerken dit resultaat ook beïnvloeden en moet de evaluatie afzonderlijk worden uitgevoerd per gegevenstype). Analyse van de belangrijkste functies van de CD4. TCM-celtype op de factor, vinden we verschillende interessante genen zoals EIF3E18 die nodig zijn voor robuuste T-celactivering en HMGB119, die de expansie en activering van T-cellen bevordert (Figuur 8B). Vervolgens voeren we de pathway-verrijkingsanalyse uit met behulp van immuunpathways uit de REACTOME20-database als een pathway set (Prepared_Pathway_Data.csv). We vinden verrijking voor verschillende 'Interleukine'-routes, waaronder 'Interleukine-6'-signalering. De expressieniveaus van verschillende genen in verschillende celtypen van de scRNA-seq-gegevens en de 'IL6'-cytokinewaarden gemeten door de Cytokine-assay droegen bij aan dit resultaat (Figuur 8C). Het identificeren van deze gedeelde patronen in verschillende gegevenstypen benadrukt de toegevoegde waarde van een geïntegreerde analyse. Over het algemeen kan deze benadering ook verschillende andere factoren identificeren die de ziektetoestand of het bijbehorende behandelingsresultaat en de onderliggende meercellige immuunprogramma's weerspiegelen, zoals meer in detail wordt beschreven in de overeenkomstige publicatie11.
Om het voordeel van geïntegreerde analyses over meerdere omics verder te benadrukken, werd dezelfde workflow ook uitgevoerd, alleen inclusief de proteomics-invoergegevens (aanvullende figuur 4). Als we de resulterende factoren analyseren, vinden we op dezelfde manier als de geïntegreerde analyse een factor (Factor1) die sterk correleert met de 'CRP'-waarde. Dit patroon beschrijft de belangrijkste bron van variatie binnen de proteomics-gegevens en is ook afgestemd op een deel van de variatie in de andere datasets zoals vastgelegd door 'Factor3' in de geïntegreerde analyse (Figuur 7C). Een soortgelijk patroon zoals aangegeven door Factor2 dat het tijdsverloop van ontsteking in de geïntegreerde analyse vastlegt, kan echter niet alleen worden geïdentificeerd op basis van proteomics-gegevens.
De geïntroduceerde workflow en het MOFA9-model zelf zijn in hoge mate aanpasbaar met veel instelbare parameters. Daarom is het belangrijk om de resultaten van verschillende configuraties te visualiseren en systematisch te vergelijken. Om deze taak te vergemakkelijken, is de uiteindelijke uitvoer die door de werkstroom kan worden gegenereerd, een vergelijking van verschillende benoemde runs van de pijplijn met verschillende parameters in de voorverwerking en modelschatting. Het MOFA-model kan bijvoorbeeld worden geschat met verschillende aantallen latente factoren (aanvullende figuur 2A) of weergaven met een lager aantal kenmerken kunnen worden gewogen (aanvullende figuur 3A). Het configureren en uitvoeren van het laatste script van de werkstroom '07_Compare_Models' levert verschillende grafieken op om de gelijkenis tussen verschillende pijplijnuitvoeringen te beoordelen. FIG07_Variance_Model_Comparison (aanvullende figuur 2B, aanvullende figuur 3B) toont een vergelijking van de totale verklaarde variantie voor elke weergave voor verschillende runs. De correlatie van de factorwaarden en het gewicht van de kenmerkfactoren tussen de verschillende runs kan aangeven hoeveel de resultaten veranderen bij het wijzigen van een bepaalde parameter (aanvullende figuur 2C, aanvullende figuur 3C). Hier leidt het wijzigen van het aantal factoren slechts tot kleine veranderingen in de geschatte factorwaarden en kenmerkgewichten (aanvullende figuur 2C). Het wijzigen van de weging van de gegevensweergave resulteert in een veel hogere verklaarde variantie in de weergaven met een lager aantal kenmerken, bijvoorbeeld de 'klinische' weergave (aanvullende figuur 3B). Niettemin zijn de relevante kenmerken binnen de eerste drie factoren nog steeds sterk gecorreleerd met die welke zijn afgeleid uit de ongewogen versie (aanvullende figuur 3C).
Met de gegenereerde modeluitvoer .csv bestanden in de resultatenmap (bijv. de geschatte factor en kenmerkgewichten) kunnen verdere individuele stroomafwaartse analyses worden uitgevoerd. Alle code en benodigde configuratiebestanden (inclusief documentatie) zijn beschikbaar op GitHub op https://github.com/heiniglab/mofa_workflow. De singulariteitsafbeelding die is gemaakt om een eenvoudige installatie van de benodigde conda-pakketten voor de analyse mogelijk te maken, kan worden gedownload van https://doi.org/10.5281/zenodo.10815146. Een kleine voorbeelddataset die kan worden gebruikt om een eerste test van de pijplijn uit te voeren, kan ook worden gedownload van hetzelfde zenodo-record.

Figuur 7: Analyse van de MOFA-output. Na het uitvoeren van het MOFA-model (03_Run_MOFA.ipynb) en de stroomafwaartse analyse van factorwaarden (04_Downstream_Factor_Analysis.ipynb) worden verschillende grafieken gegenereerd: (A) FIG03_Overview_Variance_Decomposition: geeft een visualisatie van de verklaarde variantie van de geschatte MOFA-factoren binnen de verschillende weergaven. Heatmap (links): toont het percentage van de totale variantie van een weergave vastgelegd door een factor voor elke weergave. Staafdiagram (rechts): toont het totale percentage van de variantie dat wordt vastgelegd door alle factoren voor elke weergave. (B) FIG04_Factor_Association_Numerical_Features: toont de Pearson-correlatie van de factorwaarden met gekozen numerieke steekproefcovariaten, hier: klinische variabelen (CRP, CK). (C) FIG04_Factor_Association_Categorical_Features: toont het verschil in factorwaarden voor categorische steekproefcovariabelen als een boxplot. Hier worden de factorwaarden van factoren 1-3 voor elk tijdstip van ACS- en controlepatiënten vergeleken. Klik hier om een grotere versie van deze figuur te bekijken.

Figuur 8: Analyse van MOFA-kenmerken. Na het uitvoeren van de stroomafwaartse analyses (04_Downstream_Factor_Analysis.ipynb, 05_Downstream_Investigate_Features.ipynb) worden verschillende grafieken gegenereerd. Alle grafieken hier visualiseren MOFA Factor 2: (A) FIG04_Top_Feature_Overview_per_Factor: Heatmap (links) toont voor elke weergave het percentage variantie dat wordt vastgelegd door de geselecteerde factor. Staafdiagrammen (rechts) geven de relevantie van de kenmerken van de verschillende weergaven voor de factor aan. Aan de linkerkant wordt het totale aantal functies van een specifieke weergave binnen de top 1% van hoogst gerangschikte functies over weergaven op de factor gegeven. Aan de rechterkant wordt het percentage gegeven, waarbij het totale aantal van de top 1% wordt gedeeld door het totale aantal objecten van die weergave. (B) FIG05_Heatmap_Feature_Overview: Heatmap (links) toont de hoogste rangschikking van 1% van de functies van de CD4. TCM-celtype: de genormaliseerde expressiewaarden van elk monster, waarbij de patiënten uit de 'Controlegroep' (CCS en niet-CCS) worden vergeleken met de verschillende tijdstippen voor 'ACS'-patiënten. De barplot (rechts) toont het gewicht van de objecten. De richting van het teken van het gewicht is eerder aangegeven aan de linkerkant voor de namen van de celtypen: '+' positieve factor gewicht; '-' negatieve factor weging. (C) FIG06_Pathway_and_Genes: toont het gewicht van de genen met de hoogste 25% rangschikking voor de factor die behoren tot verrijkte interleukineroutes. In de heatmap bovenaan worden ze gemiddeld over weergaven, en in de heatmap onderaan weergegeven per weergave. Klik hier om een grotere versie van deze figuur te bekijken.
Aanvullende figuur 1: Effecten op de harmonisatie van de gegevens. De figuur toont FIG03_Overview_Variance_Decomposition voor verschillende configuraties voor gegevensvoorverwerking: visualisatie van de verklaarde variantie van de geschatte MOFA-factoren binnen de verschillende weergaven. Heatmap (links): toont voor elke weergave het percentage van de totale variantie van een weergave dat wordt vastgelegd door een factor. Staafdiagram (rechts): toont voor elke weergave het totale percentage variantie dat door alle factoren wordt vastgelegd. (A) De configuratie ('MI_v1') op basis waarvan de biologische downstreamresultaten zijn geanalyseerd in eerdere figuren (parameters ingesteld zoals in standaardconfiguratiebestanden in de gekloonde repository). (B) Dezelfde voorbewerkingsconfiguratie als in 'MI_v1' met de wijziging dat er geen functiegewijze kwantitatieve normalisatie wordt toegepast (parameters ingesteld zoals in voorbeeldconfiguratiebestanden in de map 'config_examples' van de repository). Een schermafbeelding van de uitvoerwaarschuwing van het MOFA-model voor deze configuratie is toegevoegd aan de onderstaande grafiek. (C) De resulterende variantie-ontleding wanneer er geen voorbewerkingsstappen worden toegepast en alle gegevens als invoer worden gebruikt zonder enige voorbewerking of filtering van functies (parameters ingesteld zoals in het voorbeeldconfiguratiebestand in de map 'config_examples' van de opslagplaats). Een schermafbeelding van de uitvoerwaarschuwing van het MOFA-model voor deze configuratie is toegevoegd aan de onderstaande grafiek. Klik hier om dit bestand te downloaden.
Aanvullende figuur 2: MOFA-configuratie - Factor amount effect. De resulterende cijfers worden gegenereerd door het '07_Compare_Models.ipynb'-script met behulp van verschillende configuraties om het MOFA-model uit te voeren. (A) '03_MOFA_configs.csv': Voorbeeld van de verschillende configuraties die worden gebruikt om het script '03_Run_MOFA.ipynb' uit te voeren, waarbij verschillende factoren worden gespecificeerd (10,15,20,25). '07_Comparison_configs.csv': Voorbeeld van het specificeren van het configuratie-invoerbestand voor de uitvoering van het script '07_Compare_Models.ipynb'. (B) "FIG07_Variance_Model_Comparison" met de totale verklaarde variantie voor elke weergave (y-as) voor de verschillende modellen voor alle factoren die in het model zijn gespecificeerd. (C) "FIG07_Factor_Correlations" die de correlatie van de waarden van de factorsteekproef tussen de verschillende configuraties aangeeft. Klik hier om dit bestand te downloaden.
Aanvullende figuur 3: MOFA-configuratie - Effect van wegingsaanzichten. De resulterende cijfers worden gegenereerd door het '07_Compare_Models.ipynb'-script met behulp van verschillende configuraties om het MOFA-model uit te voeren. (A) '03_MOFA_configs.csv': Voorbeeld van de verschillende configuraties die worden gebruikt om het script '03_Run_MOFA.ipynb' uit te voeren, waarbij de parameter 'weighting_of_views' wordt gespecificeerd als 'TRUE' (MI_v1_MOFA_weighted) of 'FALSE' (MI_v1_MOFA). '07_Comparison_configs.csv': Voorbeeld van het specificeren van het configuratie-invoerbestand voor de uitvoering van het script '07_Compare_Models.ipynb'. (B) "FIG07_Variance_Model_Comparison" met de totale verklaarde variantie voor elke weergave (y-as) voor de verschillende modellen voor alle factoren die in het model zijn gespecificeerd. (C) "FIG07_Feature_Correlations" die de correlatie van de weging van de kenmerkfactoren tussen de verschillende configuraties aangeeft. Klik hier om dit bestand te downloaden.
Aanvullende figuur 4: Multi-omisch integratie-effect - met alleen proteomische gegevens. De resulterende patronen die door de latente factoren worden vastgelegd wanneer alleen proteomics-gegevens als input worden gebruikt. (A) FIG04_Factor_Association_Numerical_Features: Pearson-correlatie van de factorwaarden met klinische variabelen (CRP, CK). (B) FIG04_Factor_Association_Categorical_Features: Boxplot-vergelijking van de factorwaarden van elk tijdstip van ACS- en controlepatiënten. Klik hier om dit bestand te downloaden.
Aanvullend bestand 1: Supplementary_File_
Running_Pipeline_with_Exemplary_Data. Beschrijvingen over hoe de pijplijn moet worden uitgevoerd op de voorbeeldgegevens en de verwachte output worden gegeven in een aanvullend aanvullend bestand. Klik hier om dit bestand te downloaden.
Aanvullend videobestand 1: Schermopname video van het protocol. Klik hier om dit bestand te downloaden.