World Wind Users Document

From World Wind Wiki

(Difference between revisions)
Jump to: navigation, search
Revision as of 18:49, 4 February 2005 (edit)
TomServo (Talk | contribs)
m (Contact)
← Previous diff
Revision as of 18:50, 4 February 2005 (edit) (undo)
TomServo (Talk | contribs)
m (Installation)
Next diff →
Line 45: Line 45:
==Installation== ==Installation==
-b1. Requirements+====Requirements====
-Windows 2000, XP Home, or XP Professional, Windows 98+*Windows 2000, XP Home, or XP Professional, Windows 98
-Intel Pentium 3 1 ghz or AMD Athlon or higher+*Intel Pentium 3 1 ghz or AMD Athlon or higher
-256 MB of RAM +*256 MB of RAM
-3D Graphics Card (64 MB+ recommended)+*3D Graphics Card (64 MB+ recommended)
-Check out the Video hardware compatibility list +*DSL / Cable connection or faster (It does “work� on a modem connection.)
-DSL / Cable connection or faster (It does “work� on a modem connection.)+*2 GB or more of disk space
-2 GB or more of disk space +
====Download Location==== ====Download Location====

Revision as of 18:50, 4 February 2005

World Wind Documentation / Walkthru

Written and Maintined By: Chad Zimmerman

Edited By: (the world :)

Version: 0.2

Date: 02/04/05

Version Location:

Contents

Introduction

About

World Wind allows any user to zoom from satellite altitude into any place on Earth, leveraging high resolution LandSat imagery and Shuttle Radar Topography Mission (SRTM) elevation data to experience Earth terrain (or any planet with the data) in visually rich 3D, just as if they were really there. Virtually visit anyplace in the world. Look across the Andes, into the Grand Canyon, over the Alps or along the African Sahara.

World Wind downloads and displays data from numerous data sources. Such as LandSat7, MODIS and USGS (1-Meter, Topo and Urban). Using these various sources of images, you can zoom in close enough to see people walking in the streets of many of Americas cities.

Features

World Wind offers the following features:

  • Rapid Fire Modis – For getting near real time images from orbiting satellites with resolution down to 250Meter. You can filter the MODIS data by date and by event. Data is then downloaded and displays an icon in World Wind showing what event it is and where it happened. You can zoom in to view the event.
  • LandSat7 Images – LandSat 7 is a collection of images from 1999-2003 at an impressive 15 m per pixel resolution. It includes other color bands such as the infrared spectrum. Users will be able browse these different sets as they become available. Any changes and updates are automatically inherited by World Wind. LandSat 7's resolution makes it possible to see your own city, neighborhood, or landmarks in your vicinity. Seeing the whole globe like this puts the world in context with scientifically accurate data. You can view LandSat imagery in visible colors or in False Color bands.
  • WMS Browser – Web Mapping Server. (Not sure what this does.. need info)
  • SVS (Scientific Visualization Studio) – Goddard Space Flight Center (GSFC) has produced a set of visually intense animations that demonstrate a variety of subjects such as hurricane dynamics and seasonal changes across the globe. World Wind can take these animations and play them directly on the world. Anyone can immediately grasp where the event is taking place as World Wind rotates automatically into view.
  • Blue Marble - World Wind has a full copy of the Blue Marble, a spectacular true-color image of the entire Earth. Put together from data of a variety of satellites such as MODIS and Terra, the Blue Marble can be seen in all it's glory at 1 km per pixel resolution.
  • SRTM – Combining LandSat 7 imagery with Shuttle Radar Topography Mission (SRTM) Data, World Wind can display a dramatic view of the Earth at eye level. Users will literally be able to fly across the world in any direction.
  • USGS – United States Geological Survey data. USGS provides Topography maps, 1-Meter detail images of most of the United States and Urban Area images of most of the major cities down to detail of .25 Meter.

Contact

There are several ways to contact the developers of World Wind.

Website:

http://worldwind.arc.nasa.gov/

WiKi:

http://wiki.worldwindcentral.com/

Forum:

http://worldwind.arc.nasa.gov/forums/index.php

FAQ:

http://worldwind.arc.nasa.gov/forums/index.php?showtopic=148

Email:

Installation

Requirements

  • Windows 2000, XP Home, or XP Professional, Windows 98
  • Intel Pentium 3 1 ghz or AMD Athlon or higher
  • 256 MB of RAM
  • 3D Graphics Card (64 MB+ recommended)
  • DSL / Cable connection or faster (It does “workâ€? on a modem connection.)
  • 2 GB or more of disk space

Download Location

