The SNAP Microwave Toolbox

The project page of SNAP and the sentinel toolboxes can be found at http://step.esa.int. There you will find a tutorial about the usage of the application, a forum where you can ask questions and lots of other interesting things.

Building Microwave Toolbox from the source

1. Download and install the required build tools

   • Install JAVA JDK 21 and set JAVA_HOME accordingly.
   • Install Maven and set MAVEN_HOME accordingly.
   • Install git

2. Add $JAVA_HOME/bin and $MAVEN_HOME/bin to your PATH.

3. Clone the Microwave Toolbox source code and related repositories into SNAP/

   git clone https://github.com/senbox-org/microwave-toolbox.git
   git clone https://github.com/senbox-org/snap-desktop.git
   git clone https://github.com/senbox-org/snap-engine.git
   git clone https://github.com/senbox-org/snap-installer.git
   

4. CD into SNAP/snap-engine:

   mvn clean install

5. CD into SNAP/snap-desktop:

   mvn clean install

6. CD into SNAP/microwave-toolbox

   mvn clean install

7. If unit tests are failing, you can use the following to skip the tests

   mvn clean install -Dmaven.test.skip=true

Setting up IntelliJ IDEA

1. Create an empty project with the SNAP/ directory as project directory

2. Import the pom.xml files of snap-engine, snap-desktop and microwave-toolbox as modules. Ensure not to enable the option 'Create module groups for multi-module Maven projects'. Everything can be default values.

3. Set the used SDK for the main project. A JDK 21 or later is needed.

4. Use the following configuration to run SNAP in the IDE:

   • Main class: org.esa.snap.nbexec.Launcher

   • VM parameters: -Dsun.awt.nopixfmt=true -Dsun.java2d.noddraw=true -Dsun.java2d.dpiaware=false -DTopSecurityManager.disable=true -Xms1024m -Xmx22024m -Dorg.netbeans.level=INFO -Dsnap.debug=true -Djava.security.manager=allow --add-opens java.base/java.net=ALL-UNNAMED --add-opens java.desktop/sun.awt=ALL-UNNAMED --add-opens java.base/java.security=ALL-UNNAMED --add-opens java.desktop/javax.swing=ALL-UNNAMED --add-opens java.desktop/com.sun.imageio.plugins.jpeg=ALL-UNNAMED --add-opens java.desktop/sun.java2d=ALL-UNNAMED All VM parameters are optional

   • Program arguments: --clusters "C:\ESA\microwave-toolbox\microwavetbx-kit\target\netbeans_clusters\microwavetbx";"C:\ESA\optical-toolbox\opttbx-kit\target\netbeans_clusters\opttbx";"C:\ESA\microwave-toolbox\microwavetbx-kit\target\netbeans_clusters\rstb" --patches "C:\ESA\snap-engine\$\target\classes";"C:\ESA\microwave-toolbox\$\target\classes";"C:\ESA\optical-toolbox\$\target\classes";"C:\ESA\microwave-toolbox\rstb\$\target\classes"

   • Working directory: SNAP/snap-desktop/snap-application/target/snap/

   • Use classpath of module: snap-main

Contributing

Fork it on github ( https://github.com/senbox-org/s1tbx/fork )
Clone it locally (git clone https://github.com/senbox-org/microwave-toolbox.git)
Create your feature branch (git checkout -b my-new-feature)
Commit your changes (git commit -am 'Add some feature')
Push to the branch (git push origin my-new-feature)
Create a new Pull Request on github

Enjoy!