ENVIRONMENTAL INFORMATICS GEOINFORMATION PRODUCTS		BROCKMANN CONSULT
	BEAM Java Tutorial
	INDEX\| SET-UP\| EX 1\| EX 2\| EX 3a\| EX 3b\| EX 4\| OUTLOOK

Tutorial Index

General Goals

During this tutorial you will ...

learn how to read and write data products using the BEAM Java API
get a basic knowledge about the BEAM product data and product I/O models
learn how to set-up and use a modern Java IDE considering IntelliJ IDEA as example

Pre-Requisites

In order to get the most out of this tutorial you should have ...

a basic understanding of remote-sensing data. Experience with MERIS and (A)ATSR data is very welcome.
a Windows, Linux or other Unix PC with at least 256 MB of memory with the following software installed on it

BEAM-3.3 or BEAM-3.4
Java 2 Standard Edition JDK 5.0 or higher
IntelliJ IDEA IDE. The open-source Eclipse IDE or NetBeans IDE do it just as well, but they have a slighly different set-up and other key bindings.

some basic experience with Java or another object-oriented programming language, e.g. C++ or C# is very useful. We hope that C and FORTRAN programmers can follow this tutorial as well. Please note that this is neither a Java nor an object-oriented programming course.

Tutorial Overview

Lesson	Contents	Source Code
IDE Set-up	How to prepare a Java IDE for usage with BEAM: Create a new IDE project Create the BEAM-3.3 library
Exercise 1	How to open a data product and access some of its properties: Create a Java package and a new main class Open a data product Access the properties of a product Write a script to run the program from the console	Ex1.java Ex1.bat
Exercise 2	How to read pixel data from a band of a data product: List the bands contained in a data product Get a specific band and read pixel data Dump pixel data to the console	Ex2.java
Exercise 3a	How to create a new data product and write it as BEAM-DIMAP format: Create a new product object Create a new band and add it to the product Set the band's raster data with computed pixel values Write the data product as BEAM-DIMAP format Inspect data product output and open it in VISAT	Ex3a.java
Exercise 3b	How to create a new data product and write pixel data line by line: Write a product "skeleton" in BEAM-DIMAP format Compute new pixel values and write band data line-wise	Ex3b.java
Exercise 4	All together - generate an NDVI product from a MERIS Level-2 product	Ex4.java
Outlook	How to continue after this tutorial: Check for invalid or missing input pixels Specify invalid or missing output pixels Add more information to the output product Extend the BEAM Java API Find out more about the BEAM Java API

© 2005 by Brockmann Consult - Need help? Contact beam@brockmann-consult.de