Simulink.ModelWorkspace

Interagire con il workspace di un modello in modo programmatico

Descrizione

Utilizzare un oggetto Simulink.ModelWorkspace per interagire con un workspace del modello. Ad esempio, è possibile aggiungere e rimuovere variabili, impostare la sorgente dei dati del workspace e salvare le modifiche nel workspace.

Nota

Per le attività di gestione dei dati più comuni che implicano un workspace del modello, il dizionario dei dati di Simulink^® (sezione Dati di progettazione) o un file MAT, si consiglia di utilizzare le funzioni fornite dall'oggetto Simulink.data.DataConnection anziché quelle specifiche della sorgente dei dati. Queste funzioni oggetto forniscono un'interfaccia a riga di comando comune per gestire i dati utilizzando meno righe di codice. Utilizzare la funzione Simulink.data.connect per creare una connessione alla sorgente dei dati, quindi utilizzare l'insieme di funzioni comuni fornite dall'oggetto Simulink.data.DataConnection. Per le attività specifiche relative alla sorgente dei dati, ad esempio la rimozione o l'aggiunta di un dizionario dei dati di riferimento, creare un oggetto specifico per la sorgente dei dati, quindi utilizzare le funzioni fornite da tale oggetto per gestire la sorgente dei dati. Per ulteriori informazioni, vedere Manage Design Data for Simulink Models Programmatically.

Per ulteriori informazioni, vedere Model Workspaces.

Creazione

Per creare un Simulink.ModelWorkspace, utilizzare la funzione get_param per eseguire una query sul valore del parametro del modello ModelWorkspace. Ad esempio, per creare un oggetto chiamato mdlWks che rappresenti il workspace di un modello denominato myModel.slx:

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

Proprietà

DataSource — Sorgente per l'inizializzazione delle variabili nel workspace del modello

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

Sorgente per l'inizializzazione delle variabili nel workspace del modello, specificata come uno di questi vettori di caratteri:

• 'Model File': le variabili sono memorizzate nel file del modello. Quando si salva il modello, vengono salvate anche le variabili.

• 'MATLAB Code': le variabili sono create dal codice MATLAB^® scritto dall'utente e memorizzate nel file del modello.

• 'MAT-File': le variabili sono memorizzate in un MAT-file, che è possibile gestire e manipolare separatamente dal file del modello.

• 'MATLAB File': le variabili sono create dal codice MATLAB in un file di script, che è possibile gestire e manipolare separatamente dal file del modello.

Quando DataSource è impostato su 'MATLAB Code' o 'MATLAB File', il codice MATLAB non può includere alcun comando che esegua un diagramma di aggiornamento, incluso:

• sim

• codegen

• slbuild

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

Tipi di dati: char

FileName — Nome del file esterno che memorizza o crea le variabili

'' (vettore di caratteri vuoto) (predefinito) | vettore di caratteri

Nome del file esterno che memorizza o crea le variabili, specificato come vettore di caratteri. Per abilitare questa proprietà, impostare DataSource su 'MAT-File' o 'MATLAB File'.

Esempio 'myFile.mat'

Esempio 'myFile.m'

Tipi di dati: char

MATLABCode — Codice MATLAB per l'inizializzazione delle variabili

'' (vettore di caratteri vuoto) (predefinito) | vettore di caratteri

Codice MATLAB per l'inizializzazione delle variabili, specificato come vettore di caratteri. Per abilitare questa proprietà, impostare DataSource su 'MATLAB Code'.

Il codice MATLAB non può includere alcun comando che esegua un diagramma di aggiornamento, incluso:

• sim

• codegen

• slbuild

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

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

Tipi di dati: char

Funzioni oggetto

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	Assegnare un valore a una variabile nel workspace del modello

Esempi

Interazione programmatica con il workspace del modello

Creare una variabile nel workspace di un modello. Quindi, modificare la variabile ed eseguire una query sul valore della variabile per confermare la modifica.

Aprire il modello dell'esempio vdp.

openExample('simulink_general/VanDerPolOscillatorExample')

Creare un oggetto Simulink.ModelWorkspace mdlWks che rappresenti il workspace del modello di vdp.

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

Creare una variabile denominata myVar con valore 5.12 nel workspace del modello.

assignin(mdlWks,'myVar',5.12)

Applicare un nuovo valore 7.22. A tal fine, creare prima una copia temporanea della variabile utilizzando la funzione getVariable. Quindi, modificare la copia e utilizzarla per sovrascrivere la variabile originale nel workspace del modello.

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

Confermare il nuovo valore eseguendo una query sul valore della variabile.

getVariable(mdlWks,'myVar')

ans =

    7.2200

Cronologia versioni

Introduzione prima di R2006a

Vedi anche

Simulink.data.connect | Simulink.data.DataConnection

Argomenti

• Model Workspaces