dSPACE: ModelDesk¶
Bisheriger/interner Bezeichner: MODELDESK
Herstellerinformationen
Hersteller |
Webseite |
Produktname |
Version |
|---|---|---|---|
dSPACE |
ModelDesk |
dSPACE Release 2014A - 2024B |
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.
Eigenschaften 🛈¶
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. |
Jobs 🛈¶
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 |