As of the latest date on this document, the current version of WorldWind is 1.2e. You can download the latest version of WorldWind from this location: http://worldwind.arc.nasa.gov/download.html

Installing WorldWind

<< Needs to be filled in >>

The Configuration Files

In the NASA folder there is a folder called “Configuration� in there is where you will fine all the settings for World Wind. These files are in XML format but can be edited by using notepad. The configuration files are as follows: wms_server_list.xml WorldWind.exe.config WorldLayers.xml Each configuration file controls a different aspect of World Wind. wms_server_list.xml – Defines the servers that you download the Animated Earth Visualization data and the GLOBE Visualization data. WorldWind.exe.config in the main WorldWind directory lets you set cache size and directory using:

<add key="CacheDirectory" value="D:\NASA\CACHE"></add> and 

<add key="CacheSizeMegabytes" value="2000"></add> WorldLayers.xml – The meat of the configurations. Controls the settings of World Wind that are not in the other two configuration files.

Startup / Using

Starting WorldWind and General Controls

To start World Wind, click on the desktop icon that looks like this:

This will launch the application and you will see a start screen. Note: some users have reported it locking up at this point. And some have gotten past this lockup by pressing Alt+F4. It stops the boot screen but not World Wind itself.

Once World Wind is loaded, you will see the default Blue Marble view of the Earth.


Now for the commands to use World Wind. You can use your mouse or keyboard to control World Wind's views.


Mouse Commands:

Left Mouse Button = Hold this button down and move the mouse to rotate the earth to the right or left, top or bottom.

Right Mouse Button = Hold and drag your mouse to tilt the earth to see the 3D views of an area that has SRTM data. You will not really notice this function till you zoom in closer to a point on the earth.

Both Mouse Buttons = Zoom in and out of the Earth.

Scroll Wheel = Use this to zoom in and out of the Earth.

Keyboard Commands:


To use the keyboard commands, look at the file called “keychart� in your World Wind root directory. Toolbars and Menus: Worldwind has one row of menu choices and a toolbar of quick access features. The file menu choices are “File�, “View�, “Tools� and “Help�. Menus: File Save Screen Shot - Saves a screen shot of your current view of the world in WorldWind Exit – Exits WorldWind

Edit Copy Coordinates - Copies this string, worldwind://goto/world=Earth&lat=64.21778&lon=24.72139&view=0.18390, to the clipboard. I can be used as a URL in an HTML document. Clicking the link will open WorldWind and load the Lat/Lon and Altitude for that location. Paste Coordinates

View (Has some of the same choices as the Toolbar) Show Toolbar – Turns the toolbar on and of Show Lat/Lon Lines – Turns the Lat/Long grid on or off Lat/Lon Line Color – Sets the color of the Lat/Lon lines Show Planet Axis – Turn the axis line (show the poles) of the earth on or off Show Cross Hairs – Targeting cross hairs that show the center of your view Show Position – Turn on the display of the Lat/Lon lines, Heading and Altitude Motion Momentum – When enabled, when you move the Earth with the mose it will keep moving in that direction and speed Point Go-To – When enables, where you click on the globe, the view will rotate to that point so that it is the center of your view. Vertical Exaggeration - Always On Top - Fullscreen

Tools (Like View as the Toolbar choices) Layer Manager – Opens the Layers so that you can enable and disable layers in WorldWind WMS Browser – Loads WMS SVS – Loads the Animated Earth Rapid Fire MODIS – Loads the MODIS interface Place Finder – Loads the WorldWind search function

Help Keychart - Loads the keychart image Website – Loads the WorldWind website About – About WorldWind Useful Sites – A listing of WorldWind related sites

Toolbar: The toolbar is a quick link resource to the most commonly used WorldWind layers. It can be turned on or off via the Tools > Show Toolbar menu choice. The toolbar looks like the one pictured below. It can differ if extra Add-Ons have been added to WorldWind.


Navigating in WorldWind

Accessing Data Views

There are several different types of data views to World Wind, you read bout them in section 1 of this documentation. The most commonly used icons are located on the tool bar of world wind.

Blue Marble


Blue Marble is what loads by default in WorldWind. It is 4km to 1km resolution images of Earth. Once you are zoomed in past the 1km resolution of the earth, the LandSat7 Layers then start to load. Blue Marble Imagery is show down to an altitude of 780,000 meters.


Appendix

About LandSat7 data

