Skip to content

Interactively browse global, full-resolution satellite imagery

License

Notifications You must be signed in to change notification settings

tgunnoe/worldview

 
 

Repository files navigation

Build Status

Visit Worldview at https://worldview.earthdata.nasa.gov

About

This tool from NASA's EOSDIS provides the capability to interactively browse global, full-resolution satellite imagery and then download the underlying data. Most of the 200+ available products are updated within three hours of observation, essentially showing the entire Earth as it looks "right now". This supports time-critical application areas such as wildfire management, air quality measurements, and flood monitoring. Arctic and Antarctic views of several products are also available for a "full globe" perspective. Browsing on tablet and smartphone devices is generally supported for mobile access to the imagery.

Worldview uses the Global Imagery Browse Services (GIBS) to rapidly retrieve its imagery for an interactive browsing experience. While Worldview uses OpenLayers as its mapping library, GIBS imagery can also be accessed from Google Earth, NASA World Wind, and several other clients. We encourage interested developers to build their own clients or integrate NASA imagery into their existing ones using these services.

Installation

These instructions install a development version of Worldview using Node.js to serve the app locally. If you prefer to use Apache, follow the directions in Setup Using Apache.

Note: This has been demonstrated to work on Windows 7 and 10 (as tested with mingw-w64), Mac OS X, and Ubuntu.

Prerequisites:

  • Node.js
    • Note to Ubuntu users: After installing Node.js, ensure that it is available as node on the command line. If not, see here for more information.
    • A later version of Node (>v6) is required and is not available on some distributions. To make sure you have a later version, visit the Node download page
  • Windows users:
    • Git Bash, mingw-w64 bash, or a similar shell must be used in order to run bash commands.
    • .NET Framework 2.0 or Visual Studio 2005 or newer installed with Visual C++ compilers.
      It is HIGHLY recommended you install the Windows Build Tools npm package to ensure the correct compilers have been installed.
      To install this package:
    # run in administrator privileged command prompt window
    npm install --global --production windows-build-tools
    
    • Python 2.7.x (included with Windows Build Tools)
    • Python path added to Windows environmental variables (to use within cmd.exe and powershell)
      To add environmental variables:
      • Right-click the Windows icon in bottom-left corner of the screen.
      • Click System, click Advanced System Settings, click Environmental Variables.
      • Highlight the Path row and click edit.
      • Each path is seperated with a semicolon ";"
      • Add your python directory path here.*
        *Windows Build Tools includes python, the included python path is:
        %USERPROFILE%\.windows-build-tools\python27
        Otherwise the path is most likely: C:\Python27

Clone this repository:

git clone https://github.com/nasa-gibs/worldview.git
cd worldview

Select one of the following configuration repositories:

# Official EOSDIS configurations
git clone https://github.com/nasa-gibs/worldview-options-eosdis.git options

# Or a blank repository with only Corrected Reflectance and no branding
git clone https://github.com/nasa-gibs/worldview-options-template.git options

Install dependencies (NOTE for Windows users: omit the "sudo" part of the following commands as it isn't available):

# install local version of grunt
sudo npm install --global grunt-cli
# install virtualenv to keep additional libraries installed in a local directory:
sudo easy_install virtualenv==1.10.1

Run local node server:

npm install
grunt
npm start

Worldview should be available at

http://localhost:3000

A node server will continue running until you end the session. You can end the session by pressing control-C

Other Information

Contributing

See CONTRIBUTING.md.

License

This code was originally developed at NASA/Goddard Space Flight Center for the Earth Science Data and Information System (ESDIS) project.

Copyright © 2013 - 2017 United States Government as represented by the Administrator of the National Aeronautics and Space Administration. All Rights Reserved.

Licensed under the NASA Open Source Agreement, Version 1.3.

Contact

Contact us by sending an email to support@earthdata.nasa.gov

About

Interactively browse global, full-resolution satellite imagery

Resources

License

Contributing

Stars

Watchers

Forks

Packages

No packages published

Languages

  • JavaScript 89.7%
  • CSS 7.7%
  • HTML 1.4%
  • Other 1.2%