{"type":"doc","content":[{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{},"macroMetadata":{"macroId":{"value":"eca98a23-5904-48d8-bbe4-4a4d2eb0870e"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"fa7cec38-ea3f-41f8-ab83-834641b510ad"}},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"Once you have checked out the project as described in ","type":"text"},{"text":"How to build SNAP from sources","type":"text","marks":[{"type":"link","attrs":{"href":"https://senbox.atlassian.net/wiki/spaces/SNAP/pages/10879039"}}]},{"text":" you can configure IntelliJ IDEA.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Importing source code as a Project","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Select from the menu ","type":"text"},{"text":"File/New/Project from Existing Sources","type":"text","marks":[{"type":"strong"}]},{"text":" or if you're on the Welcome Screen choose ","type":"text"},{"text":"Import Project","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"strong"}]},{"text":"Find the checkout directory of ","type":"text"},{"text":"snap-engine","type":"text","marks":[{"type":"em"}]},{"text":". Keep the default values for all settings in the upcoming dialog. Just make sure that you select the option ","type":"text"},{"text":"Import project from external model","type":"text","marks":[{"type":"strong"}]},{"text":" and that ","type":"text"},{"text":"Maven","type":"text","marks":[{"type":"strong"}]},{"text":" is selected as the external model.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Next, select from the menu ","type":"text"},{"text":"File/New/Module from Existing Sources","type":"text","marks":[{"type":"strong"}]},{"text":" and select the ","type":"text"},{"text":"snap-desktop","type":"text","marks":[{"type":"em"}]},{"text":" folder. Keep again the default values.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Repeat the last step for the other project you might have checked out.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Open ","type":"text"},{"text":"File/Project Structure","type":"text","marks":[{"type":"strong"}]},{"text":". Ensure that as","type":"text"},{"text":" SDK","type":"text","marks":[{"type":"strong"}]},{"text":" a ","type":"text"},{"text":"Java 11","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":" version is selected and for ","type":"text"},{"text":"Language level","type":"text","marks":[{"type":"strong"}]},{"text":" select the option ","type":"text"},{"text":"11 - Local variable syntax for lambda parameters.","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":" Confirm the changes. If you are working with SNAP 12 or higher use as ","type":"text"},{"text":"SDK","type":"text","marks":[{"type":"strong"}]},{"text":" a ","type":"text"},{"text":"Java 21","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":" version and for ","type":"text"},{"text":"Language level","type":"text","marks":[{"type":"strong"}]},{"text":" select the option ","type":"text"},{"text":"21 - Record patterns, pattern matching for switch.","type":"text","marks":[{"type":"strong"},{"type":"em"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"On the right side of the IDE you find the ","type":"text"},{"text":"Maven Projects","type":"text","marks":[{"type":"strong"}]},{"text":" tab. There you can invoke the Maven commands to build the project. You should configure this window by clicking on the","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":5.0},"content":[{"type":"media","attrs":{"width":58,"id":"d0ec4fb9-35a4-4779-9b61-ce0f483f9375","collection":"contentId-24051775","type":"file","height":38}}]},{"type":"paragraph","content":[{"text":" three-vertical-dots symbol and selecting ","type":"text"},{"text":"Group Modules","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]}]}]},{"type":"mediaSingle","attrs":{"layout":"align-start"},"content":[{"type":"media","attrs":{"width":560,"id":"6aa84f0e-11b8-4852-9eac-e9b7c7d923b8","collection":"contentId-24051775","type":"file","height":299}}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Launching and Debugging","type":"text"}]},{"type":"paragraph","content":[{"text":"In order to launch and debug SNAP you need to create a run configuration. Before doing so you first need to build the project via maven. You can either do this from the command line or from the Maven window in Intellij IDEA. You simply need to invoke ","type":"text"},{"text":"mvn package","type":"text","marks":[{"type":"strong"}]},{"text":" for each of the projects you have checked out. This is necessary to have the target directories available which will be referenced in the run configuration.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Run plain SNAP Desktop","type":"text"}]},{"type":"paragraph","content":[{"text":"Select ","type":"text"},{"text":"Run/Edit Configurations","type":"text","marks":[{"type":"strong"}]},{"text":" and add a new configuration named ","type":"text"},{"text":"Application","type":"text","marks":[{"type":"strong"}]},{"text":". ","type":"text"},{"type":"hardBreak"},{"text":"In the following ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" is an abbreviation for ","type":"text"},{"text":"/snap/snap-desktop/snap-application/target/snap","type":"text","marks":[{"type":"code"}]},{"text":":","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Main class: ","type":"text","marks":[{"type":"strong"}]},{"text":"org.esa.snap.nbexec.Launcher","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"VM options: ","type":"text","marks":[{"type":"strong"}]},{"text":" ","type":"text"},{"text":"-Dsun.java2d.noddraw=true -Dsun.awt.nopixfmt=true -Dsun.java2d.dpiaware=false -Dorg.netbeans.level=INFO -Dsnap.debug=true -Xmx4G","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Program arguments: ","type":"text","marks":[{"type":"strong"}]},{"text":" --userdir \"/../userdir\" --patches \"/snap/snap-engine/$/target/classes\"","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Working directory","type":"text","marks":[{"type":"strong"}]},{"text":": ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Use classpath of module","type":"text","marks":[{"type":"strong"}]},{"text":": snap-main","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"If you are using SNAP 12 or higher add the following parameters to the ","type":"text"},{"text":"VM options","type":"text","marks":[{"type":"strong"}]},{"text":":","type":"text"}]},{"type":"codeBlock","content":[{"text":"-Djava.security.manager=allow\n--add-opens java.base/java.net=ALL-UNNAMED\n--add-opens java.base/java.security=ALL-UNNAMED\n--add-opens java.desktop/sun.awt=ALL-UNNAMED\n--add-opens java.desktop/javax.swing=ALL-UNNAMED \n--add-opens java.desktop/com.sun.imageio.plugins.jpeg=ALL-UNNAMED\n--add-opens java.desktop/sun.java2d=ALL-UNNAMED","type":"text"}]},{"type":"paragraph","content":[{"text":"Note that in the configuration above, the SNAP user directory at ","type":"text"},{"text":"/../userdir","type":"text","marks":[{"type":"code"}]},{"text":" will be deleted after each clean build. This is by intention. If you want to keep your settings during development (not recommended), you can configure the SNAP user directory to any other location outside of the target directory.","type":"text"}]},{"type":"paragraph","content":[{"text":"The '","type":"text"},{"text":"$","type":"text","marks":[{"type":"strong"}]},{"text":"' character in the patches path is a place holder for all the sub-modules in this project.","type":"text"}]},{"type":"paragraph","content":[{"text":"you can add the","type":"text"},{"text":" --open","type":"text","marks":[{"type":"strong"}]},{"text":" option to the program arguments to specify one more paths to products which shall be opened on start up. Also a session file is possible.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Run SNAP Desktop with additional Toolboxes (microwave, optical, smos, ...)","type":"text"}]},{"type":"paragraph","content":[{"text":"If you want to use one or more toolboxes with SNAP Desktop you need to do the following. You can use the previous configuration as template by copying it.","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"Note that you can add multiple run configurations. One for plain SNAP Desktop, one with s1tbx, one with smos, one with s2tbx and s3tbx, and other combinations. This gives you the flixbility to run SNAP in different configurations.","type":"text"}]}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"For Unix-users:","type":"text","marks":[{"type":"strong"}]},{"text":" In the following the ","type":"text"},{"text":"';'","type":"text","marks":[{"type":"strong"}]},{"text":" character is use to separate the paths. That's the seperator for Windows. On Unix based system you should use ","type":"text"},{"text":"':'","type":"text","marks":[{"type":"strong"}]},{"text":" instead,","type":"text"}]},{"type":"paragraph","content":[{"text":"Extend the ","type":"text"},{"text":"--patches","type":"text","marks":[{"type":"strong"}]},{"text":" option to include the compile output of the toolboxes.","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"--patches \"/snap/snap-engine/$/target/classes;/snap/microwave-toolbox/$/target/classes;/snap/microwave-toolbox/rstb/$/target/classes;/snap/microwave-toolbox/jlinda/$/target/classes;/snap/optical-toolbox/$/target/classes\"","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Additionally the ","type":"text"},{"text":"--clusters","type":"text","marks":[{"type":"strong"}]},{"text":" option needs to be set. The clusters contain all modules of a toolbox and are located in the so called kit module of each of them.","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"--clusters \"/snap/microwave-toolbox/microwavetbx-kit/target/netbeans_clusters/microwavetbx;/snap/microwave-toolbox/microwavetbx-kit/target/netbeans_clusters/rstb;/snap/optical-toolbox/opttbx-kit/target/netbeans_clusters/opttbx\"","type":"text","marks":[{"type":"code"}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Run gpt","type":"text"}]},{"type":"paragraph","content":[{"text":"In order to run gpt directly from the IntelliJ IDEA you should use the following configuration.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Main class: ","type":"text","marks":[{"type":"strong"}]},{"text":"org.esa.snap.runtime.Launcher","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"VM options: ","type":"text","marks":[{"type":"strong"}]},{"text":"-Dsnap.mainClass=org.esa.snap.core.gpf.main.GPT -Dsnap.home=\"/snap/snap-desktop/snap-application/target/snap\" -Dsnap.extraClusters=\"/snap/microwave-toolbox/microwavetbx-kit/target/netbeans_clusters/microwavetbx;/snap/microwave-toolbox/microwavetbx-kit/target/netbeans_clusters/rstb;/snap/optical-toolbox/opttbx-kit/target/netbeans_clusters/opttbx\" -Dsnap.debug=true -Xmx10G -Djava.awt.headless=true","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Program arguments: ","type":"text","marks":[{"type":"strong"}]},{"text":" -h","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Working directory","type":"text","marks":[{"type":"strong"}]},{"text":": ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Use classpath of module","type":"text","marks":[{"type":"strong"}]},{"text":": snap-runtime","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"As ","type":"text"},{"text":"Program arguments","type":"text","marks":[{"type":"strong"}]},{"text":" you can specify the arguments you usually use with gpt. If you have enough memory available you can increase the value for the ","type":"text"},{"text":"Xmx","type":"text","marks":[{"type":"strong"}]},{"text":" option. This value defines how much memory SNAP can use. Make sure that you leave some spare memory for the OS and other applications.","type":"text"}]},{"type":"paragraph"},{"type":"paragraph"},{"type":"paragraph"},{"type":"paragraph"}],"version":1}