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, thenA,BandCfor 10, 11 and 12. Reading the same code from a different starting point is the same pattern;333is 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
hsyncit 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
2crosses to the other hand and a4comes back to the same one. - Zero / empty hand
- A
0: no throw on that beat. The bulk table has no height1, 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 saysholds: 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,063and630are 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 togetherbutton.Search for a pattern. - Fits
- How many starting positions of a pair work: the number of slides that close. A partner list has a
Fitscolumn 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 labelledPropsand 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
Xor||. - 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). TheHow to startblock 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.
asyncis one juggler per beat;semisyncis each juggler's two hands on adjacent beats;jsyncis every juggler on every beat with hands alternating;hsyncis 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
RRRorRLR. It depends on the pattern, so/trylets 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./tryreads 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 | Bform, such as4p3 | 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.
/tryreads 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 3or 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
pmarks 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 areHand,Zap,Single,Double,Triple,Quad. - Pass marker
Xfor 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 as6h-jsync.4h-asyncis 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,3v1orw. - 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-selfandPause. - 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
Slidescolumn, 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 whomdrawings: 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.
/namedlists 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
/namedand 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.