Configuring Weaving Projects in TempoWeave
YAML--- name: configuring-weaving-projects-in-tempoweave description: Guides setup and planning of weaving projects in TempoWeave's Project Information dialog, covering loom setup, yarn/warp calculations, color breakdowns, heddle counts, and project documentation. Use when a user is setting up a new weaving draft, calculating yarn or warp requirements, troubleshooting sett/EPI/PPI values, planning target finished dimensions, or preparing a Weaver's Writeup in TempoWeave. ---
To set up a new project from scratch, open Project tab > Project Info and work through tabs in this order:
- Setup — set Shafts, Treadles, Sett (EPI), Beat (PPI), and reed/raddle info
- Planning — enter Planned Warp Length, Calculation Drivers, click Calculate Yarn
- Project Notes — add Title, Author, Tags
- Heddle Count — verify each shaft has enough heddles before threading
- Color Information — confirm yardage per color (requires Planning tab calculated first)
- Cloth Construction — only relevant after using Double Cloth feature
- Weaver's Writeup — click Generate Template, fill in, export
Progress:
- Step 1: Confirm shaft/treadle counts match the physical loom
- Step 2: Set floating selvedge options if the structure needs them
- Step 3: Enter reed and raddle dent/sley info (or use Reed/Raddle Calculator)
- Step 4: Set Sett (EPI) and Beat (PPI) — these drive all downstream math
- Step 5: On Planning tab, decide: forward calculation (have a draft, want yardage) or backward calculation (have a target size, want loom settings)
- Step 6: Enter Calculation Drivers (draw-in, take-up %, loom waste, shrinkage %)
- Step 7: Enter Length Drivers (fringe, sampling, pieces)
- Step 8: Click Calculate Yarn / Recalculate
- Step 9: Check Heddle Count tab before physically threading the loom
- Step 10: Check Color Information tab for yardage-per-color (will show dashes until Planning is calculated)
- Step 11: Fill Project Notes (title, tags) for later searchability
- Step 12: Generate and complete the Weaver's Writeup when project is ready to document
Key calculation chains:
- Width in Reed = Warp Ends ÷ Sett (EPI)
- Woven Length = Weft Picks ÷ Beat (PPI)
- Finished Width = Width in Reed − Draw-in, then reduced by Shrinkage Width %
- Finished Length = Woven Length reduced by Shrinkage Length %
- Min Warp Length = (Woven Length × (1 + Warp Take-Up%) × Pieces) + Fringe + Sampling + Loom Waste
- Target-size (backward) flow: Finished Width/Length → Req Width in Reed → Required Warp Ends (× Sett) → Required Weft Picks (× Beat)
Example 1: Forward calculation (draft exists, need yarn amount) Input: Draft has 240 warp ends, sett at 20 EPI, 480 weft picks, beat at 18 PPI. Planning for 1 piece, no fringe, no sampling, loom waste 24", warp take-up 8%, weft take-up 8%. Output:
- Width in Reed = 240 ÷ 20 = 12"
- Woven Length = 480 ÷ 18 = 26.7"
- Min Warp Length ≈ 26.7" × 1.08 + 24" ≈ 52.8" → round up and enter Planned Warp Length (e.g., 54")
- Click Calculate Yarn → warp/weft yardage populate from Planned Warp Length, sett, and take-up
Example 2: Backward calculation (target finished size known) Input: Want a finished scarf 8" wide × 60" long after 10% width shrinkage and 1" draw-in, sett 20 EPI, beat 18 PPI. Output:
- Req Width in Reed = (8" ÷ 0.90) + 1" ≈ 9.9"
- Required Warp Ends = 9.9 × 20 ≈ 198 ends
- Woven Length per Piece = 60" ÷ (1 − length shrinkage %)
- Required Weft Picks = Woven Length per Piece × 18
Example 3: Color yardage troubleshooting Input: Color Information tab shows dashes in Warp Yds/Weft Yds/Total Yds columns. Output: Go to Planning tab, enter Planned Warp Length (and Override Width/Length if needed), click Calculate Yarn, return to Color Information — yardage now populates proportionally by thread count percentage.
- Always set Sett and Beat before doing any Planning tab work — everything downstream depends on them.
- Use Override Width / Override Woven Length on the Planning tab when the actual plan differs from what's literally in the draft (e.g., weaving many more repeats than shown).
- Enter take-up and shrinkage percentages based on the specific structure (waffle weave needs much higher take-up than plain weave) rather than leaving defaults.
- Check Heddle Count before threading, not after — catching an uneven/insufficient heddle distribution early saves rework.
- Add Tags consistently (use autocomplete suggestions) so projects are searchable later by fiber, structure, or purpose.
- When planning multiple pieces from one warp, use the Pieces field rather than manually multiplying woven length yourself — it keeps Total Woven and yarn calculations consistent.
- For double cloth, only set Cloth Construction tab values after running the Double Cloth conversion — this tab documents, it doesn't create, the structure.
- Forgetting to click Calculate Yarn after changing Planning tab values — the yardage fields won't auto-update to reflect new drivers.
- Confusing Reed vs. Raddle sections — Reed determines actual EPI/sett; Raddle is just for spreading warp evenly during beaming and has wider spacing.
- Leaving Draw-In and Shrinkage at 0 — this makes "Finished" dimensions equal to loom dimensions, which is rarely accurate.
- Setting Multi-Treadle off when a draft actually needs double-treadle presses — treadling combinations will be clamped/invalid.
- Reducing Shaft or Treadle count without checking existing threading/treadling — references above the new max get reassigned or clamped, potentially altering the draft unintentionally.
- Not entering Planned Warp Length before checking Color Information — yardage columns will just show dashes with no indication of why until you look for the warning message.