BlueM.DLLAdapter: Difference between revisions

Latest revision as of 09:19, 27 January 2018

BlueM.DLLAdapter ist ein .NET Wrapper zum Ansprechen des BlueM.Sim Rechenkerns in DLL-Form.

Schnittstellendefinitionen

Klassendiagramm

Nachfolgend werden die Schnittstellen-Methoden zur Kommunikation mit der BlueM.Sim DLL mit den zugehörigen Übergabe- bzw. Rückgabeparametern aufgelistet.

Falls ein Fehler auftritt wird die Methode CreateAndThrowException aufgerufen (schmeisst einen Fehler).

Basismethoden

Initialize

public void Initialize(string filePath)

filePath ist der Absolute Pfad mit dem Projektnamen ohne die Dateiendung .ALL (Bsp.: "D:\Simulation\TSIM").

Das System wird initialisiert und alle zugehörigen Daten aus den Simulationsdateien geladen.

PerformTimeStep

public void PerformTimeStep()

Berechnet den nächsten Zeitschritt.

Finish / Dispose

 public void Finish()
 public void Dispose()

Schliessen aller Dateien und Freigabe des Speichers

Datumsangaben

 public DateTime GetCurrentTime()
 public DateTime GetSimulationStartDate()
 public DateTime GetSimulationEndDate()

Was sind die Simulationszeiten (Anfang und Ende). Wo befinden wir uns gerade (GetCurrentTime) - wird nach jedem PerformTimeStep wietergeschoben.

Anwendungsbeispiel

Beispiel zur Nutzung des Bluem.DLLAdapters zur Simulation mittels BlueM.dll in VB.NET (Anwendung nur mit einer Simulation - SingleDLL):

'Einmal zu Beginn instanzieren
bluem_dll = New BlueM_EngineDotNetAccess("Pfad-zu-BlueM.dll")

...

Try

    Call bluem_dll.Initialize("Pfad-zu-Datensatz")

    Dim SimEnde As DateTime = BlueM_EngineDotNetAccess.DateTime(bluem_dll.GetSimulationEndDate())

    'Schleife über Simulationszeitraum 
    Do While (BlueM_EngineDotNetAccess.DateTime(bluem_dll.GetCurrentTime) <= SimEnde)
        Call bluem_dll.PerformTimeStep()
    Loop

    'Simulation abschliessen
    Call bluem_dll.Finish()

    'Simulation abgeschlossen
    MsgBox("Simulation erfolgreich!", MsgBoxStyle.Information, "BlueM")

    simOK = True

Catch ex As Exception

    'Simulationsfehler aufgetreten
    MsgBox(ex.Message, MsgBoxStyle.Exclamation, "BlueM")

    'Simulation abschliessen
    Call bluem_dll.Finish()

    simOK = False

Finally

    'Ressourcen deallokieren
    Call bluem_dll.Dispose()

End Try

@@ Line 1: / Line 1: @@
-== Schnittstellendefnitionen ==
+'''BlueM.DLLAdapter''' ist ein .NET Wrapper zum Ansprechen des [[BlueM.Sim]] Rechenkerns in DLL-Form.
-Nachfolgend werden die Schnittstellen-Methoden zur Kommunikation mit der BlueM DLL mit den zugehörigen Übergabe- bzw. Rückgabeparametern aufgelistet.
-Falls ein Fehler auftritt wird die Methode "CreateAndThrowException" aufgerufen (schmeisst einen Fehler).
+==Schnittstellendefinitionen==
-* Basismethoden
+[[Bild:BlueM DLL Wrapper.png|thumb|Klassendiagramm]]
-:* Initialize
+Nachfolgend werden die Schnittstellen-Methoden zur Kommunikation mit der BlueM.Sim DLL mit den zugehörigen Übergabe- bzw. Rückgabeparametern aufgelistet.
-:<csharp>public void Initialize(string filePath)</csharp>
-:"filePath" ist der Absolute Pfad mit dem Projektnamen ohne die Dateiendung .ALL (Bsp. "d:\Simulation\TSIM").
+Falls ein Fehler auftritt wird die Methode <code>CreateAndThrowException</code> aufgerufen (schmeisst einen Fehler).
+===Basismethoden===
+'''Initialize'''
+<source lang="csharp">public void Initialize(string filePath)</source>
+:<code>filePath</code> ist der Absolute Pfad mit dem Projektnamen ohne die Dateiendung <code>.ALL</code> (Bsp.: <code>"D:\Simulation\TSIM"</code>).
 :Das System wird initialisiert und alle zugehörigen Daten aus den Simulationsdateien geladen.
