DataInstallUtil is a collection of utility methods for common data import tasks.
Illustrates how to import elevation data into WorldWind.
Illustrates how to import imagery into WorldWind.
Shows how to install a collection of DTED data.
Displays UI components for a set of caller specified installed data, and manages creation of WorldWind components from that data.
Illustrates how to install elevation data into a WorldWind
Illustrates how to install imagery into a WorldWind
Illustrates a simple application that installs imagery and elevation data for use in WorldWind.
This package contains examples that show how to import imagery and elevation data and how to use it to create layers, renderables and elevation models. Since this type of data is typically in the form of a raster, WorldWind calls it raster data. WorldWind can import many formats of raster data, including but not limited to JPEG, JPEG-2000, PNG, and DTED, and GeoTIFF for both imagery and elevations. Data can be imported from a local or network disk, or in many cases directly from a network URL. This overview describes the import process and identifies example programs showing exactly how import is done.
Note that WorldWind can also draw data incrementally from web services such as WMS and WFS, but this overview covers only importing bulk data from files or streams.
When importing data, WorldWind reprojects it to the WGS-84 datum and latitude, longitude coordinates, which is WorldWind's internal coordinate reference system (also known as EPSG:4326).
In addition to some internal importer classes, WorldWind uses
ImageIO and the open-source
GDAL library to read and potentially reproject data on import. This enables WorldWind to import a very wide range
of image formats and projection types. It also makes it possible to import very large data sets composed of many
Here is a list of the most commonly used formats supported, see
gov.nasa.worldwind.data for the full
Raster data can be imported for just the current session or installed for permanent availability.
Installing data adds it to a permanent location on the local computer. It's installed in a way that facilitates rapid access by WorldWind. Unlike the WorldWind cache, installed data is never automatically deleted. Applications may specify the installation location, but by default the location is:
These locations are peers to the WorldWind cache directory.
Installed imagery is typically displayed as a
TiledImageLayer. Elevation data is
typically used to create an
ElevationModel. As these classes run, they
automatically create sub-regions and reduced resolution versions of the data in order to optimize performance. This
information is saved permanently in the installed-data location. Depending on the size and complexity of the data,
WorldWind may also create one or two levels of reduced resolution data during installation.
When installing data, the source data can be copied to the installed-data directory or left in its original
location. If the data is not copied, it's of course necessary that it be available and accessible in the original
location when subsequently needed. The data location is captured in a configuration file stored in the
installed-data directory for the particular data set. The examples
InstallElevations shows how to use this file to create a layer and an
elevation model, respectively.
InstallImagery shows how to install imagery and use it to
TiledImageLayer. The example
InstallElevations shows how to install elevations and use them to create an
elevation model. Both classes are heavily commented to describe their operation.
It's often the case that data is needed only during a current session. In this case the data should be imported but
not installed. The
ImportElevations examples show how to import data and use it to create a
SurfaceImage for imagery and an
See the package description of
gov.nasa.worldwind.data for data import deployment instructions, including
deployment with Java Web Start.