Google Earth Engine Batch Assets Manager with Addons
Project description
Google Earth Engine Batch Asset Manager with Addons
Google Earth Engine Batch Asset Manager with Addons is an extension of the one developed by Lukasz here and additional tools were added to include functionality for moving assets, conversion of objects to fusion table, cleaning folders, querying tasks. The ambition is apart from helping user with batch actions on assets along with interacting and extending capabilities of existing GEE CLI. It is developed case by case basis to include more features in the future as it becomes available or as need arises.
If you use this tool to download data for your research, and find this tool useful, star and cite it as below
Samapriya Roy. (2021, March 15). samapriya/gee_asset_manager_addon: GEE Asset Manager with Addons (Version 0.5.4).
Zenodo. http://doi.org/10.5281/zenodo.4604084
Table of contents
Click to Read the Online Docs Here
Installation
We assume Earth Engine Python API is installed and EE authorised as desribed here. From v0.3.4 onwards geeadd will only run on Python 3. Also with the new changes to the Earth Engine API library, the tool was completely modified to work with earthengine-api v0.1.127 and higher. Authenticate your earth engine client by using the following in your command line or terminal setup.
earthengine authenticate
Quick installation pip install geeadd or pip install geeadd --user
To install using github:
git clone https://github.com/samapriya/gee_asset_manager_addon
cd gee_asset_manager_addon && pip install -r requirements.txt
python setup.py install
The advantage of having it installed is being able to execute geeadd as any command line tool. I recommend installation within virtual environment. To install run
python setup.py develop or python setup.py install
In a linux distribution
sudo python setup.py develop or sudo python setup.py install
Getting started
As usual, to print help:
To obtain help for a specific functionality, simply call it with help switch, e.g.: geeadd copy -h.
Usage examples
readme
Now open the readme webpage in your browser using
geeadd readme
quota
This tool is the very basic of tools in the toolbox which gives you your current quota. This gives you the total used and remaining quota in all your legacy folders or user root folders. It requires no additional arguments just that your earthengine api is enabled. Quota can now also handle Google Earth Engine with Google Cloud Projects enabled so you can pass project path as an argument.
> geeadd quota -h
usage: geeadd quota [-h] [--project PROJECT]
optional arguments:
-h, --help show this help message and exit
Optional named arguments:
--project PROJECT Project Name usually in format projects/project-
name/assets/
search
The search tool was added since v0.3.4 to enable users to search inside the Google Earth Engine catalog for images matching specific keywords and looks for matching images using names, ids , tags and so on. Try for example
geeadd search --keywords "fire"
> geeadd search -h
usage: geeadd search [-h] --keywords KEYWORDS
optional arguments:
-h, --help show this help message and exit
Required named arguments.:
--keywords KEYWORDS Keywords to search for can be id, provider, tag and so
on
The search tool also includes the capability to search within the community datasets catalog since v0.5.4.
geeadd search --keywords ph --source community
App to Script
This tool writes out or prints the underlying earthengine code for any public earthengine app. The tool has an option to export the code into a javascript file that you can then paste into Google Earth Engine code editor.
> geeadd app2script -h
usage: geeadd app2script [-h] --url URL [--outfile OUTFILE]
optional arguments:
-h, --help show this help message and exit
Required named arguments.:
--url URL Earthengine app url
Optional named arguments:
--outfile OUTFILE Write the script out to a .js file: Open in any text
editor
Simple setup can be
geeadd app2script --url "https://gena.users.earthengine.app/view/urban-lights"
or write to a javascript file which you can then open with any text editor and paste in earthengine code editor
geeadd app2script --url "https://gena.users.earthengine.app/view/urban-lights" --outfile "Full path to javascript.js"
Earth Engine Asset Report
This tool recursively goes through all your assets(Includes Images, ImageCollection,Table,) and generates a report containing the following fields [Type,Asset Type, Path,Number of Assets,size(MB),unit,owner,readers,writers]. This tool creates a detailed report and may take sometime to complete.
> geeadd ee_report -h
usage: geeadd ee_report [-h] --outfile OUTFILE
optional arguments:
-h, --help show this help message and exit
Required named arguments.:
--outfile OUTFILE This it the location of your report csv file
A simple setup is the following
geeadd --outfile "C:\johndoe\report.csv"
Asset Size
This tool allows you to query the size of any Earth Engine asset[Images, Image Collections, Tables and Folders] and prints out the number of assets and total asset size in non-byte encoding meaning KB, MB, GB, TB depending on size.
> geeadd assetsize -h
usage: geeadd assetsize [-h] --asset ASSET
optional arguments:
-h, --help show this help message and exit
Required named arguments.:
--asset ASSET Earth Engine Asset for which to get size properties
Task Query
This script counts all currently running, cancelled, pending and failed tasks and requires no arguments.
> geeadd tasks -h
usage: geeadd tasks [-h]
optional arguments:
-h, --help show this help message and exit
Cancel tasks
This is a simple tool to cancel tasks with specific controls. This allows you to cancel all tasks, all running tasks, all ready tasks or just a single task with a task id.
> geeadd cancel -h
usage: geeadd cancel [-h] --tasks TASKS
optional arguments:
-h, --help show this help message and exit
Required named arguments.:
--tasks TASKS You can provide tasks as running or pending or all or even a
single task id
Assets Copy
This script allows us to recursively copy entire folders, collections, images or tables. If you have read acess to assets from another user this will also allow you to copy assets from their assets.
geeadd copy -h
usage: geeadd copy [-h] [--initial INITIAL] [--final FINAL]
optional arguments:
-h, --help show this help message and exit
Required named arguments.:
--initial INITIAL Existing path of assets
--final FINAL New path for assets
Assets Move
This script allows us to recursively move entire folders, collections, images or table from one location to the other.
> geeadd move -h
usage: geeadd move [-h] [--initial INITIAL] [--final FINAL]
optional arguments:
-h, --help show this help message and exit
Required named arguments.:
--initial INITIAL Existing path of assets
--final FINAL New path for assets
Assets Access
This tool allows you to set asset access for either folder , collection or image recursively meaning you can add collection access properties for multiple assets at the same time.
> geeadd access -h
usage: geeadd access [-h] --asset ASSET --user USER --role ROLE
optional arguments:
-h, --help show this help message and exit
Required named arguments.:
--asset ASSET This is the path to the earth engine asset whose permission
you are changing folder/collection/image
--user USER "user:person@example.com" or "group:team@example.com" or
"serviceAccount:account@gserviceaccount.com", try using
"allUsers" to make it public
--role ROLE Choose between reader, writer or delete
Delete
The delete is recursive, meaning it will delete also all children assets: images, collections and folders. Use with caution!
> geeadd delete -h
usage: geeadd delete [-h] --id ID
optional arguments:
-h, --help show this help message and exit
Required named arguments.:
--id ID Full path to asset for deletion. Recursively removes all
folders, collections and images.
Delete metadata
This tool allows you to delete a specific property across a metadata. This is useful to reset any property for an ingested collection.
> geeadd delete_metadata -h
usage: geeadd delete_metadata [-h] --asset ASSET --property PROPERTY
optional arguments:
-h, --help show this help message and exit
Required named arguments.:
--asset ASSET This is the path to the earth engine asset whose
permission you are changing collection/image
--property PROPERTY Metadata name that you want to delete
Changelog
v0.5.5
- added folder migration tools
- improved recursive folder search & copy, move and permissions tools
- major improvements to copy and move tools for better migration of nested Folders
- Minor improvements and cleanup
v0.5.4
- Updated search tool to use updated endpoint
- Search tool no longer downloads zip or parses CSV
- Minor improvements
v0.5.3
- Updated app2script tool to handle change in element
v0.5.2
- Updated copy tool to allow for non mirrored copy
- Updated task and task cancel tools to account for states Pending and Cancelling
v0.5.1
- Updated quota tool to handle GCP projects inside GEE
- Updated Folder size reporting
v0.5.0
- Updated to use earthengine-api>= 0.1.222
- Copy and move tool improvements to facilitate cloud alpha support.
- Updated task check tool to account for operations based handling.
v0.4.9
- Fixed issue 11.
- Updated to recent API calls based on Issue and general improvements
- Added auto version check from pypi.
v0.4.7
- Fixed issue with delete tool and shell call.
- Fixed issue with copy and move function for single collections
v0.4.6
- Now includes asset_url and thumbnail_url for search.
- Formatting and general improvements.
v0.4.5
- Now inclues license in sdist
- Fixed issue with app2script tool and string and text parsing.
- Added readme and version tools.
- Added readme docs and deployed environment.
v0.4.4
- Removed git dependency and used urllib instead based on feedback
- Created conda forge release based on Issue 10
v0.4.2
- Fixed relative import issue for earthengine.
- Fixed image collection move tool to parse ee object type correctly as image_collection.
v0.4.1
- Made enhancement Issue 9.
- Search tool now return earth engine asset snippet and start and end dates as JSON object.
- Removed pretty table dependency.
v0.4.0
- Improved quota tools to get all quota and asset counts.
- Added a search tool to search GEE catalog using keywords.
- Improved parsing for app to script tool.
- Detailed asset root for all root folders and recursively
- Cancel tasks now allows you to choose, running, ready or specific task ids.
- Assets copy and move now allows you to copy entire folders, collectiona and assets recursively
- Updated assets access tool
- Delete metadata allows you to delete metadata for existing collection.
- Overall general improvements and optimization.
v0.3.3
- General improvements
- Added tool to get underlying code from earthengine app
v0.3.1
- Updated list and asset size functions
- Updated function to generate earthengine asset report
- General optimization and improvements to distribution
- Better error handling
v0.3.0
- Removed upload function
- Upload handles by geeup
- General optimization and improvements to distribution
- Better error handling
v0.2.8
- Uses poster for streaming upload more stable with memory issues and large files
- Poster dependency limits use to Py 2.7 will fix in the new version
v0.2.6
- Major improvement to move, batch copy, and task reporting
- Major improvements to access tool to allow users read/write permission to entire Folder/collection.
v0.2.5
- Handles bandnames during upload thanks to Lukasz for original upload code
- Removed manifest option, that can be handled by seperate tool (ppipe)
v0.2.3
- Removing the initialization loop error
v0.2.2
- Added improvement to earthengine authorization
v0.2.1
- Added capability to handle PlanetScope 4Band Surface Reflectance Metadata Type
- General Improvements
v0.2.0
- Tool improvements and enhancements
v0.1.9
- New tool EE_Report was added
v0.1.8
- Fixed issues with install
- Dependencies now part of setup.py
- Updated Parser and general improvements
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.