Simulink.ModelWorkspace

Programmatisches Interagieren mit dem Modell-Workspace eines Modells

Beschreibung

Verwenden Sie ein Simulink.ModelWorkspace-Objekt, um mit eine Modell-Workspace zu interagieren. Sie können beispielsweise Variablen hinzufügen und entfernen, die Datenquelle des Workspace festlegen und Änderungen am Workspace speichern.

Hinweis

Für die meisten gängigen Datenverwaltungsaufgaben, die einen Modell-Workspace, ein Simulink^® Data Dictionary (Abschnitt Design Data) oder eine MAT-Datei betreffen, empfiehlt es sich, die vom Simulink.data.DataConnection-Objekt bereitgestellten Funktionen gegenüber den datenquellenspezifischen Funktionen zu verwenden. Diese Objektfunktionen bieten eine gemeinsame Befehlszeilenschnittstelle zur Verwaltung der Daten mit weniger Codezeilen. Stellen Sie mithilfe der Simulink.data.connect-Funktion eine Verbindung zu Ihrer Datenquelle her und verwenden Sie dann den gemeinsamen Satz von Funktionen des Simulink.data.DataConnection-Objekts. Erstellen Sie für datenquellenspezifische Aufgaben, z. B. das Entfernen oder Hinzufügen eines Referenz-Data-Dictionary, ein datenquellenspezifisches Objekt und verwenden Sie dann die von diesem Objekt bereitgestellten Funktionen zur Verwaltung Ihrer Datenquelle. Weitere Informationen finden Sie unter Manage Design Data for Simulink Models Programmatically.

Weitere Informationen finden Sie unter Model Workspaces.

Erstellung

Um ein Simulink.ModelWorkspace zu erstellen, verwenden Sie die Funktion get_param, um den Wert des Modellparameters ModelWorkspace abzufragen. Um beispielsweise ein Objekt namens mdlWks zu erstellen, dass den Model-Workspace eines Modells namens myModel.slx darstellt:

mdlWks = get_param('myModel','ModelWorkspace')

Eigenschaften

DataSource — Quelle zum Initialisieren von Variablen im Modell-Workspace

'Model File' (Standardeinstellung) | 'MAT-File' | 'MATLAB Code' | 'MATLAB File'

Quelle zum Initialisieren der Variablen im Modell-Workspace, angegeben als einer dieser Zeichenvektoren:

• 'Model File' — Die Variablen werden in der Modelldatei gespeichert. Wenn Sie das Modell speichern, werden die Variablen ebenfalls gespeichert.

• 'MATLAB Code' – Die Variablen werden von MATLAB^® Programmcode erstellt, den Sie in der Modelldatei schreiben und speichern.

• 'MAT-File' — Die Variablen werden in einer MAT-Datei gespeichert, die Sie unabhängig von der Modelldatei verwalten und bearbeiten können.

• 'MATLAB File' – Die Variablen werden von MATLAB Programmcode in einer Skriptdatei erstellt, die Sie unabhängig von der Modelldatei verwalten und bearbeiten können.

Wenn DataSource auf 'MATLAB Code' oder 'MATLAB File' gesetzt ist, kann der MATLAB Programmcode keine Befehle umfassen, die ein Aktualisierungsdiagramm durchführen, darunter:

• sim

• codegen

• slbuild

• set_param(model,'SimulationCommand','Update')

Datentypen: char

FileName — Name der externen Datei, die Variablen speichert oder erstellt

'' (leerer Zeichenvektor) (Standardeinstellung) | Zeichenvektor

Name der externen Datei, die Variablen speichert oder erstellt, angegeben als Zeichenvektor. Um diese Eigenschaft zu aktivieren, setzen Sie DataSource auf 'MAT-File' oder 'MATLAB File'.

Beispiel: 'myFile.mat'

Beispiel: 'myFile.m'

Datentypen: char

MATLABCode — MATLAB-Code für die Initialisierung von Variablen

'' (leerer Zeichenvektor) (Standardeinstellung) | Zeichenvektor

MATLAB Programmcode zum Initialisieren von Variablen, angegeben als Zeichenvektor. Um diese Eigenschaft zu aktivieren, setzen Sie DataSource auf 'MATLAB Code'.

Der MATLAB Programmcode kann keine Befehle umfassen, die ein Aktualisierungsdiagramm durchführen, darunter:

• sim

• codegen

• slbuild

• set_param(model,'SimulationCommand','Update')

Beispiel: sprintf('%% Create variables that this model uses.\n\nK = 0.00983;\n\nP = Simulink.Parameter(5);')

Datentypen: char

Objektfunktionen

getVariable	Return value of variable in the model workspace of a model
getVariablePart	Get value of variable property in model workspace
setVariablePart	Set property of variable in model workspace
hasVariable	Determine whether variable exists in the model workspace of a model
whos	Return list of variables in the model workspace of a model
saveToSource	Save model workspace changes to the external data source of the model workspace
save	Save contents of model workspace to a MAT-file
reload	Reinitialize variables from the data source of a model workspace
evalin	Evaluate expression in the model workspace of a model
clear	Clear variables from the model workspace of a model
assignin	Assign value to variable in the model workspace

Beispiele

Programmgesteuerte Interaktion mit dem Modell-Workspace

Erstellen Sie eine Variable im Modell-Workspace eines Modells. Modifizieren Sie daraufhin die Variable und fragen Sie den Wert der Variable ab, um die Änderung zu bestätigen.

Öffnen Sie das Beispielmodell vdp.

openExample('simulink_general/VanDerPolOscillatorExample')

Erstellen Sie ein Simulink.ModelWorkspace-Objekt mdlWks, das den Modell-Workspace von vdp darstellt.

mdlWks = get_param('vdp','ModelWorkspace');

Erstellen Sie eine Variable namens myVar mit dem Wert 5.12 im Modell-Workspace.

assignin(mdlWks,'myVar',5.12)

Wenden Sie einen neuen Wert 7.22 an. Erstellen Sie hierfür mithilfe der Funktion getVariable eine temporäre Kopie der Variable. Modifizieren Sie daraufhin die Kopie und überschreiben Sie die ursprüngliche Variable im Modell-Workspace mit der Kopie.

temp = getVariable(mdlWks,'myVar');
temp = 7.22;
assignin(mdlWks,'myVar',temp)

Fragen Sie den Wert der Variable ab, um den neuen Wert zu überprüfen.

getVariable(mdlWks,'myVar')

ans =

    7.2200

Versionsverlauf

Eingeführt vor R2006a

Siehe auch

Simulink.data.connect | Simulink.data.DataConnection

Themen

• Model Workspaces