Rhai-Funktionsreferenz

Liest den Wert einer Eigenschaft auf dem aktuellen Agent. Die einfache Form gibt den Wert am aktuellen Zeitschritt zurück. Mit einem negativen Offset blicken Sie in die Vergangenheit — nützlich für selbst-referentielle Formeln, in denen der neue Wert vom alten abhängt. Der Rückgabetyp folgt dem Datentyp der Eigenschaft: eine Zahl für Number-Eigenschaften, true/false für Boolean, ein String für alles andere.

Prüft, ob eine Eigenschaft auf dem Agent existiert. Gibt true zurück, wenn die Eigenschaft auf dem Knotentyp des Agents definiert ist, sonst false. Nützlich bei optionalen Eigenschaften oder wenn Formeln sich an unterschiedliche Agent-Typen im selben Modell anpassen sollen.

Schreibt einen Wert in eine Eigenschaft des Agents am aktuellen Zeitschritt. Nur innerhalb einer Act-Methode verfügbar — Eigenschaftsformeln verwenden setprop nicht, sie geben ihr Ergebnis stattdessen zurück. setprop kann Werte überschreiben, die Eigenschaftsformeln gerade für denselben Zeitschritt berechnet haben — nutzen Sie es, wenn Verhalten mehrere Eigenschaften betrifft oder einer Zustandsmaschine ähnelt.

Zählt, wie viele Agents in einem Array einen bestimmten Wert für eine gegebene Eigenschaft haben. Häufiges Muster: verbundene Agents in einem bestimmten Zustand zählen (z. B. aktive Mitglieder eines Teams, abgeschlossene Schritte eines Prozesses). Der Vergleich ist exakt — Zeichenkettenvergleich für Text-Eigenschaften, numerischer Vergleich für Zahlen.

Summiert eine numerische Eigenschaft über ein Array von Agents. Wird häufig zusammen mit getconnected verwendet, um Werte verbundener Agents aufzurollen — Gesamtgehalt, Gesamtbestand, Gesamtumsatz. Nicht-numerische oder fehlende Eigenschaften ergeben 0, sodass eine teilweise gefüllte Menge trotzdem eine saubere Zahl liefert.

Gibt die Agents zurück, die mit dem angegebenen Agent über einen Beziehungstyp verbunden sind. Läuft den Link in beide Richtungen, sodass derselbe Aufruf funktioniert, egal ob Ihr Agent Quelle oder Ziel der Beziehung ist.

Die Schrittweite des Szenarios — z. B. 1.0, wenn Start- und Endzeit in Monaten sind und dt 1 ist, oder 1/12, wenn Start und Ende in Jahren sind und Sie monatlich rechnen. Verwenden Sie es, um Raten zu skalieren, die pro Einheit echter Zeit ausgedrückt sind — so bleibt eine Formel auch dann korrekt, wenn die Granularität des Szenarios später geändert wird.

Der Index des aktuellen Zeitschritts — 0 am Anfang des Szenarios, 1 am nächsten Schritt und so weiter. Als Scope-Variable in jeder Formel und Act-Methode verfügbar. Nützlich für periodische Logik („einmal pro Jahr"), Startbedingungen oder jede Regel, die von der absoluten Zeit innerhalb des Szenarios abhängt.