texts added

viktoria-pr · viktoria-pr · commit 2baad54cf331 · 2025-08-05T17:26:13.000+02:00
diff --git a/docs/docs/documentation/Einstellungen/Modell- Einstellungen.md b/docs/docs/documentation/Einstellungen/Modell- Einstellungen.md
@@ -20,17 +20,12 @@ Ist eine einfache, numerische Methode zur Lösung von Differentialgleichungen. I
 x(t+delta t)= x(t) + delta t* dx/dt (t)
 
 
-Aktueller Wert der Zustandsgröße (Stock)
+x(t) : Aktueller Wert der Zustandsgröße (Stock)
 
-Zeitschritt 
+delta t : Zeitschritt 
 
-Änderungsrate 
+dx/dt (t) : Änderungsrate 
 
-Beispiel: einfaches Bevölkerungswachstum (Stock: Bevölkerung P; Flow: Geburten B= r*P r=Geburtenrate) 
-
-Differenzialgleichung: dP/dt= r*P
-
-Mit Euler Verfahren: P(t+delta t) = P(t) + delta t* (r*P(t))
 
 #### Runge-Kutta Verfahren
 
diff --git a/docs/docs/documentation/Einstellungen/Szenario- Einstellungen.md b/docs/docs/documentation/Einstellungen/Szenario- Einstellungen.md
@@ -1,13 +1,23 @@
 # Szenario-Einstellungen
+Mit Szenarien lassen sich verschiedene "Was-wäre-wenn..."- Situationen in einem Modell durchspielen, ohne mehrere Modellkopien oder -versionen anlegen zu müssen. Somit kannst du ganz einfach alternative Zukunftsentwicklungen simulieren und vergleichen.
+:::note Szenario
+
+Ein Szenario ist eine definierte Variation bestimmter Modellannahmen oder Eingabewerte. Du kannst damit analysieren: 
+- wie empfindlich das Modell auf Änderungen reagiert
+- Welche Entwicklungen unter verschiedenen Rahmenbedingungen möglich sind
+- Welche Annahmen robust oder riskant sind
+:::
+
+Die Szenario-Einstellungen ermöglichen es dir auf unterschiedlichste Weise, bestimmte Primitiveparameter flexibel zu verändern, um somit schnellstmöglich und unkompliziert eine große Bandbreite an Szenarien auszuprobieren.
 
 | Eingabefelder     | Art der Eingabe |    Zweck        |
 | ----------------- | ----------------|-----------------|
-| Keine Parameter  | -   |  |
-| Boolscher Wert | On/off    |      |
-| Schieberegler | Manueller Schieberegler   | Zeitschritte des Simulationszeitraumes |
+| **Keine Parameter**  | -   |  |
+| **Boolscher Wert** | On/off    |      |
+| **Schieberegler** | Manueller Schieberegler   | Flexibel anpassbare Inputwerte |
 | Min | Numerischer Wert | Startpunkt der Spanne
 | Schritte | Numerischer Wert| Abstände der Werte zueinander|
 | Max | Numerischer Wert | Endpunkt der Spanne|
-| Wertehilfe | Auswahloption | Auswahl von Optionen festgelegter Werte|
-| Wert | Numerischer Wert  | Input zur Berechnung |
-| Label | Numerischer Wert, Text  | Beschreibung |
+| **Wertehilfe** | Auswahloption | Auswahl von Optionen festgelegter Werte|
+| **Wert** | Numerischer Wert  | Input zur Berechnung |
+| **Label** | Numerischer Wert, Text  | Beschreibung |
diff --git a/docs/docs/documentation/Einstellungen/Versions-Einstellungen.md b/docs/docs/documentation/Einstellungen/Versions-Einstellungen.md
@@ -1,8 +1,10 @@
 
 # Versions-Einstellungen
 
-Modellversionierung ist insbesondere bei langfristiger und kollaborativer Arbeit mit digitalen Modellen ein wichtiges Werkzeug. Es ermöglicht, Änderungen am Modell nachvollziehbar zu dokumentieren, frühere Stände 
+Modellversionierung ist insbesondere bei langfristiger und kollaborativer Arbeit mit digitalen Modellen ein wichtiges Werkzeug. Es ermöglicht, Änderungen am Modell nachvollziehbar zu dokumentieren, frühere Stände zu archivieren und Experimente durchzuführen, ohne den aktuellen Stand zu verlieren.
 
