make_receptor_schema: Create or validate a receptor schema object

In immundata: A Unified Data Layer for Large-Scale Single-Cell, Spatial and Bulk Immunomics

Create or validate a receptor schema object

Description

Helper functions for defining and validating the schema used by agg_receptors() to identify unique receptors.

make_receptor_schema() creates a schema list object. assert_receptor_schema() checks if an object is a valid schema list and throws an error if not. test_receptor_schema() checks if an object is a valid schema list or a character vector (which agg_receptors can also accept) and returns TRUE or FALSE.

Usage

make_receptor_schema(features, chains = NULL)

assert_receptor_schema(schema)

test_receptor_schema(schema)

Arguments

features	Character vector. Column names defining the features of a single receptor chain (e.g., V gene, J gene, CDR3 sequence).
chains	Optional character vector (max length 2). Locus names (e.g., "TRA", "TRB") to filter by or pair. If NULL or length 1, only filtering occurs. If length 2, pairing logic is enabled in agg_receptors(). Default: NULL.
schema	An object to test or assert as a valid schema. Can be a list created by make_receptor_schema or a character vector (for test_receptor_schema).

Value

make_receptor_schema returns a list with elements features and chains. assert_receptor_schema returns TRUE invisibly if valid, or stops execution. test_receptor_schema returns TRUE or FALSE.

immundata documentation built on April 4, 2026, 9:09 a.m.