It is incredible that it is as good as that. Landsat7 only gets one chance every 16 days, at about 10AM, to cover any given area. If there are clouds, fog, smog, snow on the ground (too white), too much grass on the ground (too green), too low or too high sun angle (low contrast), satellite maintenance, solar storm ..., that chance is lost. A few bad takes in a row, and a whole year is lost. A scene is 160x180KM, and a perfect scene has to have perfect conditions for the whole area.

Landsat7 was launched in 1999 and now it has some data quality problems. No replacement/equivalent satellite is planned, at least not a inexpensive, US funded one!

This dataset (GeoCover 2000) and mosaic (WMS Global Mosaic) will be the best available global images for quite a while, and the fact that they are free and available on the net makes them even more significant.

LandSat7 resolution is 10 meters per pixel


NASA OPEN SOURCE AGREEMENT VERSION 1.3

THIS OPEN SOURCE AGREEMENT (“AGREEMENT�) DEFINES THE RIGHTS OF USE, REPRODUCTION, DISTRIBUTION, MODIFICATION AND REDISTRIBUTION OF CERTAIN COMPUTER SOFTWARE ORIGINALLY RELEASED BY THE UNITED STATES GOVERNMENT AS REPRESENTED BY THE GOVERNMENT AGENCY LISTED BELOW ("GOVERNMENT AGENCY").  THE UNITED STATES GOVERNMENT, AS REPRESENTED BY GOVERNMENT AGENCY, IS AN INTENDED THIRD-PARTY BENEFICIARY OF ALL SUBSEQUENT DISTRIBUTIONS OR REDISTRIBUTIONS OF THE SUBJECT SOFTWARE.  ANYONE WHO USES, REPRODUCES, DISTRIBUTES, MODIFIES OR REDISTRIBUTES THE SUBJECT SOFTWARE, AS DEFINED HEREIN, OR ANY PART THEREOF, IS, BY THAT ACTION, ACCEPTING IN FULL THE RESPONSIBILITIES AND OBLIGATIONS CONTAINED IN THIS AGREEMENT. 

Government Agency: _____________________________________ 
Government Agency Original Software Designation: ______________
Government Agency Original Software Title: ____________________
User Registration Requested.  Please Visit http://__________________
Government Agency Point of Contact for Original Software: ___________________
________________________________________________


1.	DEFINITIONS

A.	“Contributor� means Government Agency, as the developer of the Original Software, and any entity that makes a Modification.
B.	“Covered Patents� mean patent claims licensable by a Contributor that are necessarily infringed by the use or sale of its Modification alone or when combined with the Subject Software.
C.	 “Display� means the showing of a copy of the Subject Software, either directly or by means of an image, or any other device.
D.	“Distribution� means conveyance or transfer of the Subject Software, regardless of means, to another.
E.	 “Larger Work� means computer software that combines Subject Software, or portions thereof, with software separate from the Subject Software that is not governed by the terms of this Agreement.
F.	 “Modification� means any alteration of, including addition to or deletion from, the substance or structure of either the Original Software or Subject Software, and includes derivative works, as that term is defined in the Copyright Statute, 17 USC 101.  However, the act of including Subject Software as part of a Larger Work does not in and of itself constitute a Modification.
G.	“Original Software� means the computer software first released under this Agreement by Government Agency with Government Agency designation ______________ and entitled _____________________________________________, including source code, object code and accompanying documentation, if any.
H.	“Recipient� means anyone who acquires the Subject Software under this Agreement, including all Contributors.
I.	“Redistribution� means Distribution of the Subject Software after a Modification has been made.
J.	“Reproduction� means the making of a counterpart, image or copy of the Subject Software.
K.	“Sale� means the exchange of the Subject Software for money or equivalent value.
L.	“Subject Software� means the Original Software, Modifications, or any respective parts thereof.
M.	“Use� means the application or employment of the Subject Software for any purpose.

2.	GRANT OF RIGHTS

A.	Under Non-Patent Rights:  Subject to the terms and conditions of this Agreement, each Contributor, with respect to its own contribution to the Subject Software, hereby grants to each Recipient a non-exclusive, world-wide, royalty-free license to engage in the following activities pertaining to the Subject Software:

1.	Use
2.	Distribution
3.	Reproduction
4.	Modification
5.	Redistribution
6.	Display

B.	Under Patent Rights:  Subject to the terms and conditions of this Agreement, each Contributor, with respect to its own contribution to the Subject Software, hereby grants to each Recipient under Covered Patents a non-exclusive, world-wide, royalty-free license to engage in the following activities pertaining to the Subject Software:

1.	Use
2.	Distribution
3.	Reproduction
4.	Sale
5.	Offer for Sale

