From VLE

VLE

VLE is compound of the main part named VLE, and can be associated with three add-ons: rvle (R-Package for VLE), pyvle (Python for VLE, only on linux) and jvle (Java for VLE, only on linux).

Version

The last version is VLE-1.0.2. For a detailed description for changes, see the Release notes of VLE-1.0.2.

Files

Installation

Windows

Under Windows only the main part and the R-Package for VLE (rvle) are available.

VLE main part

• Upgrading
  • Uninstall the previous version
  • Remove the remaining variable PKG_CONFIG_PATH (only earlies versions)
  • Follow the next sections for installation

• Installation requirement
  • Verify if the dependencies (cmake and mingw) are installed and if so, with the good versions (see the versions below). If the versions are not good, you can try to keep them as they are and install vle, but some compilation errors may happen. In that case, you can uninstall them in order to install the good versions, verifying at first that no others softwares need the cmake and mingw already installed versions.
  • Install the dependencies if not already installed
    • cmake-2.8.6-win32-x86.exe install CMake in the default path (C:\Program Files\CMake 2.8 for instance) add the path to the environment variable PATH for all users or for the current user.
    • mingw-get-inst-20101030.exe: install the MinGW compiler in the default path (c:\mingw for instance) and use the2010/10/30 version. To enable the compiler, you must add the installation path in the MinGW environment variable PATH. You access these variables in the properties menu of the workstation icon, in advanced tab and select the button Environment Variables. Change the environment variable Path by adding c:\mingw\bin in the front of the line. For instance, for a classical Win32 installation: c:\mingw\bin;%Systemroot%\system32;%systemroot%;%systemroot%\system32\wbem

• Installation
  • Download the binary file (vle-X.X.X-Windows-x86.exe see above). X.X.X is the last version.
  • Install VLE in the default path (c:\program files\vle X.X.X, 600 MB). If you also intend to install rvle, choose "add VLE to the system PATH for all users" during the installation of vle.

RVLE

To install RVLE (R-Package for VLE), you need the last VLE version and R (of course) and development headers of R.

Add an environment variable VLE_HOME with value c:\documents and settings\user\vle (replace user with your login). The directory must exist before launching application. It is required that VLE is in the default PATH. During the installation process of VLE, choose "add VLE to the system PATH for all users" .

• R-2.12.0-win.exe, download and install the R program.
• Install the R Package Runit from CRAN.
• rvle_1.0.2-0.zip, download RVLE and install it.

Linux / Unix

Under Linux / Unix all the packages are available.

VLE main part

• Installation requirement
  • Verify if the dependencies are installed and if so, with the good versions (see the dependencies and their versions below). If the versions are not good, you can try to keep them as they are and install vle, but some compilation errors may happen.
  • The necessary tools dependencies are: cmake (>= 2.6), make, gcc and g++ (optionally doxygen).
  • The necessary libraries dependencies are: libxml2 (>= 2.6), libgtkmm (>= 2.4), libglademm (>= 2.4), libcairomm (>= 1.0), libgtksourceviewmm (>= 2.0.2), boost (>= 1.34 with boost-serialization, boost-date-time, boost-filesystem, boost-test, boost-regex, boost-program-options, boost-thread), libglibmm and pkg-config (for distributions not using rpm for installation)
  • For example :

under ubuntu LTS 10.04, 11.10
sudo apt-get install cmake g++ libgtkmm-2.4-dev libglademm-2.4-dev libgtksourceviewmm-2.0-dev
     libboost-dev libboost-serialization-dev libboost-date-time-dev libboost-filesystem-dev
     libboost-test-dev  libboost-regex-dev libboost-program-options-dev libboost-thread-dev

under debian 6.0.4
sudo apt-get install cmake g++ libgtkmm-2.4-dev libglademm-2.4-dev libboost-serialization1.42-dev
     libboost-date-time1.42-dev libboost-filesystem-dev libboost-test-dev  libboost-regex1.42-dev
     libboost-thread-dev

under fedora 16 (with software development profile chosen at the installation)
sudo yum install libglademm24-devel-2.6.7-4.fc15 

