dSPACE: ModelDesk

Herstellerinformationen

Hersteller

Webseite

Produktname

Version

dSPACE

http://www.dspace.com

ModelDesk

dSPACE Release 2014A - 2025B

Kategorien

MDL 🛈

APL 🛈

BAN 🛈

BMA 🛈

SVC 🛈

DGN 🛈

FIU 🛈

EES 🛈

FCT 🛈

DBG 🛈

IMG 🛈

AUDIO 🛈

ENVSIM 🛈

ENVCOM 🛈

✓

Plattform

Betriebssystem

Unterstützung

Windows

✓

Linux

✓

Ports

Besonderheiten

ENVSIM-Port

Das Anzeigen der Parameter und Aliassen im Szenarienbaum, sowie das Lesen und Schreiben von Parametern und Aliassen wird im Rahmen des ENVSIM-Ports unterstützt. Auf Parameter für ParameterSets kann weiterhin nur über Tooljobs zugegriffen werden.

Um Parameter/Aliasse Lesen und Schreiben zu können, muss vor den jeweiligen Lese- bzw. Schreibschritten das entsprechende Szenario mit einem Lade Element-Schritt geladen werden. Nach einem Schreibschritt muss, analog zum Vorgehen bei dem „WriteParameter“-Tooljob, der Tooljob „DownloadScenario“/“DownloadRoad“ aufgeführt werden, damit die geschriebenen Parameter in der Simulationsplattform geladen werden.

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

Projektverzeichnis

uri

Basisverzeichnis für die Suche von ModelDesk-Projektdateien (*.cdp) auf dem Toolhost (absolut oder relativ zum Basispfad des Toolhosts)

ModelDesk-Projekt

Bereits geladenes Projekt verwenden.

uri

ModelDesk-Projekt (*.cdp), das geladen werden soll (relativ zum Projekt-Verzeichnis oder absoluter Pfad)

ModelDesk-Experiment

‚Bereits geladenes Experiment verwenden.‘

string

Name des ModelDesk-Experiments im angegebenen ModelDesk-Projekt, das aktiviert werden soll.

Tool beenden

☐

bool

Beendet ModelDesk

„Maneuver Compatibility“-Modus ist aktiviert

☐

bool

Flag zum Kennzeichnen, dass der Modus „Maneuver Compatibility“ im ausgewählten Projekt aktiviert ist. Dieser Modus ist nur verfügbar in den Releases 2018A - 2019B. In anderen Versionen wird dieses Flag ignoriert.

Timeout für Toolzugriffe ❲in Sek.❳

‚600‘

string

Zeit nach der eine Anfrage an das Tool abgebrochen wird.

ActivateRoad

Aktiviert die angegebene Straße.

ACHTUNG: Das aktive Experiment wird durch die Ausführung dieses Jobs gespeichert.

Parametrierung

Parameter

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

Road

string

Name der Straße

ActivateScenario

Aktiviert das angegebene Szenario.

ACHTUNG: Das aktive Experiment wird durch die Ausführung dieses Jobs gespeichert.

Parametrierung

Parameter

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

Scenario

string

Name des Szenarios

DownloadManeuver

Speichert, aktiviert und lädt das angegebene Maneuver auf die Simulationsplattform.

Nur bis zur Version 2017B bzw. in 2018A - 2019B mit aktivierter „Maneuver Compatibility“ verfügbar. Für die Verwendung des „Maneuver Compatibility“-Modus muss dieser in ModelDesk und in der Testbenchkonfiguration aktiviert sein.

ACHTUNG: Das aktive Experiment wird durch die Ausführung dieses Jobs gespeichert.

ACHTUNG: Der Rückgabewert erlaubt keine Rückschlüsse auf den Erfolg.

Parametrierung

Parameter

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

Maneuver

‚beibehalten‘

string

Name des Maneuvers

Rückgabewert

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

result

[False, True]

bool

DownloadParameterSet

Speichert, aktiviert und lädt den angegebenen Parametersatz auf die Simulationsplattform.

