def run_general_clustering_pipeline(self):
"""
Runs data cleaning for general_clustering_pipeline.
Args:
NA.
Returns:
validation_flag: Boolean type value indicating if input data is valid or not.
message: A message indicates the status of current check.
"""
if self.user_spreadsheet_df is None:
return False, logger.logging
# Checks intersection between user spreadsheet data and phenotype data
phenotype_df_cleaned = None
if self.phenotype_df is not None:
phenotype_df_cleaned = CommonUtil.check_phenotype_intersection(self.phenotype_df,
self.user_spreadsheet_df.columns.values)
if phenotype_df_cleaned is None:
logger.logging.append('ERROR: Phenotype is emtpy. Please provide a valid phenotype data.')
return False, logger.logging
logger.logging.append('INFO: Start to process user spreadsheet data.')
# Checks if user spreadsheet contains na value and only real number
user_spreadsheet_df_val_check = SpreadSheet.check_user_spreadsheet_data(self.user_spreadsheet_df,
dropna_colwise=True,
check_real_number=True,
check_positive_number=True)
if user_spreadsheet_df_val_check is None:
return False, logger.logging
user_spreadsheet_df_rm_na_header = SpreadSheet.remove_na_header(user_spreadsheet_df_val_check)
if user_spreadsheet_df_rm_na_header is None:
return False, logger.logging
# Removes NA value and duplication on column and row name
user_spreadsheet_df_cleaned = SpreadSheet.remove_dataframe_indexer_duplication(user_spreadsheet_df_rm_na_header)
if user_spreadsheet_df_cleaned is None:
return False, logger.logging
IOUtil.write_to_file(user_spreadsheet_df_cleaned, self.run_parameters['spreadsheet_name_full_path'],
self.run_parameters['results_directory'], '_ETL.tsv')
logger.logging.append(
'INFO: Cleaned user spreadsheet has {} row(s), {} column(s).'.format(
user_spreadsheet_df_cleaned.shape[0],
user_spreadsheet_df_cleaned.shape[1]))
if phenotype_df_cleaned is not None:
IOUtil.write_to_file(phenotype_df_cleaned, self.run_parameters['phenotype_name_full_path'],
self.run_parameters['results_directory'], '_ETL.tsv')
logger.logging.append(
'INFO: Cleaned phenotype data has {} row(s), {} column(s).'.format(phenotype_df_cleaned.shape[0],
phenotype_df_cleaned.shape[1]))
return True, logger.logging
def run_samples_clustering_pipeline(self):
"""
Runs data cleaning for samples_clustering_pipeline.
Args:
NA
Returns:
validation_flag: Boolean type value indicating if input data is valid or not.
message: A message indicates the status of current check.
"""
if self.user_spreadsheet_df is None:
return False, logger.logging
logger.logging.append('INFO: Start to process user spreadsheet data.')
# Checks if only non-negative real number appears in user spreadsheet and drop na column wise
user_spreadsheet_val_chked = SpreadSheet.check_user_spreadsheet_data(self.user_spreadsheet_df,
dropna_colwise=True,
check_real_number=True,
check_positive_number=True)
if user_spreadsheet_val_chked is None:
return False, logger.logging
# Removes NA value and duplication on column and row name
user_spreadsheet_df_checked = SpreadSheet.remove_dataframe_indexer_duplication(user_spreadsheet_val_chked)
# Checks the validity of gene name to see if it can be ensemble or not
user_spreadsheet_df_cleaned, map_filtered_dedup, mapping = SpreadSheet.map_ensemble_gene_name(
user_spreadsheet_df_checked,
self.run_parameters)
if 'gg_network_name_full_path' in self.run_parameters.keys() and \
not CommonUtil.check_network_data_intersection(user_spreadsheet_df_cleaned.index,
self.run_parameters):
return False, logger.logging
# The logic here ensures that even if phenotype data doesn't fits requirement, the rest pipelines can still run.
if user_spreadsheet_df_cleaned is None:
return False, logger.logging
else:
IOUtil.write_to_file(user_spreadsheet_df_cleaned, self.run_parameters['spreadsheet_name_full_path'],
self.run_parameters['results_directory'], '_ETL.tsv')
# writes dedupped mapping between user_supplied_gene_name and ensemble name to a file
IOUtil.write_to_file(map_filtered_dedup, self.run_parameters['spreadsheet_name_full_path'],
self.run_parameters['results_directory'], '_MAP.tsv', use_index=True, use_header=False)
# writes user supplied gene name along with its mapping status to a file
IOUtil.write_to_file(mapping, self.run_parameters['spreadsheet_name_full_path'],
self.run_parameters['results_directory'],
'_User_To_Ensembl.tsv', use_index=False, use_header=True)
logger.logging.append(
'INFO: Cleaned user spreadsheet has {} row(s), {} column(s).'.format(
user_spreadsheet_df_cleaned.shape[0],
user_spreadsheet_df_cleaned.shape[1]))
if self.phenotype_df is not None:
logger.logging.append('INFO: Start to process phenotype data.')
phenotype_df_cleaned = CommonUtil.check_phenotype_intersection(self.phenotype_df,
self.user_spreadsheet_df.columns.values)
if phenotype_df_cleaned is None:
logger.logging.append('ERROR: Phenotype is emtpy. Please provide a valid phenotype data.')
return False, logger.logging
else:
IOUtil.write_to_file(phenotype_df_cleaned, self.run_parameters['phenotype_name_full_path'],
self.run_parameters['results_directory'], '_ETL.tsv')
logger.logging.append('INFO: Cleaned phenotype data has {} row(s), {} '
'column(s).'.format(phenotype_df_cleaned.shape[0], phenotype_df_cleaned.shape[1]))
return True, logger.logging