BlueM.Opt Usage: Difference between revisions

From BlueM
Jump to navigation Jump to search
(commented out the section about using a custom version of Talsim because it's not yet implemented.)
(→‎Notes: Add note for Access driver)
 
(3 intermediate revisions by the same user not shown)
Line 21: Line 21:


==Notes==
==Notes==
=== Modifications to the dataset ===
=== Dataset locations and simulation results ===
BlueM.Opt creates copies of the dataset for carrying out the simulations. These copies are located in the directory containing <code>BlueM.Opt.exe</code>and are called <code>Thread_01</code>, <code>Thread_02</code>, etc.
BlueM.Opt creates copies of the dataset for carrying out the simulations. These copies are located in the directory containing <code>BlueM.Opt.exe</code> and are called <code>Thread_01</code>, <code>Thread_02</code>, etc. Once the objective function values have been calculated, the dataset together with the simulation results in these folders are deleted/overwritten.


The original dataset is only modified and used for simulation in the following two cases:
In order to view hydrographs and/or obtain the full simulation results of specific solutions, select a solution by clicking on it in any of the diagrams and then click the button in the ''Selected solutions'' dialog. This will cause the selected solution(s) to be simulated again, but this time in a subfolder of the original dataset named "solution_X", where X is the solution ID.
# when using [[SensiPlot]]
 
# when selecting a solution and reevaluating that solution for displaying the hydrographs in [[Wave]].
When using [[SensiPlot]], the setting ''Save individual datasets'' causes each indivual datasets to be simulated in a subfolder of the original dataset named "sensiplot_X", where X is the solution ID. If the aforementioned setting is deactivated, the dataset modifications and simulations are carried out using the original dataset.
 
=== Microsoft.ACE.OLEDB.12.0 Provider ===
BlueM.Opt stores optimization results in a MS Access database. This requires a corresponding driver to be installed on the machine. If you have Microsoft Office installed, this driver is usually already installed. However, if you have the 32bit version of Office installed, you will have to additionally install the x64-version of the driver for BlueM.Opt, which is a x64 program, to work.
 
A missing driver will result in the following or similar error message when setting the method:
<blockquote>
The Microsoft.ACE.OLEDB.12.0 Provider is not registered on the local machine
 
Der Microsoft.ACE.OLEDB.12.0 Provider ist nicht auf dem lokalen Computer registriert
</blockquote>
 
To fix this, download and install <code>AccessDatabaseEngine_X64.exe</code> from here: https://www.microsoft.com/en-US/download/details.aspx?id=13255


<!--
<!--
=== Using a custom version of Talsim ===
=== Using a custom version of Talsim ===
Currently, Talsim-NG v3.0.1.6 is included in BlueM.Opt. To use a custom version of Talsim, edit the <code>user.config</code> file located in the BlueM.Opt directory under the following directory: <code>C:\Users\[USERNAME]\AppData\Local\BlueM_Dev_Group\</code>.
Currently, Talsim-NG v3.0.1.6 is included in BlueM.Opt and is located under <code>\TALSIM\talsimw64.exe</code>. To use a custom version of Talsim, edit the <code>user.config</code> file located in the following location: <code>C:\Users\[USERNAME]\AppData\Local\BlueM_Dev_Group\BlueM.Opt.exe_Url_[]\[version]\user.config</code> and change the value of the setting <code>TALSIM_path</code> to contain the path to the desired custom Talsim executable. Restart BlueM.Opt in order for the chage to take effect.
-->
-->


[[Category:BlueM.Opt Usage|*]]
[[Category:BlueM.Opt Usage|*]]

Latest revision as of 02:52, 17 November 2022

EVO.png BlueM.Opt | Download | Usage | Development

Demonstration videos

Quickstart

  1. Start BlueM.Opt.exe
  2. Select an App (e.g. BlueM.Sim)
  3. Select an appropriate Dataset
  4. Select a Method (algorithm) (e.g. PES or SensiPlot)
  5. optionally adjust or load the settings
  6. Press the Start button

See also

Notes

Dataset locations and simulation results

BlueM.Opt creates copies of the dataset for carrying out the simulations. These copies are located in the directory containing BlueM.Opt.exe and are called Thread_01, Thread_02, etc. Once the objective function values have been calculated, the dataset together with the simulation results in these folders are deleted/overwritten.

In order to view hydrographs and/or obtain the full simulation results of specific solutions, select a solution by clicking on it in any of the diagrams and then click the button in the Selected solutions dialog. This will cause the selected solution(s) to be simulated again, but this time in a subfolder of the original dataset named "solution_X", where X is the solution ID.

When using SensiPlot, the setting Save individual datasets causes each indivual datasets to be simulated in a subfolder of the original dataset named "sensiplot_X", where X is the solution ID. If the aforementioned setting is deactivated, the dataset modifications and simulations are carried out using the original dataset.

Microsoft.ACE.OLEDB.12.0 Provider

BlueM.Opt stores optimization results in a MS Access database. This requires a corresponding driver to be installed on the machine. If you have Microsoft Office installed, this driver is usually already installed. However, if you have the 32bit version of Office installed, you will have to additionally install the x64-version of the driver for BlueM.Opt, which is a x64 program, to work.

A missing driver will result in the following or similar error message when setting the method:

The Microsoft.ACE.OLEDB.12.0 Provider is not registered on the local machine

Der Microsoft.ACE.OLEDB.12.0 Provider ist nicht auf dem lokalen Computer registriert

To fix this, download and install AccessDatabaseEngine_X64.exe from here: https://www.microsoft.com/en-US/download/details.aspx?id=13255