ACHTUNG: Das aktive Experiment wird durch die Ausführung dieses Jobs gespeichert.

Liefert im Erfolgsfall True zurück.

ACHTUNG: Unter Umständen kann das Ergebnis auch None sein. None bedeutet nicht, dass ein Fehler auftrat, sondern dass das Ergebnis des Jobs nicht bestimmt werden kann.

Parametrierung

Parameter

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

ParameterSet

‚beibehalten‘

string

Name des Parametersatzes

Rückgabewert

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

result

[False, True]

bool

DownloadRoad

Aktiviert und lädt die angegebene Straße auf die Simulationsplattform.

ACHTUNG: Das aktive Experiment wird ggf. durch die Ausführung dieses Jobs gespeichert.

Liefert im Erfolgsfall True zurück.

ACHTUNG: Unter Umständen kann das Ergebnis auch None sein. None bedeutet nicht, dass ein Fehler auftrat, sondern dass das Ergebnis des Jobs nicht bestimmt werden kann.

Parametrierung

Parameter

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

Force

True

[False, True]

bool

Wenn diese Option aktiviert ist, wird die Straße immer heruntergeladen; andernfalls wird sie nur heruntergeladen, wenn es erforderlich ist (z. B. wenn Änderungen vorgenommen wurden).

Road

‚beibehalten‘

string

Name der Straße

Rückgabewert

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

result

[False, True]

bool

DownloadScenario

Aktiviert und lädt das angegebene Szenario auf die Simulationsplattform.

Mithilfe des Parameters DownloadSelection kann der Teil ausgewählt werden, der in der Simulationsplattform geladen werden soll.

Nur ab Version 2018A verfügbar.

ACHTUNG: Das aktive Experiment wird ggf. durch die Ausführung dieses Jobs gespeichert.

Liefert im Erfolgsfall True zurück.

Parametrierung

Parameter

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

DownloadSelection

0

int

Auswahl des Szenarioinhalts der auf die Simulationsplattform geladen wird.

0 - Alles

1 - nur Maneuver

2 - nur Traffic

Force

True

[False, True]

bool

Wenn diese Option aktiviert ist, wird das Szenario immer heruntergeladen; andernfalls wird es nur heruntergeladen, wenn es erforderlich ist (z. B. wenn Änderungen vorgenommen wurden).

Scenario

‚beibehalten‘

string

Name des Szenarios

Rückgabewert

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

result

[False, True]

bool

DownloadTrafficScenario

Speichert, aktiviert und lädt das angegebene Verkehrs-Szenario auf die Simulationsplattform.

Nur bis zur Version 2017B verfügbar.

ACHTUNG: Das aktive Experiment wird durch die Ausführung dieses Jobs gespeichert.

Liefert im Erfolgsfall True zurück.

ACHTUNG: Unter Umständen kann das Ergebnis auch None sein. None bedeutet nicht, dass ein Fehler auftrat, sondern dass das Ergebnis des Jobs nicht bestimmt werden kann.

Parametrierung

Parameter

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

TrafficScenario

‚beibehalten‘

string

Name des Verkehrs-Szenarios

Rückgabewert

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

result

[False, True]

bool

GetAliases

Liefert alle Aliasnamen für den gegebenen Kontext.

Parametrierung

Parameter

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

AliasContext

‚Road‘

[‚Road‘, ‚Maneuver‘, ‚Traffic‘]

string

Kontext für die Aliasse

Rückgabewert

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

result

object

Liste der Aliasnamen

GetManeuverPool

Gibt eine Liste der im Pool des aktiven Projekts hinterlegten Maneuver zurück.

Nur bis zur Version 2017B bzw. in 2018A - 2019B mit aktivierter „Maneuver Compatibility“ verfügbar. Für die Verwendung des „Maneuver Compatibility“-Modus muss dieser in ModelDesk und in der Testbenchkonfiguration aktiviert sein.

GetParameterSetPool