+Warum ist Versionierung wichtig?
+- Rückverfolgbarkeit: Jede Änderung (zB neue Primitives, veränderte Parameter, neue Flussstruktur) kann später genau nachvollzogen werden
 :::tip Versions-Index
 
 Die Benennung der unterschiedlichen Modellversionen wird automatisch generiert und kann **nicht** manuell verändert werden.
@@ -15,4 +17,17 @@ v0.1.1 : Neuer Entwurf
 
 v1.0.0 : Major-Version -
 v1.0.1 : Neuer Entwurf
+:::
+- Fehlerkorrektur: Bei unbeabsichtigten Fehlern kann auf eine frühere Version zurückgegriffen werden 
+:::warning
+
+Du kannst keine einzelnen Entwürfe löschen, sondern ausschließlich das komplette Modell.
+
+:::
+- Vergleichbarkeit: Unterschiedliche Modellvarianten (Szenarien) lassen sich miteinander vergleichen
+- Dokumentation: Für wissenschaftliche Arbeiten oder Projekte dient die Versionierung als transparente Dokumentation des Modellierungsprozesses
+- Teamarbeit: In kollaborativen Projekten können verschiedene Bearbeitende nachvollziehen, wer wann was verändert hat
+:::tip
+
+Wenn du veröffentlichte Modelle als Basis deines Modells nehmen möchtest, erstellst du entweder einen neuen Entwurf (sofern du die Berechtigung hast) oder du klonst es, sodass du es bearebiten kannst.
 :::
diff --git a/docs/docs/documentation/Interface.md b/docs/docs/documentation/Interface.md
@@ -40,20 +40,19 @@ Auf der linken Seite ist eine einklappbare Sidebar, wo sich die Modellinformatio
 Mit einem Klick auf das jeweilige Primitive öffnet sich auf der rechten Seite der Arbeitsfläche das Einstellungsfenster für die entsprechenden Parameter.
 
 ## Handhabung 
-### Grundlegende Handhabung 
 
-#### 1. Elemente platzieren 
+### 1. Elemente platzieren 
 Wähle in der unteren ActiveBar ein Modellierungselement aus. Es wird automatisch auf der Arbeitsoberfläche platziert.
 :::tip Hinweis
 Erstelle eine Geistervariable eines Primitives, indem du es auswählst und auf das Geist- Icon klickst. Dadurch kannst du dein Modell übersichtlicher strukturieren und Primitves an einer anderen Stelle im Modell platzieren, ohne ein Gewirr von langen Verbindungen! 
 :::
-#### 2. Elemente verbinden
+### 2. Elemente verbinden
 Um die Modellierungselemente in Abhängigkeit zu setzen, verbinde sie grafisch miteinander. Indem du den Mauszeiger über einen der Knotenpunkte des Ausgangs-Primitives bewegst, wird dieser zum Fadenkreuz. Halte die linke Maustaste gedrückt und ziehe das Fadenkreuz zu dem Knotenpunkt des Primitives, welches du mit dem anderen in Relation bringen möchtest. Die erstellte Verbindung wird dir in Form eines Pfeils dargestellt, der dir gleichzeitig die Richtung der Abhängigkeit anzeigt. Das Primitive, auf das die Pfeilspitze zeigt, verwendet den Wert des anderen Primitves als Input.  
 :::tip Hinweis
 Bei den Primitves *Flow* und *Transition* sind die Knotenpunkte in ihrer Funktionsweise definiert. Die Richtung wird durch gekennzeichnete In- und Outputpfeile vorgeschrieben. Du kannst die Ausrichtung dieser festgelegten Richtung ändern, indem du das Primitve auswählst und auf das Rotation- Icon klickst.
 :::
 
