Po pomyślnym wykonaniu schematu pracy generowanych jest kilka tabel i rycin, co przedstawiono na Ryc. 2. Ryciny są umieszczane w folderze /figures (Ryc. 6, Ryc. 7, Ryc. 8, Rycina dodatkowa 1, Rycina dodatkowa 2, Rycina dodatkowa 3, Rycina dodatkowa 4), a tabele zostaną zapisane w określonym folderze /results.
W przypadku niepowodzenia wykonania przepływu pracy może to wynikać głównie z: błędów technicznych spowodowanych np. niewystarczającą ilością pamięci (zwłaszcza w pierwszym kroku, w którym ładowany jest duży zestaw danych jednokomórkowych), nieprawidłowego formatowania danych (np. niedopasowanych kolumn sample_id pomiędzy zestawami danych) lub błędnych specyfikacji w plikach konfiguracyjnych (np. wykluczenia zbyt wielu cech). W takiej sytuacji podczas wykonywania skryptu w notatniku Jupyter zazwyczaj pojawi się komunikat o błędzie, a wykresy i dane nie zostaną wygenerowane. Zaleca się korzystanie z domyślnych plików konfiguracyjnych wygenerowanych podczas uruchamiania skryptu i modyfikowanie jedynie konkretnych parametrów opisanych w protokole.
O pomyślnym wykonaniu świadczy wygenerowanie wynikowych wykresów i tabel, a każdy krok ujawni dodatkowe informacje o danych oraz głównych wzorcach wariancji w nich zawartych. Niemniej jednak nie każde wykonanie musi przynieść biologicznie użyteczne i interpretowalne wyniki. Często dane charakteryzują się dużymi efektami technicznymi i różnymi rozkładami, co musi zostać uwzględnione w kroku „Data Pre-Processing and Harmonization” lub w modelu „MOFA9 Model” (który pozwala również na określenie różnych rozkładów dla typów danych wejściowych), aby móc wyodrębnić wariację danych odzwierciedlającą podstawowe procesy biologiczne.
W przedstawionym przepływie pracy jako dane wejściowe można wykorzystać różne zestawy danych multiomicznych. Obecnie przepływ pracy akceptuje popularny format plików .h5ad dla danych z pojedynczych komórek oraz bardzo ogólny format plików .csv dla wszystkich pozostałych zestawów danych (Rycina 3). Często zdarza się, że różne zestawy danych omicznych mają bardzo odmienne formaty plików. Aby nie ograniczać wykonania przepływu pracy do konkretnych formatów, jako format bardzo ogólny zastosowano .csv . W związku z tym wszystkie rodzaje różnych zestawów danych omicznych mogą być używane jako dane wejściowe do przepływu pracy, jednak przed ich wykorzystaniem w tym procesie muszą zostać przekonwertowane na odpowiadający im format .csv , zgodnie z oznaczeniem na Rycina 3. Można to przygotować za pomocą arkusza kalkulacyjnego lub oprogramowania specyficznego dla danej omiki. W celu wstępnego przetwarzania różnych zestawów danych omicznych, w ramach przepływu pracy dostępnych jest kilka opcji umożliwiających zastosowanie różnych kroków preprocessingu i normalizacji (np. korekty wielkości biblioteki, transformacji logarytmicznej, normalizacji kwantylowej próbek) na różnych zestawach danych wejściowych poprzez konfigurację plików 02_Pre_Processing_Configs.csv oraz 02_Pre_Processing_Configs_SC.csv (Rycina 2). Niemniej jednak dostępne tutaj opcje opierają się głównie na specyficznych danych wejściowych dostępnych w prezentowanym tutaj zestawie danych (scRNA-seq, test cytokin, proteomika, prime-seq). W przypadku użycia innych typów omik/danych konieczne może być zastosowanie dodatkowych, specyficznych dla danej omiki kroków normalizacji zgodnie z istniejącymi najlepszymi praktykami. W takim przypadku dane mogą zostać przekazane do przepływu pracy w formie już wstępnie przetworzonej i zostaną zintegrowane wraz z pozostałymi zestawami danych bez stosowania dalszych kroków preprocessingu. W wielu przypadkach zastosowanie kroku Feature Wise Quantile Normalization jest przydatne w wyrównywaniu rozkładu wszystkich typów danych do rozkładu normalnego, co sprawia, że analizy downstream pomiędzy różnymi cechami wejściowymi są bardziej porównywalne i zgodne ze specyfikacją modelu szumu Gaussian .
Podczas wykonywania procedury generowanych jest kilka wykresów i wyników, które wspierają proces integracji danych i późniejszą biologiczną interpretację wyników. W przypadku danych scRNA-seq wykres w FIG01_Amount_of_Cells_Overview (Rysunek 6>) wskazuje, które typy komórek mogą zawierać zbyt mało komórek na próbkę i typ komórki, aby wiarygodnie zmierzyć sygnał ekspresji genu, ponieważ w dalszych analizach jako szacunek ekspresji wykorzystuje się wartość średnią dla wszystkich komórek danego typu w próbce (podejście pseudobulk). W tym przypadku wykluczamy typy komórek, które w większości próbek zawierają mniej niż trzy komórki.
Wykres dekompozycji wariancji FIG03_Overview_Variance_Decomposition (Rycina 7, Rycina dodatkowa 1) może wskazywać, jak dobrze integrują się różne źródła danych oraz jaka część wariancji w poszczególnych źródłach danych jest wspólna, a jaka unikalna dla każdego z nich. Na przykład testowanie różnych strategii wstępnego przetwarzania na zastosowanym tutaj zbiorze danych wykazuje, że usunięcie etapu normalizacji Feature Wise Quantile z procesu wstępnego przetwarzania prowadzi do uzyskania czynników ukrytych bardziej skoncentrowanych na konkretnych widokach danych i zmniejsza integrację danych proteomicznych z pozostałymi źródłami danych. Można to zauważyć poprzez zmniejszoną ilość wyjaśnionej wariancji (Rycina dodatkowa 1B). Uruchomienie modelu MOFA bez filtrowania cech lub bez normalizacji prowadzi do mniejszej wariancji wspólnej między różnymi widokami rejestrowanymi przez czynniki ukryte (Rycina dodatkowa 1C). Wskazuje to, że czynniki ukryte odzwierciedlają głównie techniczne efekty specyficzne dla typu danych. Poza tym sam model MOFA9 może również zwracać ostrzeżenia w przypadku słabo przetworzonych danych. Przykład takiego ostrzeżenia pokazano na Rycini dodatkowej 1 dla alternatywnych konfiguracji wstępnego przetwarzania MI_v2 oraz MI_v3 (konkretne przykładowe pliki konfiguracyjne znajdują się w sklonowanym repozytorium GitHub w folderze config_examples ).
Dodatkowo, po uruchomieniu modelu MOFA, wyniki można ocenić w ramach kilku analiz następczych, wiążąc czynnik ze znanymi biologicznymi meta-informacjami o próbkach, a także z technicznymi i innymi zakłócającymi współzmiennymi (04_Downstream_Factor_Analysis), aby zidentyfikować prawdopodobną przyczynę zmienności uchwyconej przez czynniki. Na przykład, jeśli jeden z czynników modeli MOFA silnie wiąże się z jedną ze współzmiennych technicznych (takich jak informacje o serii), może to wskazywać, że czynnik ten uchwycił raczej zmienność techniczną w danych zamiast zmienności biologicznej.
Aby zawęzić interpretację biologiczną w części analizy końcowej, przedstawiono tutaj kilka wniosków opartych na zbiorze danych wejściowych (bardziej szczegółową interpretację można znaleźć w oryginalnej publikacji11). W pierwszym kroku zaobserwowano, że przy zastosowanej strategii wstępnego przetwarzania danych zidentyfikowano kilka czynników, które oddają wariancję w wielu typach komórek, a także w innych typach danych omicznych (Ryc. 7A). Na przykład czynnik Factor 2 oddaje wariancję w klinicznych cechach wejściowych oraz w kilku typach komórek ze zbioru danych scRNA-seq. Powiązano trzy pierwsze czynniki z odpowiednimi klinicznymi współzmiennymi, takimi jak „CRP” i „CK” (Ryc. 7B), a następnie zbadano różnice w wartościach czynników dla różnych podgrup pacjentów: „Control” (w tym CCS i non-CCS) względem „ACS”, mierzonych w różnych punktach czasowych (TP1-TP4) (Ryc. 7C), co pozwoliło stwierdzić, że Factor 2 istotnie koreluje z wartością „CK”, a Factor 3 z wartością „CRP”. Jednocześnie próbki „ACS” w punktach TP1 i TP2 (odzwierciedlające ostrą fazę odpowiedzi immunologicznej na zawał mięśnia sercowego (MI)) wykazują wzrost wartości czynników w porównaniu z próbkami „Control” oraz próbkami z późniejszych punktów czasowych (TP3/TP4). CK jest znanym markerem uszkodzenia mięśnia sercowego i typowo charakteryzuje się podwyższonymi wartościami w TP1/TP2, co jest zgodne z wzorcem uchwyconym przez Factor 2.
Aby uzyskać wgląd w procesy biologiczne kształtujące Factor2, oceniamy najwyżej sklasyfikowane cechy czynnika, analizując tabelę wag cech wygenerowaną przez model (03_Weight_Data.csv). Analizując górny 1% cech o najwyższych wagach bezwzględnych dla czynnika, znajdujemy głównie CD4.TCM oraz cechy pochodzące z CD14. Mono, które są nadreprezentowane w stosunku do ich całkowitej liczby w cechach wejściowych (Rysunek 8A), co wskazuje, że typy komórek te są wysoce istotne w procesie zapalnym po MI (UWAGA: w przypadku, gdy w etapie wstępnego przetwarzania nie zastosowano kwantylowej normalizacji cech, różne rozkłady cech mogą również wpływać na ten wynik, a oceny należy dokonać oddzielnie dla każdego typu danych). Analizując najwyżej sklasyfikowane cechy typu komórek CD4.TCM dla tego czynnika, znajdujemy kilka interesujących genów, takich jak EIF3E18, niezbędny do skutecznej aktywacji limfocytów T, oraz HMGB119, który promuje ekspansję i aktywację limfocytów T (Rysunek 8B). Następnie przeprowadzamy analizę wzbogacenia ścieżek, wykorzystując ścieżki immunologiczne z bazy danych REACTOME20 jako zestaw ścieżek (Prepared_Pathway_Data.csv). Stwierdzamy wzbogacenie dla kilku ścieżek związanych z „Interleukiny”, w tym sygnalizacji „Interleukina-6”. Poziomy ekspresji kilku genów w różnych typach komórek z danych scRNA-seq oraz wartości cytokiny „IL6” zmierzone testem cytokin przyczyniły się do tego wyniku (Rysunek 8C). Identyfikacja tych wspólnych wzorców w różnych typach danych podkreśla wartość dodaną analizy zintegrowanej. Ogólnie rzecz biorąc, podejście to może również zidentyfikować kilka innych czynników odzwierciedlających stan choroby lub wiążących wynik leczenia z podstawowymi wielokomórkowymi programami odpornościowymi, co opisano bardziej szczegółowo w odpowiadającej publikacji11.
Aby dodatkowo podkreślić zaletę zintegrowanych analiz wielu danych omicznych, ten sam schemat analizy przeprowadzono również wyłącznie z uwzględnieniem danych proteomicznych (Rycina uzupełniająca 4). Analizując otrzymane czynniki, podobnie jak w analizie zintegrowanej, zidentyfikowano czynnik (Factor1), który silnie koreluje z wartością „CRP”. Wzorzec ten opisuje główne źródło zmienności w danych proteomicznych i jest również zgodny z częścią zmienności w pozostałych zestawach danych, uchwyconą przez „Factor3” w analizie zintegrowanej (Rycina 7C). Jednakże, wzorca podobnego do Factor2, który w analizie zintegrowanej oddaje przebieg czasowy stanu zapalnego, nie można zidentyfikować wyłącznie na podstawie danych proteomicznych.
Przedstawiony schemat pracy oraz sam model MOFA9 są wysoce konfigurowalne i posiadają wiele regulowanych parametrów. Dlatego istotne jest wizualizowanie i systematyczne porównywanie wyników uzyskiwanych przy różnych konfiguracjach. Aby ułatwić to zadanie, końcowym wynikiem generowanym przez schemat pracy jest porównanie różnych nazwanych uruchomień potoku (pipeline) z różnymi parametrami w etapie wstępnego przetwarzania i estymacji modelu. Na przykład model MOFA można estymować dla różnej liczby czynników utajonych (Supplementary Figure 2A) lub można nadać wagi widokom z mniejszą liczbą cech (Supplementary Figure 3A). Konfiguracja i uruchomienie ostatniego skryptu schematu pracy „07_Compare_Models” generuje kilka wykresów służących do oceny podobieństwa między różnymi uruchomieniami potoku. FIG07_Variance_Model_Comparison (Supplementary Figure 2B, Supplementary Figure 3B) przedstawia porównanie całkowitej wariancji wyjaśnionej dla każdego widoku w różnych uruchomieniach. Korelacja wartości czynników oraz wag cech czynników między różnymi uruchomieniami może wskazywać, w jakim stopniu wyniki zmieniają się przy modyfikacji określonego parametru (Supplementary Figure 2C, Supplementary Figure 3C). W tym przypadku modyfikacja liczby czynników powoduje jedynie niewielkie zmiany w estymowanych wartościach czynników i wagach cech (Supplementary Figure 2C). Modyfikacja wagowania widoku danych skutkuje znacznie wyższą wariancją wyjaśnioną w widokach z mniejszą liczbą cech, np. w widoku „clinical” (Supplementary Figure 3B). Niemniej jednak, istotne cechy w obrębie trzech pierwszych czynników są nadal silnie skorelowane z tymi wywnioskowanymi w wersji niewagowanej (Supplementary Figure 3C).
Po wygenerowaniu przez model plików wyjściowych .csv w folderze results (np. oszacowanych wag czynników i cech), można przeprowadzić dalsze indywidualne analizy typu downstream. Cały kod oraz niezbędne pliki konfiguracyjne (łącznie z dokumentacją) są dostępne na GitHubie pod adresem https://github.com/heiniglab/mofa_workflow. Obraz singularity, stworzony w celu umożliwienia łatwej instalacji wymaganych pakietów conda do analizy, można pobrać z adresu https://doi.org/10.5281/zenodo.10815146. Z tego samego wpisu w zenodo można również pobrać niewielki zbiór danych przykładkowych, który może posłużyć do przeprowadzenia wstępnego testu potoku analitycznego.

