/
SNAP Configuration

SNAP Configuration

SNAP Desktop configuration

The way SNAP Desktop is configured is mainly driven by the NetBeans platform.

On Windows, the SNAP Desktop configuration is stored in the %HOMEPATH%/AppData/Roaming/SNAP directory. On other platform (Unixes), it is $HOME/.snap/system.

This directory may contain the following sub-directories:

  • etc - NetBeans Platform application configuration

  • config - SNAP Desktop user preferences and UI configurations

  • var/log - SNAP Desktop log files

  • var/cache - NetBeans Platform cache files

  • modules - SNAP extension module installations and updates (JARs)

SNAP Engine configuration

SNAP configuration is stored in Java properties files with the ending .properties. SNAP configuration parameter names usually start with snap. and can be set via Java system properties, the ${snap.home}/etc/snap.properties file, or the .snap/etc/snap.properties file in %HOMEPATH%/ (Windows) or $HOME/ (Unixes). The SNAP configuration is programmatically accessed using the org.esa.snap.runtime.Config class. 



Key

Value

Format

Default

Description

Perf

Scope

 

Key

Value

Format

Default

Description

Perf

Scope

 

snap.home

String

path

.

SNAP installation directory.

API: Config.instance().installDir(), SystemUtils.getApplicationHomeDir()



All modules

 

snap.userdir

String

path

${user.dir}/.snap

SNAP user directory which contains per-user application data (configuration, preferences, cache, GUI state, etc). See also How to move .snap directory to a different location.

API: Config.instance().userDir(), SystemUtils.getApplicationDataDir()



All modules

 

snap.log.name

String

any

org.esa.snap

API: Config.instance().logger(), SystemUtils.LOG



All modules

 

snap.log.level

String

OFF | ERROR | WARNING | INFO | DEBUG | ALL

INFO

API: Config.instance().logger(), SystemUtils.LOG



All modules

 

snap.pythonExecutable

String

path

python

Points to the CPython interpreter executable to be used with SNAP. Used from Java (by the org.esa.snap.python.PyBridge class) in order to configure the Python VM which will be used to execute SNAP Python extensions.



snap-python

 

snap.pythonModuleDir

String

path

${snap.userdir}/snap-python

Directory where the CPython VM (see snap.pythonExecutable key) finds the Python module snappy. Used to execute SNAP Python extensions that require to call back into the SNAP Java API.



snap-python

 

snap.forcePythonConfig

Boolean

true | false

false

If set to true, SNAP will always reconfigure the CPython (org.esa.snap.python.PyBridge class) before it is used.



snap-python

 

snap.pythonExtraPaths

String

path {: path} (Unixes)

path {; path} (Windows)



Extra directories to scan for CPython extensions. Currently only Operator plugins are possible, therefore sub-directories must contain a file META-INF/services/org.esa.snap.python.gpf.PyOperator to be recognised as plugins.



snap-python

 

snap.jai.defaultTileSize

Integer

size in pixel

512

The default size in width and hight direction of a JAI tile.

 

 

 

snap.jai.tileCacheSize

Integer

Size in Megabytes

1024

The amount of memory JAi can use for caching tiles

yes

All

 

snap.jai.prefetchTiles

Boolean

true | false

false

If it is known that tiles are soon needed they can be prefetched before actually acquired.

yes

All

 

snap.jythonExtraPaths

String

path {: path} (Unixes)

path {; path} (Windows)



Extra directories to scan for Python extensions. Sub-directories must contain a file META-INF/services/org.esa.snap.jython.PluginActivator to be recognised as plugins.



snap-jython

 

snap.gpf.executionOrder

String

SCHEDULE_ROW_COLUMN_BAND | SCHEDULE_ROW_BAND_COLUMN | SCHEDULE_BAND_ROW_COLUMN | PULL_ROW_BAND_COLUMN

 



yes 

 snap-gpf

 

snap.gpf.useFileTileCache

Boolean

true | false

false



yes

snap-gpf

 

snap.gpf.disableTileCache

Boolean

true | false

false



yes

snap-gpf

 

snap.gpf.tileComputationObserver

String

class name

 

Implementation of a org.esa.snap.framework.gpf.monitor.TileComputationObserver

For example: org.esa.snap.core.gpf.monitor.TileComputationEventLogger



snap-gpf

 

snap.gpf.beepAfterProcessing

Boolean

true | false

false

If enabled GPF will make a beep when processing is finished.



snap-gpf

 

snap.gpf.allowAuxdataDownload

Boolean

true | false

true

Disables the access of external auxiliary data over the internet.



snap-gpf

 

snap.parallelism

Integer

1...n

number of CPU cores



yes

snap-core

 

snap.extraClusters

String

path {: path} (Unixes)

path {; path} (Windows)



Used for SNAP Engine stand-alone (command-line) tools, such as GPT. It's value is a list of extra NetBeans clusters whose JAR modules are added to the application's classpath.



snap-runtime

 

snap.application.name

String

any

SNAP





snap-core

 

snap.homepage.url

String

URL

http://sentinel.esa.int





snap-core

 

snap.pixelGeoCoding.fractionAccuracy

 

true | false

true | false

false



yes (Dev)

snap-core

snap.pixelGeoCoding.useTiling

Boolean

true | false

true



yes (Dev)

snap-core

 

snap.tiePointGeoCoding.maxPrecision

Boolean

true | false

false

If set to true, the inverse TiePointGeocoding uses polynomial approximates of higher order to achieve minimal interpolation errors, if set to false, approximations with an RMSE of a quarter pixel are assumed to be sufficiently precise

yes

snap-core

 

snap.useDEMGravitationalModel

Boolean

true | false

false





snap-core

 

snap.dataio.reader.tileWidth

Integer

1...n



Default tile width

yes (Dev)

snap-core

 

snap.dataio.reader.tileHeight

Integer

1...n



Default tile height

yes (Dev)

snap-core

 

snap.dataio.netcdf.metadataElementLimit

Integer

1...n

100







 

snap.binning.sliceHeight

Integer

1...n

Prefererred tile size

Height of a source slice to be processed in pixels

yes

snap-binning

 

snap.binning.traceLatLon

String

lat,lon



Bin tracing



snap-binning

 

snap.worldImageDir

String

path