-#### 3. Parameter setzen 
+### 3. Parameter setzen 
 Nach Auswahl eines Elements kannst du im Eigenschaftenfenster die gewünschten Parameter setzen. Füge individuelle Gleichungen ein oder nutze die bereits integrierten Funktionen. Den Wert des verbunden Primitves kannst du als einen Inputwert nehmen, indem du (nach dem grafischen Verbinden) auf den Button unter dem Werteingabe-Feld klickst.
 :::tip Hinweis
 Achte darauf, dass der Name des Primitves und die Bezeichnung in den eckigen Klammern im Werteingabe-Feld des verbundenen Primitves übereinstimmen (Leerzeichen beachten). Benennst du im Laufe des Modellierungsprozesses Primitives um, musst du diese in den Wertefeldern anpassen, sonst kann das Modell nicht berechnet werden. 
@@ -64,5 +63,5 @@ Mit dem Klick auf den Löschen- Button im Eigenschaftenfenster, entfernst du **n
 
 :::
 
-#### 4. Simulation starten 
+### 4. Simulation starten 
 Über die Schaltfläche "Simulieren" wird das Modell mit den gesetzten Parametern berechnet. Dabei öffnet sich in der Mitte der Arbeitsoberfläche ein neues Fenster, in dem die Simulationsergebnisse in Form einen Liniendiagramms oder eines Streuungsdiagramms angezeigt werden. Die Geschwindigkeit des Aufbaus der Anzeige kannst reguliert werden.
diff --git a/docs/docs/documentation/Primitives.md b/docs/docs/documentation/Primitives.md
@@ -25,6 +25,7 @@ Stock (dt. Bestände) bilden akkumulierte Größen bzw. Werte, die sich im Laufe
 
 *Pflichtfelder für Berechnung
 
+---
 ## Flow
 Flows (dt. Flüsse/Ströme) beschreiben die Geschwindigkeit, mit der sich ein Bestand aufbaut oder abbaut, und wirken damit direkt auf die Änderungsrate eines Stocks. Ein Flow ist eine zeitabhängige Rate, die angibt, wie schnell etwas in einen Stock hinein- oder aus ihm hinausfließt. Sie sind temporär aktiv, indem sie den Bestand verändern, aber selbst keine Werte speichern. Zudem können sie von anderen Variablen abhängen. Es gibt verschiedene Typen von Flows - zum einen statische/absolute und variable/relative In- und Outflows. 
 
@@ -44,6 +45,7 @@ Flows (dt. Flüsse/Ströme) beschreiben die Geschwindigkeit, mit der sich ein Be
 
 *Pflichtfelder für Berechnung
 
+---
 ## OGC API Features
 Die OGC API Features ist ein moderner Standard des Open Geospatial Consortium (OGC) zur Bereitstellung und Abfrage von Geodaten über Webschnittstellen. Dies ermöglicht eine einfache Integration in Webanwendungen und fördert die Interoperabilität zwischen verschiedenen Systemen. Das Masterportal Hamburg stellt über die OGC API- Features eine Vielzahl von Datensätzen aus dem Geoportal zur Verfügung.  
 
