Installation instructions

Quick reference for installing the Eclipse-based OCOPOMO Toolbox and pilot simulation models

For using the Eclipse-based part of the OCOPOMO toolbox and running simulation models, the following steps should be performed in the specified order.

 

1. Installation of Eclipse

  1. Download Eclipse Juno at http://www.eclipse.org/downloads/ and follow the installation instructions given there. Please ensure to use Juno or Kepler (or Indigo) version. Older versions of Eclipse (e.g. Galileo or Helios) are not supported.
  2. Start Eclipse.

 

2. Installation of CCD Tool, CCD2DRAMS and DRAMS Editor

  1. In Eclipse, open the "Install New Software" dialog by clicking on Help -> Install New Software in the Eclipse Menu
  2. Click on the Add button to add a new installation repository. A dialog appears in which you need to give the repository a
          Name     as e.g. "OCOPOMO" and a
          Location    : http://userpages.uni-koblenz.de/~ocopomo/release/
    Click OK afterwards.
  3.  If you are asked for user name and password, please use the following login data:
          please request the access credentials by sending an email to egov at uni-koblenz.de (the answer may take a few days, pls bring some patience with you)
  4. In the displayed Install dialog, select the check box OCOPOMO to install the CCD TOOL, the CCD2DRAMS Tool and the DRAMSEditorFeature.
  5. Click Next and follow the instructions.

More detailed instructions can be found in Deliverable 4.2, section 3.2.

 

3. Installation of OCOPOMO Extensions

  1. Open the "Install New Software" dialog by clicking on Help -> Install New Software in the Eclipse menu.
  2. Click on the Add Button to add a new installation repository. A dialog appears in which you need to give the repository a
          Name     as e.g. "OCOPOMO Extensions", and a
          Location    : http://ocopomo.ekf.tuke.sk/svn/ocopomoprj/trunk/eclipse/updatesite/site.xml
    Click OK  afterwards. No login/password is required for this installation repository.
  3. In the displayed Install dialog, select all available plug-ins.
  4. Click Next and follow the instructions.

More detailed instructions can be found in Deliverable 4.2, section 3.2.

 

4. Installation of pilot case models

  1. Download the zip archive with the prepared Eclipse workspace containing the pilot case models
  2. Unpack the archive to an arbitrary folder of the hard drive.
  3. Select the unpacked folder "models_workspace" as workspace for Eclipse, either
    -  by clicking on File -> Switch Workspace -> Other… in the Eclipse menu,
    -  by change the default workspace folder in the Select a Workspace dialog at Eclipse start-up.

If Eclipse is started and the pilot model projects are shown in the Package Explorer, it has to be assured that Eclipse uses a Java SE Development Kit 7 (JDK) for all model projects. It can be downloaded from http://www.oracle.com/technetwork/java/javase/downloads/jdk7-downloads-1880260.html. Older versions or any JRE (Java Runtime Environment) will not work.
If a respective error message appears when running a model, the following procedure can be applied to make the JDK available for the model (these steps have to be performed for each model; there are other possibly ways for selecting the runtime environment):

  1. Right-click on the affected model project in the Package Explorer and click on Run As -> Run Configurations... in the context menu.
  2. Choose the tab JRE.
  3. Select Alternate JRE.
  4. Click on Installed JREs...
  5. Click on Add... in order to add another entry by completing the wizard dialog (chose Standard VM). In the next step it is necessary to specify the location of the JDK on the hard disk by clicking on the Directory... button and selecting the JDK folder for JRE home.

 

5. Running pilot case simulation models

  1. Start the model Java class as a Java application, e.g. by right-clicking on the associated .java file and clicking on Run As -> Java Application in the context menu. The main files for the model projects are:
    Campania: /CampaniaMarket/simulation-src/campaniamarket/CampaniaMarketModel.java
    Kosice: /Kosice-3/simulation-src/kosiceextended/KosiceExtendedModel.java
    LondonHousing: /LondonHousing-v2.1/simulation-src/londonhousing/LondonHousingModel.java
  2. When the Repast control window appears, click on the Initialize button. The initialisation procedure might take up to a few minutes, dependent on the model parameters (e.g. number of agents) and the used hardware.
  3. To execute a single simulation tick, the Step button can be pressed; in order to run the simulation, click on the Start button.

 

Document Actions