DSM2 v82 PTM Compiling with Eclipse

This memo presents step-by-step instruction on establishing editable project, compiling and packaging DSM2 (version 8) PTM module in Eclipse. Note this is the version for PTM source code editing purpose. The version for straight compiling is in the DSM2 compiling memo: DSM2_v8_0_Compiling_and_Packaging.

Required Software and Source Code Check out

Java Development Kit http://java.sun.com/javase/downloads/index.jsp
Eclipse-jee-galileo-win32 +http://www.eclipse.org/downloads/packages/release/galileo/sr2+
PTM Java source code are checked out in the DSM2 Compile & Package document, with the whole DSM2 coding package:

The specific folder directory on DWR SVN server is:
+http://dminfo.water.ca.gov:8686/svn/repository/models/branches/dsm2_v8_0/src/ptm/DWR/DMS/PTM+
and could be put at following directory on local computers:
+D:\delta\models\dsm2_v8_0\src\ptm+

Build up project
Method 1: with Eclipse project description file
File -> Import -> Existing Projects into Workspace -> Next -> Select root directory (Browse) to where .project resides -> Ok -> Finish
PTM Compiling Figure 1 PTM Compiling Figure 2

Method 2: w/o Eclipse project description file

Set up workspace

Double click to open Eclipse and set up the workspace (default path as d:\workspace);
*This is the path for source code, libraries, compiled bytecode files, and et cetera. Source codes are copied from the location specified in the previous step.
*Changes made in workspace could be compiled and tested independently, then copied back to the DSM2 model package folders, and finally committed to the SVN server.
PTM Compiling Figure 3

Create the PTM project in workspace

File->New->Java Project
PTM Compiling Figure 4 'Project name' input e.g. ptm
'Project layout' select as 'Use project folder as root for sources and class files' (with src and bytecode stored at one place; the other option is also ok for use)
PTM Compiling Figure 5 Next->Libraries->Add External JARs->Select 3 jar files (COM.jar, edu.jar, xml.jar) at directory:
D:\delta\models\dsm2_v8_0\src\ptm\lib
Finish
PTM Compiling Figure 6

Create Package to include source codes:

Right click ptm in the Package Explorer->New->Package
PTM Compiling Figure 7 Input Package Name under Source folder ptm: DWR.DMS.PTM
PTM Compiling Figure 8 Import java source codes
PTM Compiling Figure 9 General->File System->Next
From directory->Browse (DSM2 PTM Java src folders) ->OK
PTM Compiling Figure 10 Check PTM box on the left window (to include all the java files)->Finish
PTM Compiling Figure 11 *Eclipse would automatically create 2 packages for the sub-folders:
DWR.DMS.PTM.behave
DWR.DMS.PTM.tools
*If some error msg like 'access restriction' comes out: Try to remove the JRE System library from Project ptm->Properties->Java Build Path->Libraries, and add it again
Compile and debug PTM

Compile source code to bytecode

Project->Build Project
PTM Compiling Figure 12 Bytecodes (.class) are stored at the same place as source codes (.java)
Automatic compilation could be enabled by Project -> Build Automatically

Run/Debug Variables Configuration

Set up the PTM input study file in IDE configuration
Menu Run/Debug-> Run/Debug Configuration
PTM Compiling Figure 13 Java Application->New
PTM Compiling Figure 14 e.g.
Main Tab:
Name: MainPTM
Main Class: DWR.DMS.PTM.MainPTM
Argument Tab:
Program arguments: historical_ptm.inp (the sample PTM input file in a DSM2 v8 historical study; make sure the hydro file has been run first and h5 file exists)
VM arguments: -ss1m -mx512m -oss1m
Other: D:\delta\dsm2_v8\study_templates\historical
Environment Tab:
DSM2_HOME d:\delta\dsm2_v8
Path d:\delta\dsm2_v8\bin
PTM Compiling Figure 15 PTM Compiling Figure 16 PTM Compiling Figure 17

Run/Debug PTM

Switch to Debug Mode, which enable breakpoint setting and variable tracking
Run->Run/Debug MainPTM for calculation checking
PTM Compiling Figure 18

Export back to DSM2 package

Combine the PTM Java bytecotes and related libraries into a JAR file

File->Export->Java->JAR file
PTM Compiling Figure 19 PTM Compiling Figure 20 Check ptm box on the left to select all the bytecode files and libraries
Select the export destination: D:\workspace\ptm\ptm.jar
PTM Compiling Figure 21

Copy the JAR file to the DSM2 distribution binary folder for packaging:

+D:\delta\models\dsm2_distribute\dsm2\ptm\lib+
Other PTM related files, e.g. ptm.dll, are compiled in related C++ and Fortran projects of DSM2 Visual Studio solution. Please see the document for details.

Attachments: