https://github.com/bcdev/s3tbx-c2rcc
Case-2 Regional / Coast Colour AC+IOP Processor
https://github.com/bcdev/s3tbx-c2rcc
Last synced: 7 months ago
JSON representation
Case-2 Regional / Coast Colour AC+IOP Processor
- Host: GitHub
- URL: https://github.com/bcdev/s3tbx-c2rcc
- Owner: bcdev
- License: gpl-3.0
- Archived: true
- Created: 2015-06-24T14:37:28.000Z (about 11 years ago)
- Default Branch: master
- Last Pushed: 2022-04-08T08:47:04.000Z (about 4 years ago)
- Last Synced: 2025-09-09T14:13:40.358Z (10 months ago)
- Language: Java
- Size: 4.59 MB
- Stars: 5
- Watchers: 9
- Forks: 4
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
- awesome-sentinel - **`C2RCC`**
- awesome-sentinel - **`C2RCC`**
README
# Note:
The is an old abandoned repository of the C2RCC processor.
For latests developments see https://github.com/senbox-org/s3tbx/tree/master/s3tbx-c2rcc
If you have any questions please visit the forum: https://forum.step.esa.int/c/s3tbx/7
## s3tbx-c2rcc
This is the source distribution of the Case-2 Regional / Coast Colour (C2RCC) Atmospheric Correction (AC) and
Inherent Optical Properties (IOP) Processor for Sentinel-3 OLCI, Sentinel-2 MSI, Landsat-8, MERIS (incl. 4th repro),
MODIS and the SeaWiFS Level 1C radiance products.
Documentation
-------------
As this processor is still in its pre-release phase and not yet final, the documentation is also very sparse.
Some documentation can be found in the [docs folder](https://github.com/bcdev/s3tbx-c2rcc/tree/master/docs).
How to build
------------
Make sure you have **[git](https://git-scm.com/)**,
**[JDK 1.8](http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html)**, and
**[Maven 3](https://maven.apache.org/)** installed. Make sure Maven find's the JDK by setting the enviromment variable `JAVA_HOME` to the directory where your JDK is installed.
Clone or fork the repository at https://github.com/bcdev/s3tbx-c2rcc.
```
> git clone https://github.com/bcdev/s3tbx-c2rcc.git
> cd s3tbx-c2rcc
```
You can update your checked-out sources from the remote repository by running
```
> git pull --rebase
```
Incremental build with Maven:
```
> mvn package
```
Clean build:
```
> mvn clean package
```
If you encounter test failures:
```
> mvn clean package -DskipTests=true
```
The build creates a SNAP plugin module file `target/nbm/s3tbx-c2rcc-.nbm`.
How to install and run the processor as SNAP plugin
---------------------------------------------------
Start SNAP (Desktop UI) and find the plugin manager in the main menu at
> **Tools / Plugins**
Then
* select tab **Downloaded**,
* click button **Add Files** and
* select the plugin module file `target/nbm/s3tbx-c2rcc-.nbm`.
* Click **Install**,
* then **Close** and
* restart SNAP.
Once the C2RCC processor is installed into SNAP it can be run from the SNAP Desktop UI's main menu at
> **Optical / Thematic Water Processing / C2RCC / \**
Or in batch mode using SNAP's `gpt` command-line tool found in `${SNAP_HOME}/bin`. Depending on the sensor you want
to execute you can call the following to get help.
```
> gpt c2rcc. -h
```
e.g.
```
> gpt c2rcc.meris -h
```
Available at the time of writing are:
* c2rcc.landsat8
* c2rcc.meris
* c2rcc.meris4
* c2rcc.modis
* c2rcc.msi
* c2rcc.olci
* c2rcc.seawifs
* c2rcc.viirs
Modifying, running and debugging the processor code
---------------------------------------------------
This section explains how to run and debug the C2RCC processor code from a Java IDE without having to install the plugin into SNAP.
You will need to install
* SNAP with the Sentinel-3 Toolbox (S3TBX) from http://step.esa.int/main/download/
* IntelliJ IDEA (Community Edition) IDE from https://www.jetbrains.com/idea/download/
Start IDEA and select **File / New / Project from Existing Sources**. Select the `pom.xml` (Maven project file) in the source directory. Leave all default settings as they are and click **Next** until IDEA asks for the JDK. Select the installed JDK from above and finish the dialog.
From the main menu select **Run / Edit Configurations**. In the dialog click the **+** (add) button and select **JAR Application**. Then the settings are as follows:
* **Name**: SNAP Desktop
* **Path to JAR:** `${SNAP_HOME}/snap/snap/core/snap-main.jar`
* **VM options:** `-Xmx4G -Dorg.netbeans.level=INFO -Dsun.java2d.noddraw=true -Dsun.awt.nopixfmt=true -Dsun.java2d.dpiaware=false`
* **Program arguments:** `--userdir ${C2RCC_HOME}/target/testdir --clusters ${C2RCC_HOME}/target/nbm/netbeans/s3tbx --patches ${C2RCC_HOME}/$/target/classes`
* **Working directory:** `${SNAP_HOME}`
where
* `${SNAP_HOME}` must be replaced by your SNAP installation directory
* `${C2RCC_HOME}` must be replaced by your C2RCC project directory (where the `pom.xml` is located in)