Source code for cellphonedb.src.core.preprocessors.method_preprocessors

import pandas as pd

from cellphonedb.src.core.exceptions.ProcessMetaException import ProcessMetaException


[docs]def meta_preprocessor(meta_raw: pd.DataFrame) -> pd.DataFrame: """ Re-formats meta_raw if need be to ensure correct columns and indexes are present Parameters ---------- meta_raw: pd.DataFrame A DataFrame containing a mapping between cells and cell types. Returns ------- pd.DataFrame meta DataFrame containing columns and indexes as expected by the analysis methods """ meta_raw.columns = map(str.lower, meta_raw.columns) try: if 'cell' in meta_raw and 'cell_type' in meta_raw: meta = meta_raw[['cell', 'cell_type']] meta.set_index('cell', inplace=True, drop=True) return meta if isinstance(meta_raw.index, pd.core.indexes.multi.MultiIndex): raise ProcessMetaException elif 'cell_type' in meta_raw: meta = meta_raw[['cell_type']] if isinstance(meta_raw.index, pd.core.indexes.range.RangeIndex): meta.set_index(meta_raw.iloc[:, 0], inplace=True) meta.index.name = 'cell' return meta if isinstance(meta_raw.index, pd.core.indexes.base.Index): meta.index.name = 'cell' return meta num_unique_vals_in_first_col = len(list(set(meta_raw.iloc[:, 0].values))) num_unique_vals_in_second_col = len(list(set(meta_raw.iloc[:, 1].values))) if num_unique_vals_in_first_col > num_unique_vals_in_second_col: meta = pd.DataFrame(data={'cell_type': meta_raw.iloc[:, 1]}) meta.set_index(meta_raw.iloc[:, 0], inplace=True) meta.index.name = 'cell' meta.index = meta.index.astype(str) return meta else: raise ProcessMetaException except Exception: raise ProcessMetaException