BlueM.Opt Code: Difference between revisions

From BlueM
Jump to navigation Jump to search
(Ablaufdiagramm eingefügt)
mNo edit summary
 
(42 intermediate revisions by 2 users not shown)
Line 1: Line 1:
[[Bild:EVO_Ablaufdiagramm.png|thumb|Ablaufdiagramm (EVO-BlauesModell)]]
{{EVO.NET_nav}}
==Projektstruktur==
[[Bild:Meta wc layout.png|thumb|300px|Layout der working copy nach checkout von der Meta-Repository mit Beschriftung der Repository-Zugehörigkeiten]]
Der Code besteht aus den folgenden Assemblies (Projekten), welche in einer Projektmappe zusammengeführt werden:
* '''<u>Main</u>''': Startprojekt
** Form1.vb: Hauptformular
** EVO_Einstellungen.vb: Steuerelement für das Setzen der Optimierungseinstellungen
** EVO_Opt_Verlauf: Steuerelement, dass den Verlauf der Optimierung anzeigt
** EVOMOD.vb:
** ...
 
* '''BlueM.Opt.Algos''': Unterordner für Algorithmen
** ''<u>IController</u>'': Stellt ein Interface für Controller zur Verfügung
** '''<u>ES</u>''': Evolutionsstrategie ([[PES]])
** '''<u>DDS</u>''': [[DDS|Dynamically Dimensioned Search]]
** '''<u>MetaEvo</u>''': [[MetaEvo|hybrider Optimierungsalgorithmus]]
** '''<u>HookeAndJeeves</u>''': [[Hooke & Jeeves]]
** '''<u>SensiPlot</u>''': [[SensiPlot|Sensitivitätsanalyse]]
** '''<u>TSP</u>''': [[TSP|Traveling Salesman Problem]]
 
* '''<u>Bluem.Opt.Apps</u>''': Assembly enthält Klassen für Evaluierungsanwendungen
** Sim.vb: Basisklasse für Simulationsanwendungen
** '''BlueM''':
*** BlueM.vb: Anbindung an [[BlueM]]
*** BlueM.dll: BlueM Rechenkern
*** IHWB.BlueM.DLLAdapter.dll: .NET Wrapper zum Ansprechen des BlueM Rechenkerns (siehe [[BlueM.DLLAdapter]])
*** SKos.vb:
** '''S_CAN:''' Anwendung S:CAN (Sonde Graz)
*** Scan.vb
** '''SMUSI''':
*** Smusi.vb: Anbindung an [[SMUSI]]
*** IHWB.SMUSI.DLLAdapter.dll: .NET Wrapper zum Ansprechen des SMUSI Rechenkerns
** '''SWMM'''
*** SWMM.vb: Anbindung an [[SWMM]]
*** Swmm_Iface.vb
*** SWMM5.dll: SWMM Rechenkern
** '''Testprobleme:''' [[Testprobleme]] (Sinusfunktion, Deb, etc.)
*** Testprobleme.vb
 
* '''<u>Bluem.Opt.Common</u>''': Gemeinsam genutzte Objekte
** Constants.vb: Modul enthält Konstanten und Enums
** Constraint.vb: Klasse für Constraint
** EVO_Settings.vb: Klasse, die die EVO_Einstellungen abbildet (XML-Serialisierbar)
** Individuum.vb: Basisklasse für Individuen
** Problem.vb: Definiert das zu lösende Optimierungsproblem
** Progress.vb: Speichert den Optimierungsverlauf
** OptParameter.vb: Klasse für OptParameter
** Modellparameter.vb: Structure für Modellparameter
** Provider.vb: Modul stellt Provider zur Verfügung (z.B. FortranProvider)
** Objectivefunction.vb: Klasse für Zielfunktion
 
* '''<u>Bluem.Opt.Diagramm</u>''': Diagramm- und Zeichenfunktionalitäten
** Diagramm.vb: Klasse, die von Steema.TeeChart.TChart erbt und diese Klasse erweitert
** Hauptdiagramm.vb: Abkömmling von Diagramm
** Monitor.vb: Formular enthält ein Monitor-Diagramm und einen Log
** Scatterplot.vb: Form für die Anzeige einer Scatterplot-Matrix
 
* '''<u>[[MO_Indicators|Bluem.Opt.MO_Indicators]]</u>''': Assembly zur Berechnung von Multi-Objective Indikatoren wie Hypervolumen, etc.


