Glossary

The words this site uses, grouped by the part of the problem they belong to. Where a definition quotes notation, it is set in code.

Patterns and throws

The shape of a pattern itself: what its code means, how long its round is, and what its throws add up to.

Pattern
One row of the table: a siteswap in its canonical spelling, with its period, landing group and figures. The pages use pattern for the thing and siteswap for its code.
Siteswap
The code for a pattern: one character per throw, giving how many beats the prop stays in the air. Digits run 0–9, then A, B and C for 10, 11 and 12. Reading the same code from a different starting point is the same pattern; 333 is three throws of height 3.
Async siteswap
A siteswap in which the hands throw in turn, never two at once. Every pattern in the bulk table is async: one juggler throws per beat, and the hands come round A right, B right, A left, B left.
Beat
One unit of the count. In an async two-juggler pattern one juggler throws on each beat, so each juggler throws every second beat and each hand every fourth.
Period
The number of throws in one round of a pattern. For hsync it counts sync beats, each holding two throws. A pair's combined pattern runs over twice the period for async and semisync, and once for jsync and hsync.
Round and cycle
A round is one pass through the pattern's throws, from a throw back to the same place. The cycle is the closed sequence the animation plays until every prop is back in the hand it started in; it can run for several rounds.
Throw height
The character for one throw: how many beats it stays in the air. In an async pattern an odd height is a pass and an even one is a self throw.
Pass
A throw to the other juggler. In an async pattern it is an odd height.
Passing pattern
A pattern shared by two or more jugglers, in which some throws are passes.
Self throw
A throw the thrower catches themselves. In an async pattern it is an even height: a 2 crosses to the other hand and a 4 comes back to the same one.
Zero / empty hand
A 0: no throw on that beat. The bulk table has no height 1, so a token containing one is not a pattern the table can hold.
Hold
A prop kept in the hand instead of thrown. In a group pattern's grid it is a Pause, or a self that returns to the same hand next turn when the file says holds: carry.
Multiplex
More than one prop leaving the same hand on the same beat, written in brackets such as [43].
Mean height
The throw sum divided by the period: a single pattern's average height. The named list groups a self-pair by this number when it is whole.
Passes per round
The number of odd heights in a round: how many throws go to the partner.
Highest throw
The largest height in the pattern.
Empty throws
Whether a round contains a 0. The search table has a column for it, because an empty hand changes what a pattern can do with a partner.
Token
One pattern's code as typed or stored: a string of throw characters before it is rotated to its canonical spelling. A token may be a rotation of the row it names.
Rotation
A cyclic shift of a token. 306, 063 and 630 are one pattern, and starting the code elsewhere does not change it.
Canonical spelling
The one spelling the table stores for a rotation: the rotation with the smallest packed value. Lookups rotate a typed token to it first.
Object, prop, club
A thing being juggled. The site's drawings and copy assume clubs, so it often says club. A single pattern's object count is its mean height; a pair's real count is its props.
Workload
The total of a round's throw heights. A pair's workload is both patterns' sums, and dividing it by the pair's frame gives the props.

Finding a pattern and a partner

How the search form and the partner list narrow 62 million patterns down to two people.

Bulk table / pattern table
The 62,164,039-row SQLite table behind the pages: every async pattern of periods 2–9, read-only. A row is identified by its period and packed throws.
Facet / filter
One control in the search form — period, throw heights, passes, objects or props, or the box for patterns that fit themselves — and the value it carries in the URL. The page copy uses both facet and filter.
Anchor pattern
The pattern a partner search starts from. The endpoint reads its period, workload and landing group from its row, so a URL cannot widen the search by lying about them.
Partner list
The patterns your partner can juggle with the anchor, one row each, with a Juggle together button.Search for a pattern.
Fits
How many starting positions of a pair work: the number of slides that close. A partner list has a Fits column unless it is embedded in a pattern page, where the pair page states the count.
Objects range
On /search, a range on a pattern's mean height. On a partner list the same parameter is labelled Props and measures the pair, because the anchor's workload is subtracted from it server-side.
Fits itself
A pattern that can be juggled with itself: both jugglers throw it and the props come back round. The search box of that name restricts results to patterns in landing groups that are their own partner, and leaves out the all-empty pattern.Search with the box.
Landing group
The set of patterns of one period whose throws land on the same beats — the same landing mask. It is named Period P · Landing Group I, with the index counted from 0 within the period.
Partner group
The one landing group a pattern's partners come from. Every group has exactly one, the relation is symmetric, and 102 groups are their own partner.
Partner pattern
A pattern from the anchor's partner group: what the other juggler throws.

Pairing two patterns

Two patterns can be juggled together in several ways. These are the words for the ways, and for what each hand holds.

