VLE-1.0

= 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.3. For a detailed description for changes, see the Release notes of VLE-1.0.3.

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. You need to choose installation of "g++" and "fortran" compiler during installation og MinGW. 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.15.0-win.exe, download and install the R program.
 * Install the R Package Runit from CRAN.
 * rvle_1.0.3-3.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

WARNING: on ubuntu 12.10, ask for a patch on source code required for the compatibility with the new version of glib.

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

wget http://sourceforge.net/projects/vle/files/1.0/1.0.3/vle-1.0.3.tar.gz tar zxf vle-1.0.3.tar.gz cd vle-1.0.3 mkdir build cd build
 * Installation
 * Download the vle main part:
 * Uncompress the package:
 * Prepare the necessary repertory:

cmake -DCMAKE_BUILD_TYPE=RelWithDebInfo -DCMAKE_INSTALL_PREFIX=/usr .. make
 * Build the package


 * Prepare package for installation

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

under debian 6.0.4 to avoid a bug with cmake sudo make install sudo dpkg -i vle-1.0.3-Linux-i686.deb under Redhat and derivate distribution (Fedora, Mandriva, Suse etc.) cpack -G RPM sudo rpm -i vle-1.0.3-Linux-i686.rpm sudo make install
 * finalize the installation

RVLE 1.0.3
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.3/rvle_1.0.3-3.tar.gz tar xvfz rvle_1.0.3-3.tar.gz sudo R CMD INSTALL rvle

PyVLE 1.0.3
To install PyVLE (Python for VLE), you need VLE 1.0.3, 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.3/pyvle-1.0.3.tar.gz tar zxf pyvle-1.0.3.tar.gz cd pyvle-1.0.3 mkdir build cd build cmake -DCMAKE_BUILD_TYPE=RelWithDebInfo -DCMAKE_INSTALL_PREFIX=/usr .. make cpack -G DEB sudo dpkg -i pyvle-1.0.3-Linux.deb cpack -G RPM sudo rpm -i pyvle-1.0.3-Linux-i686.rpm sudo make install
 * 1) And:
 * 2) * Debian and derivate distribution (Ubuntu etc.)
 * 1) * Redhat and derivate distribution (Fedora, Mandriva, Suse etc.)
 * 1) * For all other

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

wget http://sourceforge.net/projects/vle/files/1.0/1.0.3/jvle-1.0.3.tar.gz tar zxf jvle-1.0.3.tar.gz cd jvle-1.0.3 mkdir build cd build cmake -DCMAKE_BUILD_TYPE=RelWithDebInfo -DCMAKE_INSTALL_PREFIX=/usr .. make cpack -G DEB sudo dpkg -i jvle-1.0.3-Linux.deb cpack -G RPM sudo rpm -i jvle-1.0.3-Linux-i686.rpm sudo make install
 * 1) And:
 * 2) * Debian and derivate distribution (Ubuntu etc.)
 * 1) * Redhat and derivate distribution (Fedora, Mandriva, Suse etc.)
 * 1) * For all other

Public API Changes

 * package : update the root's CMakeLists.txt file in your packages:
 * 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. :


 * 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&.

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

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 --stat --summary 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/
 * git diff --dirstat v0.8.0..v1.0.1

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 vle ; 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 rvle ; git log -r v0.8.0..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 pyvle ; git log v1.0.1 | git shortlog -s ; cd ..

6 Eric Ramat 23 Gauthier Quesnel 8 Loik Hameaux
 * cd jvle ; git log v1.0.1 | git shortlog -s ; cd ..