$$\rightleftharpoonup{xx}$$
$$\longleftharp{xx}$$,
$$\longrightharp{xx}$$,
Po pomyślnym wykonaniu przepływu pracy, generowanych jest kilka tabel i rysunków, jak wskazano w Rysunek 2. Rysunki są umieszczane w folderze /figures (Rysunek 6, Rysunek 7, Rysunek 8, Rysunek uzupełniający 1, Rysunek uzupełniający 2, Rysunek uzupełniający 3, Rysunek uzupełniający 4), a tabele zostaną umieszczone w określonym folderze /results.
W przypadku, gdy wykonanie przepływu pracy nie powiedzie się, może to być głównie spowodowane: błędami technicznymi spowodowanymi, na przykład, niewystarczającą ilością pamięci (szczególnie w pierwszym kroku, gdzie ładowany jest duży zestaw danych jednokomórkowych), nieprawidłowo sformatowanymi danymi (np. niepasującymi kolumnami sample_id między zestawami danych) lub nieprawidłowymi specyfikacjami w plikach konfiguracyjnych (np. wykluczeniem wielu funkcji). W takim przypadku zwykle podczas wykonywania pojawi się komunikat o błędzie w skrypcie Jupyter-notebook i nie zostaną wygenerowane żadne wykresy i dane. Zaleca się używanie domyślnych plików konfiguracyjnych wygenerowanych podczas wykonywania skryptu i modyfikowanie tylko określonych parametrów zgodnie z opisem w protokole.
Pomyślne wykonanie jest sygnalizowane przez wygenerowanie wynikowych wykresów i tabel, a każdy krok ujawni dodatkowe informacje o danych i głównych wzorcach wariancji z nimi związanych. Jednak niekoniecznie każde wykonanie przyniesie biologicznie użyteczne i możliwe do zinterpretowania wyniki. Często dane charakteryzują się dużymi efektami technicznymi i różnymi rozkładami, które muszą być uwzględnione w kroku "Wstępne przetwarzanie i harmonizacja danych" lub w modelu "MOFA9 Model' (który umożliwia również określenie różnych rozkładów dla typów danych wejściowych), aby móc wyodrębnić zmienność danych, która odzwierciedla podstawowe procesy biologiczne.
W ramach prezentowanego przepływu pracy, różne zestawy danych multiomicznych mogą być używane jako dane wejściowe. Obecnie przepływ pracy akceptuje popularny format pliku .h5ad dla danych jednokomórkowych i bardzo ogólny format pliku .csv dla wszystkich innych zestawów danych jako dane wejściowe (Rysunek 3). Często zdarza się, że różne zestawy danych omicznych mają bardzo różne formaty plików. Aby nie ograniczać wykonywania przepływu pracy do określonych formatów plików, .csv jest używany jako format bardzo ogólny. W związku z tym wszystkie rodzaje różnych zestawów danych omicznych mogą być używane jako dane wejściowe dla przepływu pracy, ale muszą być konwertowane do odpowiedniego formatu .csv, jak wskazano w Rysunek 3 przed użyciem w tym przepływie pracy. Można to przygotować za pomocą arkusza kalkulacyjnego lub specjalnego oprogramowania omicznego. Aby wstępnie przetworzyć różne zestawy danych omicznych, w przepływie pracy dostępnych jest kilka opcji, które umożliwiają zastosowanie różnych kroków wstępnego przetwarzania i normalizacji (np. dostosowanie rozmiaru biblioteki, transformacja logarytmu, normalizacja kwantylu próbki) na różnych wejściowych zestawach danych poprzez skonfigurowanie pliku 02_Pre_Processing_Configs.csv i pliku 02_Pre_Processing_Configs_SC.csv (Rysunek 2). Niemniej jednak dostępne tutaj opcje opierają się głównie na konkretnych danych wejściowych dostępnych w przedstawionym tutaj zbiorze danych (scRNA-seq, test cytokin, proteomika, prime-seq). W przypadku użycia innych typów omicznych/danych może być konieczne zastosowanie dodatkowych kroków normalizacji specyficznych dla omiku zgodnie z istniejącymi najlepszymi praktykami. W takim przypadku dane mogą zostać przekazane do przepływu pracy w już wstępnie przetworzonej formie i zostaną zintegrowane z innymi zestawami danych bez konieczności stosowania dalszych kroków przetwarzania wstępnego. W wielu przypadkach zastosowanie kroku normalizacji kwantylu według cech jest przydatne w dostosowaniu rozkładu wszystkich typów danych do rozkładu normalnego i umożliwieniu dalszej analizy między różnymi cechami wejściowymi bardziej porównywalnej i zgodnej ze specyfikacją modelu szumu Gaussa.
Podczas wykonywania przepływu pracy generowanych jest kilka wykresów i wyników, które wspierają proces integracji danych i późniejszej biologicznej interpretacji. W przypadku danych sekwencyjnych scRNA, 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 przypadku kolejnych analiz średnia wartość dla wszystkich komórek typu komórki na próbkę jest używana jako oszacowanie ekspresji (podejście psedobulk-). W tym przypadku użycia wykluczamy typy komórek, które mają mniej niż trzy komórki w większości próbek.
Wykres dekompozycji wariancji FIG03_Overview_Variance_Decomposition (Rysunek 7, Rysunek uzupełniający 1) może wskazywać, jak dobrze integrują się różne źródła danych i jaka część wariancji w różnych źródłach danych jest wspólna i unikalna dla każdego źródła danych. Na przykład testowanie różnych strategii przetwarzania wstępnego na używanym tutaj zestawie danych pokazuje na przykład, że usunięcie kroku normalizacji kwantylu według cech z przetwarzania wstępnego prowadzi do czynników utajonych, które są bardziej skoncentrowane na określonych widokach danych i ogranicza integrację danych proteomicznych z innymi źródłami danych. Można to zaobserwować w zmniejszonej ilości wyjaśnionej wariancji (rysunek uzupełniający 1B). Uruchomienie modelu MOFA bez filtrowania cech lub bez normalizacji prowadzi do mniejszej współużytkowanej wariancji między różnymi widokami przechwyconymi przez czynniki utajone (rysunek uzupełniający 1C). Wskazuje to, że czynniki ukryte odzwierciedlają głównie skutki techniczne specyficzne dla danego typu danych. Poza tym model MOFA9 może również zwracać ostrzeżenia w przypadku źle przetworzonych danych. Przykład takiego ostrzeżenia pokazano na rysunku uzupełniającym 1 dla alternatywnych konfiguracji przetwarzania wstępnego MI_v2 i MI_v3 (konkretne przykładowe pliki konfiguracyjne są przechowywane w sklonowanym repozytorium GitHub w folderze config_examples).
Dodatkowo, po uruchomieniu modelu MOFA, wyniki mogą być oceniane w kilku dalszych analizach, poprzez powiązanie czynnika ze znanymi biologicznymi meta-informacjami o próbkach, a także technicznymi i innymi zakłócającymi 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 jest silnie powiązany z jedną z technicznych zmiennych współzmiennych (takich jak informacje o partii), może to wskazywać, że czynnik ten obejmuje raczej zmienność techniczną w danych, a nie zmienność biologiczną.
Aby zawęzić interpretację biologiczną w dalszej części analizy, przedstawiono tutaj kilka ustaleń opartych na wejściowym zbiorze danych (bardziej szczegółową interpretację można znaleźć w oryginalnej publikacji11). W pierwszym kroku mogliśmy zaobserwować, że przy zastosowanej strategii przetwarzania wstępnego znajdujemy kilka czynników, które rejestrują wariancję w wielu typach komórek, ale także w innych typach danych omicznych (Rysunek 7A). Na przykład czynnik 2 wychwytuje wariancję w klinicznych cechach wejściowych i w kilku typach komórek zestawu danych scRNA-seq. Powiązanie pierwszych trzech czynników z odpowiednimi współzmiennymi klinicznymi, takimi jak "CRP" i "CK" (Figura 7B) i zbadanie różnic w wartościach czynników dla różnych podgrup pacjentów: "Kontrola (w tym CCS i bez CCS) vs. "ACS" mierzona w różnych punktach czasowych (TP1-TP4) (Rysunek 7C), stwierdzamy również, że Czynnik2 wiąże się w znacznym stopniu z wartością "CK", a Czynnik3 z wartością "CRP". Jednocześnie próbki "ACS" w TP1 i TP2 (które odzwierciedlają ostrą fazę odpowiedzi immunologicznej na zawał mięśnia sercowego (MI)) wykazują wzrost wartości czynników w porównaniu z próbkami "kontrolnymi" i późniejszymi próbkami punktu czasowego (TP3/TP4). CK jest znanym markerem uszkodzenia mięśnia sercowego i zwykle charakteryzuje się zwiększonymi wartościami w TP1 / TP2, podobnie jak wzorzec uchwycony przez Factor2.
Aby wygenerować wgląd w procesy biologiczne kształtujące Czynnik2, oceniamy najważniejsze cechy czynnika, patrząc na tabelę wag cech wygenerowaną przez model (03_Weight_Data.csv). Analizując górny 1% cech o najwyższych bezwzględnych wagach czynnika, znajdujemy głównie CD4. TCM oraz CD14. Cechy monopochodne są nadreprezentowane w porównaniu z ich ogólną liczbą cech wejściowych (Rysunek 8A), co wskazuje, że te typy komórek są bardzo istotne w procesie zapalnym po MI (UWAGA: w przypadku, gdy w przetwarzaniu wstępnym nie zastosowano normalizacji kwantylowej pod względem cech, różne rozkłady cech mogą również wpływać na ten wynik, a ocena powinna być wykonywana oddzielnie według typu danych). Analiza najwyżej ocenianych funkcji CD4. Typ komórki TCM na czynniku, znajdujemy kilka interesujących genów, takich jak EIF3E18 wymagany do silnej aktywacji komórek T i HMGB119, który promuje ekspansję i aktywację limfocytów T (Figura 8B). Następnie przeprowadzamy analizę wzbogacania szlaków przy użyciu szlaków immunologicznych z bazy danych REACTOME20 jako zestawu ścieżek (Prepared_Pathway_Data.csv). Znaleźliśmy wzbogacenie dla kilku szlaków "interleukiny", w tym sygnalizacji "interleukiny-6". Do tego wyniku przyczyniły się poziomy ekspresji kilku genów w różnych typach komórek danych scRNA-seq oraz wartości cytokin "IL6" mierzone za pomocą testu cytokin (Figura 8C). Identyfikacja tych wspólnych wzorców w różnych typach danych podkreśla wartość dodaną zintegrowanej analizy. Ogólnie rzecz biorąc, podejście to może również zidentyfikować kilka innych czynników, które odzwierciedlają stan choroby lub wiążą się z wynikiem leczenia i leżącymi u jego podstaw wielokomórkowymi programami odpornościowymi, jak opisano bardziej szczegółowo w odpowiedniej publikacji11.
Aby jeszcze bardziej podkreślić zalety zintegrowanych analiz w wielu rodzajach omicznych, ten sam przepływ pracy został również uruchomiony tylko z uwzględnieniem danych wejściowych proteomiki (Rysunek uzupełniający 4). Analizując otrzymane czynniki, znajdujemy, podobnie jak w analizie zintegrowanej, czynnik (Czynnik1), który jest silnie skorelowany z wartością "CRP". Wzorzec ten opisuje główne źródło zmienności w danych proteomicznych i jest również zgodny z niektórymi zmianami w innych zestawach danych, które zostały uchwycone przez "Czynnik3" w zintegrowanej analizie (Rysunek 7C). Jednak podobny wzorzec, jak wskazano w Factor2, który ujmuje przebieg zapalenia w czasie w zintegrowanej analizie, nie może być zidentyfikowany wyłącznie na podstawie danych proteomicznych.
Wprowadzony przepływ pracy i model MOFA9 są wysoce konfigurowalne z wieloma regulowanymi parametrami. Dlatego ważne jest, aby wizualizować i systematycznie porównywać wyniki uzyskiwane przez różne konfiguracje. Aby ułatwić to zadanie, końcowym wyjściem, które może zostać wygenerowane przez przepływ pracy, jest porównanie różnych nazwanych przebiegów potoku z różnymi parametrami w przetwarzaniu wstępnym i szacowaniu modelu. Na przykład model MOFA może być szacowany za pomocą różnej liczby czynników utajonych (rysunek uzupełniający 2A) lub widoki z mniejszą liczbą cech mogą być ważone (rysunek uzupełniający 3A). Skonfigurowanie i uruchomienie ostatniego skryptu przepływu pracy "07_Compare_Models" powoduje utworzenie kilku wykresów w celu oceny podobieństwa między różnymi przebiegami potoku. FIG07_Variance_Model_Comparison (Rysunek uzupełniający 2B, Rysunek uzupełniający 3B) przedstawia porównanie całkowitej wyjaśnionej wariancji dla każdego widoku dla różnych przebiegów. Korelacja wartości współczynników i wag współczynników cech między różnymi przebiegami może wskazywać, jak bardzo zmieniają się wyniki podczas modyfikowania określonego parametru (rysunek uzupełniający 2C, rysunek uzupełniający 3C). W tym przypadku modyfikacja liczby czynników powoduje tylko niewielkie zmiany w szacowanych wartościach czynników i wagach cech (rysunek uzupełniający 2C). Modyfikacja wagi widoku danych skutkuje znacznie większą wyjaśnioną wariancją w widokach o mniejszej liczbie cech, np. w widoku "klinicznym" (rysunek uzupełniający 3B). Niemniej jednak istotne cechy w ramach pierwszych trzech czynników są nadal silnie skorelowane z tymi, które wywnioskowano za pomocą wersji nieważonej (rysunek uzupełniający 3C).
Dzięki wygenerowanym plikom wyjściowym modelu .csv w folderze wyników (np. szacowanym czynnikom i wagom cech), można przeprowadzić dalsze indywidualne analizy. Cały kod i niezbędne pliki konfiguracyjne (w tym dokumentacja) są dostępne na GitHub pod adresem https://github.com/heiniglab/mofa_workflow. Obraz osobliwości, który został utworzony w celu umożliwienia łatwej instalacji wymaganych pakietów conda do analizy, można pobrać z https://doi.org/10.5281/zenodo.10815146. Mały przykładowy zestaw danych, który może być użyty do przeprowadzenia wstępnego testu potoku, można również pobrać z tego samego rekordu zenodo.

