geeviz 2020.9.1

A package to help with GEE data processing, analysis, and visualization

#GTAC GEE Visualization Python Modules

A repository of GEE Python code modules for general data processing, analysis, and visualization

Can be accessed in GitHub Or within the internal Forest Service GitHub instance Or within the GEE Community Repository

A javaScript equivalent can be accessed in the GEE Playground on GitHub Or withing the Forest Service GitHub instance

Primary POCs

Ian Housman- [e-mail]

Leah Campbell- [e-mail]

Bonnie Ruefenacht- [e-mail]

Installing

1. Become a trusted Google Earth Engine (GEE) tester (https://signup.earthengine.google.com/#!/)

2. Install package using pip (pip install geeViz) folder

3. Authenticate using the GEE cli in a cmd prompt (earthengine authenticate)

4. You can also install with git. If installing this way, first install the Python GEE package (pip install earthengine-api)

5. Then clone this repository (git clone https://github.com/rcr-usfs/geeViz) into your Python's site-packages

6. To stay up to date, pull the latest commit (git pull origin master)

7. This repository is also available within the FS gitHub instance (https://code.fs.usda.gov/forest-service/geeViz)

   • To add this instance to your local git instance execute remote add https://code.fs.usda.gov/forest-service/geeViz in a git bash
   • Now you can pull the latest from your origin (git pull origin master) or github (git pull github master)

Using

• Several examples are available within the examples module to help you get started. To test, enter the following command within the Python build you installed geeViz in:

  • from geeViz.examples import geeViewExample

• Other examples are:

  • from geeViz.examples import getLandsatWrapper
  • from geeViz.examples import getSentinel2Wrapper
  • from geeViz.examples import harmonicRegressionWrapper
  • from geeViz.examples import LANDTRENDRWrapper
  • from geeViz.examples import CCDCViz

• When these examples are run, a viewer should open in your default browser. It will show any data that was added to the map.

• Layers can be toggled on/off and opacity changed. They can also be measured and queried under the TOOLS pane.

Contributing

1. If contributing, contact a POC
2. Install git locally (https://git-scm.com/download/win)
3. Make sure you have the latest commit (git pull origin master)
4. Create and checkout a new branch (`git checkout -b branchName')
5. Make your changes
6. Add your changes (git add .)
7. Commit your changes (git commit -m 'Add some fooBar')
8. Push to the branch (git push origin branchName)