Weave Calculator 1.1 for Windows Phone 8.1 or later knows how to do all of the everyday calculations that a weaver needs to do when planning out a product. In particular, it can:

• Calculate how much yardage a project will take if you know the size on the loom.
• Calculate the finished size of a project if you know the size on the loom and your expected shrinkage.
• Calculate how long you can make a project if you know the width, sett (ends and picks per inch or centimeter), loom waste, and available yards or meters of yarn.
• Convert between inches, feet, yards, centimeters, and meters.

In addition, Weave Calculator can save and reload the calculations for a project. You can start sketching out a project while waiting for a bus, save your work when the bus arrives, start sketching out a second project over your lunch hour, save that, and on your next free day, go to the yarn store, reload one project, get the needed yarn, reload a second project, find yarn for it, take your purchases home, and whip our your phone and reload again when you are ready to measure your warp.

Note: The images in this document were captured on a phone set to the blue theme. Where you see blue in the document, on your phone you will see your theme's accent color.

Weave Calculator 1.1 is a free application. It does not display ads.

Weave Calculator 1.1 runs on Windows Phone 8.1 and later versions of Windows Phone supporting backward compatibility with Windows Phone 8.1.

General Usage Instructions

Weave Calculator Windows 1.1 is a standard Metro style application. The top of the screen has a banner identifying the product (Weave Calculator), the CD-spooling-out-yarn Canitag logo identifying it as one of my yarn/fiber related applications, and the page name or mode. For all pages except the main, the page name area holds the name of the page.

The main page is a different from the others. The main page is a Metro pivot page. The large text in the page name area at the top reports which of the input/output panes (pivots) is active:

• sett - your project's sett in ends and picks per inch (or centimeter)
• width - the on-the-loom (pre-shrinkage) and finished, off-the-loom (post-shrinkage) width of your project
• length - the length woven as measured on the loom, the finished (post-shrinkage) length of woven fabric, and total length used when measuring off your warp
• threads - the number of ends of warp and picks of weft in your project
• shrinkage - your estimate of how much shrinkage to expect
• other - extras that add to the length of warp needed, specifically, your loom waste and total allowance for fringe
• yardage - the number of yards (or meters) of yarn your project will require for warp, weft, and in total

Each of the seven input/output panes has a table identifying a quantity, for example, the ends per inch (or centimeter). The line for each quantity has a label, a checkbox, and a box that is either empty or gives the value. If the checkbox is checked, you are expected to supply a value. Weave Calculator will not attempt to calculate a value unless you uncheck the checkbox. If the checkbox is unchecked, Weave Calculator will calculate the value if sufficient information is available. The box to be filled in with the quantity is shaded in light gray when Weave Calculator is expecting you to supply the value. The box will have a background matching your phone's theme's background color (that is, white or black) and an outline in your theme's accent color if Weave Calculator believes it should calculate the value.

For example, when you first start Weave Calculator, you'll be shown the sett pane. Both ends per inch (or centimeter) and picks per inch (or centimeter) will be checked because typically weavers have an idea of what sett is likely to yield a fabric of the desired drape. The default for Weave Calculator is to mark these as inputs from the weaver. The image that follows shows what the ends per inch value looks like when you're expected to supply the value and the picks per inch value looks like when Weave Calculator is supplying the value.

By default, Weave Calculator assumes you'll want it to compute the number of ends (warp threads) and picks (weft threads) based on information such as the target width, target length, and sett. You can uncheck both ends and picks per inch on the sett pane and use the threads pane to fill in these counts if you prefer.

If you swipe right to left along the pane name area, you will see the width pane. The ordering of panes is based on the anticipation that most weavers will want to enter sett, width, and length. If you've just reloaded an old project, you can swipe left to right to see the yardage pane instead. The image that follows shows what the width pane looks like when you are expected to enter the width on the loom and Weave Calculator is supposed to compute the finished width.

Weave Calculator lets you check and uncheck items based on what you know and what you'd like Weave Calculator to compute. If you happen to know your sett, how many yards of yarn you have available, how wide your loom is, and want to know how long a piece of fabric you could weave, check those items to make them inputs, uncheck the length values, and let Weave Calculator do the rest.

