← AI tools

How the breeding tools calculate

Every probability, count and date in the Mendelian calculator and the cross planner comes from the methods on this page. AI only reads the words of a goal; it never computes a number.

Engine version 1.0.0.

Mendelian inheritance

  • Each locus is inherited on its own, unless loci share a linkage group. Linked loci on an autosome travel together as one block.
  • Linked loci are read in coupling phase: an animal's mutant alleles sit on one chromosome. An animal typed as a carrier at one linked locus but not another is used as recorded, and the result says so.
  • X-linked loci: sons take their mother's X and their father's Y; daughters take one X from each parent. Y-linked loci pass from father to son only.
  • At a locus whose assay shows only present or absent, most often a transgene, a carrier counts as one copy (hemizygous) unless you choose two.
  • Probabilities are exact fractions with a power of two below the line, such as 1/8 or 3/32, shown with their percent. The offspring of one cross add up to exactly 1.
  • A locus where either parent has no genotype is left out of the result and named. The calculator never guesses a missing genotype.

Inbreeding

The inbreeding coefficient F of a pair's offspring is Wright's coefficient, from three generations of recorded parents: the sum, over every ancestor the sire and dam share, of (1/2)n + m + 1, where n and m are the generations from the sire and from the dam to that ancestor. A parent paired with its own offspring counts as 0.25.

Full siblings give 0.25, half siblings 0.125 and first cousins 0.0625. By default the planner leaves out pairs at 0.25 or more; a lab can choose 0.125, 0.0625 or no limit. Siblings bred within a plan count as 0.25. A pair with no recorded parents counts as unrelated in the app; the free public planner has no pedigree, so its pairs' F is unknown.

How the cross planner sizes a plan

  • Goal pups per litter: mu = share x litter size x (1 - pre-weaning loss), where the share is the fraction of pups with the goal's genotype and sex.
  • Litters needed: the smallest whole number L with P(Poisson(L x mu) >= count) >= 0.8, so a plan reaches its count with a probability of at least 80%.
  • Litters per pair: 1 + floor((window - pairing to first litter) / interval between litters), where the window runs from the pair's start to the last birth that can still be weaned and genotyped by the date.
  • Pairs: ceil(L / litters per pair / share of pairs that produce litters). Pairs that start on different days each count their own litters.
  • Completion: the genotyping date of the litter after which the expected goal pups reach the count with a probability of 0.8.
  • Plans run up to three generations: animals on hand, then the pups of one step bred in the next. A bred animal joins a pair once it is expected (with probability 0.8) and old enough to breed.
  • Breeders are taken in order of lowest F, then the youngest female, the youngest male and the animal ID; each animal once per plan. Up to the 20 youngest animals of each genotype are used.
  • Cages: each pair holds a cage from its start until the plan completes; each litter's weaned pups wait for genotyping in 2 x ceil(pups / 2 / adults per cage) cages, one set per sex; the goal animals stay, per sex, until the date. Cage-days add up the cages in use each day, and cost is cage-days times the lab's cost per cage per day.
  • When a goal names a protocol, a plan whose pups would take the protocol past its approved number is left out.
  • Plans are ranked on five components, each scaled from 0 to 1 across the plans found: goal pups per litter, days to completion, pairs, cage-days and the most related pair. You set their weights; ties go to the earlier completion, then fewer pairs.

Parameters and their sources

Every default the planner uses, with where it comes from. Your colony's own litters replace a default per strain once there are enough: litter size (pups born alive) from 5 recorded litters, the interval between litters from 5 intervals of the same pairs, and pre-weaning loss from 5 weaned litters, all born in the last 24 months. Dead-at-birth pups come off litter size once and are not counted again as losses. The planner names the source of every number it shows.

