Skip to main content

Crate imgt

Crate imgt 

Source
Expand description

§IMGT

Handle the IMGT database of antibody germlines easily.

§Library features

  • Access to all germlines from all species in IMGT
  • Access to all isotopes of the germlines
  • Access to the regions (CDRs etc) and annotations (conserved etc)
  • Single threaded and multi threaded access

§Example usage

use imgt::*;
let selection = Selection::default()
    .species([Species::HomoSapiens])
    .chain([ChainType::Heavy])
    .gene([GeneType::V]);
let first = selection.germlines(&STATIC_IMGT).next().unwrap();
assert_eq!(first.name(), "IGHV1-2*01");

§Compilation features

  • rayon - enables parallel iterators using rayon

§Changelog

§0.2.0

  • Added more constant chain options
  • Added Lzw parsing (in mzcv) to allow automatic download and update
  • Fixed some issues with parsing
  • Updated static data to version 202631-5 date 2026-07-31 This crate handles parsing the IMGT LIGM-DB database into structures compatible with mzcore. It additionally stores all regions and annotations. There are two main ways of selecting germline(s), specified by name get_germline or by building a query over the data Selection.
Data present per species ## Bos taurus / Domestic bovine
KindVJC
IGHV12/133/47/9
IGKV6/61/11/1
IGLV25/265/54/4
IGIV0/00/00/0

Number of genes / number of alleles

§Camelus dromedarius / Arabian camel

KindVJC
IGHV22/225/59/9
IGKV8/84/41/1
IGLV0/00/00/0
IGIV0/00/00/0

Number of genes / number of alleles

§Canis lupus familiaris / Domestic dog

KindVJC
IGHV35/355/54/6
IGKV18/484/41/2
IGLV71/719/99/9
IGIV0/00/00/0

Number of genes / number of alleles

§Capra hircus / Domestic goat

KindVJC
IGHV0/00/00/0
IGKV5/51/10/0
IGLV24/241/11/1
IGIV0/00/00/0

Number of genes / number of alleles

§Ctenopharyngodon idella / Grass carp

KindVJC
IGHV0/028/287/7
IGKV0/00/00/0
IGLV0/00/00/0
IGIV0/00/00/0

Number of genes / number of alleles

§Danio rerio / Zebrafish

KindVJC
IGHV33/337/72/2
IGKV0/00/00/0
IGLV0/00/00/0
IGIV3/33/33/3

Number of genes / number of alleles

§Equus caballus / Domestic horse

KindVJC
IGHV19/256/610/19
IGKV17/204/51/2
IGLV0/00/00/0
IGIV0/00/00/0

Number of genes / number of alleles

§Felis catus / Domestic cat

KindVJC
IGHV36/364/44/4
IGKV12/125/51/1
IGLV32/3210/105/5
IGIV0/00/00/0

Number of genes / number of alleles

§Gadus morhua / Atlantic cod

KindVJC
IGHV0/00/00/0
IGKV0/00/00/0
IGLV0/00/00/0
IGIV0/06/66/6

Number of genes / number of alleles

§Gallus gallus / Domestic chicken

KindVJC
IGHV2/21/10/0
IGKV0/00/00/0
IGLV2/31/11/1
IGIV0/00/00/0

Number of genes / number of alleles

§Gorilla gorilla / Western gorilla

KindVJC
IGHV0/00/02/2
IGKV0/00/00/0
IGLV0/00/00/0
IGIV0/00/00/0

Number of genes / number of alleles

§Gorilla gorilla gorilla / Western lowland gorilla

KindVJC
IGHV55/975/810/24
IGKV26/515/61/1
IGLV28/446/66/12
IGIV0/00/00/0

Number of genes / number of alleles

§Heterodontus francisci / Horn shark

KindVJC
IGHV1/11/11/1
IGKV0/00/00/0
IGLV0/00/00/0
IGIV0/00/00/0

Number of genes / number of alleles

§Homo sapiens / Human

