"""
DDA Quantification Module for precursor level Quantification.
"""
from __future__ import annotations
import pandas as pd
from pandas import DataFrame
from proteobench.datapoint.quant_datapoint import QuantDatapointHYE
from proteobench.exceptions import (
ConvertStandardFormatError,
IntermediateFormatGenerationError,
ParseError,
ParseSettingsError,
QuantificationError,
)
from proteobench.io.parsing.parse_ion import load_input_file
from proteobench.io.parsing.parse_settings import ParseSettingsBuilder
from proteobench.modules.constants import MODULE_SETTINGS_DIRS
from proteobench.modules.quant.benchmarking import run_benchmarking
from proteobench.modules.quant.quant_base_module import QuantModule
from proteobench.score.quantscores import QuantScoresHYE
[docs]
class DDAQuantIonModuleQExactive(QuantModule):
"""
DDA Quantification Module for precursor level Quantification.
Parameters
----------
token : str
GitHub token for the user.
proteobot_repo_name : str, optional
Name of the repository for pull requests and where new points are added, by default "Proteobot/Results_quant_ion_DDA".
proteobench_repo_name : str, optional
Name of the repository where the benchmarking results will be stored, by default "Proteobench/Results_quant_ion_DDA".
Attributes
----------
module_id : str
Module identifier for configuration.
precursor_column_name: str
Level of quantification.
"""
module_id = "quant_lfq_DDA_ion_QExactive"
def __init__(
self,
token: str,
proteobot_repo_name: str = "Proteobot/Results_quant_ion_DDA",
proteobench_repo_name: str = "Proteobench/Results_quant_ion_DDA",
):
"""
Initialize the DDA Quantification Module for precursor level Quantification.
Parameters
----------
token : str
GitHub token for the user.
proteobot_repo_name : str, optional
Name of the repository for pull requests and where new points are added, by default "Proteobot/Results_quant_ion_DDA".
proteobench_repo_name : str, optional
Name of the repository where the benchmarking results will be stored, by default "Proteobench/Results_quant_ion_DDA".
"""
super().__init__(
token,
proteobot_repo_name=proteobot_repo_name,
proteobench_repo_name=proteobench_repo_name,
parse_settings_dir=MODULE_SETTINGS_DIRS[self.module_id],
module_id=self.module_id,
)
self.precursor_column_name = "precursor ion"
[docs]
def is_implemented(self) -> bool:
"""
Return whether the module is fully implemented.
Returns
-------
bool
True if the module is fully implemented, False otherwise.
"""
return True
[docs]
def benchmarking(
self,
input_file_loc: any,
input_format: str,
user_input: dict,
all_datapoints: pd.DataFrame,
default_cutoff_min_prec: int = 3,
input_file_secondary: str = None,
) -> tuple[DataFrame, DataFrame, DataFrame]:
"""
Main workflow of the module. Used to benchmark workflow results.
Parameters
----------
input_file_loc : any
Path to the workflow output file.
input_format : str
Format of the workflow output file.
user_input : dict
User provided parameters for plotting.
all_datapoints : pd.DataFrame
DataFrame containing all datapoints from the proteobench repo.
default_cutoff_min_prec : int
Minimum number of runs a precursor ion has to be identified in.
input_file_secondary : str, optional
Path to a secondary input file (used for some formats like AlphaDIA).
Returns
-------
tuple[DataFrame, DataFrame, DataFrame]
Tuple containing the intermediate data structure, all datapoints, and the input DataFrame.
"""
return run_benchmarking(
input_file=input_file_loc,
input_format=input_format,
user_input=user_input,
all_datapoints=all_datapoints,
parse_settings_dir=self.parse_settings_dir,
module_id=self.module_id,
precursor_column_name=self.precursor_column_name,
default_cutoff_min_prec=default_cutoff_min_prec,
add_datapoint_func=self.add_current_data_point,
input_file_secondary=input_file_secondary,
)
[docs]
def get_plot_generator(self):
return super().get_plot_generator()
