Source code for immuneML.encodings.deeprc.DeepRCEncoder


from pathlib import Path

import pandas as pd

from immuneML.data_model.dataset.RepertoireDataset import RepertoireDataset
from immuneML.data_model.encoded_data.EncodedData import EncodedData
from immuneML.encodings.DatasetEncoder import DatasetEncoder
from immuneML.encodings.EncoderParams import EncoderParams
from immuneML.util.PathBuilder import PathBuilder


[docs]class DeepRCEncoder(DatasetEncoder): """ DeepRCEncoder should be used in combination with the DeepRC ML method (:ref:`DeepRC`). This encoder writes the data in a RepertoireDataset to .tsv files. For each repertoire, one .tsv file is created containing the amino acid sequences and the counts. Additionally, one metadata .tsv file is created, which describes the subset of repertoires that is encoded by a given instance of the DeepRCEncoder. Note: sequences where count is None, the count value will be set to 1 YAML specification: .. indent with spaces .. code-block:: yaml my_deeprc_encoder: DeepRC """ ID_COLUMN = "ID" SEQUENCE_COLUMN = "amino_acid" COUNTS_COLUMN = "templates" SEP = "\t" EXTENSION = "tsv" def __init__(self, context: dict = None, name: str = None): self.context = context self.name = name self.max_sequence_length = 0
[docs] def set_context(self, context: dict): self.context = context return self
@staticmethod def _prepare_parameters(context: dict = None, name: str = None): return {"context": context, "name": name}
[docs] @staticmethod def build_object(dataset, **params): if isinstance(dataset, RepertoireDataset): prepared_params = DeepRCEncoder._prepare_parameters(**params) return DeepRCEncoder(**prepared_params) else: raise ValueError("DeepRCEncoder is not defined for dataset types which are not RepertoireDataset.")
[docs] def export_repertoire_tsv_files(self, output_folder: Path): repertoires = self.context["dataset"].repertoires for repertoire in repertoires: filepath = output_folder / f"{repertoire.identifier}.{DeepRCEncoder.EXTENSION}" if not filepath.is_file(): df = pd.DataFrame({DeepRCEncoder.SEQUENCE_COLUMN: repertoire.get_sequence_aas(), DeepRCEncoder.COUNTS_COLUMN: repertoire.get_counts()}) df[DeepRCEncoder.COUNTS_COLUMN].fillna(1, inplace=True) df.to_csv(path_or_buf=filepath, sep=DeepRCEncoder.SEP, index=False) max_sequence_length = max(df[DeepRCEncoder.SEQUENCE_COLUMN].str.len()) self.max_sequence_length = max(self.max_sequence_length, max_sequence_length)
[docs] def export_metadata_file(self, dataset, labels, output_folder): metadata_filepath = output_folder / f"{dataset.identifier}_metadata.{DeepRCEncoder.EXTENSION}" metadata = dataset.get_metadata(labels, return_df=True) metadata[DeepRCEncoder.ID_COLUMN] = dataset.get_repertoire_ids() metadata.to_csv(path_or_buf=metadata_filepath, sep="\t", index=False) return metadata_filepath
[docs] def encode(self, dataset, params: EncoderParams) -> RepertoireDataset: result_path = params.result_path / "encoding" PathBuilder.build(result_path) self.export_repertoire_tsv_files(result_path) labels = params.label_config.get_labels_by_name() metadata_filepath = self.export_metadata_file(dataset, labels, result_path) encoded_dataset = dataset.clone() encoded_dataset.encoded_data = EncodedData(examples=None, labels=dataset.get_metadata(labels) if params.encode_labels else None, example_ids=dataset.repertoire_ids, encoding=DeepRCEncoder.__name__, info={"metadata_filepath": metadata_filepath, "max_sequence_length": self.max_sequence_length}) return encoded_dataset
[docs] @staticmethod def export_encoder(path: Path, encoder) -> Path: encoder_file = DatasetEncoder.store_encoder(encoder, path / "encoder.pickle") return encoder_file