KindVJC
IGHV61/1816/1410/51
IGKV45/735/61/4
IGLV37/839/127/15
IGIV0/00/00/0

Number of genes / number of alleles

§Hylobates lar / Common gibbon

KindVJC
IGHV0/00/02/3
IGKV0/00/00/0
IGLV0/00/00/0
IGIV0/00/00/0

Number of genes / number of alleles

§Ictalurus punctatus / Channel catfish

KindVJC
IGHV28/2820/203/3
IGKV0/00/00/0
IGLV0/00/00/0
IGIV4/42/23/3

Number of genes / number of alleles

§Lama glama / Llama

KindVJC
IGHV8/80/00/0
IGKV0/00/00/0
IGLV0/00/00/0
IGIV0/00/00/0

Number of genes / number of alleles

§Lemur catta / Ring-tailed lemur

KindVJC
IGHV56/564/43/3
IGKV11/224/51/2
IGLV118/11810/108/8
IGIV0/00/00/0

Number of genes / number of alleles

§Leucoraja erinacea / Little skate

KindVJC
IGHV0/02/20/0
IGKV0/00/00/0
IGLV0/00/00/0
IGIV0/00/00/0

Number of genes / number of alleles

§Macaca assamensis / Assam macaque

KindVJC
IGHV0/00/01/1
IGKV0/00/00/0
IGLV0/00/00/0
IGIV0/00/00/0

Number of genes / number of alleles

§Macaca fascicularis / Crab-eating macaque

KindVJC
IGHV1/16/61/1
IGKV0/00/00/0
IGLV0/00/00/0
IGIV0/00/00/0

Number of genes / number of alleles

§Macaca mulatta / Rhesus monkey

KindVJC
IGHV118/2737/118/16
IGKV59/785/51/2
IGLV55/747/76/8
IGIV0/00/00/0

Number of genes / number of alleles

§Mesocricetus auratus / Golden hamster

KindVJC
IGHV0/00/07/7
IGKV0/00/01/1
IGLV0/00/03/3
IGIV0/00/00/0

Number of genes / number of alleles

§Mus cookii / Cook’s mouse

KindVJC
IGHV0/00/00/0
IGKV0/00/01/1
IGLV0/00/00/0
IGIV0/00/00/0

Number of genes / number of alleles

§Mus minutoides / Southern African pygmy mouse

KindVJC
IGHV0/00/00/0
IGKV0/00/01/1
IGLV0/00/00/0
IGIV0/00/00/0

Number of genes / number of alleles

§Mus musculus / House mouse

KindVJC
IGHV286/3994/79/23
IGKV103/1155/91/1
IGLV3/54/44/5
IGIV0/00/00/0

Number of genes / number of alleles

§Mus musculus domesticus / Western European house mouse

KindVJC
IGHV0/01/10/0
IGKV0/00/00/0
IGLV0/01/12/2
IGIV0/00/00/0

Number of genes / number of alleles

§Mus pahari / Shrew mouse

KindVJC
IGHV0/00/00/0
IGKV0/00/01/1
IGLV0/00/00/0
IGIV0/00/00/0

Number of genes / number of alleles

§Mus saxicola / Spiny mouse

KindVJC
IGHV0/00/00/0
IGKV0/00/01/1
IGLV0/00/00/0
IGIV0/00/00/0

Number of genes / number of alleles

§Mus sp. / Mice

KindVJC
IGHV0/02/20/0
IGKV0/00/00/0
IGLV0/00/00/0
IGIV0/00/00/0

Number of genes / number of alleles

§Mus spretus / Western wild mouse

KindVJC
IGHV0/00/00/0
IGKV0/00/01/1
IGLV2/21/12/3
IGIV0/00/00/0

Number of genes / number of alleles

§Mustela putorius furo / Domestic ferret

KindVJC
IGHV42/426/65/5
IGKV40/404/41/1
IGLV40/407/75/5
IGIV0/00/00/0