Rysunek 7: Analiza danych wyjściowych MOFA. Po uruchomieniu modelu MOFA (03_Run_MOFA.ipynb) i dalszej analizie wartości czynników (04_Downstream_Factor_Analysis.ipynb) generowanych jest kilka wykresów: (A) FIG03_Overview_Variance_Decomposition: zwraca wizualizację wyjaśnionej wariancji szacowanych czynników MOFA w różnych widokach. Mapa cieplna (po lewej): pokazuje procent całkowitej wariancji widoku przechwyconego przez czynnik dla każdego widoku. Wykres słupkowy (po prawej): pokazuje łączną wartość procentową wariancji, która jest przechwytywana przez wszystkie czynniki dla każdego widoku. (B) FIG04_Factor_Association_Numerical_Features: pokazuje korelację Pearsona wartości czynników z wybranymi współzmiennymi liczbowymi próby, w tym przypadku: zmiennymi klinicznymi (CRP, CK). (C) FIG04_Factor_Association_Categorical_Features: pokazuje różnicę w wartościach czynników dla współzmiennych próbki kategorycznej jako wykres pudełkowy. W tym miejscu porównywane są wartości czynników 1-3 dla każdego punktu czasowego pacjentów z OZW i grupą kontrolną. Kliknij tutaj, aby zobaczyć większą wersję tego rysunku.

