Weave Calculator 1.0 for Windows Phone 7 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 a calculation. 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 red theme. Where you see red in the document, on your phone you will see your theme's accent color.

Note: Weave Calculator 1.0 is paid for by the advertising it displays. You can opt out of the advertising, but Weave Calculator will give you only trial mode functionality while you are opting out. You will not be able to save or load projects in trial mode.

Weave Calculator 1.0 runs on Windows Phone 7 and later versions of Windows Phone supporting backward compatibility with Windows Phone 7.

General Usage Instructions

Weave Calculator Windows Phone Edition is a standard Metro style application. The top of the screen has a banner identifying the product (Weave Calculator), our company (Canitag Apps N Crafts), 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)
• threads - the number of ends of warp and picks of weft in your project
• 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 of unwoven warp
• 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 a value looks like when you're expected to supply the value.

If you swipe right to left along the title bar area, you will see the threads pane. 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. The image that follows shows what a value looks like when Weave Calculator is supposed to compute a value for you.

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.

The main page has two other differencs from the other pages. The main page has an application bar. On the main page, if you are holding the phone narrow end up, the bottom of the screen has an application bar with four icons and an ellipsis (...). The application bar will be found to one side or the other if you are on the main page holding the phone long end up.

The application bar has four icons plus an additional two menu choices that can be brought into view by tapping the ellipsis or dragging the application bar upward with a finger. 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 are:

• Privacy - a page with a summary of the privacy policy and links to more information on this website
• Analytics - details of what usage information this device will upload unless you opt out of sending data

Just above the application bar, there is a block of space reserved for advertisements. Sometimes the area will be all black, as depicted in the images shown in this documentation. Sometimes it will hold an advertisement. Weave Calculator is an ad-supported application.

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. It assumes you are willing to have it send us reports of application crashes but not of application usage. Weave Calculator defaults to a 25 inches of loom waste and 15% shrinkage. You can change any of these defaults 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 three sections. The first section lets you indicate your preference for working in inches or centimeters. Scroll through the list box at the top of the screen to specify what unit you want to use when describing the width and length of your project. For example, if you want to say that your project is 2.5 feet width by 8 feet long, select feet. 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 save/load page) or you enter Weave Calculator afresh. Changing the values won't tamper with what is on your main page right now.

The third section enables you to opt out and opt back in to reporting of the two kinds of data that Weave Calculator is capable of sending us (Canitag Apps N Crafts) and the one kind of data Weave Calculator is capable of sending advertisers publishing through Microsoft's advertising service:

• Crash dumps - information on where a crash arose
• Analytics - information on what features people use
• Advertisements - whatever advertisers can observe when you tap on their ads

A crash dump report identifies the type of phone, version of software, and location of a crash. The information we collect does not identify you, your phone, or contain other personal information. We use the information to help us fix the problem. Weave Calculator defaults to sending crash reports because we feel that the benefit of getting a more stable application (i.e. getting these nasty bugs fixed) outweighs the privacy needs of most people and the cost of the data network usage. If you value your privacy more highly, by all means, opt out.

An analytics report identifies the type of phone and version of sofware. It conveys some performance data and some feature usage data. The report does not contain personal information, although it does hint at personal behaviors. We aggregate the performance and usage data to take away the temptation to track usage patterns of individuals. You can see the kind of data contained in an Analytics report by scrolling up in the application bar and selecting the analytics menu item. By default, Weave Calculator does not send feature usage analytics to us. Since you're paying us by putting up with the advertising, we felt is unreasonable to also collect this data without your explicit permission. If you do opt in, we will use the data to help make decisions in the future about things like whether we should make finished versus on-the-loom values the default input.

Advertisers will know that their ads are being sent to Weave Calculator. They will know if you open up an ad that you were using Weave Calculator. It is certainly best to assume that they will have access to the usual sorts of information sent from web browsers or, if you click on a call-the-company ad, from caller id. Weave Calculator does not use (GPS or other) location libraries. It will not tell the advertising service where you are. For more about the kinds of privacy policies Microsoft has to safeguard your data, read Microsoft's privacy policy.

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 start 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 title bar 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 threads pane. Weave Calculator 1.0 assumes that the number of warp and weft threads is something you'll want it to calculate. It can't calculate the values until it knows the more about your project, so expect to see empty values here the first time you visit the pane. Later on, you can scroll around and see what Weave Calculator has computed.

Continue on to the right and you'll encounter 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.

The pane to the right of length 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.0 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 Calculor lets you save your work and read it back at a later time except when offering trial mode functionality to those who opt out of receiving advertisements. To save or restore, click on the Save icon on the application bar:

This will send you to the Saved Data page.

To save your work, enter some text to identify the project whose calculations you are saving (shown as the text box labeled Memo in the image above), then click the Save button. If you click the save button without entering a memo, Weave Calculator will use the current date and time as the note. After you click the 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 saved data page and reload the data from a previous save. The data is kept until you use the saved data page to delete it (or until you wipe all data on your phone). The list of your saves is shown in the bottom 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 Load button, 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.

The Clear button next to the Save button will erase the data on the main page. This gives you a fresh start for entering data about your next project. Weave Calculator 1.0 does not ask for confirmation about clearing the data for your current project.