You can also swipe left to right to navigate in the reverse order. You can tap on the one word title of a pane if it is in view to jump directly to the pane.

Pages that contain material that might flow beyond the end of the screen can be scrolled. Weave Calculator shows a faded arrow on the righthand edge of areas containing scrollable content even if all of the content happens to fit on screen. You can swipe or drag in the direction of the arrow to get the content to scroll.

Every page (screen) has an application bar. If you are holding the phone narrow end up, application bar will be found at the bottom of the page. If you hold your phone wide side up, the application bar will be found on either the right or left edge of the phone. The application bar always has at least an ellipsis (...). Some pages also have icons in the application bar. If you tap on the ellipsis, the application bar will grow to show you the labels for the icons and any additional commands that are anticipated to be used less often. Tapping on an icon or one of the additional commands will carry out some action applicable to the page.

The main page has an application bar with four icons and four additional commands.

The icons are:

	Settings - go to a page that lets you change the settings
	Save & Load - go to a page that lets you save and re-load values typed into the main page
	Feedback - go to a page that gives easy access to ways to provide feedback about this product
	Help - go to a page giving basic instructions and a link to this documentation.

The additional menu choices that are usually off-screen on the main page are:

• Privacy Page - sends you to a page with a summary of the privacy policy and links to more information on this website
• Clear Project - discards any unsaved project data and starts a new empty project
• Show Unsent Bug Reports - sends you to a page listing all pending bug reports (i.e. those created in the last 30 days that you haven't deleted yet)
• Create Bug Report -- sends you to a page enabling you to create a bug report

The two bug reporting options are also present in all of the other non-bug-reporting pages.

Weave Calculator makes a number of default assumptions. It assumes you want to work with sett values given as threads per inch, with lengths and widths in inches, and with the total amount of warp and weft yarn measured in yards. Weave Calculator defaults to a 25 inches of loom waste and 15% shrinkage. You can change any of these defaults by use of the settings page. To get to the settings page, select the gear shaped icon in the application bar:

The settings icon sends you to the settings page.

The settings page has two sections. The first section lets you indicate your preference for working in inches or centimeters. You'll find a line listing different units for length (e.g. inch or centimeter). Tap on the unit you want to use when describing the width and length of your project. The selected unit will be shown in your accent color instead of your usual text color. For example, if you want to say that your project is 2.5 feet width by 8 feet long, select foot. When you ask for measurements in inches, feet, or yards, Weave Calculator will use sett values that are per inch and yarn usage in yards. When you ask for measurements in centimeters or meters, Weave Calculator will use sett values that are per centimeter and yarn usage in meters.

You can switch units at any point. If you have already typed in some of the values for your project, Weave Calculator will convert their values from the old unit to the newly selected unit.

The second section let you supply defaults for the kinds of projects you typically weave. You can replace the default 25 inches of loom waste and 15% shrinkage with values typical of your (primary) loom and type of yarn. If you change these values, the new defaults will go into effect the next time you clear out project information (something you can do from the main page) or you enter Weave Calculator afresh. Changing the values won't tamper with what is on your main page right now.

Weave Calculator 1.1 no longer provides a third section allowing you to opt out of advertisements and diagnostics. Weave Calculator 1.1 does not display advertisements ever. Diagnostic information is only sent when you explicitly grant permission. You can see and edit the emails containing diagnostic data to ensure that information you consider private is not sent. However, the more you edit out, the more likely that the misbehavior affecting you will not be diagnosed or fixed.

Calculating Information About Your Project

Weave Calculator calculates as many of the statistics you have marked as outputs as it can, given which values marked as inputs have been filled in. Weave Calculator starts up showing the pane (pivot) prompting you to supply how many ends and picks per inch (or centimeter) you want to use. Fill in values that will yield the desired drape of fabric based on what you know of the yarn you plan to use, your experience, and any sampling you've done.

If you have not already configured Weave Calculator to use the units you want (inches or centimeters), follow the instructions in the section on configuring Weave Calculator. Then come back to the sett pivot of the main page.

Enter your ends and picks per inch (or centimeter) into the text boxes. You can use integers and decimal numbers. You can't use fractions such as 4 1/3. The input areas are normal Metro text inputs. If you don't have a keyboard or have not slid it out, the page will slide up to make room for a numeric input keypad below the text input.

If you are doing a balanced weave (same number of threads per inch or centimeter for both warp and weft), you can uncheck either the ends or picks checkbox. Weave Calculator will fall back to assuming you want a balanced weave (if the ends/picks per inch/centimeter value is not forced by other constraints).

Now swipe along the line with pane names to bring each of the other panes (pivots) into view. If you see a value checked and you don't want to supply a value, uncheck it. If you see a value that you want to enter and it isn't already checked, tap the checkbox to check it.

The pane to the right of sett is the width pane. By default, the width pane will prompt you for the width of your project on the loom and (once enough is known) will report back the finished width. If you have a particular finished width in mind, uncheck the box for the width on the loom, check the box for the finished width, and enter the value.

Many weavers have a particular project size in mind and so will fill out one of the two widths. However, if you happen to have a limited amount of some special yarn you want to use and you want to make as big a project as you can, go ahead and uncheck both boxes. Check the boxes in the yardage pane and enter how much of your special yarn you have available.

Continue on one more pane to the right and you'll reach the length pane. By default, the length pane will prompt you for the length you plan to weave on the loom. Weave Calculator is perfectly capable of computing the total length of your warp threads by adding in your allowance for loom waste and fringe.

The length pane will normally report back on the total length of the warp threads and the finished size of the woven portion of the project. You can check and uncheck boxes if you would rather supply the finished woven length or warp thread length. You can uncheck all of the boxes if you know how many yards (or meters) of warp yarn you have and how many picks per inch you'll be weaving.

Continue on to the right and you'll encounter the threads pane. Weave Calculator 1.1 assumes that the number of warp and weft threads is something you'll want it to calculate.

The pane to the right of threads is shrinkage. The shrinkage is normally an input, but its value is initially set to a default. You can change the default for future calculations via the settings page. Weave Calculator starts off with a common value for how much both warp and weft will shrink when you take your weaving off the loom. If you know something about how you will weave or about your warp and weft yarns that make you expect that the warp and weft will behave differently, uncheck the common shrinkage checkbox and check the individual warp and weft checkboxes. Fill in your estimates.

Shrinkage values are percentages. You can enter a number between 0 and 100, for example, 12. You can use a decimal point in your number, for example, 8.3. You can put or leave a percent sign after your number, for example, 12.2%. Keep in mind that, even if you omit the percent sign and enter a number less than 1.0, Weave Calculator will interpret the value as a percentage. The value 0.25 is interpreted as 0.25 % (one part in 400), not as 25% (one part in four).

To the right of the shrinkage pane, you will find the other pane. This pane is dedicated to the other factors that determine the length of the warp threads. You'll find a line specifying the loom waste here. The loom waste is an input that is automatically filled in with a default value. You can use the settings page to change the default for future projects.

Edit the loom waste value to match what is typical of the loom you plan to use for this project. If you plan on fringe, enter the total length of warp you want to leave unwoven for fringe. Do not count the length of fringe that will come out of what would otherwise be your loom waste. By default, Weave Calculator will assume you do not want any fringe (or other unwoven portions of warp).

The final pane, the yardage pane, is to the right of the other pane. The yardage pane supplies information about how many yards (or meters) of yarn you will need for warp and weft for your project. You can check these fields and supply them as inputs if you have a fixed amount of yarn. Be sure to uncheck the length if your project's length is limited by available warp yarn. Be sure to uncheck the width if your project's width is limited by available weft yarn.

The panes on the main page wrap around. If you continue to the right from the yardage pane, you'll find yourself back at the sett pane.

Hints

Weave Calculator computes as much as it can the moment you finish entering a value. When have you finished entering a value? If you aren't using a physical keyboard, then you've finished when the onscreen numeric keypad goes away. You can tap outside of a text box to dismiss the keypad. Tapping outside of a text box also tells the phone you're done changing a value when using a physical keyboard.

If Weave Calculator is leaving a value blank and you think you've provided enough information for its value to be computed, check:

• Is the checkbox checked? If so, Weave Calculator thinks you want to supply a value. Uncheck the checkbox.
• Look around the other panes. Are there checked checkboxes that are empty? If you don't want to supply a value for them, uncheck them. Sometimes Weave Calculator has to be given permission to compute one value as a stepping stone en route to computing the value you really care about.

Weave Calculator uses shrinkage values to convert between finished and on-the-loom sizes. Expect to supply two out of three:

• width on the loom -- weft shrinkage -- finished width
• woven length on the loom -- warp shrinkage -- finished length

Sett, threads, and size form another triad. Typically, you supply the sett and size and Weave Calculator computes the thread count. You can, however, switch to supplying a different two-out-of-three:

• width -- ends per inch/centimeter -- ends
• woven length -- picks per inch/centimeter -- picks (aka throws)

The yardage for your warp and weft yarns are normally computed based on the number of ends and picks plus the width and total length (not just woven length) of your project. The warp yardage is computed from the combination of number of ends and the total length. The weft yardage is computed from the number of picks and the width of the project. Weave Calculator is perfectly capable, however, of computing any one of either triad given the other two:

• ends -- total length -- warp yardage
• picks -- width -- weft yardage

Total yardage is normally computed by adding up the warp and weft yardage. You can, however, use the total yardage as an input and let Weave Calculator compute other values based on the limit imposed by the available yarn. Some combinations that work:

• ends per inch + picks per inch + total yardage + width
• ends per inch + picks per inch + total yardage + woven length + fringe + loom waste

One thing that Weave Calculator 1.1 does not do is warn you when you've specified an incompatible set of inputs. For example, if you specify that your project uses a sett of 12 ends per inch and 12 picks per inch, has a shrinkage of 18%, a finished width of 48 inches, a finished length of 5 yards, and uses 1 yard of yarn, Weave Calculator will not warn you that 1 yard of yarn is insufficient. So don't supply values unless you're sure they are feasible when combined with all of the other values you are providing.

Weave Calculator lets you save your work and read it back at a later. In Weave Calculator 1.0, saving and restoring projects only worked if you opted in to advertising. Weave Calculator 1.1 has no advertising so save and restore functionality always works.

To save or restore, click on the Save icon on the application bar:

This will send you to the Saved Data page.

This page has four icons on its application bar.

	Add - create a new entry in the list of saved projects
	Save - overwrites the selected saved project with the current data
	Sync - syncs the main page of Weave Calculator to show the data loaded from the selected save
	Delete - deletes the selected saved project

To save your data for a new project, click on the add icon to create an entry for your project. A dialog like the one shown below will pop up. Enter some text to identify the project whose calculations you are saving, then click the Create button. After you click the create button, you'll see a new entry in the list of previously saved data projects.

Weave Calculator keeps the following information when its saves data:

• which values are marked as inputs (items you will supply)
• the values you supplied for the inputs
• the most recent calculated values

You can come back at any time to the save project page and reload the data from a previous save. The data is kept until you use the save project page to delete it (or until you wipe all data on your phone). The list of your saves is shown in main portion of the saved data page. To load or delete a save, first tap it to select it. The text of the item you select will turn into your accent color.

If you click the Sync icon, the data will be loaded into the main page and you will be automatically sent back to the main page. If you click the Delete button, you'll be given a chance to confirm that you do want to delete the save. If you confirm, the data will be deleted.

To update data for an existing project, first use the save project page to sync to the previously saved data for your project (i.e. click on the Sync icon). Use the main page of Weave Calculator to make the changes you desire. Then go back to the save project page. You'll see that the entry for your current project is shown in the theme color instead of the usual text color. That means that your current project has already been selected. So you can just click on the Save icon.

You can overwrite the data for any save by first tapping on the memo for that project then clicking on the save icon.

Weave Calculator version 1.1 supports creating bug reports that you can either manually send in or delete. If Weave Calculator crashes, it will automatically attempt to log a bug report for the crash on your phone but will not automatically upload it anywhere. In addition, Weave Calculator version 1.1 provides a page that enables you to create a bug report whenever you choose. Please use the create bug report feature only to report once on each feature that confuses you or that you feel is not working properly.

Weave Calculator 1.1 logs your most recent actions in memory. When you exit Weave Calculator, this log goes away. When a bug report is created, the log of recent actions along with information about your phone's manufacturer and model plus all software versions is added to the bug report. This information is intended to help me figure out the conditions under which the bug happens. I promise that I'll only use it for the purpose of figuring out how to fix bugs in Weave Calculator and improve the experience of its users. Weave Calculator does not save data about your activity except in bug reports on your phone. Weave Calculator only sends bug reports off your phone when you tell it to send a bug report.

Bug reports are delivered to me via email, by handing over the entire bug report to Microsoft code that hands the email to (one of) your email program(s). You can see the whole bug report and edit out any details that you consider private before you tell your email program to send the bug report. You can always decide that you don't want to send the bug report after you read its content.

Suggestion: if you replace information that you consider private with some word like PRIVATE, you will be giving me information about what kind of data my users find sensitive. I'll think hard about not collecting such data for bug reports in future versions of the application.

If you tap on the ellipsis (...) in the application bar of any page, you'll see at least the following two menu choices:

• Show Unsent Bug Reports - a page that shows a list of automatically or manually created bug reports
• Create Bug Report - a page that lets you manually create a bug report

When you click on the menu choice Create Bug Report, you'll be sent to a page prompting for two pieces of information.

The first field is a short description of the bug. It will appear in the listing of bug reports logged on your phone and in the subject of the email reporting the bug to me (if you choose to send such an email). Don't try to describe everything that went wrong. Just give enough to give me a general idea of the kind of problem. Don't bother filing bugs that fail to describe what you experienced that seemed wrong. Complaints like It didn't work are not useful. What is it? What did you see that you wouldn't have seen if it had worked? What did you fail to see that you would've seen if it had worked?

The second field is for a longer description of what you find confusing or think is incorrect behavior. It is helpful if you also add what you remember doing that led to the bug. The purpose of this is to tell me what to do to get the bug to happen on my phone. Anything you remember doing that was different from what you've done in the past without trouble is extra helpful. Weave Calculator supplements the details you remember with details it holds in memory (not storage) so please don't get stressed out with worry that you might forget something.

When you have filled in the two fields, click on one of the three icons in the application bar.

	Upload - hand off the bug report to your email program right now
	Save - save the bug report on your phone now and email it later
	Delete - discard any data you've entered without saving a bug report

If you decide you don't want to create a bug report now, click the Delete icon. If you want to create the bug report but don't feel like sending out an email now, click the Save icon. If you want to create the bug report and send an email now, click the Upload icon. If you click the Upload icon, the bug report is also saved on your phone. After sending your email, Windows Phone will return you to the Report Bug page. You'll be asked whether you want to delete the bug report or leave it around. If you successfully sent the bug report email, I recommend deleting the bug report so that you aren't confused later about whether you sent it and aren't nagged about pending bug reports.

The Show Unsent Bug Reports sends you to a page listing all bug reports that you haven't deleted and that haven't expired after 30 days. Note that if you have uploaded a bug report via email but chosen not to delete the bug report, it will still appear on this page.

There are two things you can do with a bug report: upload it via email or delete it. If you just ignore a bug report for 30 days, it will automatically be deleted. Click on the bug report that you want to act upon (its text will change color to your accent color) then click on the appropriate icon in the application bar.

	Upload - hand off the bug report to your email program right now
	Delete - delete the bug report

The list of bug reports includes both those you create and those Weave Calculator creates when it is crashing.

Because bug reports are most valuable to me when they are delivered in a timely fashion, I've written Weave Calculator 1.1 to remind you that you have pending bug reports when you first start the application. You'll see the following dialog pop up:

If you click the Now dialog button, Weave Calculator will send you to its page listing pending bug reports. You can choose to individually delete or upload each of the pending bug reports.

If you click the Never dialog button, Weave Calculator will delete all pending bug reports. You won't be reminded about any of them again. If you see the dialog again, it will be because new bug reports have been created.

If you click the Later dialog button, the dialog will be dismissed. You can use Weave Calculator normally. If you exit Weave Calculator entirely without deleting all of the pending bug reports and start Weave Calculator afresh later, you'll see the dialog again.