source: trunk/loci/visbio/help/measuring.html @ 2906

Revision 2906, 5.4 KB checked in by sorber, 13 years ago (diff)

Added measuring tutorial to built-in help.

Line 
1<html>
2<title>VisBio Measurements Tutorial</title>
3<body>
4<h2>Getting started with measuring</h2>
5
6<p>This tutorial is intended to help you start taking measurements as quickly as possible in VisBio.</p>
7
8
9
10
11<h2>1) Load images</h2>
12
13<h3>Start VisBio</h3>
14<p>Double click the VisBio icon on the desktop to start the program.  The red VisBio logo will appear with a progress bar indicating that VisBio is loading.  Then the main VisBio screen appears:</p>
15
16<p><img src="measuring/main.png" border="0" alt=""></p>
17
18<h3>Import images</h3>
19<i>For more detail, see <a href="import_data.html">Importing a dataset from disk</a>.</i>
20<p>To load images into Visbio, click the "Add >" button and then select "Dataset".  The "Import data" window appears:</p>
21
22<p><img src="measuring/import-data.png" border="0" alt=""></p>
23
24<p>Click "Select File", then pick the file you want to load.  If the file you want to load is part of a numbered series, VisBio will try to guess the other files in the series and load them all as one dataset.</p>
25
26<p>Click "Next >".</p>
27
28<p><img src="measuring/next.png" border="0" alt=""></p>
29
30<p>VisBio will read the dimensions of the image in microns if possible from the image. </p> 
31
32<p><img src="measuring/microns.png" border="0" alt=""></p>
33
34<p>Click "Finish".  VisBio will load the image and offer you a several display options.</p>
35
36
37
38<br>
39<h2>2) Create a display with overlays</h2>
40<i>For more detail, see <a href="overlays.html">Overlays</a>.</i>
41
42
43<p>Select the option "In 2D with overlays" and click "Ok."</p>
44
45<p><img src="measuring/visualize.png" border="0" alt=""></p>
46
47<p>Click "OK" in this window to generate the display.</p>
48
49<p><img src="measuring/add2d.png"  border="0" alt=""></p>
50
51<p>VisBio will display two windows: 1) the Display window, containing your image and 2) the Tools window, which you will use for drawing measurements.</p>
52
53<p><img src="measuring/display1.png"  border="0" alt=""></p>
54
55
56
57<br>
58<h2>2) Take measurements</h2>
59
60<h3>Zoom-in on the area you want to measure</h3>
61
62<p>First, use the display window's controls to zoom, pan, and rotate the image.  These are located at the top right of this window under "Appearance":</p>
63
64<p><img src="measuring/appearance.png"  border="0" alt=""></p>
65
66<h3>Select a measurement tool</h3>
67
68<p>There are several tools which can be used for measurements.  Select the tool you want by clicking it's icon in the tools window:</p>
69
70<p><img src="measuring/tools.png"  border="0" alt=""></p>
71
72<h3>Line tool</h3>
73
74<p><img src="measuring/line.png"  border="0" alt=""></p>
75
76<p>Use the line tool for measuring straight lines.  Click and drag to draw a line.</p>
77
78<p><img src="measuring/lineDrawn.png" border="0" alt=""></p>
79
80<p>The line's length appears in the "Statistics" area of the tools window.</p>
81
82<p><img src="measuring/lineStats.png"  border="0" alt=""></p>
83
84<h3>Freeform tool</h3>
85
86<img src="measuring/freeform.png"  border="0" alt="">
87
88<p>Use the freeform tool for measuring curved lines.  Click and drag to draw a freeform line.</p> 
89
90<p><img src="measuring/freeformDrawn.png" border="0" alt=""></p>
91
92<p>The freeform's length appears in the "Statistics" area of the tools window.</p>
93
94<p><img src="measuring/freeformStats.png"  border="0" alt=""></p>
95
96<h3>Polyline tool</h3>
97
98<p><img src="measuring/polyline.png"  border="0" alt=""></p>
99
100<p>The polyline tool can also be used for measuring curved lines.  Click once to place a new "node" in the polyline.  Double-click to end the polyline.</p>
101
102<p><img src="measuring/polylineDrawn.png"  border="0" alt=""></p>
103
104<br>
105<h2>3) View measurements in a spreadsheet</h2>
106
107<p>To view measurements in a spreadsheet application such as Excel, click "Export overlays..." in the tools window.</p>
108
109<p><img src="measuring/exportButton.png"  border="0" alt="">  </p>
110
111<p>Before exporting, you may select the statistics you wish to include in the Excel file (these are the same statistics that appear in the "Statistics" area of the control window). 
112By default, all statistics are exported.  You may want to "turn off" some statistics to make your files easier to read.</p>
113
114<p><img src="measuring/export.png" alt=""></p>
115
116<p>The .xls file generated looks like this:</p>
117
118<p><img src="measuring/spreadsheet.png"  border="0" alt=""></p> 
119
120<br>
121<h2>4) Save your measurements</h2>
122
123<p><img src="measuring/saveButton.png"  border="0" alt="">  </p>
124
125<p>If you want to reload your measurements at a later time, click "Save overlays..." in the tools window.  As when exporting, you may select which statistics to store in the text file.  <i>(Note: these statistics are printed in the text file for your convenience only—when you reload your measurements later, VisBio will recalculate all overlay statistics, whether explicitly saved or not.)</i></p>
126
127<p><img src="measuring/save.png"  border="0" alt="">  </p>
128
129<p>VisBio will save your overlays to a text file which it can reread.  These text files contain the same information as the Excel files which VisBio generates, and are formatted almost identically:</p>
130
131<p><img src="measuring/text.png"  border="0" alt=""> </p> 
132
133<br>
134<h2>5) Load your measurements</h2> 
135
136<p>Follow this tutorial up to step 2.  Then click "Load overlays..." in the Controls window.</p>
137
138<p><img src="measuring/loadButton.png"  border="0" alt="">  </p>
139
140<p>Select the text file containing the overlays you wish to load and click OK.</p>
141
142<p><img src="measuring/load.png"  border="0" alt="">  </p>
143
144<p>VisBio will reload your overlays for you to view or modify.</p>
145<br>
146<br>
147<br>
148</body></html>
Note: See TracBrowser for help on using the repository browser.