gbdxtools4j is a package for ordering imagery and launching workflows on DigitalGlobe's GBDX platform.
In order to use gbdxtools4j, you need GBDX credentials. Email GBDX-Support@digitalglobe.com to get these.
Example scripts can be found under the src/test/java directory of this repo.
See the license file for license rights and limitations (MIT).
IMPORTANT SAFTEY NOTE: gbdxtools4j is very much in development right now. There is much more work to do but this is a start at getting a Java version of the excellent gbdxtools for the Python world.
gbdxtools4j requires Java 7. Maven 3 is also a prerequsite. Once you have that installed you can build gbdxtools4j.
Clone this repository and do a
mvn clean install
Keep in mind that the master branch is constantly under development.
gbdxtools4j can read a configuration file in your home directory to help with authentication to the GBDX system. The file is named ".gbdx-config". It is a very simple INI style file that looks like:
[gbdx] user_name = <your GBDX user name> user_password = <your GBDX password>
All of these values come from the GBDX web application.
If the configuration file does not exist then the parameters can also come from
the operating system environment (i.e. setenv
) and/or from Java system
parameters (i.e. -D parameters on the Java command line). Even if the file exists
the parameters in it can be overridden on the command line or with environment variables.
The priority is system property, then environment variable and then the configuration file.
brew install gpg
gpg --list-keys
ln -s ./gpg /usr/local/bin/gpg2
export GPG_TTY=$(tty)
Use existing sonatype/ nexus repository credentials in settings.xml or have new ones created and attached to the com.digitalglobe.gbdx.tools repository.
Fix github url in release.properties, scm.url=scm:git:https://github.com/digitalglobe/gbdxtools4j.git
mvn release:prepare
mvn release:perform
Promote release https://oss.sonatype.org/index.html#stagingRepositories close release