C.	The rights granted under Paragraph B. also apply to the combination of a Contributor’s Modification and the Subject Software if, at the time the Modification is added by the Contributor, the addition of such Modification causes the combination to be covered by the Covered Patents.  It does not apply to any other combinations that include a Modification.

D.	The rights granted in Paragraphs A. and B. allow the Recipient to sublicense those same rights.  Such sublicense must be under the same terms and conditions of this Agreement.

3.	OBLIGATIONS OF RECIPIENT

A.	Distribution or Redistribution of the Subject Software must be made under this Agreement except for additions covered under paragraph 3H.

1.	Whenever a Recipient distributes or redistributes the Subject Software, a copy of this Agreement must be included with each copy of the Subject Software; and
2.	If Recipient distributes or redistributes the Subject Software in any form other than source code, Recipient must also make the source code freely available, and must provide with each copy of the Subject Software information on how to obtain the source code in a reasonable manner on or through a medium customarily used for software exchange.

B.	Each Recipient must ensure that the following copyright notice appears prominently in the Subject Software:

[Government Agency will insert the applicable copyright notice in each agreement accompanying the initial distribution of original software and remove this bracketed language.]

[The following copyright notice will be used if created by a contractor pursuant to Government Agency contract and rights obtained from creator by assignment.  Government Agency will insert the year and its Agency designation and remove the bracketed language.]  Copyright „ {YEAR} United States Government as represented by ______
_________________________.  All Rights Reserved.

[The following copyright notice will be used if created by civil servants only. Government Agency will insert the year and its Agency designation and remove the bracketed language.]  Copyright � {YEAR} United States Government as represented by _____________
_____________________________.  No copyright is claimed in the United States under Title 17, U.S.Code. All Other Rights Reserved.

C.	Each Contributor must characterize its alteration of the Subject Software as a Modification and must identify itself as the originator of its Modification in a manner that reasonably allows subsequent Recipients to identify the originator of the Modification.  In fulfillment of these requirements, Contributor must include a file (e.g., a change log file) that describes the alterations made and the date of the alterations, identifies Contributor as originator of the alterations, and consents to characterization of the alterations as a Modification, for example, by including a statement that the Modification is derived, directly or indirectly, from Original Software provided by Government Agency. Once consent is granted, it may not thereafter be revoked.

D.	A Contributor may add its own copyright notice to the Subject Software.  Once a copyright notice has been added to the Subject Software, a Recipient may not remove it without the express permission of the Contributor who added the notice.

E.	A Recipient may not make any representation in the Subject Software or in any promotional, advertising or other material that may be construed as an endorsement by Government Agency or by any prior Recipient of any product or service provided by Recipient, or that may seek to obtain commercial advantage by the fact of Government Agency's or a prior Recipient’s participation in this Agreement.  

F.	In an effort to track usage and maintain accurate records of the Subject Software, each Recipient, upon receipt of the Subject Software, is requested to register with Government Agency by visiting the following website: ______________________________.  Recipient’s name and personal information shall be used for statistical purposes only. Once a Recipient makes a Modification available, it is requested that the Recipient inform Government Agency at the web site provided above how to access the Modification.

[Alternative paragraph for use when a web site for release and monitoring of subject software will not be supported by releasing Government Agency]  In an effort to track usage and maintain accurate records of the Subject Software, each Recipient, upon receipt of the Subject Software, is requested to provide Government Agency, by e-mail to the Government Agency Point of Contact listed in clause 5.F., the following information: ______________________________.  Recipient’s name and personal information shall be used for statistical purposes only. Once a Recipient makes a Modification available, it is requested that the Recipient inform Government Agency, by e-mail to the Government Agency Point of Contact listed in clause 5.F., how to access the Modification.

G.	Each Contributor represents that that its Modification is believed to be Contributor’s original creation and does not violate any existing agreements, regulations, statutes or rules, and further that Contributor has sufficient rights to grant the rights conveyed by this Agreement.

H.	A Recipient may choose to offer, and to charge a fee for, warranty, support, indemnity and/or liability obligations to one or more other Recipients of the Subject Software.  A Recipient may do so, however, only on its own behalf and not on behalf of Government Agency or any other Recipient.  Such a Recipient must make it absolutely clear that any such warranty, support, indemnity and/or liability obligation is offered by that Recipient alone.  Further, such Recipient agrees to indemnify Government Agency and every other Recipient for any liability incurred by them as a result of warranty, support, indemnity and/or liability offered by such Recipient.

I.	A Recipient may create a Larger Work by combining Subject Software with separate software not governed by the terms of this agreement and distribute the Larger Work as a single product. In such case, the Recipient must make sure Subject Software, or portions thereof, included in the Larger Work is subject to this Agreement.

