Recent changes to Home

Home modified by Edmund Widl

Edmund Widl — Fri, 20 Oct 2017 16:06:01 -0000

--- v19
+++ v20
@@ -1,44 +1,17 @@
-FUMOLA installation instructions
+The FUMOLA co-simulation environment
 ===
+Welcome to the online documentation of FUMOLA, a co-simulation environment based on the [Ptolemy II](http://ptolemy.eecs.berkeley.edu/ptolemyII/ptII10.0/ptII/ptolemy/domains/de/doc/index.htm) simulation framework.

-Prerequisites
----
+[About FUMOLA](About%20FUMOLA): Read about the FUMOLA basics, including a discussion of the provided FMU actors.

-* This binary version of FUMOLA is intended to be installed on top of **Ptolemy II 10.0.1 (32-bit) on Windows**. Get the Windows 32-bit Installer [here](http://ptolemy.eecs.berkeley.edu/ptolemyII/ptII10.0/index.htm "Ptolemy II 10.0.1 download page").
-* Installation of Ptolemy II via the Windows Installer requires a Java Runtime Environment to be installed, e.g. from [here](http://www.oracle.com/technetwork/java/javase/downloads/index.html "Oracle Java SE Downloads").
-* The minimum **Ptolemy II packs** that need to be selected for installation are: **Ptiny**, **Full** & **JRE**.
+[Installation (binary version)](Installation%20%28binary%20version%29): The easiest way to install FUMOLA is this binary version (Windows 32-bit).

+[Installation (from source code)](Installation%20%28from%20source%20code%29): Advanced users and non-Windows users may want to build and install FUMOLA directly from source code.

-FUMOLA installation
----
+[Running simulations with FUMOLA](Running%20simulations%20with%20FUMOLA): Overview of how to run co-simulations with FUMOLA.

-* Download file *fumola-install.zip*, see download button below.
-* Unzip *fumola-install.zip* and change to folder *fumola-install*.
-* In case you did not choose the default installation path for Ptolemy II (*C:\Ptolemy\ptII10.0.1*), you need to adapt *install.bat*.
-    * Open it in an editor and point variable PTII (line 4) to your Ptolemy II installation directory.
-    * For instance, in case your Ptolemy II installation directory is *D:\My Development\ptII*, then line 4 of *install.bat* should read like this: *SET PTII="D:\My Development\ptII"*
-* Run *install.bat* by double-clicking it.
-* Finally, add Ptolemy II's *lib* directory to the Windows system path.
-    * Look for instance [here](https://de.mathworks.com/matlabcentral/answers/94933-how-do-i-set-my-system-path-under-windows "How do I set my system path under Windows?") for instructions on how to do that.
-    * For instance, in case you chose the default installation path for Ptolemy II (*C:\Ptolemy\ptII10.0.1*), you have to add *C:\Ptolemy\ptII10.0.1\lib* to the Windows system path.
-* Done.
+[Creating FUMOLA models using Vergil](Creating%20FUMOLA%20models%20using%20Vergil): Using Vergil, Ptolemy II's graphical user interface, is the easiest and most convenient way to set up your own co-simulation.

-
-Troubleshooting
----
-
-When starting *vergil.exe*, the following error message indicates that the Windows system path has not been set correctly:
-~~~
-Error encountered in:
-<entity name="FMUDebugger" class="fumola.base.FMUDebugger">
-no fmippim_wrap_java in java.library.path
-~~~
-In this case please check again that you included Ptolemy II's ***lib*** folder in the system path. In case you chose the default installation path you should add *C:\Ptolemy\ptII10.0.1\lib* to the system path.
-
-* * *
-
-In case Ptolemy II crashes without any warning or error message when starting a simulation, check if [Windows Update KB2533623](https://support.microsoft.com/en-us/kb/2533623 "Windows Update KB2533623") has already been installed.
-
-
+[Creating FUMOLA models using the JAVA Kernel API](Creating%20FUMOLA%20models%20using%20the%20JAVA%20Kernel%20API): When using graphical models is not feasible anymore, FUMOLA co-simulation models can also be done in JAVA.

 [[download_button]]

Home modified by Edmund Widl

Edmund Widl — Mon, 11 Jul 2016 10:41:38 -0000

--- v18
+++ v19
@@ -37,8 +37,7 @@

 * * *

-In case Ptolemy II crashes without any warning when starting a simulation,
-check if [Windows Update KB2533623](https://support.microsoft.com/en-us/kb/2533623 "Windows Update KB2533623") has been installed.
+In case Ptolemy II crashes without any warning or error message when starting a simulation, check if [Windows Update KB2533623](https://support.microsoft.com/en-us/kb/2533623 "Windows Update KB2533623") has already been installed.

Home modified by Edmund Widl

Edmund Widl — Mon, 11 Jul 2016 10:40:39 -0000

--- v17
+++ v18
@@ -27,23 +27,6 @@
 Troubleshooting
 ---

-In case the installation was not successfull you may get the following error messages when starting *vergil.exe*:
-~~~
-Error encountered in:
-<entity name="FMUDebugger" class="fumola.base.FMUDebugger">
-at/ait/fmipp/LogBuffer
-~~~
-
-This indicates that at the startup of *vergil.exe* the Java archive *fmipp.jar* is for some reason not found. In such a case, the easiest solution is the following:
-
-* Copy *fmipp.jar*, found in subfolder *.ptolemyII* of *fumola-install*, to the Ptolemy II installation directory (by default *C:\Ptolemy\ptII10.0.1*).
-* Extract *fmipp.jar* directly in the Ptolemy II installation directory, using e.g. [7-zip](http://7-zip.org/).
-* This creates a new folder called *at* in the Ptolemy II installation directory.
-* Done.
-
-
-* * *
-
 When starting *vergil.exe*, the following error message indicates that the Windows system path has not been set correctly:
 ~~~
 Error encountered in:
@@ -52,5 +35,11 @@
 ~~~
 In this case please check again that you included Ptolemy II's ***lib*** folder in the system path. In case you chose the default installation path you should add *C:\Ptolemy\ptII10.0.1\lib* to the system path.

+* * *
+
+In case Ptolemy II crashes without any warning when starting a simulation,
+check if [Windows Update KB2533623](https://support.microsoft.com/en-us/kb/2533623 "Windows Update KB2533623") has been installed.
+
+

 [[download_button]]

Home modified by Edmund Widl

Edmund Widl — Fri, 01 Jul 2016 09:15:46 -0000

--- v16
+++ v17
@@ -44,7 +44,7 @@

 * * *

-The following error message indicates that the Windows system path has not been set correctly:
+When starting *vergil.exe*, the following error message indicates that the Windows system path has not been set correctly:
 ~~~
 Error encountered in:
 <entity name="FMUDebugger" class="fumola.base.FMUDebugger">

Home modified by Edmund Widl

Edmund Widl — Fri, 01 Jul 2016 09:14:11 -0000

--- v15
+++ v16
@@ -42,4 +42,15 @@
 * Done.

+* * *
+
+The following error message indicates that the Windows system path has not been set correctly:
+~~~
+Error encountered in:
+<entity name="FMUDebugger" class="fumola.base.FMUDebugger">
+no fmippim_wrap_java in java.library.path
+~~~
+In this case please check again that you included Ptolemy II's ***lib*** folder in the system path. In case you chose the default installation path you should add *C:\Ptolemy\ptII10.0.1\lib* to the system path.
+
+
 [[download_button]]

Home modified by Edmund Widl

Edmund Widl — Thu, 30 Jun 2016 11:55:42 -0000

--- v14
+++ v15
@@ -27,14 +27,14 @@
 Troubleshooting
 ---

-In case the installation was not successfull you may get the following error messages when starting vergil:
+In case the installation was not successfull you may get the following error messages when starting *vergil.exe*:
 ~~~
 Error encountered in:
 <entity name="FMUDebugger" class="fumola.base.FMUDebugger">
 at/ait/fmipp/LogBuffer
 ~~~

-This indicates that at the startup of vergil the Java archive *fmipp.jar* is for some reason not found. In such a case, the easiest solution is the following:
+This indicates that at the startup of *vergil.exe* the Java archive *fmipp.jar* is for some reason not found. In such a case, the easiest solution is the following:

 * Copy *fmipp.jar*, found in subfolder *.ptolemyII* of *fumola-install*, to the Ptolemy II installation directory (by default *C:\Ptolemy\ptII10.0.1*).
 * Extract *fmipp.jar* directly in the Ptolemy II installation directory, using e.g. [7-zip](http://7-zip.org/).

Home modified by Edmund Widl

Edmund Widl — Thu, 30 Jun 2016 11:54:31 -0000

--- v13
+++ v14
@@ -23,10 +23,8 @@
     * For instance, in case you chose the default installation path for Ptolemy II (*C:\Ptolemy\ptII10.0.1*), you have to add *C:\Ptolemy\ptII10.0.1\lib* to the Windows system path.
 * Done.

-[[download_button]]

-
-Trouble shooting
+Troubleshooting
 ---

 In case the installation was not successfull you may get the following error messages when starting vergil:
@@ -38,7 +36,10 @@

 This indicates that at the startup of vergil the Java archive *fmipp.jar* is for some reason not found. In such a case, the easiest solution is the following:

-* Copy *fmipp.jar* found in subfolder *.ptolemyII* of *fumola-install* to the Ptolemy II installation directory (be default *C:\Ptolemy\ptII10.0.1*).
+* Copy *fmipp.jar*, found in subfolder *.ptolemyII* of *fumola-install*, to the Ptolemy II installation directory (by default *C:\Ptolemy\ptII10.0.1*).
 * Extract *fmipp.jar* directly in the Ptolemy II installation directory, using e.g. [7-zip](http://7-zip.org/).
-* This should create a new folder called *at* in the Ptolemy II installation directory.
+* This creates a new folder called *at* in the Ptolemy II installation directory.
 * Done.
+
+
+[[download_button]]

Home modified by Edmund Widl

Edmund Widl — Thu, 30 Jun 2016 11:52:59 -0000

--- v12
+++ v13
@@ -35,7 +35,9 @@
 <entity name="FMUDebugger" class="fumola.base.FMUDebugger">
 at/ait/fmipp/LogBuffer
 ~~~
+
 This indicates that at the startup of vergil the Java archive *fmipp.jar* is for some reason not found. In such a case, the easiest solution is the following:
+
 * Copy *fmipp.jar* found in subfolder *.ptolemyII* of *fumola-install* to the Ptolemy II installation directory (be default *C:\Ptolemy\ptII10.0.1*).
 * Extract *fmipp.jar* directly in the Ptolemy II installation directory, using e.g. [7-zip](http://7-zip.org/).
 * This should create a new folder called *at* in the Ptolemy II installation directory.

Home modified by Edmund Widl

Edmund Widl — Thu, 30 Jun 2016 11:52:25 -0000

--- v11
+++ v12
@@ -24,3 +24,19 @@
 * Done.

 [[download_button]]
+
+
+Trouble shooting
+---
+
+In case the installation was not successfull you may get the following error messages when starting vergil:
+~~~
+Error encountered in:
+<entity name="FMUDebugger" class="fumola.base.FMUDebugger">
+at/ait/fmipp/LogBuffer
+~~~
+This indicates that at the startup of vergil the Java archive *fmipp.jar* is for some reason not found. In such a case, the easiest solution is the following:
+* Copy *fmipp.jar* found in subfolder *.ptolemyII* of *fumola-install* to the Ptolemy II installation directory (be default *C:\Ptolemy\ptII10.0.1*).
+* Extract *fmipp.jar* directly in the Ptolemy II installation directory, using e.g. [7-zip](http://7-zip.org/).
+* This should create a new folder called *at* in the Ptolemy II installation directory.
+* Done.

Home modified by Edmund Widl

Edmund Widl — Thu, 30 Jun 2016 09:09:45 -0000

--- v10
+++ v11
@@ -14,7 +14,7 @@

 * Download file *fumola-install.zip*, see download button below.
 * Unzip *fumola-install.zip* and change to folder *fumola-install*.
-* In case you did not chose the default installation path for Ptolemy II (*C:\Ptolemy\ptII10.0.1*), you need to adapt *install.bat*.
+* In case you did not choose the default installation path for Ptolemy II (*C:\Ptolemy\ptII10.0.1*), you need to adapt *install.bat*.
     * Open it in an editor and point variable PTII (line 4) to your Ptolemy II installation directory.
     * For instance, in case your Ptolemy II installation directory is *D:\My Development\ptII*, then line 4 of *install.bat* should read like this: *SET PTII="D:\My Development\ptII"*
 * Run *install.bat* by double-clicking it.