OrthoServer

MITOrthoTools for Arcview

• Software Requirements
• Installation Directions
• Usage Instructions

---

Software Requirements

• Arcview 3.0 or better
• At least one of
  Perl v5 or better with XML::Parser and LWP::Simple;
  or Java 1.0 Run Time
• Dialog Designer Extension for Arcview (see arcview help files for more information)
• JPEG Extension for Arcview (for viewing JPEG images)

Files needed for Dialog Designer: For Windows 95 and NT, you need avdlog.dll in the bin32 directory and avdlog.dat in the lib32 directory. For UNIX, you need avdlog.dll in the bin directory and avdlog.dat in the lib directory.

---

Installation Directions

Files List

• wmtmitortho.avx - the Arcview extension file
• wmtmitorthoPC.ini or wmtmitorthoUNIX.ini - the user configurable initialization file
• wmtmitortho.pl - perl script to retrieve an image file from a WMT server or retrieve capabilities XML file from a WMT server
• MITOrthoTools.jar - Java bytecode to retrieve an image file from a WMT server or retrieve capabilities XML file from a WMT server

Directions

1. Install Perl and the XML and LWP modules.
   • Perl is available from ActiveState.com.
   • The distribution should include the required packages by default, but if it doesn't you'll have to install them.
   • Use the Perl Package Manager by typing "ppm" at a command line. Type "query" to list installed packages.
   • After executing "ppm", type "install XML-Parser" and "install libwww-perl" to automatically download and install the packages.
2. Alternatively, you can install the Java Run Time Environment (JRE) version 1.0 or higher.
   • Java is available from JavaSoft.com.
   • All functionality is included in the JRE distribution.
3. The USEREXT and AVEXT environment variables store the directories where Arcview looks for its list of available extensions. The .avx and .ini files must be installed in one of these directories.
4. Copy the .pl and/or .jar file to the same directory, or any other directory of your choosing, e.g. c:\wmtmitortho.
5. Edit the .ini file and change the directory settings to reflect your system set up.

---

Usage Instructions

Overview

Load the extension and then click the "S" icon to pick a WMT server to connect to. Choose which layer you want to retrieve. Retrieve images by clicking on the globe icon.

How to use

If the extension has been placed in the right location, it should appear in the extensions list. If not, review the installation instructions or the FAQ. 

Loading the extension adds two buttons to the view button bar:

• Pick Server: Click on this button to choose a WMTServeras the source for your orthophotos. You can select a predefined server (from the .ini file) or enter your own. You can experiment the servers on the WMT Servers List. The button will execute some perl or java to retrieve the server capabilities, parse them, and then ask you which layer, image format, and SRS you would like.
•   Get Ortho: Click on this button to retrieve the orthophoto that covers the geographic extent of the current view. 

To overlay your vector files with a downloaded image, one of two conditions must hold: 

• The vector files are in the same projection as the image downloaded.
• The vector files are in lat/lon (in which case you need to choose the image projection in your view according to the WMTOrthoServer images projection).

  Step-by-step

  1. Run Arcview.
  2. From the "File->Extensions" menu, click the checkbox next to the "WMTMITOrtho Extension" and then click "OK". If you don't see the extension in the list, see the installation directions.
  3. You may also want to select the "JPEG/JFIF Extension" and other image reading extensions.
  4. Once the extension is loaded, you will have two new buttons in your View toolbar, and a new menu "MIT Ortho" in your Project menubar. You won't see the buttons unless a View is made active.
  5. Use the "MIT Ortho" menu from the Project view to configure directory locations.
  6. From a View, click on the "S" button to connect to a server. Wait for the scripts to run.
  7. Choose a server from the list, or choose "other..." to enter your own server.
  8. If you enter your own server, make sure you include the full URL like: "http://wmt.server.com/capabilities.cgi".
  9. The extension will call a Perl script to connect to the server and download and parse its capabilities.
  10. After that completes, you will be presented with a list of layers to choose. Choose one of the layers.
  11. Next, you will be asked to choose an image format for downloading the image. Currently supported are JPEG, GeoTIFF, and TIFF. Other formats will be downloaded to the temporary directory, but not displayed in the view.
  12. Now choose an SRS or Projection that matches the projection of your view. A list will be presented showing the projections supported by the server. If your view's projection is already set through View->Properties, and it matches one supported by the server, it will be highlighted by default. However, if your view projection was not set, pick the one that matches the data in your view.
  13. Make your View active again if it isn't already.
  14. Center and zoom your view to the location where you want the image layer to be downloaded.
  15. Click on the globe icon and a Perl script will be called to connect to the server and download the image.
  16. If that completes successfully, the image should now be shown as a new layer in your view.

---

Image Preparation | Home | MIT OrthoTools (non-WMT) | MITOrtho Web Page | Frequently Asked Questions |