Help:Causal Generator

From PassingWiki.org

Jump to: navigation, search

Contents

Introduction

The Causal-Generator is a Mediawiki extension that allows generating Causal Diagrams via simple text representation. It is a graphical tool tailored for the visualizing passing patterns. The Causal-Generator actually has no knowledge of passing itself. This allows you to create patterns that may not make any sense when it comes to juggling. This page gives you a introduction of the supported features.

Embedding Causal-Diagrams in your Pages

The Causal-Generator plugin defines a new wiki-markup which can be used wherever you like on your pages. The following simple wiki-source may be used for embedding a causal-diagram on any wiki page:

{{#causal2:  
P S S P S S N
P S S P S S N
}}

The passingwiki will take that source and use it to render your causal-diagram:

causal2

Causal Diagram Description Syntax

Activity Nodes

The input syntax of the Causal-Generator is very easy. Each line of input represents a single juggler. With the very basic syntax all jugglers start with their right hand. Every node (the circles usually containing R/L) is described by at least one character that gives the generator information about the jugglers activity. Only a few possible activities for each node are allowed:

Hold

{{#causal2: 
H
}}
causal2

Single Self (S)

{{#causal2: 
S H
}}
causal2

Double Self (S2)

{{#causal2: 
S2 H H
}}
causal2

Triple Self (S3)

{{#causal2: 
S3 H H H
}}
causal2

4-Turn Self (S)

{{#causal2: 
S4 H H H H
}}
causal2

Joe Pass (P0)

{{#causal2: 
P0 H
 H H
}}
causal2

You may notice that the arrow is blue. This is because Causal-Generator highlights cross-passes in blue color. When looking at the nodes you see that they are shifted by half a beat. This is because the second line of the causal starts with a SPACE character (this is needed to demonstrate the joe-pass).

Single Pass (P)

{{#causal2: 
P H
H H
}}
causal2

Double Pass (P2)

{{#causal2: 
P2 H H
H H H
}}
causal2

Triple Pass (P3)

{{#causal2: 
P3 H H H
H H H H
}}
causal2

4-turn Pass (P4)

{{#causal2: 
P4 H H H H
H H H H H
}}
causal2

Zip (Z)

{{#causal2: 
H Z
}}
causal2

Empty hands 2 beats (Z2)

{{#causal2: 
H H Z2
}}
causal2

Empty hands 3 beats (Z3)

{{#causal2: 
H H H Z3
}}
causal2

Empty hands 4 beats (Z4)

{{#causal2: 
H H H H Z4
}}
causal2

None (N)

{{#causal2: 
S N
}}
causal2

Do not draw the node. Even though the node is needed (in this case because it is the target of the self thrown a beat before).

Node Character

Usually the character written in the nodes are R or L denoting the hand which receives an object which causes the throw. Sometimes you may need have some control over the character written within the node. You may easily do this by prepending the character you want followed by a '.' and the actual action. For example L.P results in a node that has an 'L' written in it and an outgoing single pass.

{{#causal2: 
R.P R.S L.P L.S N
R.P R.S L.P L.S N
}}
causal2

You may notice that some of the nodes are yellow. This is because Causal-Generator highlights hurries as yellow nodes.

Pass Destinations

Having only two jugglers makes it pretty easy to guess, that every pass simple goes to the opposite juggler. With more jugglers you must give Causal-Generator some hints where the pass should go. You may do this by appending a @-character followed by the jugglers number to the activity character.

{{#causal2: 
P S S P S S N
P@1 P@3 S P@1 P@3 S N
S P S S P S N
}}
causal2

However Causal-Generator comes with some defaults. This is why we don't need the @ directive in this case for juggler 1 and 3 (as long as they only pass to juggler 2 - this is default for 3 jugglers). For more then three jugglers the default is that every juggler passes to juggler one (as long as not changed by the @ directive).

Asynchronous Jugglers

Sometimes you need jugglers to throw half a beat asynchronous. If you want a juggler to start half a beat later, just start the jugglers line with a SPACE character.

{{#causal2: 
S2 P S S2 P S N N
 S S2 P S S2 P N
}}
causal2

Different Timings of Jugglers

Other patterns require an entire different timing for both passers. Timing in terms of beats may be specified by prepending the offset to the last node.

{{#causal2: 
0.166/P S S S P S S S P S N
P 1.33/S 1.33/S 1.33/P 1.33/S 1.33/S 1.33/P 1.33/N 
}}
causal2

This also allows you to specify random timings like that of 7-clubs 2-count on singles or other a-rhytmic patterns.

{{#causal2: 
P 0.5/S P 0.5/S P 0.5/S N 0.5/N
0.75/P 0.5/S P 0.5/S P 0.5/N
}}
causal2

When you start manipulating the timing the Causal-Generator may be unable to determine the destination node of passes. Sometimes this may result in problems drawing specific diagrams. An optional offset parameter may allow you to manipulate the destination of your pass. This overrides the automatic search of possible destination nodes depending on the type of pass.

{{#causal2: 
P@2+0 S P@2+1 S P@2+2 S P@2+3.1 S S H
H H H H H H H H H H
}}
causal2

Synchronous Bi-Handed Throws

You may want to specify a pattern where a juggler throws with both hands at the same time. Synchronous throws of a single juggler can be specified by chaining them together using the '-' character. Things start to get a bit more complex at this point because Causal-Generator does not know to which of the synchronous nodes your pass should go. This is the reason why you have to specify the destination with P@2.2 . This means that the pass goes to the second juggler to the second sub-node (from top).

{{#causal2: 
P-P@2.2 N P-P@2.2
N L.P-R.P@1.2 N N-N
}}
causal2

Multiplex Throws from a single Hand

For some reason you want to draw more than one arrow from one hand to different destinations. Well it is possible at least Causal-Generator supports it. You simple add more destinations separated by ','. You may specify a self and a pass at the same time by S,P

{{#causal2: 
S,P H
H H
}}
causal2

Vertical Separators

For visualizing cycles it is possible to draw vertical lines into your causal diagram. Dotted and solid lines are supported. A line may be drawn between two nodes ...

{{#causal2: 
S ; S ! H
}}
causal2

... or through the nodes ...

{{#causal2: 
S ;S !H
}}
causal2

The control characters used are ';' for dotted lines or '!' for solid lines. This character must be between two nodes (separated by spaces) or after the optional timing parameter:

{{#causal2: 
S ; S ;S 1.5/;R.S 1.5/;S ;R.S H
}}
causal2

Formation Diagrams

Formation Diagrams are useful to show how the jugglers are located to each other. To enable the formation diagram the parameter

?formation

must be passed to the Causal Generator. For example

{{#causal2: 
H
H
H
?formation=circle
?nocausal
}}
formation2

The option ?nocausal that was given in this example hides the causal diagram that is generated by default. There are a few predefined values for the formation parameter, but you may also define the location of the jugglers using coordinates.

Type: circle

Arrange the jugglers in along the edge of a circle

formation2

In case the order shall be different from the predefined one, use the additional ?formation_order=1,3,2 parameter. This works with all of the predefied formations.

formation2

Type: feed

One juggler

formation2

Type: wfeed

formation2

Type: box

formation2

Type: <empty>

The location of the jugglers must be given seperately. You prepend x,y,rotation# to for each juggler:

{{#causal2: 
1,1,45#H
2,2,225#H
?formation
?nocausal
}}
formation2
Personal tools