Model Definition

Um ein MARS Modell verwenden zu können müssen definierte Entitäts, Agenten und Layertypen dem System bekannt machen.

Im Projekt muss dazu eine sogenannte ModelDescription definiert werden (zum Beispiel definiert im Einstiegspunkt Main()) und alle relevanten Typen registriert werden.

Registration

Zunächst muss der using Import des Namnsraums hinzugefügt werden:

using Mars.Core.Model.Entities;

Im Programmcode (zum Beispiel dem Einstiegspunkt Main() der .NetCore Anwendung) muss ein ModelDescription Objekt definiert werden. Diese Objekt enthält alle Typen die Modell vorkommen und die von außen durch eine SimulationConfig parametrisiert werden können.

public static void Main() 
{
    var description = new ModelDescription();

    description.AddLayer<MyLayer>();
    description.AddAgent<MyAgent,MyLayer>();

}

Die oben registrierten Typen umfassen den selbst-definierten Agententypen MyAgent und den dazugehörigen Agentenlayer MyLayer. Möchte man zusätzliche Daten im Modell verwenden müssen die jeweiligen Datenlayer zusätzliche registriert werden:

description.AddLayer<MyVectorLayer>();
description.AddLayer<MyRasterLayer>();

💡: MyLayer kann ebenso als Datenlayer verwendet werden wie MyVectorLayer oder MyRasterLayer, sofern der Kontrakt als Datenlayer erfüllt ist (siehe hier).

Registration with Names

Standardmäßig wird der definierte Klassenname (z.B. MyAgent) als Name innerhalb des Modells verwendet. Es können alternative Namen bei der Registrierung übergeben werden:

description.AddAgent<MyAgent,MyLayer>("myAlternativeAgentName");

Dies sorgt für eine