Default parameters with their values and sources
ParameterApplies toValueSource
Pairing to first litterMouse21 daysdefault, JAX colony planningJAX gives gestation as "~19-21 days"; ConductColony's breeding calendar already uses 21.
Pairing to first litterRat22 daysdefault, McGill 2020McGill gives 21 to 23 days of gestation; 22 is the midpoint.
Weaning ageMouse21 daysdefault, JAX colony planningJAX: weaning at "~21 days".
Weaning ageRat21 daysdefault, McGill 2020McGill: rats are weaned between 21 and 23 days.
Breeding ageMouse56 daysdefault, JAX and McGill 2020Mice breed from 6 to 8 weeks; the planner uses the upper bound, 8 weeks.
Breeding ageRat84 daysdefault, McGill 2020Rats breed from 10 to 12 weeks; the planner uses the upper bound, 12 weeks.
Oldest breederMouse240 daysdefault, McGill 2020McGill: breeding success decreases after 8 months in mice. JAX: about 7 to 8 months.
Oldest breederRat270 daysdefault, McGill 2020McGill: breeding success decreases after 9 months in rats.
Interval between littersMouse21 daysdefault, McGill 2020McGill: mice have "one litter every 21 days if male breeder is kept with the female".
Interval between littersRat34 daysdefault, derived from McGill 2020Derived: postpartum matings are at least 50% successful, otherwise breeding resumes 2 to 4 days after weaning, so 0.5 x 22 + 0.5 x (21 + 3 + 22) = 34.
Litter size (pups born)Mouse, C57BL/6 background7 pupsdefault, C57BL/6J, Silver 1995Silver, Table 4.1: C57BL/6J litters average 7.0 pups.
Litter size (pups born)Mouse, other backgrounds6 pupsdefault, McGill 2020McGill: mice have "6-8 on average"; the planner uses the lower bound.
Litter size (pups born)Rat9 pupsdefault, McGill 2020McGill: rats have "8-10 on average"; 9 is the midpoint.
Productive matings (share of pairs that produce litters)Mouse, C57BL/6 background84%default, C57BL/6J, Silver 1995Silver, Table 4.1: 84% of C57BL/6J matings are productive.
Productive matings (share of pairs that produce litters)Mouse, other backgrounds75%default, median of five strains, Silver 1995The median of the five strains in Silver's Table 4.1.
Productive matings (share of pairs that produce litters)Rat100%not modeled for ratsNo rat source was found, so every rat pair is counted as productive.
Pre-weaning loss (share of live-born pups lost before weaning)Mouse14%default, Morello et al. 2020Morello et al.: 14% at one facility and 39% at the other, across 219,975 C57BL/6 pups; the planner uses 14%.
Pre-weaning loss (share of live-born pups lost before weaning)Rat14%default, mouse figure from Morello et al. 2020, no rat sourceThe mouse figure, because no rat source was found.
Adults per cageMouse and rat5default, McGill 2020McGill: 5 adult mice of one sex per cage. Used only when the lab has no cages; otherwise the mean capacity of its cages, rounded down.
Genotyping turnaroundMouse and rat7 daysdefaultNot a biological value. Each lab sets its own in Settings, Breeding defaults.
  1. [1] JAX colony planning. The Jackson Laboratory, "Colony Planning" (read 2026-09-26). https://www.jax.org/jax-mice-and-services/customer-support/technical-support/breeding-and-husbandry-support/colony-planning
  2. [2] Silver 1995. Silver LM. Mouse Genetics: Concepts and Applications. Oxford University Press, 1995. Table 4.1, "Reproductive characteristics of some important inbred strains". https://www.informatics.jax.org/silver/tables/table4-1.shtml
  3. [3] McGill 2020. McGill University Comparative Medicine and Animal Resources Centre, "Module 5: Introduction to Rodent Breeding Colony Management" (Laboratory Animal Biomethodology Workshop handout, October 2020). https://www.mcgill.ca/research/files/research/breeding_module_handout_oct_2020.pdf
  4. [4] Morello et al. 2020. Morello GM, Hultgren J, Capas-Peneda S, et al. "High laboratory mouse pre-weaning mortality associated with litter overlap, advanced dam age, small and large litters." PLoS One 2020;15(8):e0236290. https://doi.org/10.1371/journal.pone.0236290

Reproducibility

Each plan run returns the engine version and an inputs hash: the SHA-256 of the canonical JSON of the engine version, the goal, the options, every parameter, each candidate animal with its genotype and the days it can breed, the F values, protocol use, cage capacity and the date. The same inputs always give the same plans and the same hash, so a plan can be checked later against the records it was made from.

What the AI does

In the cross planner you can describe the animals you need in your own words. A language model turns the words into a draft of the planner's form, using the loci your lab has recorded; anything it cannot match to a locus is listed for you, never invented. You check the form and press Plan. The model never computes a probability, count, date or cost. When AI is off, the box is hidden and the form works the same.

The anomaly detector and the colony assistant are in development; this page will describe their methods when they ship.