= 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 spacing }}} The 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. 1. 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. 1.#2 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' ''' 1. Individual shift''' - Shifts an individual image. 1. Enter the Image number (i.e., "k" value) that you want to shift. 1. Enter the number of pixels to shift * the x distance (positive moves to the right * the y distance (positive moves down) 1.#3 Enter the next Image number (i.e,. "k" value) and proceed as before. When you're finished with the individual shifts 1.#4 Enter "0" to quit to the Main Menu. ''' 2. Global shift''' - Shifts all images the specified amount. 1. 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) CategoryLithosMenu