iggytop.adapters.trait_adapter.TRAITAdapter#

class iggytop.adapters.trait_adapter.TRAITAdapter(bc, cache_dir=None, receptors_to_include=('TCR', 'BCR'), test=False)#

A Comprehensive Database for T-cell Receptor-Antigen Interactions TRAIT.

__init__(bc, cache_dir=None, receptors_to_include=('TCR', 'BCR'), test=False)#

Initializes the BaseAdapter instance.

Parameters:

bc (BioCypher) – An instance of the BioCypher class.
cache_dir (str | None) – Directory to cache data. Defaults to None.
receptors_to_include (Optional[Sequence[Literal['TCR', 'BCR']]]) – Receptors to include. Defaults to (“TCR”, “BCR”).
test (bool) – Whether to run in test mode. Defaults to False.

Methods

`__init__`(bc[, cache_dir, ...])	Initializes the BaseAdapter instance.
`create_anndata`()	Creates an Anndata object from the AIRR cell data and saves it to a file in the cache directory.
`get_edges`()	Yield BioCypher edges generated via OntoWeaver.
`get_latest_release`(bc)	Retrieves the latest release of the TRAIT database.
`get_nodes`()	Yield BioCypher nodes generated via OntoWeaver.
`read_table`(bc, table_path, receptors[, test])	Reads and processes the TRAIT table from the downloaded database file.
`set_metadata`([version, source_url, ...])	Sets the metadata for the adapter.

Attributes

`DB_DIR`	Directory name for the downloaded database.
`DB_NAME`	Name of the database.
`DB_URL`	URL to download the TRAIT database.
`DB_VERSION`	Version of the TRAIT database, taken from the date embedded in `DB_URL`.
`airr_cells`	Property to get the list of AIRR cells.
`available_receptors`	Receptor types available in TRAIT.
`cache_dir`	Property to get the cache directory.
`db_name`	Property to get the database name.
`metadata`	Property to get the adapter metadata.
`receptors`	Property to get the available receptor types.
`table`	Property to get the data table.

get_latest_release(bc)#

Retrieves the latest release of the TRAIT database.

read_table(bc, table_path, receptors, test=False)#

Reads and processes the TRAIT table from the downloaded database file.

Parameters:

bc (BioCypher) – An instance of the BioCypher class.
table_path (str) – Path to the table file.
receptors (list[str]) – List of receptor types to include in the table (Ignored as only TCR is available).
test (bool) – If True, loads only a subset of the data for testing (default is False).

Return type:

DataFrame

Returns:

A DataFrame containing the processed table data.

Raises:

FileNotFoundError – If the table file cannot be found.

DB_URL = 'https://pgx.zju.edu.cn/download.trait/Interactive_TCR-pMHC_Pairs.zip_20250312.zip'#: URL to download the TRAIT database.

DB_VERSION = '2025-03-12'#: Version of the TRAIT database, taken from the date embedded in DB_URL.

available_receptors: list[str] = ['TCR']#: Receptor types available in TRAIT.

iggytop.adapters.trait_adapter.TRAITAdapter