Gibt eine Liste der im Pool des aktiven Projekts hinterlegten Parametersätze zurück

GetRoadPool

Gibt eine Liste der im Pool des aktiven Projekts hinterlegten Straßen zurück

GetScenarioPool

Gibt eine Liste der im Pool des aktiven Projekts hinterlegten Szenarien zurück.

Nur ab Version 2018A verfügbar.

GetTrafficPool

Gibt eine Liste der im Pool des aktiven Projekts hinterlegten Verkehrs-Szenarien zurück.

Nur bis zur Version 2017B verfügbar.

Import

Importiert die angegebene Datei (xml- oder zip-Datei) in den Pool des Projekts. ACHTUNG: Durch Verwendung dieses Jobs wird das ModelDesk-Projekt gespeichert.

Parametrierung

Parameter

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

filename

string

Dateiname

Rückgabewert

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

result

[False, True]

bool

ReadAlias

Liest für einen Alias alle zugehörigen Werte.

Jedem Alias sind eine oder mehrere Referenzen zugeordnet. Diese haben jeweils einen eigenen Wert, sind aber alle zum Alias zugehörig.

Parametrierung

Parameter

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

AliasContext

‚Road‘

[‚Road‘, ‚Maneuver‘, ‚Traffic‘]

string

Kontext für die Aliasse

AliasName

string

Name des Alias

Rückgabewert

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

result

object

Liste von Tupeln mit Referenzname und gelesenem Wert

ReadParameter

Führt einen beliebigen API-Pfad in Stringform aus und gibt dessen Resultat zurück. Der Basisknoten des Pfads ist das aktive Experiment.

Beispielaufruf:

ApiPath: ‚Road.Roads.Item(0).Length‘

-> Gibt Länge der ersten aktiven Straße zurück.

Parametrierung

Parameter

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

ApiPath

string

API-Befehlspfad

Rückgabewert

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

result

object

ReloadActiveProject

Schließt das aktuell geöffnete Projekt und öffnet es erneut.

Parametrierung

Parameter

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

SaveProject

True

[False, True]

bool

Wenn gesetzt, wird das zuvor geladene Projekt gespeichert, bevor es erneut geöffnet wird.

ResetManeuver

Setzt das Modell zurück.

Liefert im Erfolgsfall True zurück.

Parametrierung

Rückgabewert

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

result

[False, True]

bool

StartManeuver

Startet das Manöver.

Liefert im Erfolgsfall True zurück.

Parametrierung

Parameter

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

DownloadExperimentElements

True

[False, True]

bool

Lädt die im aktiven Experiment ausgewählten Elemente wie Road, Scenario und Parameterset.

Rückgabewert

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

result

[False, True]

bool

StopManeuver

Stoppt das Manöver.

Liefert im Erfolgsfall True zurück.

Parametrierung

Rückgabewert

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

result

[False, True]

bool

WriteAlias

Schreibt den gegeben Wert für den Alias und damit für alle zugehörigen Referenzen.

Parametrierung

Parameter

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

AliasContext

‚Road‘

[‚Road‘, ‚Maneuver‘, ‚Traffic‘]

string

Kontext für die Aliasse

AliasName

string

Name des Alias

AliasValue

object

Wert der geschrieben werden soll

WriteParameter

Führt einen beliebigen API-Pfad in Stringform aus, schreibt den angegebenen Wert darauf und gibt den neuen Wert zurück. Der Basisknoten des Pfads ist das aktive Experiment.

Beispielaufruf:

ApiPath: ‚Road.Roads.Item(0).StartParameter.x‘

Value: 20

-> Setzt die x-Koordinate des Startpunkts der ersten aktiven Straße auf den Wert 20.

ACHTUNG: Die geschriebene Änderung wird erst durch einen erneuten Download eines Parametersatzes/Maneuvers/Straße/Verkehrs-Szenario in die Simulation übertragen.

Parametrierung

Parameter

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

ApiPath

string

API-Befehlspfad

Value

object

Wert

Rückgabewert

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

result

object