-:* PerformTimeStep
-:<csharp>public void PerformTimeStep()</csharp>
+'''PerformTimeStep'''
+<source lang="csharp">public void PerformTimeStep()</source>
 :Berechnet den nächsten Zeitschritt.
-:* Finish / Dispose
-:<csharp> public void Finish()</csharp>
-:<csharp> public void Dispose()</csharp>
-:Schliessen alle Dateien und freigabe des Speichers
-* Auszuge aus dem Quellcode
-<csharp>
-namespace IHWB.OpenMI.BlueM
-{
-    public class BlueM_EngineDotNetAccess
-    {
-        #region Basisfunktionen
-        public void Initialize(string filePath)
-        public void Finish()
-        public void Dispose()
-        public void PerformTimeStep()
-        #endregion
-        #region ModelInfo
-        public string GetModelDescription()
-        public string GetModelID()
-        #endregion
-        #region Exchangeobjekte
+'''Finish / Dispose'''
+<source lang="csharp">
+ public void Finish()
+ public void Dispose()
+</source>
+:Schliessen aller Dateien und Freigabe des Speichers
-        public int GetNumberOfNodes()
+'''Datumsangaben'''
+<source lang="csharp">
+ public DateTime GetCurrentTime()
+ public DateTime GetSimulationStartDate()
+ public DateTime GetSimulationEndDate()
+</source>
+:Was sind die Simulationszeiten (Anfang und Ende). Wo befinden wir uns gerade (GetCurrentTime) - wird nach jedem PerformTimeStep wietergeschoben.
-        public string GetNodeKennung(int NodeID)
+==Anwendungsbeispiel==
+Beispiel zur Nutzung des Bluem.DLLAdapters zur Simulation mittels BlueM.dll in VB.NET (Anwendung nur mit einer Simulation - ''SingleDLL''):
+<source lang="vbnet">
+'Einmal zu Beginn instanzieren
+bluem_dll = New BlueM_EngineDotNetAccess("Pfad-zu-BlueM.dll")
-        public double GetYCoordinate(int NodeID)
+...
-        public double GetXCoordinate(int NodeID)
+Try
-        #endregion
+    Call bluem_dll.Initialize("Pfad-zu-Datensatz")
-        #region Zeit_methoden
+    Dim SimEnde As DateTime = BlueM_EngineDotNetAccess.DateTime(bluem_dll.GetSimulationEndDate())
-         public int GetTimeStepLength()
+    'Schleife über Simulationszeitraum
+    Do While (BlueM_EngineDotNetAccess.DateTime(bluem_dll.GetCurrentTime) <= SimEnde)
+         Call bluem_dll.PerformTimeStep()
+    Loop
-        public string GetCurrentTime()
+    'Simulation abschliessen
+    Call bluem_dll.Finish()
-        public string GetSimulationStartDate()
-        public string GetSimulationEndDate()
+    'Simulation abgeschlossen
+    MsgBox("Simulation erfolgreich!", MsgBoxStyle.Information, "BlueM")
-        #endregion
+    simOK = True
-        #region Get_SET_VALUES
+Catch ex As Exception
-        public double Get_Qab(int index)
+    'Simulationsfehler aufgetreten
+    MsgBox(ex.Message, MsgBoxStyle.Exclamation, "BlueM")
-        public void Set_Qzu(int index, double inflow)
+    'Simulation abschliessen
+    Call bluem_dll.Finish()
-        #endregion
+    simOK = False
-        #region Private_methoden
+Finally
-        private void CreateAndThrowException()
+    'Ressourcen deallokieren
-        {
+    Call bluem_dll.Dispose()
-            int numberOfMessages = 0;
-            numberOfMessages = mBlueM_DLLMethoden.GetNumberOfMessages();
-            string message = "Error Message from BlueM Fortran Core ";
-            for (int i = 0; i < numberOfMessages; i++)
+End Try
-            {
+</source>
-                int n = i+1; // Fortran zählt ab 1 (nicht 0)
-                StringBuilder messageFromCore = new StringBuilder("                                                        ");
-                mBlueM_DLLMethoden.GetMessage(ref n, messageFromCore, (uint)messageFromCore.Length);
-                message += "; ";
-                message += messageFromCore.ToString().Trim();
-            }
-            throw new Exception(message);
-        }
-        #endregion
-    }
+[[Kategorie:BlueM.Sim Development]]
-}
-</csharp>

BlueM.DLLAdapter: Difference between revisions

Latest revision as of 09:19, 27 January 2018

Schnittstellendefinitionen

Basismethoden

Anwendungsbeispiel

Navigation menu

Search