Rysunek 8: Analiza cech MOFA. Po przeprowadzeniu dalszych analiz (04_Downstream_Factor_Analysis.ipynb, 05_Downstream_Investigate_Features.ipynb) generowanych jest kilka wykresów. Wszystkie wykresy tutaj wizualizują współczynnik MOFA 2: (A) FIG04_Top_Feature_Overview_per_Factor: Mapa cieplna (po lewej) pokazuje dla każdego widoku procent wariancji, który jest uchwycony przez wybrany czynnik. Wykresy słupkowe (po prawej) wskazują znaczenie cech różnych widoków dla czynnika. Po lewej stronie podana jest łączna liczba obiektów określonego widoku w obrębie 1% najwyższych wskaźników w widokach współczynnika. Po prawej stronie podana jest wartość procentowa, która dzieli łączną liczbę wśród 1% najlepszych przez łączną liczbę obiektów tego widoku. (B) FIG05_Heatmap_Feature_Overview: Mapa termiczna (po lewej) pokazuje dla najwyższej rangi 1% funkcji CD4. Typ komórki TCM: znormalizowane wartości ekspresji każdej próbki, porównujące pacjentów z grupy "kontrolnej" (CCS i bez CCS) z różnymi punktami czasowymi dla pacjentów z "OZW". Wykres słupkowy (po prawej) pokazuje wagę obiektów. Kierunek znaku wagi jest wskazany przed po lewej stronie przed nazwami typów komórek: "+" waga czynnika dodatniego; '-' waga czynnika ujemnego. (C) FIG06_Pathway_and_Genes: pokazuje wagę najwyższych 25% genów w rankingu dla czynnika, który należy do wzbogaconych szlaków interleukiny. Na mapie cieplnej u góry są one uśredniane w różnych widokach, a na mapie cieplnej u dołu są wyświetlane dla każdego widoku. Kliknij tutaj, aby zobaczyć większą wersję tego rysunku.
Rysunek uzupełniający 1: Efekty harmonizacji danych. Na rysunku przedstawiono FIG03_Overview_Variance_Decomposition dla kilku różnych konfiguracji wstępnego przetwarzania danych: wizualizacja wyjaśnionej wariancji szacowanych czynników MOFA w różnych widokach. Mapa cieplna (po lewej): pokazuje dla każdego widoku procent całkowitej wariancji widoku, który jest przechwytywany przez czynnik. Wykres słupkowy (po prawej): pokazuje dla każdego widoku łączną wartość procentową wariancji, która jest przechwytywana przez wszystkie czynniki. (A) Konfigurację ("MI_v1"), na podstawie której przeanalizowano dalsze wyniki biologiczne na poprzednich rysunkach (parametry ustawione jak w domyślnych plikach konfiguracyjnych w sklonowanym repozytorium). (B) Ta sama konfiguracja przetwarzania wstępnego, co w 'MI_v1' z modyfikacją polegającą na tym, że nie jest stosowana normalizacja kwantylowa pod względem cech (parametry ustawiane jak w przykładowych plikach konfiguracyjnych w folderze 'config_examples' repozytorium). Zrzut ekranu z ostrzeżeniem wyjściowym modelu MOFA dla tej konfiguracji został dodany do poniższego wykresu. (C) Wynikowa dekompozycja wariancji, gdy nie są stosowane żadne etapy wstępnego przetwarzania, a wszystkie dane są używane jako dane wejściowe bez żadnego wstępnego przetwarzania lub filtrowania cech (parametry ustawione jak w przykładowym pliku konfiguracyjnym w folderze "config_examples" repozytorium). Zrzut ekranu z ostrzeżeniem wyjściowym modelu MOFA dla tej konfiguracji został dodany do poniższego wykresu. Kliknij tutaj, aby pobrać ten plik.
Rysunek uzupełniający 2: Konfiguracja MOFA - Wpływ wielkości czynnika. Wynikowe figury są generowane przez skrypt "07_Compare_Models.ipynb" przy użyciu kilku różnych konfiguracji w celu uruchomienia modelu MOFA. (A) '03_MOFA_configs.csv': Przykład różnych konfiguracji używanych do uruchomienia skryptu '03_Run_MOFA.ipynb' określający kilka różnych czynników (10,15,20,25). '07_Comparison_configs.csv': Przykład określenia pliku wejściowego konfiguracji do wykonania skryptu '07_Compare_Models.ipynb'. (B) "FIG07_Variance_Model_Comparison" przedstawiające całkowitą wyjaśnioną wariancję dla każdego widoku (oś y) dla różnych modeli we wszystkich czynnikach określonych w modelu. C) "FIG07_Factor_Correlations" przedstawiające korelację wartości próbek czynnikowych między różnymi konfiguracjami. Kliknij tutaj, aby pobrać ten plik.
Rysunek uzupełniający 3: Konfiguracja MOFA - Wpływ ważenia widoków. Wynikowe figury są generowane przez skrypt "07_Compare_Models.ipynb" przy użyciu kilku różnych konfiguracji w celu uruchomienia modelu MOFA. (A) '03_MOFA_configs.csv': Przykład różnych konfiguracji używanych do uruchomienia skryptu '03_Run_MOFA.ipynb', określając parametr 'weighting_of_views' jako "TRUE" (MI_v1_MOFA_weighted) lub 'FALSE' (MI_v1_MOFA). '07_Comparison_configs.csv': Przykład określenia pliku wejściowego konfiguracji do wykonania skryptu '07_Compare_Models.ipynb'. (B) "FIG07_Variance_Model_Comparison" przedstawiające całkowitą wyjaśnioną wariancję dla każdego widoku (oś y) dla różnych modeli we wszystkich czynnikach określonych w modelu. (C) "FIG07_Feature_Correlations" przedstawiające korelację wag współczynników cech między różnymi konfiguracjami. Kliknij tutaj, aby pobrać ten plik.
Rysunek uzupełniający 4: Efekt integracji multiomicznej - przy użyciu tylko danych proteomicznych. Wynikowe wzorce uchwycone przez czynniki utajone, gdy jako dane wejściowe są używane tylko jako dane proteomiczne. (A) FIG04_Factor_Association_Numerical_Features: Korelacja Pearsona wartości czynników ze zmiennymi klinicznymi (CRP, CK). (B) FIG04_Factor_Association_Categorical_Features: Porównanie wartości czynników na wykresie pudełkowym każdego punktu czasowego pacjentów z OZW i grupą kontrolną. Kliknij tutaj, aby pobrać ten plik.
Plik uzupełniający 1: Supplementary_File_
Running_Pipeline_with_Exemplary_Data. Opisy sposobu uruchamiania potoku na przykładowych danych i oczekiwanych danych wyjściowych znajdują się w dodatkowo dostarczonym pliku uzupełniającym. Kliknij tutaj, aby pobrać ten plik.
Dodatkowy plik wideo 1: Zrzut ekranu z protokołu. Kliknij tutaj, aby pobrać ten plik.