### Displaying Images

At the present time, the following imagery, all TM, is stored in a Directory called "PITimages". This contains the following scenes: 1) Morro Bay, the same image as used in Section 1 of the Tutorial; 2) Rocks, the same Waterpocket Fold scene used in Section 2; 3) Israel; and 4) NB, an image (location uncertain) in the Colorado Plateau of the U.S., illustrating a plateau type topography. Each image is 512 by 512 pixels (about 16 km or 10 miles on a side). For this training session, we will use the Israel scene, which is dominated by agriculture, with several types of crops and fields free of growing produce, along with towns, sand, and water. The scene is along the southern Israeli coast, with the town of Ashdod on the coastline. The image was acquired in August of 1985. To begin, follow these next steps to learn ways to call images into the Thumbnail window. Then, work through the subsequent instructions.

1. Click on Images, then Open, and the window labeled "Image path, sources, and size" comes up. Note that on the right are seven "Browse" buttons each associated with a rectangular box labeled Band 1, Band 2,....Band 7. Click on the first Browse button.
2. A window labeled "Select band 1 path " appears, containing a long list of files beginning with CHANGES.LOG. You will be looking for the file "PIT images". In the present configuration of file levels, this first list does not contain the directory named "PITimages". Now left click on the Parent Directory button (hereafter, whenever the left button on the mouse is to be used, if the word "click" alone is used, this will mean hitting the left button just once ["double click", which may be spelled out {or if one click doesn't work, automatically try two clicks} requires two such actions]; if the right button is to be applied, the words "right click" will be chosen). In the next right subwindow are a list of three general directories. You should only see PIT, Rus, and Tcl. Don't click on any of these; if you do the wrong final directory will appear. Now double click on Parent once more and a new list headed by AUTOEXEC.NU4. From the list you should now find PITimages. Click on it and a single file named "PITimages" will open. Double click on that and a list of 4 sets of TM images will appear. Hereafter, the simple direct way to get to these images is to click on Browse, then on Parent Directory 3 times which brings up the PITimage file in a list; then, just click on it to see the list.
3. Note: you can get to PITimages by clicking on the leftmost button, PIT, then Open, then on Parent Directory 3 times. The list reached includes "PITimages" but there is no way to connect this with the Browse routine.
4. First listings are the 7 TM bands labeled as ISRAEL. This scene covers an area including the town of Ashdod, about 20 miles south of Tel Aviv, a nearby military airport, and crop fields. Highlight (in blue) ISRAEL.1 by single clicking on it and click on Enter. Note that the rectangular box labeled band 1 is now filled with ./../PITimages.ISRAEL.1.
5. Move to the second browse button and repeat the previous (step 4) procedure which inserts ISRAEL.2. Do the same now - browse button-highlight name-enter - for those other bands as you wish to enter - in this case, all 7 TM bands for ISRAEL, which will be the image scene we will work on first in Appendix B. Be especially watchful in this sequence and make sure that the band number you want goes into its corresponding box; for TM you will confuse things if you put, say, TM 3 into Band 1 - it's good practice to have TM and band numbers the same; if you make a mistake and put the wrong band into a box, simply hit Browse and choose the correct one - this will overwrite the erroneous one.
6. Go now to the Source Box and press the Browse button. A listing of Landsat sensor systems,NOAA/AVHRR, and GOES sensors will be shown. Highlight (blue) Landsat TM; then enter via the Select button. Move to the next box, Size, through Browse and pick the only choice, 512 x 512 and hit its Browse button.
7. Now, click on the Open button at the bottom. If you have not placed entries in all 7 available boxes, a window will replace the band entry window telling you that certain bands were not specified, and you will be asked to acknowledge this omission. After hitting Acknowledge, a large gray tone image will appear. This is the initial Thumbnail for the scene, a view of TM Band 1. Take a quick look; locate the following reference features: Mediterranean sea; docks; town of Ashdod; sand dunes; roadways; airport; active crops (darker rectangles, etc.); fallow fields (medium gray patterns).
8. The Image routine serves just to get the different bands online. Only one image, by default the first band, is automatically displayed. Clicking on View-->Current confirms that B1 is being displayed. You may wish to drag (on the blue banner at the top) an image to the right, as this may remove it from a screen that defaults to the left.
9. To see the other bands, and do some image adjustments, you must click on the View button. Then choose "Display Image Control Window". The first thing that appears is a small window labeled: PIT - Thumbnail Image Controls. It will have three rectangular boxes, the first (top) is labeled Expression, in which B1 is entered, and the second and third, each with a sliding button, labeled Contrast and Brightness. At the bottom are four larger buttons, two of which, Apply and RGB, are of interest at this time.
10. Our first task is to examine each of the 7 bands. To see B2, you can proceed either by placing your cursor in the Expression box next to the 1 and delete that character with the left keyboard arrow, then type in 2 in its place and click on Apply. OR it may be easier for you to click on the black inverted triangle button to the right, which will drop down a list from B1 to B7, then clicking on B2 (or any other) and Apply. Each of the other bands is called up in the same way; but it replaces the previous band image which is lost (a way to save and display two is described later). Familiarize yourself with the appearance of each band; Band 6 is the thermal band and is rather washed out in this unstretched rendition. Look at it.
11. Unfortunately, this initial version of PIT does not automatically label each image by its name. To check the band number being displayed, drag the Thumbnail Control box to the right and on the image window click View, then Current, as you did for B1 earlier.
12. The appearance of some - maybe all - of the bands can be improved. The standard way is through some type of contrast stretch. In Section 1 on Morro Bay some of the mathematic stretches were defined and explained. PIT, as now developed, does not have these capabilities and flexibilities. It simply permits two manipulations but these lead to meaningful and esthetic results.
13. To learn the effective use of these sliding buttons, go back to any of the bands you wish. Let us choose Band 4 (B4). Get it displayed. Now move (holding the left mouse button down, displace the sliding button by dragging the mouse on its pad) the sliding button for Contrast all the way to the right. In the small window next to the button, a number "*8.00" should appear and the image becomes bright white after clicking Apply. Then, drag the button all the way to the left and look for "/8.00"; the image is dark (black) after clicking Apply. Once again, bring the button back to its center position. Now slide it slowly to the right. At some short distance, the number "*1.10 will suddenly appear. So, keep dragging it rightward and note that the numbers increase by units of 0.1 (leftward, the same result). Same holds for slow leftward movement. Trying the same approach using the sliding Brightness button produces a right range up to +400 and a left range to -400. Slow movement from center starts right or left increments in units of +10 and -10.
14. Let us do a sample stretch. Set the Contrast button at *1.50 and Brightness at +100 and then click on Apply. You will note an overall change in image gray tones, with a somewhat different range of gray levels and an overall increase in brightness. The resulting image may strike you as improved from the start - this is a rather subjective judgment. Now set the C and B limits at *250 and +200. No doubt you will react negatively to the result. Try C and B limits at /150 and - 200. This also will not be a pleasing result. For a given image, there tends to be a narrow range of C and B in combination with changed values that give satisfying improvements. You, as the analyst must pass judgment on a set of B and C values that seems to you to improve image quality - but this is obviously subjective. Note: if you move the buttons left or right only slight amounts (before any numbers appear) and then hit Apply to see any changes, nothing does change and the buttons revert to center; this means that real changes can occur only when numbers start appearing. Generally, most images improve when the C numbers fall in ranges less than *2 and /2 and B not greater than + or - 150 but some processing operations yield new images that require more extensive stretches or overall tone increase/decrease, so that the larger values apply. While you are at it, try to find the best stretch that optimizes band 6 gray levels.
15. Images in color are the next set of products sought through image processing. PIT makes these in a straightforward way. To start, again click on View and then Display Image Control Window. As before, the Thumbnail Image Control window will come up, as it does for individual band stretches. But, now click on the RGB button, and a new larger window comes up with three internal rectangular boxes, the top outlined in red, the middle in green, and the bottom in blue. Each one also has a pair of C and B sliding buttons. Note that, by default, B1 is inserted in each of the three Expression boxes. Also, there are Gray and Palette buttons to the right. Do not use the Palette button at this time. If you want to see any individual band image, press on Gray which will bring up any individual band you enter in the usual way. A stretch may be needed.
16. To see an image in color, choose what band you wish to render in the particular color you select, either by accepting or editing the band number in the Expression box or clicking on the black triangle and selecting the Bn desired. As an example, put B4 in the red Expression box, B3 in green, and B2 in blue. Then press Apply. A standard false color composite, with vegetation in red, should replace the band 3 image. Next, either delete/type the number or use the triangle, put B3, B2, and B1 in the red, green and blue outlined boxes. This will give a good natural color view.
17. But, better renditions are possible, even likely. Move experimentally the sliding buttons for each of the three bands to new positions, followed by Apply. Keep doing this until you reach a color display that seems close to nature or is at least esthetic. One natural view that is pleasing is B3: *1.10, +30; B2 *1.80, +30; B1 *1.10, +10. In effect, you are enhancing the image by selective, band by band, contrast stretching.
18. For the fun and knowledge of it, try other combinations, as you choose. For example, R = B7, G = B2, B = B4. Various subtle new information may emerge from some particular combination. Also, vary C and B. Remember to enter through Apply.
19. PIT has a systematic size changing program, or Zoom, that enlarges or diminishes an image. To bring about a change, follow this sequence (which also previews a major operation which we will do under the Classification tutorial): From the PIT Thumbnail window (hereafter, alternately just referred to as the PIT window), click on the rightmost button, Windows, then through these choices in the step windows that will appear to the right = Open - Interpretation - Scheme (top or left). After the left mouse button is released at the last step, a large window will appear with a black rectangle on the left (or top; depending on choice) and an image will appear in a window to its right.That image is the current one that is active. If you prefer to display another band, press on View, click on Display Image Control Window, then change band number in the Expression box (or click on RGC and fill in all three to get a color composite), and hit Apply. Note that the image that you settle on will have a square grid superposed on it (this grid is used in the classification procedure). To remove this grid for now, go to View, then click on Show and note that four options are listed. One is labeled Grid and has a check mark in front. Click on the check mark, which removes it, and then displays the image without the grid. You are now ready to Zoom.
20. The procedure to change size is simple. Assuming you are still in the PIT-Interpretation window, first, click on View, then on Zoom in its dropdown menu. This will display numbers like 2x, 4x, 8x, ... . Whichever has the check in front denotes the size increment that will take place one step at a time. Most instances, an increase by 2x is adequate, but the higher numbers enlarge or diminish the image by greater amounts. For now, choose 2x. Then, click on Mode (top left button), and in its window menu will be two options: Zoom In (enlarges) and Zoom Out (diminishes). Assuming you have a full scene in display, choose the Zoom In command. Nothing apparently happens but move your mouse to bring the cursor into the image. You should see that the cursor has changed to a small bright square outline with a dot in its middle. Place that square somewhere in the image where you seek enlargement and click once (left). A new scene shows up in the image window, which you should recognize as a part of the image surrounding the square at its center. If you want to see a different area enlarged, repeat the procedure with the cursor placed within it. Or, given the first enlargement, center the square and click again. Once more, the expansion is by a factor of 2x; the image now begins to show individual pixels (as squares) but recognizable features may still retain identifying patterns. Repeating this once more (now 2x three times, or 8x) makes the pixels so large that the patterns begin to break down. To reverse the size increase, go to Mode, then Zoom Out, by clicking on that command. The cursor, when it is placed somewhere on the (restored or enlarged) image, has a different shape: it is a cross (+) with the tips ending in tiny arrowheads. Depending on the degree of enlargement, one or more clicks will in effect increase the displayed pixel size while restoring the image scene to larger scene areas that are displayed. From 8x, three clicks will restore the original full scene, if that was the starting point. Enlargements by zooming in provide smaller subsections of a scene that may be all you will wish to classify or otherwise manipulate. Note: you can start with a higher zoom factor, e.g., 4x or 8x, cutting out incremental steps.
21. PIT presently is not designed to routinely display more than one image band at a time but there is a way to put most of the areas of two bands on the screen simultaneously. To do this, first put up the PIT Thumbnail image (after closing out the PIT - Interpretation window by hitting on its X button) and if other than the default image is to be displayed, get it in the usual manner through View - Display Image Control Window and select the band (delete/place number or black triangle) wanted + Apply. After it is then displayed, you next want to bring up the second band. To do this, at the top click and drag on Windows - Open - Classification - Supervised - Image - Partial - Top Scheme, and click the mouse button on that last command. Either a blank pair of windows will come up or the bottom window will have the image of one of the bands (check Current). To get the band you want in this right window, go to View - Display Image Control Window - band number - Apply. You should now see both band images but a small part of one and/or the other may not be visible. You can move either or both around the screen by placing the cursor on the top banner, holding the mouse button down and dragging. Keep in mind, also, that there are other situations in using PIT where windows might overlap; in some instances these can be repositioned by dragging one or more, again by placing the cursor on the blue title bar (top). Note: Using top schemes and 1280 x 1024 screen resolution will allow the windows to be viewed side-by-side with no overlap.

To leave PIT altogether, go to the PIT button (first on left) and click on Quit. But, you may wish to leave one image data set and look at another. You can just quit and start again. But there is an alternative. Go to the second button, Image, and click on Open. You will see the band(s) you already have worked with. Go to the first Browse button and proceed (through 3 menus) to PIT Images and find the first band from the image you now want displayed. Click on it and insert - it will overwrite the previous image. Do that for other bands; if you wish to skip one, just "erase" it by sweeping with your cursor over its entry and press delete. Now press Open and a Save Current Image box drops down. Click on Cancel and a box will appear that may inform you that one or more bands were not chosen - in this case hit Acknowledge and the new image(s) will be loaded, with the top one displayed (if you hit Cancel, you will be bounced completely from PIT). This example illustrates that PIT has limited flexibility in moving around from images displayed and processing routines; you may be shoved off the program if the wrong command or option is given, but with experience that will decrease in frequency.

Now that you have completed these first processing operations using PIT, the primary writer (NMS) wants to call your attention to several pitfalls that could be encountered using the present version of PIT (which implies it hasn't been sufficiently debugged). First, like most programs it can shut down erratically, when certain actions are taken. If that happens, you will need to start over. Second, it is sometimes difficult to switch from one operation to another. There is no Back or Undo buttons. In some cases, simply hitting the minimize button (-) will get a current program off screen, permitting the user to access a previous screen or program (check the bottom of your desktop for buttons that show the removed program can still be re-activated. Sometimes, the Esc(ape) button on your keyboard will remove a window. Finally, just clicking in the desktop background can perform a desired action. Third, there are certain commands or action in the original write-up by Jeff Love that are not correct. For example, "Enter" in his instructions for some operations is not correct - this does not mean hitting your keyboard Enter. Instead, Open or Apply should be the choice. NMS has tried to change these as he reviewed and revised these Instructions, but one or more of this command may have been missed. If you, the user, find inconsistencies or confusing or downright incorrect instructions (for instance, flaws in a sequence) email NMS.

Nicholas M. Short, Sr. email: nmshort@ptd.net
Jeff Love, PIT Developer (love@gst.com