Align landmarks
(lithos Main Menu Option 1. Align landmarks)
Description
This Main Menu option is used to align all the images in a landmark. After you complete the alignment, you can then build a template (Find template) and build topography (Find heights).
Suboptions
When you choose Option 1. Align landmarks from the Main Menu, you will see this set of Suboptions:
Main Menu: Q 0123O IUCRSG NVAMBX DEPL FZH? 1 >1 0. Auto align 1. Individual shift 2. Global shift 3. Align with picture 4. Align with gradient q. Quit
0. Auto align - Aligns images to the template.
Here is a sample of the display for 0. Auto align:
k picnm lambda phi cvg nlmk
1 P3T11M2H0217 1.158 0.000 0.871 846
2 P3T11M2H0218 1.138 0.000 0.871 857
3 P3T11M2H0219 1.373 0.000 0.881 853
4 P3T11M2H0220 1.063 0.000 0.881 871
5 P3T11M2H0222 1.067 0.000 0.942 856
6 P3T11M2H0223 1.378 0.000 1.000 858
7 P3T11M2H0224 1.061 0.000 1.000 875
8 P3T11M2H0225 1.166 0.000 0.928 848
9 P3T11M2H0226 1.135 0.000 0.929 866
10 P3T11M2H0227 1.105 0.000 0.850 854
11 P3T11M2H0228 1.361 0.000 0.851 868
12 P3T11M2H0229 1.091 0.000 0.965 849
13 P3T11M2H0231 1.100 0.000 1.000 855
14 P3T11M2H0232 1.348 0.000 1.000 872
gc LMRK_DISPLAY0.pgm
gc LMRK_DISPLAY1.pgm
check display
enter spacingThe auto-align display includes these elements:
k - Image number
picnm - Image (picture) file name
lambda - Overall brightness scale factor (See Find template.)
phi - Background brightness factor (See Find template.)
cvg - Coverage. This is the fraction of image that is found in the landmark.
nlmk - Number of landmarks that use this image. (You can also think of this as each landmark that has been added to the image.)
Auto-align requires these additional inputs:
enter spacing - This input sets the number of pixels that lithos is allowed to shift the image.
- Enter a number between 1 and 5.
The lower the number, the fewer number of pixels lithos is allowed to shift the image. '1' searches a 5x5 pixel area, '2' a 10x10 and so on. A display indicates the number of pixels moved in both x and y, and the new correlation factor for the new image location.
- Respond to each of these suboptions:
new spacing? y[n] - You can choose a new number if you don't like the results. "Enter" defaults to "no."
0. continue. (default) - You can continue with current positions. 'Enter' defaults to this selection.
1. halve shifts. - This moves the image half the distance spacing calculated. (This can help with images that want to bounce between two locations.)
2. quarter shifts. - This choice is similar to above, but it only shifts the image one quarter of the distance.
Update landmark pixel locations? y[n]
- 'y' saves the new position and returns to the Main Menu
- 'n' discards the changes and returns to the Main Menu
- 'Enter' defaults to 'n'
- Enter a number between 1 and 5.
1. Individual shift - Shifts an individual image.
- Enter the Image number (i.e., "k" value) that you want to shift.
- Enter the number of pixels to shift
- the x distance (positive moves to the right
- the y distance (positive moves down)
- Enter the next Image number (i.e,. "k" value) and proceed as before.
- When you're finished with the individual shifts
- Enter "0" to quit to the Main Menu.
2. Global shift - Shifts all images the specified amount.
- Enter the x and y pixel shifts. You will then be asked:
Update vector? (y/n) Choose 'y' if you want to do a "v1" (from Find_V_Z_or_PTG).
3. Align with picture - You select one image, and then SPC aligns all the other images to it.
- First, enter the number associated with the image you want to align to. Enter spacing as in "Option 0" above. This is used sometimes when auto-align isn't working and you don't want to align pictures by hand.
This option doesn't always work because of differing illumination conditions. Note that using this option will move the reference image to position #1 and will flag or "turn off" all the other images. You will need to perform a 0-a from the Main Menu to add them all back.
4. Align with gradient - This option is like auto-align (Option 0) except that it uses the gradients normal to the sun direction instead of the template.
- This is used in the same situation as "Align with picture" and sometimes works better. Like option 3, option 4 will "turn off" all images that are not the selected image. You will have to add these back before you build a template.
q. Quit - Quit to the Main Menu.
Typical Example
The following sample shows the screen output from entering:
- 1
- 0
- 1
- n
- 0
- y
Main Menu: Q 0123O IUCRSG NVAMBX DEPL FZH? 1
>1
0. Auto align
1. Individual shift
2. Global shift
3. Align with picture
4. Align with gradient
q. Quit
0
0
k picnm lambda phi cvg nlmk
1 P3T11L2H0201 1.158 0.000 0.881 96
2 P3T11L2H0202 1.155 0.000 0.877 96
3 P3T11L2H0203 1.354 0.000 0.879 94
4 P3T11L2H0204 1.072 0.000 0.879 96
5 P3T11L2H0206 1.057 0.000 0.945 97
6 P3T11L2H0207 1.351 0.000 1.000 95
7 P3T11L2H0208 1.070 0.000 1.000 97
8 P3T11L2H0209 1.159 0.000 0.934 96
9 P3T11L2H0210 1.161 0.000 0.934 97
10 P3T11L2H0211 1.084 0.000 0.853 96
11 P3T11L2H0212 1.355 0.000 0.853 94
12 P3T11L2H0213 1.070 0.000 0.955 96
13 P3T11L2H0215 1.082 0.000 1.000 96
14 P3T11L2H0216 1.355 0.000 1.000 93
gc LMRK_DISPLAY0.pgm
gc LMRK_DISPLAY1.pgm
check display
enter spacing
1
1
1 P3T11L2H0201 0.028 0.029 0.968 +++++
2 P3T11L2H0202 -0.048 0.026 0.941 +++++
3 P3T11L2H0203 0.038 0.026 0.909 +++++
4 P3T11L2H0204 -0.051 0.011 0.955 +++++
5 P3T11L2H0206 -0.053 0.003 0.961 +++++
6 P3T11L2H0207 0.031 -0.020 0.930 +++++
7 P3T11L2H0208 -0.054 -0.006 0.957 +++++
8 P3T11L2H0209 0.030 -0.010 0.971 +++++
9 P3T11L2H0210 -0.052 -0.017 0.947 +++++
10 P3T11L2H0211 0.029 0.001 0.977 +++++
11 P3T11L2H0212 -0.051 -0.023 0.910 +++++
12 P3T11L2H0213 0.030 0.007 0.974 +++++
13 P3T11L2H0215 0.028 0.015 0.974 +++++
14 P3T11L2H0216 -0.047 0.021 0.878 +++++
0.041 0.017
new spacing? y[n]
n
0. continue. (default)
1. halve shifts.
2. quarter shifts.
0
0
Update landmark pixel locations? y[n]
y
y
Current landmark = EE0001
SCALE = 0.000100 QSZ = 49
Lat/Lon/Rad = -6.800 264.090 0.266
Region = EE
gc LMRK_DISPLAY0.pgm
gc LMRK_DISPLAY1.pgm
check display
Main Menu: Q 0123O IUCRSG NVAMBX DEPL FZH?
(Compiled by JRW)