{"entity":{"id":"tcr-repertoire-clonality","kind":"term","name":"T-cell receptor repertoire diversity and clonality","aka":["TCR repertoire clonality","TCR repertoire diversity"],"tldr":"Repertoire measures describe how many receptor identities are sampled and how unevenly they are represented. A dominant sequence does not tell us what its cells recognize.","summary":"Repertoire sequencing can describe richness and the distribution of sampled receptor sequences. Those summaries depend on the sampled population and the way receptor identities and counts are defined; the original sequencing study found diversity estimates that differed from earlier methods. A repertoire dominated by a clone is a distributional observation. It is distinct from proving tumor specificity, a malignant clone or successful tumor killing, each of which needs additional evidence.","asOf":"2026-11-10","links":[{"label":"Comprehensive assessment of T-cell receptor beta-chain diversity in alphabeta T cells.","url":"https://doi.org/10.1182/blood-2009-04-217604"},{"label":"Phenotypic analysis of antigen-specific T lymphocytes.","url":"https://doi.org/10.1126/science.274.5284.94"},{"label":"Ruggiero et al., High-resolution analysis of the human T-cell receptor repertoire (Nat Commun 2015)","url":"https://pubmed.ncbi.nlm.nih.gov/26324409/"},{"label":"Han et al., Linking T-cell receptor sequence to functional phenotype at the single-cell level (Nat Biotechnol 2014)","url":"https://pubmed.ncbi.nlm.nih.gov/24952902/"},{"label":"Yost et al., Clonal replacement of tumor-specific T cells following PD-1 blockade (Nat Med 2019)","url":"https://pubmed.ncbi.nlm.nih.gov/31359002/"},{"label":"den Braber et al., Maintenance of peripheral naive T cells is sustained by thymus output in mice but not humans (Immunity 2012)","url":"https://pubmed.ncbi.nlm.nih.gov/22365666/"},{"label":"VDJtools: Unifying Post-analysis of T Cell Receptor Repertoires.","url":"https://doi.org/10.1371/journal.pcbi.1004503"},{"label":"3D: diversity, dynamics, differential testing - a proposed pipeline for analysis of next-generation sequencing T cell repertoire data.","url":"https://pubmed.ncbi.nlm.nih.gov/28241742/"},{"label":"VDJtools: diversity-index definitions","url":"https://vdjtools-doc.readthedocs.io/en/master/diversity.html"}],"tags":[],"related":["tcr-repertoire-sequencing","clonality-testing","immune-cytotoxicity-assays"],"cancers":[],"sections":[],"technologies":[],"targets":[],"drugs":[],"companies":[],"institutions":[],"pathways":[],"terms":[],"trials":[],"people":[],"bottlenecks":[],"keyPapers":[],"journals":[],"dependsOn":[],"notes":["The repertoire is a distribution of receptor identities and abundances in a stated population and time. A clone is a cellular lineage; a clonotype is an operational sequence grouping. Single-chain labels and paired identities have different resolution. V(D)J assembly and thymic selection contribute diversity, while expansion changes abundance; diversity and total T-cell count are different quantities.","Blood, tumour and lymph nodes sample overlapping but different populations. Infection, therapy, age and movement can change a sample; absence from one tube may reflect sampling or detection rather than whole-body absence. A pretreatment blood sample is not a complete stored repertoire. Lower measured diversity after infection may reflect a vigorous response and does not establish cancer specificity, vaccine causation or uniformly worse immunity.","Fictional matched receptor samples contain 10 clonotype A cells among 1,000 T cells (1%) and 10 among 100 (10%). The sampled count remains 10; the changed denominator drives the larger fraction. Absolute expansion requires comparable sampling and calibrated counts, and neither frequency identifies antigen. State sampling depth, chain definition, compartment, method and timing.","Metrics and arithmetic, fictional: with natural logarithms Shannon entropy is H = minus the sum of p times ln p, and one normalised clonality convention is 1 minus H / ln K for K observed clonotypes greater than one. Four clonotypes at 25, 25, 25 and 25 of 100 measured molecules give H = ln 4 = 1.386 and clonality 0. The same four at 70, 10, 10 and 10 give H = 0.940, clonality 1 minus 0.940 / 1.386 = 0.32, and an effective number of clonotypes exp(H) = 2.56. Richness is four in both, so many identities can coexist with strong dominance. Software may report Shannon entropy, its exponential or a normalised score, and these are not interchangeable: in the VDJtools documentation the Shannon-Wiener index returns the exponent of the entropy and the normalised index returns the entropy divided by the log of the clonotype count, which is evenness and not 1 minus that ratio, so a clonality built as 1 minus normalised entropy is a different number from either.","Share against count, fictional: clonotype A is 30 of 100 measured molecules, 30%, and later 30 of 50, 60%. Its measured count did not rise, the total fell, and its relative frequency doubled, so relative enrichment is not absolute expansion and the molecule counts are not blood cell counts. In a published analysis pipeline, clonality was identified as a robust key metric and first choice for measuring TCR repertoire diversity, and in prostate cancer patients given sipuleucel-T the pipeline detected changes in sequence frequency and diversity in blood and prostate tissue (Zhang 2017); that is a methods and example study and sets no response threshold. A diversity-analysis software suite reports repertoire comparison and diversity outputs (Shugay 2015), and formulas, software settings and subsampling depth have to be stated.","Measurement card: input is a sequencing-derived clonotype table and the calculation consumes no further tissue, though the upstream assay consumes its sample. Output units are a count for richness, dimensionless values for entropy and normalised clonality, and an effective clonotype count for effective diversity. Controls are matched compartments and handling, chain definition, error filtering, abundance units (reads, corrected molecules or cells are not automatically equivalent), depth assessment and replicates or resampling. Subsampling to a comparable depth helps assess sampling effects but cannot recover cells never sampled. A clonality summary does not identify what the receptors recognise, whether cells killed tumour, or whether treatment helped, and there is no universal clonality score that means an immune therapy is working.","Effective-diversity measures weight a distribution differently. For the inverse-Simpson convention, define D as the sum of squared clonotype fractions and report 1 / D: four equal fractions of 0.25 give 4, whereas 0.70, 0.10, 0.10 and 0.10 give 1 / 0.52, about 1.92. This differs from the Shannon effective diversity of about 2.56 for the same uneven distribution. A fictional sample containing only A and B at 50 molecules each has richness 2 and equal weights; low richness does not imply unequal weights.","For one observed clonotype, the expression 1 minus H / ln K divides by ln 1, which is zero. Report how the software handles that case rather than silently applying the formula. Low input, unequal depth, amplification bias, sequence errors, changing mixtures and inconsistent clonotype definitions can alter the result. Keep the software version, formula, filtering, input, compartment and abundance units, and inspect the distribution alongside the summary. Analytical reproducibility of a repertoire statistic does not establish a prognostic association or predict treatment benefit."],"category":"Immunology"},"route":"/terms/tcr-repertoire-clonality/","neighbours":{"term":[{"id":"immune-product-evidence","kind":"term","name":"Immune measurements and product evidence","route":"/terms/immune-product-evidence/"},{"id":"immune-cytotoxicity-assays","kind":"term","name":"Immune-cell cytotoxicity assays","route":"/terms/immune-cytotoxicity-assays/"},{"id":"immunodominance","kind":"term","name":"Immunodominance","route":"/terms/immunodominance/"},{"id":"tcr-repertoire-sequencing","kind":"term","name":"T-cell receptor repertoire sequencing","route":"/terms/tcr-repertoire-sequencing/"}],"technology":[{"id":"clonality-testing","kind":"technology","name":"Immunoglobulin and T-cell receptor clonality testing","route":"/technologies/clonality-testing/"}]}}