Rycina 7: Analiza wyników MOFA. Po uruchomieniu modelu MOFA (03_Run_MOFA.ipynb) i późniejszej analizie wartości czynników (04_Downstream_Factor_Analysis.ipynb) generowanych jest kilka wykresów: (A) FIG03_Overview_Variance_Decomposition: przedstawia wizualizację wyjaśnionej wariancji oszacowanych czynników MOFA w różnych widokach. Mapa ciepła (lewo): pokazuje procent całkowitej wariancji widoku uchwycony przez dany czynnik dla każdego widoku. Wykres słupkowy (prawo): pokazuje całkowity procent wariancji uchwycony przez wszystkie czynniki dla każdego widoku. (B) FIG04_Factor_Association_Numerical_Features: przedstawia korelację Persona wartości czynników z wybranymi numerycznymi kowariantami próbek, w tym przypadku: zmiennymi klinicznymi (CRP, CK). (C) FIG04_Factor_Association_Categorical_Features: przedstawia różnicę w wartościach czynników dla kategorycznych kowariantów próbek w formie wykresu pudełkowego. Tutaj porównano wartości czynników Factors1-3 dla każdego punktu czasowego u pacjentów z ACS i grupy kontrolnej. Kliknij tutaj, aby wyświetlić większą wersję tej ryciny.