Number of genes / number of alleles

§Neogale vison / American mink

KindVJC
IGHV25/253/36/6
IGKV0/00/00/0
IGLV0/00/00/0
IGIV0/00/00/0

Number of genes / number of alleles

§Oncorhynchus mykiss / Rainbow trout

KindVJC
IGHV42/4519/233/5
IGKV0/00/00/0
IGLV0/00/00/0
IGIV0/02/22/2

Number of genes / number of alleles

§Ornithorhynchus anatinus / Platypus

KindVJC
IGHV34/3410/107/7
IGKV0/00/00/0
IGLV0/00/00/0
IGIV0/00/00/0

Number of genes / number of alleles

§Oryctolagus cuniculus / Rabbit

KindVJC
IGHV8/86/117/8
IGKV5/55/82/9
IGLV20/202/23/3
IGIV0/00/00/0

Number of genes / number of alleles

§Ovis aries / Domestic sheep

KindVJC
IGHV3/32/20/0
IGKV5/51/11/1
IGLV50/601/11/2
IGIV0/00/00/0

Number of genes / number of alleles

§Pan troglodytes / Chimpanzee

KindVJC
IGHV0/00/03/3
IGKV0/00/00/0
IGLV0/00/00/0
IGIV0/00/00/0

Number of genes / number of alleles

§Pongo abelii / Sumatran orangutan

KindVJC
IGHV61/1184/79/23
IGKV32/524/41/2
IGLV31/504/55/11
IGIV0/00/00/0

Number of genes / number of alleles

§Pongo pygmaeus / Bornean orangutan

KindVJC
IGHV61/853/310/13
IGKV36/555/51/2
IGLV36/545/75/8
IGIV0/00/00/0

Number of genes / number of alleles

§Rattus norvegicus / Norway rat

KindVJC
IGHV122/1224/48/10
IGKV39/396/61/1
IGLV13/172/34/6
IGIV0/00/00/0

Number of genes / number of alleles

§Salmo salar / Atlantic salmon

KindVJC
IGHV69/7619/196/8
IGKV0/00/00/0
IGLV0/00/00/0
IGIV3/30/00/0

Number of genes / number of alleles

§Sus scrofa / Domestic pig

KindVJC
IGHV5/55/510/13
IGKV11/195/81/2
IGLV10/143/42/2
IGIV0/00/00/0

Number of genes / number of alleles

§Takifugu rubripes / Torafugu

KindVJC
IGHV8/80/00/0
IGKV0/00/00/0
IGLV0/00/00/0
IGIV0/00/00/0

Number of genes / number of alleles

§Vicugna pacos / Alpaca

KindVJC
IGHV4/46/65/5
IGKV0/00/00/0
IGLV0/00/00/0
IGIV0/00/00/0

Number of genes / number of alleles

§Xenopus laevis/gilli / African or Cape clawed frog

KindVJC
IGHV4/40/00/0
IGKV0/00/00/0
IGLV0/00/00/0
IGIV0/00/00/0

Number of genes / number of alleles

Structs§

Allele
A returned allele
AnnotatedSequence
Intermediate representation for annotated sequence
Chain
The intermediate representation for a chain
Gene
A germline gene name, broken up in its constituent parts.
Germline
Intermediate representation for germline
Germlines
A selection of germlines from a single species.
IMGT
IMGT antibody germlines
NotASpecies
Error type to indicate that the given name was not a recognised species from the IMGT database
Selection
The selection rules for iterating over a selection of germlines.

Enums§

AlleleSelection
The allele handling strategy
ChainType
Any chain type of germline
Constant
Any type of constant gene
GeneType
Any gene in a germline, eg variable, joining
Species
All species available in the IMGT dataset. Look at the main documentation to see which actually have data provided.

Statics§

STATIC_IMGT
A single shared static access to the static data in the ontologies for cases where no runtime resolution is needed (like tests).

Traits§

FancyDisplay
Display things and allow the use of fancy non ascii characters