Pair
Two patterns juggled together. The second may be slid by any whole number of its own throws, and each slide is a different combined pattern.
Juggler A and juggler B
The two seats. A is drawn on the left and B on the right. The seat decides which side a drawing puts a juggler on and whether a pass is marked X or ||.
Slide
One whole-number shift of B's pattern against A's. Each slide is a different combined pattern with a different hand-out; only some close.
Starting position
The pair page's name for a slide, counted from 1.
Offset
The API's name for a slide, counted from 0. The pair page converts it at the fetch boundary, so a pasted URL and its heading name the same slide.
Meshes
The arithmetic says the two parts' throws and catches line up beat for beat. Meshing is necessary but not sufficient: the props must also come back round.
Closes / realizable
The props return to the hands that started with them. A pair that closes has a hand-out and can be animated.
Cannot show
A slide meshes but working out who holds what never finishes, so there is no hand-out or animation to draw.
Hand-out
How the props are distributed among the four hands at a starting position: what each hand holds before the first throw.
Ground state
A pair where every prop returns to the hand it started in after one round (returnsAfterRounds = 1). The How to start block shows its opening hold and what each juggler starts throwing.
Props
The number of clubs in the air between the two jugglers at a starting position.
Global siteswap
One string of throws over all the jugglers' beats; for two jugglers, A's and B's interleaved. For a slide this is also called the combined siteswap; the pair page prints it and the starting-position table has a column for it.
Local siteswap
One juggler's own throws, which is the form the pattern table stores and the form a juggler reads.
Frame
The number of beats a pair's combined pattern writes: twice the period for async and semisync, the period for jsync and hsync.
Self-pair
Both jugglers throw the same pattern.
Timing
How the hands are ordered. async is one juggler per beat; semisync is each juggler's two hands on adjacent beats; jsync is every juggler on every beat with hands alternating; hsync is both hands on every other beat. The bulk table's two-juggler patterns are async; the 4-handed non-async datasets are reached through the pair page's timing selector.
Hand order
The order hands throw in. For async it is A right, B right, A left, B left; for semisync it is A right, A left, B right, B left; jsync alternates hands with every juggler in step, and hsync throws both hands together every other beat.
Starting hands
Which hand each juggler starts with, written RRR or RLR. It depends on the pattern, so /try lets the reader set it.

Notations

The same pattern written for different readers: one juggler, two jugglers, a group, or the words jugglers say.

Notation
A way of writing a pattern. The site reads solo siteswap, JugglingLab passing notation, pattern-book notation, global siteswap for N jugglers, Prechac, Hefflish and a JIF.
Solo siteswap
A pattern for one juggler: plain digits, multiplex brackets, sync pairs, and * for a full cycle. /try reads it.Try one.
Sync pair
Two throws at the same time by the two hands, written in parentheses such as (4,2x).
JugglingLab passing notation
Two jugglers' throws written <3p 3 3|3p 3 3>, read exactly as JugglingLab reads it.Juggling Lab.
Pattern-book notation
The book's A | B form, such as 4p3 | 34p. The timing and B's starting hand are inferred from every start that juggles.
Global siteswap for N jugglers
One string for 4–14 hands, with a hand order and each juggler's starting hand. /try reads it for up to seven jugglers.
Synchronous passing pattern
A pattern where the jugglers throw at the same time, as most pattern-book patterns do. It has no global siteswap: a global siteswap writes one throw per beat and relies on the hand order to say who catches it, so it cannot hold several jugglers throwing at once. Staggering the jugglers to fit would change when every pass lands, which makes a different pattern. A synchronous pattern is written one juggler at a time instead, in Prechac such as 5p3 3 4p2 3 or in the book's table.
Prechac
A throw's height divided by the number of jugglers, so it is counted in the thrower's own beats. A p marks a pass.
Hefflish (Heffling words)
The spoken names for throws by their length in the thrower's own beats: Empty, Zip, Flip, Self, Heff, Trelf, Quelf; passes are Hand, Zap, Single, Double, Triple, Quad.
Pass marker
X for a crossing pass (right to right or left to left) and || for a straight pass (right to left or left to right). A self throw or an empty hand has no marker.
JIF
Juggling Interchange Format: the sequence description the animation and diagrams read. The app builds one for every pattern, pair and mix.

Group patterns

Patterns for three or more jugglers, one part per juggler and one shape they stand in.

