Quick Start

Update date:

Forewords

This document will ease the download process of MECSYCO and its dependencies. At the end you will have a file named libs to place in the folder of each of your Eclipse project using MECSYCO and any of its component (visu, com, world-netlogo, debug, world-fmi). We will also go through the install process of DDS and the debug system.

Setup

As a start, create a folder named “For MECSYCO”, and inside a folder named “libs”. Everything we download would then be located in one place and it will be easier to work with.

MECSYCO-re

Core component of MECSYCO.

JARs

For this dependencies, you will be redirect to maven repository. The download link is found in the table line Files under the name Download(BUNDLE) or Download(JAR)

Maven links location
Figure 1: Maven links location

Put all those jars in the libs folder:

libs folder 1
Figure 2: Libs folder 1

MECSYCO-visu

Observing tools, in order to display, save or treat simulation results.

JARs

Classic download

Jz3d (0.9.1)

Go to Jz3d website and access this page. The download link will be located there:

jz3d link
Figure 3: JZ3D link

Gluegen and JOGL

Go to the Glugen website to this specic location:

glugen and jogl link
Figure 4: glugen and jogl link

Extract the folder and open the jar folder. Delete everythin in order that the jar folder looks like this:

glugen and jogl jar file
Figure 5: glugen and jogl jar file



Put all those jars in the libs folder (content of jar folder and jars directly downloaded):

Libs folder 2
Figure 5: Libs folder 2

MECSYCO-com-dds

Communication tools, in order to distribure the co-simulation over several machines.

JARs

Classic download

Opensplice DDS

Go to the download list of DDS Community website, and select the one corresponding to your system. You will also need to create an account.

Windows install (example in 64 bit)

You will download an archive file to extract in the location you want to install DDS. I advise you in the folder “Program Files”. First, copy the jar dcpssaj.jar (HDE->x86_64.win64->jar) and paste it in the libs fodlder.

Then, you need to create the following environnement variables:

  • OSPL_HOME: path to Openslice folder (C:\Program Files\HDE\x86_64.win64\)
  • OSPL_PATH: %OSPL_HOME%\bin;%OSPL_HOME%\lib;%OSPL_HOME%\examples\lib
  • OSPL_TMPL_PATH: %OSPL_HOME%\etc\idlpp
  • OSPL_URI: file://%OSPL_HOME%\etc\config\ospl.xml
  • in PATH, add: %OSPL_PATH% To do so:
  • Go to “Advanced system setting”
Advanced system setting
Figure 5: Advanced system setting
  • Clic on “Environment Variables”
Environment Variables
Figure 5: Environment Variables
  • Create what you need to create
Create new variables
Figure 5: Create new variables
  • Edit what you need to edit
Edit path
Figure 5: Edit path

Linux install (example in 64 bit)

The first step is exactly similar, download-extract, copy past the jar file.

Before working on the environment, we need to make a change in the file release.com (HDE->x86_64.linux), replace “@@INSTALLDIR@@” by the path to the installation directory:

release.com
Figure 5: release.com file



Don’t forget to put all those jars in the libs folder:

Libs folder 3
Figure 5: Libs folder 3

MECSYCO-world

MECSYCO complement in order to include certain simulator.

NetLogo
Figure 5: NetLogo link

FMI

jna
Figure 5: jna link
  • simple-xml-2.7.1 (the jar is contained in the zip file: simple-xml-2.7.1->jar)

    Put all those jars in the libs folder:
Libs folder 4
Figure 5: Libs folder 4

Debug system

Includ a specific debug system to MECSYCO

JARs

Put all those jars in the libs folder, at this point, your libs folder is ready, and you should have 41 elements in it:

Libs folder 5
Figure 5: Libs folder final

Conf Folder

Download the conf folder and extract it in “For MECSYCO” (next to the libs folder):

MECSYCO folder
Figure 5: MECSYCO folder

Install MECSYCO

Setup

In Eclipse, create a new Java Project. Right clic on the new project -> Show In -> System Explorer:

Install1
Figure 5: Acces to the project folder

Copy the content of the folder “For MECSYCO” and paste it in the project folder:

Install2
Figure 5: Project folder

Back to the Eclipse window, you can notice that nothing changed, you need to refresh the project first (libs and conf should appear):

Install3
Figure 5: Refresh

Next steps, we need to configure the project (adding libs and the conf folder)

Libs

To install libs, go to the “Librairies” panel of the “Configure Build Path” windows:

Install4.1 Install4.2
Figure 5: Adding JARs

Clic on “Add JARs”, and select everything from the libs folder:

Install5
Figure 6: JARs added

conf folder

In this same windows, go to the panel “Source”, clicl on “Add Folder” and select the conf folder:

Install6.1 Install6.2
Figure 6: Adding conf folder

Final notes

You can see the final results in the set of downloadable applications.

The other available examples follow the same principles.