Skip to content

geeup: Simple CLI for Earth Engine Uploads

Compare
Choose a tag to compare
@samapriya samapriya released this 16 Aug 03:09
· 182 commits to master since this release

This came of the simple need to handle batch uploads of both image assets to collections but also thanks to the new table feature the possibility of batch uploading shapefiles into a folder. Though a lot of these tools including batch image uploader is part of my other project geeadd which also includes additional features to add to the python CLI, this tool was designed to be minimal so as to allow the user to simply query their quota, upload images or tables and also to query ongoing tasks and delete assets. I am hoping this tool with a simple objective proves useful to a few users of Google Earth Engine.

This also needs earthengine cli to be installed and authenticated on your system and earthengine to be callable in your command line or terminal

To install geeup: Simple CLI for Earth Engine Uploads you can install using two methods

pip install geeup

or you can also try

git clone https://github.com/samapriya/geeup.git
cd geeup
python setup.py install

For linux use --user flag it there are issues

pip install geeup --user
usage: geeup.py [-h]
                {update,quota,zipshape,upload,selupload,seltabup,tasks,delete}
                ...

Simple Client for Earth Engine Uploads with Selenium Support

positional arguments:
  {update,quota,zipshape,upload,selupload,seltabup,tasks,delete}
    update              Updates Selenium drivers for firefox [windows or linux
                        systems]
    quota               Print Earth Engine total quota and used quota
    zipshape            Zips all shapefiles and subsidary files into
                        individual zip files
    getmeta             Generates generalized metadata for all rasters in folder
    upload              Batch Asset Uploader using Selenium
    seltabup            Batch Table Uploader using Selenium.
    selsetup            Non headless setup for new google account, use if upload
                        throws errors
    tasks               Queries current task status
                        [completed,running,ready,failed,cancelled]
    delete              Deletes collection and all items inside. Supports
                        Unix-like wildcards.

optional arguments:
  -h, --help            show this help message and exit

Changelog

v0.2.5

  • Now allows for downloading geckodriver for macos Fix to Issue 10
  • Now includes a metadata tool to generate a generalized metadata for any raster to allow upload.
    Fix to Issue 7
  • Changed from geeup update to init to signify initialization
  • Added selsetup this tool allows for setting up the gecko driver with your account incase there are issues uploading
  • Better error handling for selenium driver download

v0.2.2

  • Can now handle generalized metadata (metadata is now required field)
  • Fixed issues with table upload
  • Overall code optimization and handle streaming upload

v0.1.9

  • Changes to handle PyDL installation for Py2 and Py3
  • Removed Planet uploader to make tool more generalized