==Projektstruktur==
* '''<u>Bluem.Opt.OptResult</u>''': Assembly verwaltet das Optimierungsergebnis mit zugehöriger Datenbank
Der Code besteht den drei folgenden Projekten, welche in der Datei <code>Evolutionsstrategie.sln</code> zusammengeführt werden:
* '''_Main:''' Zentrale Verwaltungseinheit.
** [[Form1.vb]]:
** [[Module1.vb]]:


* '''Apps:''' Anwendungen für die Evolutionsstrategie
* '''<u>Wave</u>''': Zeitreihenverwaltung und -darstellung (siehe [[Wave]])
** [[BlueM.vb]]: Anbindung an das BlaueModell
** [[IHA.vb]]: Berechnung von IHA-Parametern
** [[SensiPlot.vb]]: Sensitivitätsanalyse
** [[Testprobleme.vb]]: Testprobleme (Sinusfunktion, Deb, etc.)
** [[Wave.vb]]: Anzeige von Ganglinien


* '''EVO_FORM:''' Steuerelemente für die Einstellungen und den Optimierungsverlauf.
==Code Formatting==
** [[EVO_Einstellungen.vb]]: Steuerelement für das Setzen der Optimierungseinstellungen
===Tab settings===
** [[EVO_Opt_Verlauf]]: Steuerelement, dass den Verlauf der Optimierung anzeigt
[[File:VB tabsettings.png|thumb|400px|center|VB tab settings]]
** [[EVOMOD.vb]]:
** [[myEVOS.vb]]:


