summaryrefslogtreecommitdiff
path: root/meme/README
blob: a49dbc9d0402c0616bf21da2274847545456335b (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
Mesh measurement utility
========================


Usage:

meme <path-to-STL-file>


Mouse
-----

- move mouse: places the cursor on the vertex closes to the mouse pointer
- turn scroll wheel:
  - C key not held: zooms in or out
  - C key held: increase/decrease contrast
- click left button:
  - not on measurement point: set/move measurement point
  - on measurement point: cancel measurement point
- click right button:
  - delete both measurement points


Keyboard
--------

- C: enter contrast enhancement mode, see below
- E: highlight equal height, see below
- G: toggle grid (edges) display
- P: toggle profiles display, see below
- Q: quit
- *: center and zoom to extents


Profiles
--------

Profiles show the intersections of the mesh with XZ and YZ planes placed
at the cursor location. The XZ profile is shown at the bottom of the window
(screen X is mesh X, screen Y is mesh Z) and the YZ profile is shown at
the right side (screen -X is mesh Z, screen Y is mesh Y).

Profiles are toggled with the P key.


Contrast enhancement
--------------------

Contrast enhancement mode can be entered by pressing and holding the C
key. When pressing C, the Z to greyscale mapping is adjusted such that
the Z value at the cursor position becomes the middle of the greyscale
range.

Contrast can be increased or decreased with the scroll wheel. Areas
that exceed the contrast range are shown in yellow.

The normal mapping is restored when releasing the C key.


Highlight equal
---------------

While pressing the E key, a contour line at the Z position at the cursor
is drawn in purple. Areas that are coplanar with that Z position are
filled. This is similar to contrast enhancement and intended for quick
estimation of where the cursor is located with respect to plateaus.


Workflow
--------

- load the STL file, ideally at a resolution of 100 um or better
- zoom into the area of interest

To measure vertical distances:

- use contrast enhancement mode to identity flat areas at the desired
  heights and place the measurement markers there. When both markers
  are present, a window with the measured distances will appear.

To measure horizontal distances:

- note that the meshes are not corrected for the size of the scanning
  needle, which has a hemispherical tip with a diameter of 0.8 mm and
  a conical shaft.

- use profiles and/or contrast enhancement to find the desired edges.
  Edges are typically located between the last point of a plateau and
  the adjacent point that is slightly below the plateau.

- left-click to place a measurement marker

- find the corresponding second point and place the second measurement
  marker

To clear a marker, move the cursor exactly on the marker and
left-click. To clear both markers, right-click.


Known bugs and limitations
--------------------------

- only suitable for 2.5 D scans, i.e., there it at most one vertex at
  any (x, y) position
- doesn't support other views than from the top
- doesn't support rotation
- profiles overwrite each other (clear artefacts caused by this by
  zooming out and in again)
- contours aren't always closed lines - why ?