J.	Notwithstanding any provisions contained herein, Recipient is hereby put on notice that export of any goods or technical data from the United States may require some form of export license from the U.S. Government.  Failure to obtain necessary export licenses may result in criminal liability under U.S. laws.  Government Agency neither represents that a license shall not be required nor that, if required, it shall be issued.  Nothing granted herein provides any such export license. 

4.	DISCLAIMER OF WARRANTIES AND LIABILITIES; WAIVER AND INDEMNIFICATION

A.	No Warranty: THE SUBJECT SOFTWARE IS PROVIDED “AS IS� WITHOUT ANY WARRANTY OF ANY KIND, EITHER EXPRESSED, IMPLIED, OR STATUTORY, INCLUDING, BUT NOT LIMITED TO, ANY WARRANTY THAT THE SUBJECT SOFTWARE WILL CONFORM TO SPECIFICATIONS, ANY IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, OR FREEDOM FROM INFRINGEMENT, ANY WARRANTY THAT THE SUBJECT SOFTWARE WILL BE ERROR FREE, OR ANY WARRANTY THAT DOCUMENTATION, IF PROVIDED, WILL CONFORM TO THE SUBJECT SOFTWARE. THIS AGREEMENT DOES NOT, IN ANY MANNER, CONSTITUTE AN ENDORSEMENT BY GOVERNMENT AGENCY OR ANY PRIOR RECIPIENT OF ANY RESULTS, RESULTING DESIGNS, HARDWARE, SOFTWARE PRODUCTS OR ANY OTHER APPLICATIONS RESULTING FROM USE OF THE SUBJECT SOFTWARE.  FURTHER, GOVERNMENT AGENCY DISCLAIMS ALL WARRANTIES AND LIABILITIES REGARDING THIRD-PARTY SOFTWARE, IF PRESENT IN THE ORIGINAL SOFTWARE, AND DISTRIBUTES IT “AS IS.�

B.	Waiver and Indemnity:  RECIPIENT AGREES TO WAIVE ANY AND ALL CLAIMS AGAINST THE UNITED STATES GOVERNMENT, ITS CONTRACTORS AND SUBCONTRACTORS, AS WELL AS ANY PRIOR RECIPIENT.  IF RECIPIENT'S USE OF THE SUBJECT SOFTWARE RESULTS IN ANY LIABILITIES, DEMANDS, DAMAGES, EXPENSES OR LOSSES ARISING FROM SUCH USE, INCLUDING ANY DAMAGES FROM PRODUCTS BASED ON, OR RESULTING FROM, RECIPIENT'S USE OF THE SUBJECT SOFTWARE, RECIPIENT SHALL INDEMNIFY AND HOLD HARMLESS THE UNITED STATES GOVERNMENT, ITS CONTRACTORS AND SUBCONTRACTORS, AS WELL AS ANY PRIOR RECIPIENT, TO THE EXTENT PERMITTED BY LAW.  RECIPIENT'S SOLE REMEDY FOR ANY SUCH MATTER SHALL BE THE IMMEDIATE, UNILATERAL TERMINATION OF THIS AGREEMENT.


5.	GENERAL TERMS

A.	Termination:  This Agreement and the rights granted hereunder will terminate automatically if a Recipient fails to comply with these terms and conditions, and fails to cure such noncompliance within thirty (30) days of becoming aware of such noncompliance.  Upon termination, a Recipient agrees to immediately cease use and distribution of the Subject Software.  All sublicenses to the Subject Software properly granted by the breaching Recipient shall survive any such termination of this Agreement.

B.	Severability:  If any provision of this Agreement is invalid or unenforceable under applicable law, it shall not affect the validity or enforceability of the remainder of the terms of this Agreement.  

C.	Applicable Law:  This Agreement shall be subject to United States federal law only for all purposes, including, but not limited to, determining the validity of this Agreement, the meaning of its provisions and the rights, obligations and remedies of the parties.

D.	Entire Understanding:  This Agreement constitutes the entire understanding and agreement of the parties relating to release of the Subject Software and may not be superseded, modified or amended except by further written agreement duly executed by the parties.

E.	Binding Authority:  By accepting and using the Subject Software under this Agreement, a Recipient affirms its authority to bind the Recipient to all terms and conditions of this Agreement and that that Recipient hereby agrees to all terms and conditions herein.

F.	Point of Contact:  Any Recipient contact with Government Agency is to be directed to the designated representative as follows.
Personal tools