• Installation
  • Download the vle main part:

wget http://sourceforge.net/projects/vle/files/1.0/1.0.2/vle-1.0.2.tar.gz

• • Uncompress the package:

tar zxf vle-1.0.2.tar.gz

• • Prepare the necessary repertory:

cd vle-1.0.2
mkdir build
cd build

• • Build the package

cmake -DCMAKE_BUILD_TYPE=RelWithDebInfo -DCMAKE_INSTALL_PREFIX=/usr ..
make

• • Prepare package for installation

under ubuntu or Debian
cpack -G DEB
sudo dpkg -i vle-1.0.2-Linux-i686.deb

under debian 6.0.4 to avoid a bug with cmake
sudo make install
sudo dpkg -i vle-1.0.2-Linux-i686.deb

under Redhat and derivate distribution (Fedora, Mandriva, Suse etc.)
cpack -G RPM
sudo rpm -i vle-1.0.2-Linux-i686.rpm

• • finalize the installation

sudo make install

RVLE 1.0.2

To install RVLE (R-Package for VLE), you need the last VLE version and R (of course) and development headers of R.

aptitude install r-base-dev r-cran-runit

To build the package:

wget http://sourceforge.net/projects/vle/files/1.0/1.0.2/rvle_1.0.2-0.tar.gz
tar xvfz rvle_1.0.2-0.tar.gz
sudo R CMD INSTALL rvle

PyVLE 1.0.2

To install PyVLE (Python for VLE), you need VLE 1.0.2, boost-python and Python (>= 2.5) and development headers of Python.

aptitude install libboost-python-dev python-dev

To build the port:

wget http://sourceforge.net/projects/vle/files/1.0/1.0.2/pyvle-1.0.2.tar.gz
tar zxf pyvle-1.0.2.tar.gz
cd pyvle-1.0.2
mkdir build
cd build
cmake -DCMAKE_BUILD_TYPE=RelWithDebInfo -DCMAKE_INSTALL_PREFIX=/usr ..
make

# And:
# * Debian and derivate distribution (Ubuntu etc.)
cpack -G DEB
sudo dpkg -i pyvle-1.0.2-Linux.deb

# * Redhat and derivate distribution (Fedora, Mandriva, Suse etc.)
cpack -G RPM
sudo rpm -i pyvle-1.0.2-Linux-i686.rpm

# * For all other
sudo make install

JVLE 1.0.2

To install JVLE (Java for VLE), you need VLE 1.0.2, a JRE and a JDK with JNI.

wget http://sourceforge.net/projects/vle/files/1.0/1.0.2/jvle-1.0.2.tar.gz
tar zxf jvle-1.0.2.tar.gz
cd jvle-1.0.2
mkdir build
cd build
cmake -DCMAKE_BUILD_TYPE=RelWithDebInfo -DCMAKE_INSTALL_PREFIX=/usr ..
make

# And:
# * Debian and derivate distribution (Ubuntu etc.)
cpack -G DEB
sudo dpkg -i jvle-1.0.2-Linux.deb

# * Redhat and derivate distribution (Fedora, Mandriva, Suse etc.)
cpack -G RPM
sudo rpm -i jvle-1.0.2-Linux-i686.rpm

# * For all other
sudo make install

Public API Changes

• package : update the root's CMakeLists.txt file in your packages:

< // VLE 0.8.x
< PKG_CHECK_MODULES(VLE vle-0.8)
> // VLE 1.0.x
> PKG_CHECK_MODULES(VLE vle-1.0)

• libvledevs (kernel vle)
  • devs::Dynamics::confluentTransitions : remove the const keywords and change the type returned by the function. The function now need to manager its behavior. It can call internal, external transition or add its own behavior. By default, the internal transition the external transition are called. Break API and ABI with VLE 0.8. :

< // VLE 0.8.x
< virtual vle::devs::Event::EventType confluentTransitions(
<             const vle::devs::Time& /* time */,
<             const vle::devs::ExternalEventList& /* extEventlist */) const
< {
<     return Event::INTERNAL;
< }
> VLE 1.0.x
> virtual void confluentTransitions(
>              const vle::devs::Time& time,
>             const vle::devs::ExternalEventList& extEventlist);
> {
>     internalTransition(time);
>     externalTransition(extEventList, time);
> }

