The SNAP Microwave Toolbox
======================

[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.20284489.svg)](https://doi.org/10.5281/zenodo.20284489)
[![Build Status](https://gitlab.com/senbox-org/microwave-toolbox/badges/master/pipeline.svg](https://gitlab.com/senbox-org/microwave-toolbox/) 
[![Coverity Scan Status](https://gitlab.com/senbox-org/microwave-toolbox/badges/master/coverage.svg)](https://gitlab.com/senbox-org/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
	  -Xms256m
	  -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!