This tool 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.
-If you find this tool useful, star and cite it as below
Samapriya Roy. (2019, May 9). samapriya/geeup: geeup: Simple CLI for Earth Engine Uploads (Version 0.1.9). Zenodo.
http://doi.org/10.5281/zenodo.2678142
This assumes that you have native python & pip installed in your system, you can test this by going to the terminal (or windows command prompt) and trying
python and then pip list
If you get no errors and you have python 2.7.14 or higher you should be good to go. Please note that I have tested this only on python 2.7.15, but it should run on Python 3.
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 sudo or try pip install geeup --user.
Installation is an optional step; the application can also be run directly by executing geeup.py script. The advantage of having it installed is that geeup can be executed as any command line tool. I recommend installation within a virtual environment. If you don't want to install, browse into the geeup folder and try python geeup.py to get to the same result.
As usual, to print help:
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
upload Batch Asset Uploader using Selenium
seltabup Batch Table Uploader using Selenium.
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
To obtain help for specific functionality, simply call it with help switch, e.g.: geeup zipshape -h. If you didn't install geeup, then you can run it just by going to geeup directory and running python geeup.py [arguments go here]
The tool is designed to handle batch uploading of images and tables(shapefiles). While there are image collection where you can batch upload imagery, for vector or shapefiles you have to batch upload them to a folder.
This is a key step since all upload function depends on this step, so make sure you run this. This downloads selenium driver and places to your local directory for windows and Linux subsystems. This is the first step to use selenium supported upload.
geeup update
Just a simple tool to print your earth engine quota quickly.
usage: geeup quota [-h]
optional arguments:
-h, --help show this help message and exit
So here's how table upload in Google Earth Engine works, you can either upload the component files shp, shx, prj and dbf or you can zip these files together and upload it as a single file. The pros for this is that it reduces the overall size of the shapefile after zipping them along, this tool looks for the shp file and finds the subsidiary files and zips them ready for upload. It also helps when you have limited upload bandwidth. Cons you have to create a replicate structure of the file system, but it saves on bandwidth and auto-arranges your files so you don't have to look for each additional file.
usage: geeup zipshape [-h] --input INPUT --output OUTPUT
optional arguments:
-h, --help show this help message and exit
Required named arguments.:
--input INPUT Path to the input directory with all shape files
--output OUTPUT Destination folder Full path where shp, shx, prj and dbf
files if present in input will be zipped and stored
The script creates an Image Collection from GeoTIFFs in your local directory. By default, the image name in the collection is the same as the local directory name; with the optional parameter you can provide a different name.
usage: geeup upload [-h] --source SOURCE --dest DEST [-m METADATA]
[--large] [--nodata NODATA] [--bands BANDS] [-u USER]
[-b BUCKET]
optional arguments:
-h, --help show this help message and exit
Required named arguments.:
--source SOURCE Path to the directory with images for upload.
--dest DEST Destination. Full path for upload to Google Earth
Engine, e.g. users/pinkiepie/myponycollection
-u USER, --user USER Google account name (gmail address).
Optional named arguments:
-m METADATA, --metadata METADATA
Path to CSV with metadata.
--large (Advanced) Use multipart upload. Might help if upload
of large files is failing on some systems. Might cause
other issues.
--nodata NODATA The value to burn into the raster as NoData (missing
data)
--bands BANDS Comma-separated list of names to use for the image
bands. Spaces or other special characters are not
allowed.
-b BUCKET, --bucket BUCKET
Google Cloud Storage bucket name.
This tool allows you to batch download tables/shapefiles to a folder. It uses a modified version of the image upload and a wrapper around the earthengine upload cli to achieve this while creating folders if they don't exist and reporting on assets and checking on uploads. This only requires a source, destination and your ee authenticated email address. This tool also uses selenium to upload the tables.
usage: geeup.py seltabup [-h] --source SOURCE --dest DEST [-u USER]
optional arguments:
-h, --help show this help message and exit
Required named arguments.:
--source SOURCE Path to the directory with zipped folder for upload.
--dest DEST Destination. Full path for upload to Google Earth
Engine, e.g. users/pinkiepie/myponycollection
-u USER, --user USER Google account name (gmail address).
This script counts all currently running, ready, completed, failed and canceled tasks along with failed tasks. This tool is linked to your google earth engine account with which you initialized the earth engine client. This takes no argument.
usage: geeup tasks [-h]
optional arguments:
-h, --help show this help message and exit
The delete is recursive, meaning it will also delete all children assets: images, collections, and folders. Use with caution!
usage: geeup delete [-h] id
positional arguments:
id Full path to asset for deletion. Recursively removes all
folders, collections and images.
optional arguments:
-h, --help show this help message and exit
- Changes to handle PyDL installation for Py2 and Py3
- Removed Planet uploader to make tool more generalized
- Multipart encoder using requests toolbelt for streaming upload
- Changed manifest upload methodology to match changes in earthengine-api
- Fixed issue with module locations
- Fixed issue with gecko driver paths
- Fixed issue with null uploads using task, switched to ee CLI upload
- OS based geckdriver path fix
- General improvements
- fixed issues with extra arguments
- Upload issue resolved
- General dependency
- fixed dependency issues
- Upload post issues resolved
- Removed dependency on poster for now
- fixed attribution and dependecy issues
- Included poster to improve streaming uploads
- All uploads now use selenium
- fixed issues with unused imports
- fixed issues with manifest lib
- Detailed quota readout
- Uses selenium based uploader to upload images
- Avoids issues with python auth for upload
- Removed unnecessary library imports
- Minor improvements and updated readme
- Improved valid table name check before upload
- Improvements to earth engine quota tool for more accurate quota and human readable