Group pattern
A passing pattern for three or more jugglers, stored as one YAML file and compiled into the site.Browse the group patterns.
Part
One juggler's row of throws in an N-handed pattern, written in the dataset's notation.
Dataset
A table of N-handed parts named <hands>h-<timing>, such as 6h-jsync. 4h-async is the two-juggler table.
Hands
Twice the number of jugglers: 4-handed is two jugglers, 6-handed three, up to 12-handed six.
Formation
The shape the jugglers stand in, inferred from the pass graph: a feed, a polygon, 3v3 or a line.
Feed
One juggler passes to everyone else and gets passes back: a star graph (one hub, everyone else a spoke), written v, 3v1 or w.
Polygon
Every juggler passes to every other: a triangle, square, pentagon or hexagon.
3v3
Two groups of three passing within their group; the pass graph splits into two halves.
Seat map
A plan view of where each juggler stands, with a wedge for facing and an arrow for every pass.
Pass matrix
A table of every pass: from, to, beat, hand, direction and note.
Role card
One juggler's part in words: the clubs they start with, what each hand throws over a cycle, and who throws to them.
Grid (the book's table)
The pattern book's own beat grid, printed as the book prints it: a row per juggler and a column per beat, or per right-hand throw when the book counts right hands only, with cells such as T-C, D-B, D-self and Pause.
Dropback
A pass to a catcher who faces away from the thrower.
Dropforward
A pass to a catcher behind the thrower.
Reading notes
Warnings from compiling a group pattern file: places where the file and the reading disagree, for a person to check. A mix's equivalent section is What to watch for.
Draft / published
A group pattern is draft until its heights, hands and paths have been checked; then it is published. Drafts are listed and marked.

Moving patterns

The patterns whose jugglers walk, and the words the movement plan uses.

Moving pattern
A group pattern whose jugglers walk between stations.
Stage
The movement plan: stations, route, offsets and entries.
Station
A floor position in metres, seen from above.
Route
One juggler's stations, entry by entry.
Offsets
How many entries each juggler is behind the route's start.
Via
A floor point a walk passes through on its way to the next entry, to curve round a juggler standing in the way.
Spin
How many turns a juggler makes getting to the next entry, on top of the facing turning to wherever the next entry looks.
Stop
A brief standstill on a station, for a pass made on the way round.
Carry
A club kept in the hand while walking instead of thrown; set with holds: carry.

Mixes and saved patterns

Building a group pattern one juggler at a time, and keeping it.

Mix
A pattern built by picking a compatible part for each of 3–6 jugglers, one at a time. The last juggler is forced: after N−1 parts are placed, the free slots name one group, and the last part must land exactly on them.Start a mix.
Phase
Which rotation of a part is placed in the mix. The picker lists the phases whose landing slots fit the free slots.
Slides (in the picker)
How many phases of a part fit the free slots. It is the Slides column, and it is not a pair's starting positions despite the shared word.
Saved mix
A mix a signed-in user saves as a group pattern row. It is rebuilt from its stored parts, phases, starts and formation when opened, and stays private to its owner until a curator publishes it.

Drawings, diagrams and animation

What the pictures are called and what each one shows.

Still
The SVG drawing of a pattern's throws on a card or in a page header.
Tiny drawing
A small still beside a pattern's code in a table row.
Animation
The 3D animation of a pattern or pair, played by the widget.
Widget
The Passist component that plays the animation or draws a diagram. It reads a JIF.Passist.
Causal diagram
A strip of every throw in one round, each throw joined to the catch it forces. It repeats the round and scrolls by beat.
Ladder diagram
One rail per hand, with every throw drawn from the hand and beat it leaves to the beat it lands on.
Formation diagram
The Who throws to whom drawings: four views of the whole pattern, and each juggler's part alone.
Movement map
The plan view of a moving pattern's route, with a scrubber.
Scrubber
The slider that moves the movement map through the pattern's beats.

Names, difficulty and accounts

The contributed figures and names, and who may publish them.

Named pattern
A pattern with at least one published name. /named lists them grouped by the objects a self-pair holds.Browse the names.
Alias
A name attached to a pattern. A curated alias is published; a suggested one is pending until a curator approves it.
Pending / approved
A suggested name is pending until a curator approves it. Only approved names are public, and the proposer sees their own pending one.
Popular list
The names jugglers circulate, marked with a dot on /named and filtered by the page's box.
Name queue
The curator's list of pending suggestions on /review, where a name can be corrected before it is approved.
Curator
An account with PocketBase's admin flag. Curators approve names and publish saved mixes; the flag is granted only in PocketBase's dashboard.
Estimated difficulty
A 0–5 figure computed from a pattern's throws alone. It is not a vote and is never merged with one.
User difficulty
The mean of a pattern's 1–5 votes.
Rating
A signed-in user's 1–5 vote on a pattern.
Favourite
A star on a pattern. It is kept in the browser before sign-in and filed to the account afterwards.

The pages themselves are the other reference: a pattern's own page has its figures and notations, a pair's page has its starting positions, and Try reads any notation here.