# Primary sources

Working list of sources we will check the simulation against. The
discipline is the same as Antikythera Live: every mechanical claim
should be traceable to a primary source, and the UI should mark
"documented" vs "inferred" where the reconstruction goes beyond what
the source actually shows.

## Inventor lineage (pre-Jacquard, essential context)

- **Basile Bouchon** (1725) — Lyon. Perforated paper roll selecting
  needles in a drawloom. The first card-controlled (well, tape-
  controlled) loom. Bouchon's son Jean-Baptiste Falcon (1728)
  generalised it to chained punched cards.
- **Jacques de Vaucanson** (1745) — added a cylinder to advance the
  cards mechanically, removing the need for a draw-boy. Loom largely
  ignored in his lifetime; Conservatoire des Arts et Métiers
  preserved it.
- **Joseph-Marie Jacquard** (1804) — combined Bouchon's holes,
  Falcon's chained cards, and Vaucanson's cylinder into a practical,
  affordable loom attachment. *This* is what spread.

The sim should make this lineage visible; it's pedagogically the most
important thing.

## Mechanical references

- **Bibliothèque Nationale de France** — Jacquard's patent drawings
  (Brevet d'invention, 1804). Public domain.
- **Musée des Arts et Métiers, Paris** — Vaucanson's surviving loom
  and a working Jacquard demonstration. Photographable, on permanent
  display.
- **Conservatoire National des Arts et Métiers** — archived
  mechanical drawings.
- **Science and Industry Museum, Manchester** — operating Jacquard
  attachment on a power loom. Demonstrations in 2025–26 (verify
  schedule).
- **Posselt, E. A.** *The Jacquard Machine, Analyzed and Explained*
  (Philadelphia, 1888). Engineering-grade plates of the
  mechanism. Public domain via HathiTrust / archive.org.
- **Barlow, Alfred.** *The History and Principles of Weaving by Hand
  and by Power* (London, 1878). Public domain.

## Modern technical references

- **Essinger, James.** *Jacquard's Web* (Oxford UP, 2004). Cited only.
- **Schoeser, Mary.** *Silk* (Yale UP, 2007). Material context.
- **Liu, Jingjing & Zhao, Feng.** Studies on Chinese
  draw-loom precursors — pattern looms predate Jacquard by ~1800
  years in China. Important for the global story.

## Pattern data

For "load an image, weave it" we need bitmap → punched-card encoding.
The classic Jacquard test image is the **Jacquard portrait** woven
in 1839 — 24,000 cards, photo-realistic at the time. We can use the
portrait itself (or a stylised version) as the first demo bitmap.

## Card encoding

Standard Jacquard cards have a fixed grid (commonly 8×52 holes for
small looms, up to 1200+ hooks on jacquards used in textile mills).
Each row of holes = one pick = one card. Pattern repeats by wrapping
the card chain into a loop.

For v1 we'll fix a small grid (e.g. 32 hooks × N picks) and let users
upload an image up to that resolution. This keeps the geometry budget
sane and the teaching point clear.