For Developers

This page describes the CPS Wildfire Management Tool (WMT) software architecture and it shows you how to build the WMT application. The WMT software is a modular Java 6 application built on the NetBeans platform and the NASA WorldWind Java SDK, plus several other open source libraries. This information is presented here with the hope that you will get involved with this open source project, and that you can learn how to build your own NetBeans platform applications using these, or similar technologies.

Most all of the individual modules within these projects are released under the BSD 3-Clause License.

[ software module diagram goes here ]

Getting Ready

The requirements for building the WMT software include:

NetBeans IDE 7
Java 6 compatible operating system (for Mac, OS 10.5 or better is required)
Up to date OpenGL drivers for your computer's display adapter

The CPS Wildfire Management Tool software is comprised of three NetBeans projects stored on Java.net.

Emergency Management Geomatics (Emxsys)
This project includes the a reusable cluster of modules that provides the basic user interface and functionality common to Emxsys software applications. This framework includes the NASA WorldWind SDK and other third-party libraries.
Campbell Prediction System (CPS) Plugin
This project is a suite of modules that provide the fire behavior analysis and prediction capabilities. This suite is a plugin for the Emergency Management Geomatics application framework.
Incident Command System (ICS) Plugin
This project is a suite of modules that provide the incident command system symbology. This suite is a plugin for the Emergency Management Geomatics application framework.

How to Do It

This section will show you how to download, install, and configure NetBeans; how to download the CPS and Emxsys projects from the Subversion repositories; and how to compile and run the projects.

Download, Install & Configure NetBeans IDE 7

Download NetBeans IDE 7 from netbeans.org:
You should download the NetBeans Java SE bundle or any other bundle that includes Java SE and the Platform SDK (e.g., the Java EE bundle or All).
Install NetBeans:
1. Launch the Installer
2. Accept the license agreement(s)
3. Choose to install JUnit
4. Proceed with the installation
5. Finished
Launch NetBeans and perform an update to ensure your IDE is up-to-date with the latest patches:
1. In the NetBeans menu, select Help > Check for Updates
2. Proceed (if required, go ahead and restart NetBeans after the update)
Install the NetBeans Team Server plugin [Optional]
This step is recommended for easy project updates and/or project participation via an issue tracker and chat facilities.
1. In the NetBeans menu, select Tools > Plugins
2. Check the Team Server checkbox in the list of Available Plugins
3. Click Install and proceed with the NetBeans installer:
- After the plugin is installed, add Project Kenai to the list of servers.
  This is where the CPS and Emxsys projects are hosted.
  1. In the NetBeans menu, select Team > Team Server > Login...
  2. In the Login to Team Server dialog, Login to: field, select Add New...
  3. Configure the new New Team Server:
    - In the Name text box, enter Java.net
    - In he URL text box, and enter https://java.net
    - Click Add.
  4. Now you can proceed to login to Project Kenai with your credentials, or you can setup an account on Project Kenai if you haven't already done so.

Download the Emxsys, CPS and ICS Projects via the Team Server

You can use these steps to download the sources if you installed the Team Server plugin and if you are logged into the Project Kenai server.

Note that if you "join" the projects, it will be somewhat easier to download the sources, the Subversion repositories will be preselected for you. You can join any Java.net project by logging into via you web browser, search for a project, and then select the "Bookmark This Project" link. Here are the links to bookmark the CPS and Emxsys projects:

Download Emxsys Sources

Get the Emxsys Framework project:
In the NetBeans menu, select Team > Team Server > Get Sources...
Update the Get Sources from Team Server dialog:
- Logged into: Java.net
- Java.net Repository: https://svn.java.net/svn/emxsys~svn
  You can browse to this project if it is not in the list of your member projects: use "emxsys" for your search criteria and select the Emergency Management Geomatics from the list.
- Folder to Get: trunk
- Local Folder: <your user folder>/NetBeansProjects/emxsys~svn
When the Checkout is complete, you can open this project.

Download the CPS and ICS Sources

Here you simply repeat the above steps, but use "cps" and "ics" instead of "emxsys":

Get the CPS-Suite project:
In the NetBeans menu, select Team > Team Server > Get Sources...
Update the Get Sources from Team Server dialog:
- Logged into: Java.net
- Java.net Repository: https://svn.java.net/svn/cps~svn
  You can browse to this project if it is not in your list of member projects: use "cps" for your search criteria and select the Campbell Prediction System project from the list.
- Folder to Get: trunk
- Local Folder: <your user folder>/NetBeansProjects/cps~svn
When the Checkout is complete, you can open this project.
Repeat this process for the ICS project.

Compile and Run the Project

The Emergency Management Geomatics (emxsys) project must be compiled before compiling the CPS and ICS plugins. After these three projects have been built, you can build the Wildfire Management Tool (emxsys_wmt) project.

Check out the CPS Wiki on Project Kenai for more information about the CPS software development.

Source Code

The Java source code can be browsed from the Emxsys, CPS and ICS Subversion repositories located on the Java.net hosting site:

http://emxsys.java.net/sources

http://cps.java.net/sources

http://ics.java.net/sources

Open Source Resources

The WMT software uses open-source libraries and code from NetBeans, NASA's WorldWind SDK, the VisAD Visualization library, and the JFreeChart.