• libvleoov
  • Merge output plug-ins CSV, Text, RData in a File plugin.
  • CVS, Rdata and text are deprecated.

• libvlevalue
  • The vle::devs::InitEventList is now an const vle::value::Map&.

< // VLE 0.8.x
< Model(const DynamicsInit& init, const vle::devs::InitEventList& events)
<     : devs::Dynamics(init, events)
< {
<     double x = events.get("x").toDouble().value();
< }
> // VLE 1.0.x
> Model(const DynamicsInit& init, const vle::devs::InitEventList& events)
>     : devs::Dynamics(init, events)
> {
>     double x = events.getDouble("x");
>     double x = events.get("x")->toDouble().value();
> }

Release notes

VLE 1.0.1 has been released to the world. See the the ChangeLog for details. Highlights include big changes of the GVLE program to improve the user experience like a new visualization of modeling, new dialog and new mechanism for a faster experience. Another feature is a Java bindings in addition to Python and R. The VLF (VLE Foundation Libraries) are updated to provide a clean and powerful API but these changes break the API and ABI between 0.8 and 1.0.

Many thanks for all contributors:

Mahuna Akplogan, Guillaume Ansel, Jennifer Baudet, Pierre Casadebaig, Patrick Chabrier, Rémy Desrivières, Raphael Duboz, David Duvivier, Loik Hameaux, Cyril Marcq, Tatiana Pruvost, Guillaume Radenne, Eric Ramat, Daniel Salomé, David Sauvage, Jérome Thiard, Ronan Trépos and Grégory Wisniewski

• git diff --stat --summary v0.8.0..v1.0.1

861 files changed, 69226 insertions(+), 40322 deletions(-)
0.4 to 0.5: 446 files changed, 39146 insertions(+), 20625 deletions(-)
0.5 to 0.6: 618 files changed, 51676 insertions(+), 6385 deletions(-)
0.6 to 0.7: 485 files changed, 18787 insertions(+), 10386 deletions(-)
0.7 to 0.8: 874 files changed, 78011 insertions(+), 25070 deletions(-)

• git diff --dirstat v0.8.0..v1.0.1

  3.8% i18n/
  3.4% share/
  3.5% src/examples/qss/
  7.4% src/examples/
  4.4% src/vle/devs/
  4.3% src/vle/extension/
  5.7% src/vle/gvle/modeling/fsa/
  4.1% src/vle/gvle/modeling/petrinet/
  6.7% src/vle/gvle/outputs/
 16.6% src/vle/gvle/
  4.4% src/vle/oov/plugins/cairo/
  3.2% src/vle/utils/
  6.4% src/vle/value/
  8.8% src/vle/

• cd vle ; git log -r v0.8.0..v1.0.1 | git shortlog -s ; cd ..

    1  Bruno Bonté
    1  Cyril Marcq
    1  David Duvivier
   22  Eric Ramat
   13  Gaetan Vergeot
  170  Gauthier Quesnel
   11  Guillaume Radenne
    1  Jennifer Baudet
    3  Jerome Thiard
    1  Mahuna Akplogan
   13  Patrick Chabrier
    9  Ronan Trépos
   16  Rémy Desrivieres
   12  Tatiana Pruvost

• cd rvle ; git log -r v0.8.0..v1.0.1 | git shortlog -s ; cd ..

   17  Gauthier Quesnel
    4  Patrick Chabrier
    1  Pierre Casadebaig
    4  Ronan Trépos

• cd pyvle ; git log v1.0.1 | git shortlog -s ; cd ..

   10  Daniel Salome
    8  Daniel Salomé
   23  Eric Ramat
   25  Gauthier Quesnel
    1  Grégory Wisniewski
    8  Jerome Thiard
    1  Sauvage David

• cd jvle ; git log v1.0.1 | git shortlog -s ; cd ..

    6  Eric Ramat
   23  Gauthier Quesnel
    8  Loik Hameaux