> For the complete documentation index, see [llms.txt](https://docs.tempoweave.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.tempoweave.com/help-by-menu-tabs/tools-menu/fabric-analysis-mode.md).

# Fabric Analysis Mode

*Desktop only. Requires the Pro tier.*

### What It Does

Fabric Analysis lets you work backwards. Instead of building a draft from threading, treadling and tie-up, you draw the cloth itself on the drawdown, one cell at a time, and TempoWeave works out a threading, treadling and tie-up (or liftplan) that weaves it.

Use it when you have a piece of cloth in hand, or a clear photo of one, and want a draft that reproduces it.

***

### Starting

* **Ribbon:** Tools tab ▸ Fabric Analysis
* **Mac menu:** Tools ▸ Fabric Analysis Mode

A green banner appears above the draft. It tells you you're drawing, shows what your drawing needs so far, and has the buttons to finish (**Done**) or leave without changes (**Cancel**).

On a blank or small draft, you get an empty 40-end by 40-pick grid to draw on. To make the grid bigger, right-click a cell where it should end.

You can also start on an existing draft. Its cloth is already drawn, so you can change a few cells and see what the change costs in shafts and treadles. Shaft and treadle numbers stay as they were wherever your drawing still agrees with the draft. Only threads and picks you changed get new numbers.

***

### Drawing

* **Click** a cell to fill it: the warp is on top there. Filled cells are black.
* **Right-click** (or Control-click) a cell to empty it: the weft is on top. Empty cells are white.
* Drag to fill or empty a run of cells.

While Fabric Analysis is on, the grid is black and white whatever your thread colors are, so you see only the structure.

Mark **which thread is on top**, not which color you see. In a color-and-weave cloth, such as log cabin, the colors can make a pattern that isn't in the structure.

The threading, treadling and tie-up update as you draw. While a repeat is only half drawn, they can show more shafts than the finished cloth needs; that settles once the repeat is complete.

If you work in **Back View**, you're drawing the back of the cloth: a filled cell means the warp is on top as seen from the back. In Swedish-style drafts, a filled cell follows the Swedish convention, as everywhere else in TempoWeave.

#### What the banner tells you

* **Needs 4 shafts and 6 treadles** (or **Needs 8 shafts (liftplan)**): what your drawing needs right now.
* **Your draft had 8 shafts** / **8 treadles**: shown in amber when the drawing needs more than the draft you started from, which is usually what your loom has.
* **Threads that never rise, left unthreaded**: a thread that is never on top anywhere in the drawing doesn't need a shaft, so it's left unthreaded instead of getting a shaft that never lifts.
* **Cells that look like slips**: see Check for Slips below.

#### Tie-up or liftplan

The drop-down in the banner chooses the result:

* **Tie-up and treadling**: every different pick becomes a treadle. Best for floor looms.
* **Liftplan**: each pick lifts its own shafts, so there are no treadles to run out of. Best for dobby, table and computer-assisted looms, and for photos of busy cloth.

A liftplan draft starts on Liftplan. If the picks need more treadles than TempoWeave allows, the result is a liftplan automatically.

***

### Drawing faster: Repeat to Fill

Most cloth is one small repeat over and over. Draw a single repeat, starting at thread 1 and pick 1, then click **Repeat to Fill**. TempoWeave copies it across the whole grid.

Repeat to Fill repeats the block your filled cells cover, from thread 1 and pick 1 to the furthest cell you filled. To fill a bigger area, first make the grid bigger by right-clicking where it should end.

**Clear Grid** empties every cell, if you'd like to start again. You can undo it.

***

### Check for Slips

Every different thread pattern needs its own shaft, and every different pick needs its own treadle. One wrong cell in a long thread gives that thread a shaft of its own.

**Check for Slips** looks for cells like that: a thread or pick that would match others if one cell were changed. They're outlined in orange. Right-click or click the cell to change it, or leave it if it's meant to be that way.

***

### Finishing

Click **Done** in the banner, or the Fabric Analysis button again.

1. If any cells look like slips, TempoWeave shows them and offers **Fix Them** (change each one to match), **Keep as Drawn**, or **Go Back** to keep drawing.
2. If the drawing needs more shafts or treadles than the draft you started from, it says so. If it's the treadles, you can switch to a liftplan. You can also **Finish Anyway** or **Go Back**.
3. The draft is trimmed to the area you drew, and the threading, treadling and tie-up (or liftplan) stay as shown.

**Cancel** leaves Fabric Analysis and puts the draft back exactly as it was when you started. Undo brings back your drawing if you change your mind.

#### Undo

While drawing, Undo (Ctrl+Z / ⌘Z) takes back one stroke at a time. Repeat to Fill, Clear Grid, Fix Them and switching between tie-up and liftplan are each one step too.

***

### Step by Step: Analyzing a Twill Sample

1. Open a new, blank draft.
2. Choose **Tools ▸ Fabric Analysis**.
3. Look closely at the cloth (a magnifier or pick glass helps). Starting at a corner, fill each cell where the warp is on top for one repeat. For a 2/2 twill, that's a 4 by 4 block.
4. Click **Repeat to Fill**.
5. The banner reads *Needs 4 shafts and 4 treadles*, and the threading shows a straight draw.
6. Click **Done**.

### Step by Step: Working From a Photo

1. Count one repeat in the photo, in threads and picks.
2. Start Fabric Analysis on a blank draft and draw that repeat.
3. Click **Check for Slips**. Fix any cell you misread.
4. Click **Repeat to Fill**, then **Done**.
5. If the result needs more shafts than your loom has, try **Shaft Reducer**, or simplify the drawing.

***

### Fabric Analysis or Drawing on the Drawdown?

Outside Fabric Analysis, clicking the drawdown with a drawing tool changes the **tie-up** (or liftplan) for that cell. The threading and treadling stay as they are, and every cell woven by the same shaft and treadle changes with it.

Fabric Analysis is the other way round: you draw any cloth you like, cell by cell, and TempoWeave builds a new threading and treadling to match. Use it when you're starting from cloth, not from a draft.

***

### Tips

* **Draw one full repeat.** Half a repeat gives more shafts than the cloth needs.
* **Fewer different threads means fewer shafts.** Twenty threads with only four different patterns make a 4-shaft draft.
* **For a picture or a design you drew elsewhere**, Image Center turns an image into a grid you can paste onto the drawdown. TempoWeave then works out the threading the same way.

***

### Quick Reference

| Action                          | How                                             |
| ------------------------------- | ----------------------------------------------- |
| Start                           | Tools tab ▸ Fabric Analysis                     |
| Warp on top                     | Click (fills the cell)                          |
| Weft on top                     | Right-click or Control-click (empties the cell) |
| Make the grid bigger            | Right-click where it should end                 |
| Copy one repeat across the grid | Repeat to Fill                                  |
| Find likely mistakes            | Check for Slips                                 |
| Tie-up or liftplan              | Drop-down in the banner                         |
| Finish                          | Done (or the Fabric Analysis button)            |
| Leave without changes           | Cancel                                          |
