Help pages for GroundForge

View project on GitHub

Getting Started

In the following tutorial, we will explore a versatile ground from the Whiting catalogue and illustrate some basic features of GroundForge.

First navigate to the Whiting catalogue (click on this link) and look at the grounds. By clicking on a photo in the catalogue, you will launch the associated page in Gertrude Whiting’s book A lace guide for makers and collectors which will give more information about the ground. The grounds are arrange in columns labelled A to H and rows labelled 1 to 18.

Clicking on the diagram link above a photo in the catalogue will launch the GroundForge tool, initialized with the details of the selected Whiting ground.

Open the diagram for ground G-2 (column G, row 2) in the Whiting catalogue.

Highlight a thread

For each lace ground, GroundForge displays two generated drawings: a pair diagram (based on the International Colour Code) and a thread diagram. Help pages, accessible by clicking on the info image above each diagram, provide more information.

In the thread diagram, each thread has a small square at the start and a bobbin at the end. You may need to scroll the diagram to see them. Click on a square or bobbin to change the color of the thread from black to red. Click on the square or bobbin of a red thread and it turns to green, next time to violet, and finally back to black. You can highlight more than one thread at a time. For more colours and options, visit thread properties.

Resize pattern

You can increase or decrease the size of the sample (also known as a “swatch”) generated in the pair and thread diagrams. Above the pair and thread diagrams, change the number of columns and rows for the swatch. Note: If you make the swatch very large, performance may slow down considerably. Read about restrictions to the swatch size for more details.

Every time you change the swatch size, you must regenerate the pair and thread diagrams by clicking on the wand image found near the top left of the Diagrams area.

Modify stitches

To change the stitches, go to the pattern diagram in the Edit pattern section. The pattern contains a vector drawing showing the order in which pairs of threads come together. There are multiple copies of the ground pattern in the prototype, showing how the pattern repeats. One copy is brightly coloured, the others appear faded. We will always work with the brightly coloured copy.

Where two pairs come together, there is a circle with a number or letter in its centre. Click once on any of these circles and a yellow box appears with the stitch definition. To change the stitch, type the new instructions while the yellow box is visible. Note: Do not try to click inside the yellow box to change the caret position. Use the arrows on the keyboard instead.

Every time you change the stitch definitions, you must regenerate the pair and thread diagrams by clicking on the wand image found near the top left of the Edit pattern area.

Exercise: Try to change the center of the spider from ctcctc to t. (Spoiler alert: The center of the spider is the black circle around the symbol 5, located in the top left corner of the prototype).

In addition to the usual c for cross and t for twist, you can twist only the right pair by typing r or type l to twist only the left pair. You can also “drop” a stitch. That is, when two pairs meet, do not braid them together at all. To drop a stitch, replace the stitch instructions with -. Be careful when dropping stitches. It can have unexpected consequences.

Exercise: Can you create the following variation? solution

Undo changes

To return the pattern to its original values, click on the ‘Reload’ button (also called ‘Refresh’) at the top of your browser.

Save and share changes

Once you have invested some time working on a lace ground, you will want to save your work. Click on the link image near the top left of the Edit pattern area. This will change the text in the address bar at the top of your browser. The text is a link to this website and contains the lace pattern as well as the stitch choices you have made.

Save the link text into a file for later use. Copy and paste the link text into the address bar of your browser to return to your current state or share it with other lacemakers.

Create a new ground pattern

The area labelled “Edit pattern” is used to create a new pattern. First, we map the pattern onto a grid. Symbols, comprising numbers or letters, are used to draw lines on the grid. This creates a vector diagram showing the order in which pairs of threads come together. From this description, the software generates a pair diagram and a thread diagram. A more detailed tutorial fully explains the many construction options available.

Add footsides

In addition to modelling a lace ground, GroundForge can also model a footside for it. Left and right footsides are defined separately and depend on the number of columns in the patch. For example, here is footside for Whiting G-2. There is a separate tutorial on how to create footsides.

Next steps