Rycina 8: Analiza cech MOFA. Po uruchomieniu analizy końcowych (04_Downstream_Factor_Analysis.ipynb, 05_Downstream_Investigate_Features.ipynb) generowanych jest kilka wykresów. Wszystkie przedstawione tutaj wykresy wizualizują czynnik MOFA 2: (A) FIG04_Top_Feature_Overview_per_Factor: Mapa ciepła (lewo) pokazuje dla każdego widoku procent wariancji uchwycony przez wybrany czynnik. Wykresy słupkowe (prawo) wskazują istotność cech z różnych widoków dla danego czynnika. Po lewej stronie podano całkowitą liczbę cech konkretnego widoku w obrębie 1% najwyżej sklasyfikowanych cech we wszystkich widokach dla tego czynnika. Po prawej podano wartość procentową, dzieląc całkowitą liczbę cech z grupy 1% przez całkowitą liczbę cech danego widoku. (B) FIG05_Heatmap_Feature_Overview: Mapa ciepła (lewo) pokazuje dla 1% najwyżej sklasyfikowanych cech typu komórek CD4.TCM znormalizowane wartości ekspresji dla każdej próbki, porównując pacjentów z grupy „Control” (CCS i non-CCS) z różnymi punktami czasowymi dla pacjentów „ACS”. Wykres słupkowy (prawo) pokazuje wagi cech. Kierunek znaku wagi jest wskazany wcześniej po lewej stronie, przed nazwami typów komórek: „+” dodatnia waga czynnika; „-” ujemna waga czynnika. (C) FIG06_Pathway_and_Genes: pokazuje wagi 25% najwyżej sklasyfikowanych genów dla danego czynnika, które należą do wzbogaconych ścieżek interleukin. Na górnej mapie ciepła są one uśrednione dla wszystkich widoków, a na dolnej mapie ciepła przedstawione dla każdego widoku z osobna. Kliknij tutaj, aby wyświetlić powiększoną wersję tej ryciny.
Rysunek uzupełniający 1: Efekty harmonizacji danych. Rysunek przedstawia FIG03_Overview_Variance_Decomposition dla kilku różnych konfiguracji wstępnego przetwarzania danych: wizualizację wyjaśnionej wariancji szacowanych czynników MOFA w obrębie poszczególnych widoków. Mapa ciepła (lewo): pokazuje dla każdego widoku procent całkowitej wariancji widoku, który jest przechwytywany przez dany czynnik. Wykres słupkowy (prawo): pokazuje dla każdego widoku całkowity procent wariancji przechwytywanej przez wszystkie czynniki. (A) Konfiguracja ('MI_v1'), na podstawie której przeanalizowano biologiczne wyniki końcowe na poprzednich rysunkach (parametry ustawione zgodnie z domyślnymi plikami konfiguracyjnymi w sklonowanym repozytorium). (B) Ta sama konfiguracja wstępnego przetwarzania co w 'MI_v1', z modyfikacją polegającą na tym, że nie zastosowano normalizacji kwantylowej dla poszczególnych cech (parametry ustawione zgodnie z przykładowymi plikami konfiguracyjnymi w folderze 'config_examples' repozytorium). Poniżej wykresu dodano zrzut ekranu ostrzeżenia z wyjścia modelu MOFA dla tej konfiguracji. (C) Wynikowy rozkład wariancji w przypadku, gdy nie zastosowano kroków wstępnego przetwarzania, a wszystkie dane zostały użyte jako dane wejściowe bez żadnego przetwarzania wstępnego lub filtrowania cech (parametry ustawione zgodnie z przykładowym plikiem konfiguracyjnym w folderze 'config_examples' repozytorium). Poniżej wykresu dodano zrzut ekranu ostrzeżenia z wyjścia modelu MOFA dla tej konfiguracji. Kliknij tutaj, aby pobrać ten plik.
Rysunek uzupełniający 2: Konfiguracja MOFA – wpływ liczby czynników. Wykresy wygenerowane przez skrypt „07_Compare_Models.ipynb” przy użyciu kilku różnych konfiguracji uruchomienia modelu MOFA. (A) „03_MOFA_configs.csv”: przykład różnych konfiguracji użytych do uruchomienia skryptu „03_Run_MOFA.ipynb”, określających kilka różnych liczb czynników (10, 15, 20, 25). „07_Comparison_configs.csv”: przykład sposobu określania pliku wejściowego konfiguracji dla wykonania skryptu „07_Compare_Models.ipynb”. (B) „FIG07_Variance_Model_Comparison” przedstawiający całkowitą wariancję wyjaśnioną dla każdego widoku (oś y) dla różnych modeli w odniesieniu do wszystkich czynników określonych w modelu. (C) „FIG07_Factor_Correlations” przedstawiający korelację wartości próbek czynników pomiędzy różnymi konfiguracjami. Kliknij tutaj, aby pobrać ten plik.
Rycina uzupełniająca 3: Konfiguracja MOFA – wpływ ważenia widoków. Wynikowe wykresy wygenerowane przez skrypt „07_Compare_Models.ipynb” przy użyciu kilku różnych konfiguracji do uruchomienia modelu MOFA. (A) „03_MOFA_configs.csv”: Przykład różnych konfiguracji użytych do uruchomienia skryptu „03_Run_MOFA.ipynb”, określających parametr „weighting_of_views” jako „TRUE” (MI_v1_MOFA_weighted) lub „FALSE” (MI_v1_MOFA). „07_Comparison_configs.csv”: Przykład sposobu określania pliku wejściowego konfiguracji dla wykonania skryptu „07_Compare_Models.ipynb”. (B) „FIG07_Variance_Model_Comparison” przedstawiający całkowitą wariancję wyjaśnioną dla każdego widoku (oś y) dla różnych modeli we wszystkich czynnikach określonych w modelu. (C) „FIG07_Feature_Correlations” przedstawiający korelację wag czynników cech pomiędzy różnymi konfiguracjami. Kliknij tutaj, aby pobrać ten plik.
Rysunek uzupełniający 4: Efekt integracji multiomicznej – przy użyciu wyłącznie danych proteomicznych. Wzorce uzyskane za pomocą czynników latentnych przy zastosowaniu wyłącznie danych proteomicznych jako danych wejściowych. (A) FIG04_Factor_Association_Numerical_Features: Korelacja Pearsona wartości czynników ze zmiennymi klinicznymi (CRP, CK). (B) FIG04_Factor_Association_Categorical_Features: Wykres pudełkowy porównujący wartości czynników dla każdego punktu czasowego u pacjentów z ACS oraz w grupie kontrolnej. Kliknij tutaj, aby pobrać ten plik.
Plik uzupełniający 1: Supplementary_File_
Running_Pipeline_with_Exemplary_Data. Opisy sposobu uruchomienia potoku analizy (pipeline) na przykładowych danych oraz oczekiwane wyniki znajdują się w dodatkowo dostarczonym pliku uzupełniającym. Prosimy kliknąć tutaj, aby pobrać ten plik.
Plik wideo uzupełniający 1: Nagranie ekranu z protokołem. Kliknij tutaj, aby pobrać ten plik.