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.

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.