This is the overview page of the BEAM Java API and examples documentation.
The BEAM (Meris and (A)ATSR ToolBoX) Java library comprises a development framework and a great number of packages containing specific, problem-oriented implementations.
The BEAM Framework API is a core part of the BEAM API which defines all interfaces, classes and recurring design patterns used to implement concrete software modules such as VISAT, the processing tools, data product readers and writers or map projections.
This package provides the software frameworks used throughout the MERIS/(A)ATSR Toolbox software.
Currently, the following framework packages exist:
Note that all classes and packages contained in org.esa.beam.framework
are independent
from other org.esa.beam.*
classes and packages.
{@link org.esa.beam.util}
PackageCurrently the following sub-packages exist:
1. {@link org.esa.beam.examples.data_export}: very simple examples showing how to read data from a product and write them out: The package conatins three source files:
2. {@link org.esa.beam.examples.ndvi_simple}: a very simple NDVI (normalized differential vegetation index) processor. The package contains a single source file:
3. {@link org.esa.beam.examples.ndvi_processor}: a more advanced NDVI processor which uses parts of the BEAM processing framework. The example comprises two source files:
You can also download the bundled examples as a single ZIP file.
In order to compile the examples, the ZIP file also contains a build.xml
file for use
with the open source tool
ant
(a kind of make
for Java)
developed by the Apache Software Foundation.
Newcomers who want to develop export tools and data processors are invited to look at {@link org.esa.beam.examples.data_export} and {@link org.esa.beam.examples.ndvi_simple} first. The first package contains basic tools which lets you extract geophysical data from products. The {@link org.esa.beam.examples.ndvi_simple} package contains a few lines of code showing you how to compute the NDVI value from a MERIS Level 1b input product.
Once you have understood that, please examine the {@link org.esa.beam.examples.ndvi_processor} example contained in this package. {@link org.esa.beam.examples.ndvi_processor.NdviProcessorMain} implements is a fully functional data processor which uses some important concepts and mechanisms of the BEAM processing framework. Don't be afraid, it is still very easy code. It can be used as a template for your own data processors.
This is the list of the most important API packages used by the examples:
{@link org.esa.beam.framework.datamodel}
package.{@link org.esa.beam.framework.dataio}
package.{@link org.esa.beam.util}
package.