* '''EVO_KERN:''' Der Optimierungsalgorithmus selbst.
===Comments===
** [[CEvolutionsstrategie.vb]]: Evolutionsstrategie
Es sollte die im VS integrierte Code-Dokumentationsfunktion genutzt werden ("XML-Kommentare"). Anleitung dazu bietet folgender [[Screencast XML-Kommentare|Screencast]]. Further information on using XML comments in Visual Studio can be found [http://msdn.microsoft.com/en-us/magazine/dd722812.aspx here].
** [[CES.vb]]: Combinatorial Evolution Strategy


==Code Formatierung==
Formatierung von Überschriften:
Formatierung von Überschriften:
<vbnet>
<source lang="vbnet">
#Region "Überschrift1"
#Region "Überschrift1"


Line 35: Line 79:
   'XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
   'XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX


       'Überschrift 3 (Titel von Funktionen/Subs)
       ''' <summary>
       '*****************************************
      ''' XML-Kommentare für Methoden, Eigenschaften, Felder etc.
       ''' </summary>
       Sub Beispiel()
       Sub Beispiel()


         'Untertitel innerhalb von Funktionen
         'Untertitel 1
         '-----------------------------------
         'xxxxxxxxxxxx


        'Normale Kommentare
            'Untertitel 2
            '============
 
              'Untertitel 3
              '------------
 
              'Normale Kommentare


       End Sub
       End Sub


#End Region 'Überschrift1
#End Region 'Überschrift1
</vbnet>
</source>


==Tokens==
==Tokens==
Folgende Tokens werden im Code benutzt:
Folgende Tokens werden im Code benutzt:
{| class="standard" cellspacing="0" cellpadding="5" border="0"
{| cellspacing="0" cellpadding="5" border="0" class="standard stripes"
! Token !! Bedeutung
! Token !! Bedeutung
|-  
|-  
| '''ACHTUNG''' || Wichtiges Kommentar
| '''ACHTUNG''' || Wichtiger Kommentar
|-
|-
| '''BUG''' || Betrifft einen Bug in Bugzilla
| '''BUG''' || Betrifft einen Bug in Bugzilla
Line 65: Line 116:
|-
|-
| '''CHECK''' || ???
| '''CHECK''' || ???
|-
| '''UPGRADE''' || Kleine mögliche Erweiterungen innerhalb von Funktionen
|-
|-
| '''UPGRADE_NOTE''' || Beim Update von VB6 auf VB generierte Kommentare
| '''UPGRADE_NOTE''' || Beim Update von VB6 auf VB generierte Kommentare
Line 73: Line 126:
|}
|}


[[Kategorie:EVO]]
[[Kategorie:BlueM.Opt Code|*]]
[[Kategorie:EVO Code]]

Latest revision as of 05:58, 18 December 2021

EVO.png BlueM.Opt | Usage | Development

Projektstruktur

Layout der working copy nach checkout von der Meta-Repository mit Beschriftung der Repository-Zugehörigkeiten

Der Code besteht aus den folgenden Assemblies (Projekten), welche in einer Projektmappe zusammengeführt werden:

  • Main: Startprojekt
    • Form1.vb: Hauptformular
    • EVO_Einstellungen.vb: Steuerelement für das Setzen der Optimierungseinstellungen
    • EVO_Opt_Verlauf: Steuerelement, dass den Verlauf der Optimierung anzeigt
    • EVOMOD.vb:
    • ...
  • Bluem.Opt.Apps: Assembly enthält Klassen für Evaluierungsanwendungen
    • Sim.vb: Basisklasse für Simulationsanwendungen
    • BlueM:
      • BlueM.vb: Anbindung an BlueM
      • BlueM.dll: BlueM Rechenkern
      • IHWB.BlueM.DLLAdapter.dll: .NET Wrapper zum Ansprechen des BlueM Rechenkerns (siehe BlueM.DLLAdapter)
      • SKos.vb:
    • S_CAN: Anwendung S:CAN (Sonde Graz)
      • Scan.vb
    • SMUSI:
      • Smusi.vb: Anbindung an SMUSI
      • IHWB.SMUSI.DLLAdapter.dll: .NET Wrapper zum Ansprechen des SMUSI Rechenkerns
    • SWMM
      • SWMM.vb: Anbindung an SWMM
      • Swmm_Iface.vb
      • SWMM5.dll: SWMM Rechenkern
    • Testprobleme: Testprobleme (Sinusfunktion, Deb, etc.)
      • Testprobleme.vb
  • Bluem.Opt.Common: Gemeinsam genutzte Objekte
    • Constants.vb: Modul enthält Konstanten und Enums
    • Constraint.vb: Klasse für Constraint
    • EVO_Settings.vb: Klasse, die die EVO_Einstellungen abbildet (XML-Serialisierbar)
    • Individuum.vb: Basisklasse für Individuen
    • Problem.vb: Definiert das zu lösende Optimierungsproblem
    • Progress.vb: Speichert den Optimierungsverlauf
    • OptParameter.vb: Klasse für OptParameter
    • Modellparameter.vb: Structure für Modellparameter
    • Provider.vb: Modul stellt Provider zur Verfügung (z.B. FortranProvider)
    • Objectivefunction.vb: Klasse für Zielfunktion
  • Bluem.Opt.Diagramm: Diagramm- und Zeichenfunktionalitäten
    • Diagramm.vb: Klasse, die von Steema.TeeChart.TChart erbt und diese Klasse erweitert
    • Hauptdiagramm.vb: Abkömmling von Diagramm
    • Monitor.vb: Formular enthält ein Monitor-Diagramm und einen Log
    • Scatterplot.vb: Form für die Anzeige einer Scatterplot-Matrix
  • Bluem.Opt.OptResult: Assembly verwaltet das Optimierungsergebnis mit zugehöriger Datenbank
  • Wave: Zeitreihenverwaltung und -darstellung (siehe Wave)

Code Formatting

Tab settings

VB tab settings

Comments

Es sollte die im VS integrierte Code-Dokumentationsfunktion genutzt werden ("XML-Kommentare"). Anleitung dazu bietet folgender Screencast. Further information on using XML comments in Visual Studio can be found here.

Formatierung von Überschriften: 

#Region "Überschrift1"

'Überschrift 1 (z.B. Unterteilung zwischen Eigenschaften und Methoden
'####################################################################

   'Überschrift 2 (z.B. Größere Gruppen von Funktionen/Subs)
   'XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

      ''' <summary>
      ''' XML-Kommentare für Methoden, Eigenschaften, Felder etc.
      ''' </summary>
      Sub Beispiel()

         'Untertitel 1
         'xxxxxxxxxxxx

            'Untertitel 2
            '============

               'Untertitel 3
               '------------

               'Normale Kommentare

      End Sub

#End Region 'Überschrift1

Tokens

Folgende Tokens werden im Code benutzt:

Token Bedeutung
ACHTUNG Wichtiger Kommentar
BUG Betrifft einen Bug in Bugzilla
TODO Noch zu tun
HACK Temporäre Lösung
UNDONE ???
CHECK ???
UPGRADE Kleine mögliche Erweiterungen innerhalb von Funktionen
UPGRADE_NOTE Beim Update von VB6 auf VB generierte Kommentare
UPGRADE_WARNING Beim Update von VB6 auf VB generierte Kommentare
UPGRADE_ISSUE Beim Update von VB6 auf VB generierte Kommentare
Retrieved from "https://wiki.bluemodel.org/index.php?title=BlueM.Opt_Code&oldid=7586"