@@ -70,6 +72,7 @@ Die OGC API Features ist ein moderner Standard des Open Geospatial Consortium (O
 
 *Pflichtfelder für Berechnung
 
+---
 ## Variablen
 In der Systemdynamik beschreiben Variablen größenveränderliche Einflussfaktoren, die nicht direkt Bestände (Stocks) sind und im Gegensatz zu diesen keine Speicherfunktion der Werte aufweisen. Sie sind Berechnungsgrößen, die Flüsse oder andere Variablen beeinflussen. Sie fungieren als Rechenhilfen, indem sie die Struktur vereinfachen und 
 ermöglichen Modulare Modellierung.
@@ -90,6 +93,7 @@ ermöglichen Modulare Modellierung.
 
 *Pflichtfelder für Berechnung
 
+---
 ## Converter
 Ein Converter ist ein Modellierungselement, das eine Berechnung, Transformation oder Ableitung aus anderen Variablen oder Konstanten durchführt. Er ist funktional gleichzusetzen mit einer Hilfsvariablen und speichert keine Werte, sondern wird bei jeder Simulationszeit neu berechnet.
 
@@ -111,6 +115,7 @@ Ein Converter ist ein Modellierungselement, das eine Berechnung, Transformation
 
 *Pflichtfelder für Berechnung
 
+---
 ## States
 Ein State in der agentenbasierten Modellierung bezeichnet einen Zustand (oder verschiedene Modi), der die aktuelle Situation oder Konfiguration eines Agenten, die sein Verhalten und seine Reaktion im Modell beeinflusst. Die Agenten wechseln von einem State in einen anderen, ausgelöst durch Regeln, Wahrscheinlichkeiten oder Umwelteinflüsse.
 
@@ -126,6 +131,7 @@ Ein State in der agentenbasierten Modellierung bezeichnet einen Zustand (oder ve
 
 *Pflichtfelder für Berechnung
 
+---
 ## Transitions
 Transitions bezeichnen die Übergänge zwischen den Zuständen (States) eines Agenten. Sie beschreiben wann und unter welchen Bedingungen ein Agent von einem Zustand in einen anderen wechselt.
 
@@ -146,6 +152,7 @@ Transitions bezeichnen die Übergänge zwischen den Zuständen (States) eines Ag
 
 *Pflichtfelder für Berechnung
 
+---
 ## Actions
 Actions sind die konkreten Handlungen, die ein Agent während eines Zustandes oder bei einem Zustandswechsels (Transitions) ausführt. Sie bestimmen das sichtbare Verhalten eines Agenten innerhalb des Modells. Sie sind opelrationale Verhaltensregeln, wie beispielsweise sich bewegen, mit anderen Agenten interagieren, Ressourcen verbrauchen etc.
 
@@ -161,6 +168,7 @@ Actions sind die konkreten Handlungen, die ein Agent während eines Zustandes od
 
 *Pflichtfelder für Berechnung
 
+---
 ## Agent
 Ein Agent ist eine autonome Entität, die eigene Zustände, Eigenschaften und Verhaltensregeln besitzt und mit ihrer Umwelt und anderen Agenten interagieren kann. Als individuelles Modellobjekte können Agenten eigenständige Entscheidungen treffen, zustandsabhängig handeln, sich verändern und lokal interagieren.
 
@@ -171,7 +179,7 @@ Ein Agent ist eine autonome Entität, die eigene Zustände, Eigenschaften und Ve
 | **Schnittstelle & Szenario** | 
 | Ausgabeparameter | Boolean | Wenn als Ausgabeparameter gewählt, gibt dies Aufschluss über den Zustand des Systems im Zeitverlauf. Es werden Wirkungen von Entscheidungen, Änderungen oder externen Faktoren sichtbar. |
 
-
+---
 ## Population
 Eine Population bezeichnet eine Gesamtheit alles Agenten eines bestimmten Typs innerhalb eines Modells. Diese kollektive Menge an Agenten haben gemeinsame Eigenschaften oder Verhaltenstype, agieren sowohl in einer gemeinsamen Umwelt als auch untereinander.
 
@@ -193,6 +201,7 @@ Eine Population bezeichnet eine Gesamtheit alles Agenten eines bestimmten Typs i
 
 *Pflichtfelder für Berechnung
 
+---
 ## Folder
 Ein Folder ist ein strukturgebendes Element, welches die Organisation eines Modells vereinfacht. In einem Ordner können manuell ausgewählte Modellteile gesammelt, gruppiert und bewegt werden.
 
diff --git a/docs/docs/documentation/Publizieren/Modell veröffentlichen.md b/docs/docs/documentation/Publizieren/Modell veröffentlichen.md
@@ -14,7 +14,7 @@ Unter den Versionseinstellungen in der Sidebar findest du die Funktion "Veröffe
 | Notizen  | Nur einsehbar in den Metadaten des Modells. Müssen eingetragen sein und min. 3 Zeichen lang sein, damit Modell veröffentlicht werden kann|
 
 ## Veröffentlichen als Modellserver Endpunkt
-Der Urban Model Builder stellt einen Microserver dar. Die von dir oder anderen Usern erstellten Modelle werden zunächst lokal auf dem Server beim jeweiligen Client durchgeführt und berechnet. Wenn du dein Modell als Modellserver Endpunkt veröffentlichst, kann die Urban Model Plattform (UMP) als API daran anknüpfen. Bei weiterem Interesse findest du hier mehr Infos zur [UMP](https://citysciencelab.github.io/urban-model-platform/content/03-architecture/overview.html).
+Der Urban Model Builder stellt einen sogenannten Microserver dar. Die von dir oder anderen Usern erstellten Modelle werden zunächst lokal auf dem Server beim jeweiligen Client durchgeführt und berechnet. Wenn du dein Modell als Modellserver Endpunkt veröffentlichst, kann die Urban Model Plattform (UMP) als API daran anknüpfen. Bei weiterem Interesse findest du hier mehr Infos zur [UMP](https://citysciencelab.github.io/urban-model-platform/content/03-architecture/overview.html).
 Die Prüfung und Freigabe des Modells erfolgt durch einen Administrator nachdem du eine E-Mail an cut@hcu-hamburg.de gesendet hast. Nach kurzer Zeit, erhält du eine Bestätigungsmail, dass dein Modell nun durch die Schnittstelle der UMP auf unserem Server durchgeführt und berechnet werden kann. Dies bietet sich gerade bei komplexen Modellen an, die eine höhere Rechenkapazität erfordern. 
 Wenn du dein veröffentlichtes Modell löscht, wird es von allen Servern entfernt - auch deine Anfrage zur Freigabe verfällt automatisch. Mit dem Löschen des veröffentlichten Modells ziehst du nicht bloß die Veröffentlichung zurück. Es taucht dann auch nicht mehr bei deinen Modellen zur weiteren Bearbeitung auf. Wenn du die Veröffentlichung zurückziehen möchtest, aber dein Modell weiterhin bearbeiten möchtest, erstelle einen Klon oder einen neuen Entwurf.
 Mit der Veröffentlichung deines Modells, stimmst du der Veröffentlichung unter der GPL-3.0 Lizenz zu. Weitere Infos zu der Lizenz findest du unter den [Nutzungsbedingungen](https://modelbuilder.comodeling.city/nutzungsbedingungen).
diff --git a/docs/docs/documentation/Simulation durchführen.md b/docs/docs/documentation/Simulation durchführen.md
@@ -1,6 +1,41 @@
 ---
 sidebar_position: 7
 ---
+Simulationen bilden ein zentrales Werkzeug, um komplexe Systeme besser zu verstehen, Entscheidungen zu unterstützen und alternative Entwicklungen zu erkunden. Durch das schrittweise Durchlaufen von modellierten Prozessen lassen sich Ursache-Wirkungs-Zusammenhänge, Zeitverläufe und kritische Parameter sichtbar machen. Das Durchführen von Simulationen ermöglicht es, verschiedene Szenarien durchzurechnen, Unsicherheiten zu analysieren und Hypothesen zu überprüfen. 
+
 ## Simulationsergebnisse 
+Es gibt zwei Arten, wie die Ergebnisse geplottet werden: 
+
+Time-Series 
+- Verlaufsdiagramm zeigt die Entwicklung von Daten über die Zeit 
+- Mouseover: spezifische Ergebnisanzeige 
+- Filterung der Ergebnisse durch Ein-bzw. Ausschalten der Darstellung durch Klick auf die Legende
+
+Scatter-Plot
+- Verhalten und Zustandsänderungen werden georeferenziert auf einem Grid angezeigt
+- Mouseover: Ergebnisanzeige 
+- Filterung der Ergebnisse durch Ein-bzw. Ausschalten der Darstellung durch Klick auf die Legende
+
+:::warning
+
+Die Simulation kann nur durchgeführt werden, wenn ein Outputparameter festgelegt wurde und es keine Logik- bzw. Syntaxfehler in der Modellstruktur gibt. 
+
+:::
+
+## Validierung 
+Wenn das Modell simuliert und technisch durchkalkuliert werden kann, solltest du dennoch immer selbst hinterfragen, ob das modellierte Systemverhalten inhaltlich korrekt sein kann und die Realität auf geeignete Weise abbildet.
+:::tip Prüfen
+
+Standardmäßig können bspw. die Werte von Stocks mathemathisch in den negativen Zahlenbereich gehen. Jedoch ergibt das bei einem Bevölkerungsbestand wenig Sinn.  
+
+::: 
+
+- Du kannst die Ergebnisse mit realen Mess- oder Statistikdaten abgleichen und somit einschätzen, ob die Verhältnissmäßigkeiten oder Größenordnungen stimmen könnten
+- Fachleute können beurteilen, ob das Modell und seine Ergebnisse pöausibel und fachlich korrekt sind
+- Du kannst auch historische Daten zur Validierung deines Modells heranziehen, um zu prüfen, ob die bekannte Entwicklung korrekt reproduzierbar ist
+- Du kannst die Sensitivität deines Modells überprüfen, indem du testet, wie stark kleine Änderungen von Parametern das Modellverhalten beeinflussen
+:::note Herausforderungen 
 
-## Validierung 
+Es ist gar nicht so leicht, das eigene Modell zu validieren! Entweder es gibt keine nutzbaren Realweltdaten, das Modell abstrahiert bewusst und lässt sich nur schwer vergleichen oder modelliertes soziales Verhalten ist besonders schwierig zu definieren.
+ 
+:::
diff --git a/docs/docs/documentation/basiswissen/simulationsmodelle.md b/docs/docs/documentation/basiswissen/simulationsmodelle.md
@@ -15,10 +15,20 @@ Digitale Simulationsmodelle erlauben es, Szenarien durchzuspielen, ohne physisch
 
 :::tip Annahmen treffen
 
-Das Urban Model Builder ist ein Tool zur individuellen Modellierung von komplexen Systemen. Somit wird eine Vielzahl an persönlichen Annahmen getroffen, sowohl bezogen auf die übergeordnete Konzeption des Modells als auch bei den jeweiligen Werten und Funktionsbeschreibungen, die getroffen werden.
+Das Urban Model Builder ist ein Tool zur individuellen Modellierung von komplexen Systemen. Somit wird eine Vielzahl an persönlichen Annahmen getroffen, sowohl bezogen auf die übergeordnete Konzeption des Modells als auch bei den jeweiligen Werten und Funktionsbeschreibungen, die getroffen werden müssen. 
+
+- Halte Annhamen explizit und nachvollziehbar fest
+- Begründe, warum du sie triffst und welche Alternativen denkbar wären 
+- Überprüfe, ob sie unter neuen Erkenntnissen noch gültig sind 
+
 :::
 
 :::tip Umgang mit Unsicherheiten
 
+Unsicherheiten gehören unvermeidbar zur Modellierung - sei es durch ungenaue Daten, variable Parameter oder unklare Zukunftsszenarien. 
+
+- Gehe offen mit Unsicherheiten um
+- Nutze Szenarien und Validierungen, um Bandbreiten von Ergebnissen sichtbar zu machen
+- Simulationen sind keine Vorhersagen, sondern Hilfsmittel zur Orientierung 
 
 :::
diff --git a/docs/docs/funktionen/Basic Programming.md b/docs/docs/funktionen/Basic Programming.md
@@ -137,14 +137,16 @@ Car <- {
 }
 Car.make  # = "Toyota"
 ```
-```jsx title="Füge Verhaltensregeln den Funktionen hinzu:"
+```jsx title="Füge Verhaltensregeln zu Funktionen hinzu:"
 Car.fullInfo <- function()
   self.make + " (" + self.year + ")"
 end function
 ```
 ### Inheritance
-```jsx title=""
-
+```jsx title="Erstellt Objekte, die von anderen erben, mit "new" :"
+Truck <- new Car
+Truck.make <- "Ford"
+Truck.year <- 2022
 ```
 ### Constructors
 ```jsx title="Füge Verhaltensregeln den Funktionen hinzu:"
diff --git a/docs/docs/tutorials/ABM_tutorial.md b/docs/docs/tutorials/ABM_tutorial.md
diff --git a/docs/docs/tutorials/API_tutorial.md b/docs/docs/tutorials/API_tutorial.md
diff --git a/docs/docs/tutorials/SD_tutorial.md b/docs/docs/tutorials/SD_tutorial.md
diff --git a/docs/docs/tutorials/tutorial1.md b/docs/docs/tutorials/tutorial1.md
