BlueM.Sim application - Revision history

Froehlich: fix download links

2024-10-03T15:53:31Z

fix download links

← Older revision		Revision as of 08:53, 3 October 2024
Line 13:		Line 13:
	===Releases starting from 0.9.1===		===Releases starting from 0.9.1===
	For individual simulations, it is easiest to use the '''[[BlueM.Win]]''' package.		For individual simulations, it is easiest to use the '''[[BlueM.Win]]''' package.
	* [~~[BlueM Downloads\|~~Download]] the precompiled package <code>BlueM.Win.zip</code> and unzip.		* [https://bluemodel.org/download/ Download] the precompiled package <code>BlueM.Win.zip</code> and unzip.
	* Start the program '''<code>BlueM.Win.exe</code>'''		* Start the program '''<code>BlueM.Win.exe</code>'''
	* Select a dataset		* Select a dataset

Froehlich: BlueM.QGISInterface

2022-03-05T12:56:54Z

BlueM.QGISInterface

← Older revision		Revision as of 05:56, 5 March 2022
Line 5:		Line 5:
	==Dataset==		==Dataset==
	* A BlueM.Sim dataset consists of several text files. The minimum requirements are an [[ALL-File]] - (general options) and a [[SYS-File]] - (System Plan). Furthermore, files for describing the different types of system elements must be included. All files must have the same filename (which is also the name of the dataset), only the file extensions differ. <small>(The name of the dataset should not be longer than 32 characters! ''See Bug 13'')</small>		* A BlueM.Sim dataset consists of several text files. The minimum requirements are an [[ALL-File]] - (general options) and a [[SYS-File]] - (System Plan). Furthermore, files for describing the different types of system elements must be included. All files must have the same filename (which is also the name of the dataset), only the file extensions differ. <small>(The name of the dataset should not be longer than 32 characters! ''See Bug 13'')</small>
			* A QGIS plugin for creating BlueM.Sim input files, developed by Martin Grosshaus as part of his Master Thesis, is available on GitHub: https://github.com/bluemodel/BlueM.QGISInterface
	* It is possible to create a dataset using [[TALSIM]], which can then be exported and used for BlueM.Sim. Minor modifications to the export files need to be carried out (see [[TALSIM Export]]).		* It is possible to create a dataset using [[TALSIM]], which can then be exported and used for BlueM.Sim. Minor modifications to the export files need to be carried out (see [[TALSIM Export]]).
	''See also [[BlueM Eingabedateien\|Input files]]''		''See also [[BlueM Eingabedateien\|Input files]]''

Froehlich: /* Release 0.9 */

2021-09-26T09:19:51Z

Release 0.9

← Older revision		Revision as of 02:19, 26 September 2021
Line 65:		Line 65:
	* In the simplest case the compiled EXE file ([[BlueM Downloads\|BlueM.exe]]) is in the same directory as the dataset to be simulated. In this case, simply launch the EXE and then enter the dataset name.		* In the simplest case the compiled EXE file ([[BlueM Downloads\|BlueM.exe]]) is in the same directory as the dataset to be simulated. In this case, simply launch the EXE and then enter the dataset name.
	* You can specify the name of the dataset directly as a parameter to pass to BlueM.exe		* You can specify the name of the dataset directly as a parameter to pass to BlueM.exe
	:<pre>C:\WorkingDir>"~~Path~~\to\BlueM.exe" datasetname</pre>		:<pre class="dos">C:\WorkingDir>"path\to\BlueM.exe" datasetname</pre>
	* To prevent the window from closing immediately when the simulation is finished or an error has occurred, a shortcut to BlueM.exe can be created. In the properties of the shortcut enter the following "target" :		* To prevent the window from closing immediately when the simulation is finished or an error has occurred, a shortcut to BlueM.exe can be created. In the properties of the shortcut enter the following "target":
	:<pre>cmd.exe /K "path\to\BlueM.exe"</pre>		:<pre>cmd.exe /K "path\to\BlueM.exe"</pre>
	:~~Under "Start in"~~ the working directory ~~must be specified, i.e.,~~ the directory in which the dataset is located.		:Also, specify the working directory as the directory in which the dataset is located.

	==Results==		==Results==

Froehlich: /* Release 0.9 */ formatting

2018-01-27T16:52:18Z

Release 0.9: formatting

← Older revision		Revision as of 09:52, 27 January 2018
Line 65:		Line 65:
	* In the simplest case the compiled EXE file ([[BlueM Downloads\|BlueM.exe]]) is in the same directory as the dataset to be simulated. In this case, simply launch the EXE and then enter the dataset name.		* In the simplest case the compiled EXE file ([[BlueM Downloads\|BlueM.exe]]) is in the same directory as the dataset to be simulated. In this case, simply launch the EXE and then enter the dataset name.
	* You can specify the name of the dataset directly as a parameter to pass to BlueM.exe		* You can specify the name of the dataset directly as a parameter to pass to BlueM.exe
	:<~~dos~~>C:\WorkingDir>"Path\to\BlueM.exe" datasetname</~~dos~~>		:<pre>C:\WorkingDir>"Path\to\BlueM.exe" datasetname</pre>
	* To prevent the window from closing immediately when the simulation is finished or an error has occurred, a shortcut to BlueM.exe can be created. In the properties of the shortcut enter the following "target" :		* To prevent the window from closing immediately when the simulation is finished or an error has occurred, a shortcut to BlueM.exe can be created. In the properties of the shortcut enter the following "target" :
	:<pre>cmd.exe /K "path\to\BlueM.exe"</pre>		:<pre>cmd.exe /K "path\to\BlueM.exe"</pre>

Froehlich: /* Using BlueM.Sim with OpenMI */ fix syntax highlighting

2013-12-08T13:17:04Z

Using BlueM.Sim with OpenMI: fix syntax highlighting

← Older revision		Revision as of 06:17, 8 December 2013
Line 22:		Line 22:
	====Using BlueM.Sim with OpenMI====		====Using BlueM.Sim with OpenMI====
	You need an OMI file, an example of which is provided below:		You need an OMI file, an example of which is provided below:
	<xml>		<source lang="xml">
	<LinkableComponent Type="IHWB.BlueM.OpenMIAdapter.BlueM_LinkableComponent" Assembly="D:\BlueM\IHWB.BlueM.OpenMIAdapter.dll">		<LinkableComponent Type="IHWB.BlueM.OpenMIAdapter.BlueM_LinkableComponent" Assembly="D:\BlueM\IHWB.BlueM.OpenMIAdapter.dll">
	<Arguments>		<Arguments>
Line 33:		Line 33:
	<Argument Key="Simulationsanfang" ReadOnly="true" Value="28.12.1967 00:00" />		<Argument Key="Simulationsanfang" ReadOnly="true" Value="28.12.1967 00:00" />
	</Arguments>		</Arguments>
	</LinkableComponent></~~xml~~>		</LinkableComponent>
			</source>

	The directories have to be modified to point to the correct locations on your computer.		The directories have to be modified to point to the correct locations on your computer.
Line 40:		Line 41:

	Location of the dataset (path and filename without ".ALL")		Location of the dataset (path and filename without ".ALL")
	<xml><Argument Key="FilePath" ReadOnly="true" Value="D:\Dataset\demoNA" /></~~xml~~>		<source lang="xml"><Argument Key="FilePath" ReadOnly="true" Value="D:\Dataset\demoNA" /></source>

	How many internal timesteps within one OpenMI timestep		How many internal timesteps within one OpenMI timestep
	<xml><Argument Key="AnzahlInterneZeitschritte" ReadOnly="true" Value="5" /></~~xml~~>		<source lang="xml"><Argument Key="AnzahlInterneZeitschritte" ReadOnly="true" Value="5" /></source>

	Use the water quality model ([[SWQM]])?		Use the water quality model ([[SWQM]])?
	<xml><Argument Key="Guetemodell" ReadOnly="true" Value="false" /></~~xml~~>		<source lang="xml"><Argument Key="Guetemodell" ReadOnly="true" Value="false" /></source>

	Use degradation processes in the quality model ?		Use degradation processes in the quality model ?
	<xml><Argument Key="Guetemodell_Abbauprozess" ReadOnly="true" Value="true" /></~~xml~~>		<source lang="xml"><Argument Key="Guetemodell_Abbauprozess" ReadOnly="true" Value="true" /></source>

	No effect yet !		No effect yet !
	<xml>		<source lang="xml">
	<Argument Key="Guetemodell_Dispersion" ReadOnly="true" Value="false" />		<Argument Key="Guetemodell_Dispersion" ReadOnly="true" Value="false" />
	<Argument Key="Guetemodell_Merge" ReadOnly="true" Value="false" /></~~xml~~>		<Argument Key="Guetemodell_Merge" ReadOnly="true" Value="false" />
			</source>

	Start date of the simulation:		Start date of the simulation:
	<xml><Argument Key="Simulationsanfang" ReadOnly="true" Value="28.12.1967 00:00" /></~~xml~~>		<source lang="xml"><Argument Key="Simulationsanfang" ReadOnly="true" Value="28.12.1967 00:00" /></source>

	===Release 0.9===		===Release 0.9===

Froehlich: /* Releases starting from 0.9.1 */ call it API

2013-09-13T22:03:09Z

Releases starting from 0.9.1: call it API

← Older revision		Revision as of 15:03, 13 September 2013
Line 18:		Line 18:
	* After successful simulation, view the simulation result in [[Wave]].		* After successful simulation, view the simulation result in [[Wave]].

	The computational core (<code>bluem.dll</code>) can be controlled ~~from another application~~ using the [[BlueM.DLLAdapter]].		The computational core (<code>bluem.dll</code>) can be controlled using the API of the [[BlueM.DLLAdapter]].

	====Using BlueM.Sim with OpenMI====		====Using BlueM.Sim with OpenMI====

Froehlich: /* Using BlueM.Sim with OpenMI */

2009-09-16T16:09:11Z

Using BlueM.Sim with OpenMI

← Older revision		Revision as of 09:09, 16 September 2009
Line 45:		Line 45:
	<xml><Argument Key="AnzahlInterneZeitschritte" ReadOnly="true" Value="5" /></xml>		<xml><Argument Key="AnzahlInterneZeitschritte" ReadOnly="true" Value="5" /></xml>

	Use the water quality model (SWQM)?		Use the water quality model ([[SWQM]])?
	<xml><Argument Key="Guetemodell" ReadOnly="true" Value="false" /></xml>		<xml><Argument Key="Guetemodell" ReadOnly="true" Value="false" /></xml>

Froehlich: /* Using BlueM.Sim with OpenMI */

2009-09-16T16:08:21Z

Using BlueM.Sim with OpenMI

← Older revision		Revision as of 09:08, 16 September 2009
Line 23:		Line 23:
	You need an OMI file, an example of which is provided below:		You need an OMI file, an example of which is provided below:
	<xml>		<xml>
	<LinkableComponent Type="IHWB.BlueM.OpenMIAdapter.BlueM_LinkableComponent" Assembly="D:\~~PRGLeitfaden\BIN\BlueMSWQM4~~\IHWB.BlueM.OpenMIAdapter.dll">		<LinkableComponent Type="IHWB.BlueM.OpenMIAdapter.BlueM_LinkableComponent" Assembly="D:\BlueM\IHWB.BlueM.OpenMIAdapter.dll">
	<Arguments>		<Arguments>
	<Argument Key="FilePath" ReadOnly="true" Value="D:\~~PRGLeitfaden~~\~~Fallbeispiele\Test\TestGueteQ\TestGuete~~" />		<Argument Key="FilePath" ReadOnly="true" Value="D:\Dataset\demoNA" />
	<Argument Key="AnzahlInterneZeitschritte" ReadOnly="true" Value="5" />		<Argument Key="AnzahlInterneZeitschritte" ReadOnly="true" Value="5" />
	<Argument Key="Guetemodell" ReadOnly="true" Value="false" />		<Argument Key="Guetemodell" ReadOnly="true" Value="false" />
Line 40:		Line 40:

	Location of the dataset (path and filename without ".ALL")		Location of the dataset (path and filename without ".ALL")
	<xml><Argument Key="FilePath" ReadOnly="true" Value="D:\~~PRGLeitfaden~~\~~Fallbeispiele\Test\TestGueteQ\TestGuete~~" /></xml>		<xml><Argument Key="FilePath" ReadOnly="true" Value="D:\Dataset\demoNA" /></xml>

	How many internal timesteps within one OpenMI timestep		How many internal timesteps within one OpenMI timestep

Froehlich: formatting

2009-09-16T16:04:29Z

formatting

← Older revision		Revision as of 09:04, 16 September 2009
Line 8:		Line 8:
	''See also [[BlueM Eingabedateien\|Input files]]''		''See also [[BlueM Eingabedateien\|Input files]]''

	==~~OpenMI~~==		==Simulation==
			[[File:BlueMWin_screenshot.png\|thumb\|BlueM.Win Screenshot]]
			===Releases starting from 0.9.1===
			For individual simulations, it is easiest to use the '''[[BlueM.Win]]''' package.
			* [[BlueM Downloads\|Download]] the precompiled package <code>BlueM.Win.zip</code> and unzip.
			* Start the program '''<code>BlueM.Win.exe</code>'''
			* Select a dataset
			* Start the simulation
			* After successful simulation, view the simulation result in [[Wave]].

	~~Omifile~~:		The computational core (<code>bluem.dll</code>) can be controlled from another application using the [[BlueM.DLLAdapter]].
	<~~XML~~>
			====Using BlueM.Sim with OpenMI====
			You need an OMI file, an example of which is provided below:
			<xml>
	<LinkableComponent Type="IHWB.BlueM.OpenMIAdapter.BlueM_LinkableComponent" Assembly="D:\PRGLeitfaden\BIN\BlueMSWQM4\IHWB.BlueM.OpenMIAdapter.dll">		<LinkableComponent Type="IHWB.BlueM.OpenMIAdapter.BlueM_LinkableComponent" Assembly="D:\PRGLeitfaden\BIN\BlueMSWQM4\IHWB.BlueM.OpenMIAdapter.dll">
	<Arguments>		<Arguments>
Line 22:		Line 33:
	<Argument Key="Simulationsanfang" ReadOnly="true" Value="28.12.1967 00:00" />		<Argument Key="Simulationsanfang" ReadOnly="true" Value="28.12.1967 00:00" />
	</Arguments>		</Arguments>
	</LinkableComponent>		</LinkableComponent></xml>

	~~<!--~~		The directories have to be modified to point to the correct locations on your computer.
	~~DEMOFILE:~~

	~~The directories have to be modified.~~		<u>Explanation of the argument keys:</u>

	~~Where lies~~ the dataset (path and filename without ".~~all~~")		Location of the dataset (path and filename without ".ALL")
	<Argument Key="FilePath" ReadOnly="true" Value="D:\PRGLeitfaden\Fallbeispiele\Test\TestGueteQ\TestGuete" />		<xml><Argument Key="FilePath" ReadOnly="true" Value="D:\PRGLeitfaden\Fallbeispiele\Test\TestGueteQ\TestGuete" /></xml>

	How many internal timesteps within one ~~openMI~~ timestep		How many internal timesteps within one OpenMI timestep
	<Argument Key="AnzahlInterneZeitschritte" ReadOnly="true" Value="5" />		<xml><Argument Key="AnzahlInterneZeitschritte" ReadOnly="true" Value="5" /></xml>

	~~With~~ quality model ?		Use the water quality model (SWQM)?
	<Argument Key="Guetemodell" ReadOnly="true" Value="false" />		<xml><Argument Key="Guetemodell" ReadOnly="true" Value="false" /></xml>

	~~With prozesses of~~ the quality model ?		Use degradation processes in the quality model ?
	<Argument Key="Guetemodell_Abbauprozess" ReadOnly="true" Value="true" />		<xml><Argument Key="Guetemodell_Abbauprozess" ReadOnly="true" Value="true" /></xml>

	No effect yet !		No effect yet !
			<xml>
	<Argument Key="Guetemodell_Dispersion" ReadOnly="true" Value="false" />		<Argument Key="Guetemodell_Dispersion" ReadOnly="true" Value="false" />
	<Argument Key="Guetemodell_Merge" ReadOnly="true" Value="false" />		<Argument Key="Guetemodell_Merge" ReadOnly="true" Value="false" /></xml>

	~~start date of the simulation~~
	<~~Argument Key="Simulationsanfang" ReadOnly="true" Value="28.12.1967 00:00"~~ />


	~~-->~~
	~~</XML>~~
	~~==Simulation==~~
	~~[[File:BlueMWin_screenshot.png\|thumb\|BlueM.Win Screenshot]]~~
	~~===Releases starting from 0.9.1===~~
	~~For individual simulations, it is easiest to use the '''[[BlueM.Win]]''' package.~~
	* [[BlueM Downloads\|Download]] the precompiled package <code>BlueM.Win.zip</code> and unzip.
	* Start the program <code>BlueM.Win.exe</code>
	* Select a dataset
	* Start the simulation
	* After successful simulation, view the simulation result in [[Wave]].

	~~The computational core (~~<~~code~~>~~bluem~~.~~dll<~~/~~code~~>~~) can be controlled from another application using the [[BlueM.DLLAdapter]].~~<~~br clear="all"~~/>		Start date of the simulation:
			<xml><Argument Key="Simulationsanfang" ReadOnly="true" Value="28.12.1967 00:00" /></xml>

	===Release 0.9===		===Release 0.9===

Reussner at 15:36, 16 September 2009

2009-09-16T15:36:47Z

@@ Line 8: / Line 8: @@
 ''See also [[BlueM Eingabedateien|Input files]]''
 ==Simulation==
 [[File:BlueMWin_screenshot.png|thumb|BlueM.Win Screenshot]]