Contenuto principale

La traduzione di questa pagina non è aggiornata. Fai clic qui per vedere l'ultima versione in inglese.

Simulink.SimulationInput

Creare oggetti Simulink.SimulationInput per apportare modifiche al modello per simulazioni multiple o singole

Descrizione

L'oggetto Simulink.SimulationInput consente di apportare modifiche a un modello e di eseguire simulazioni con tali modifiche. Queste modifiche vengono applicate temporaneamente al modello. Utilizzando un oggetto Simulink.SimulationInput è possibile modificare lo stato iniziale, i parametri del modello, i parametri del blocco, gli input esterni e le variabili. Tramite l'oggetto Simulink.SimulationInput, è inoltre possibile specificare le funzioni di MATLAB® da eseguire all'inizio e alla fine di ciascuna simulazione, utilizzando la funzione setPreSimFcn e setPostSimFcn.

Creazione

Descrizione

simIn = Simulink.SimulationInput(mdlName) crea un oggetto Simulink.SimulationInput per configurare una simulazione del modello specificato da mdlName.

esempio

Argomenti di input

espandi tutto

Nome del modello, specificato come stringa o vettore di caratteri. Quando si specifica il nome del modello, non includere l'estensione .slx.

Proprietà

espandi tutto

Nome del modello per il quale viene creato l'oggetto SimulationInput.

Stato iniziale del modello per una simulazione, specificato come oggetto Simulink.op.ModelOperatingPoint.

Input esterni aggiunti al modello per una simulazione.

Parametri di blocco del modello che vengono modificati.

Variabili del modello che vengono modificate.

Parametri del modello che vengono modificati.

Funzione di MATLAB da eseguire prima dell'inizio della simulazione.

Funzione di MATLAB da eseguire dopo ciascuna simulazione.

Breve descrizione della simulazione, specificata come array di caratteri o stringa.

Da R2024a

Nome della configurazione della variante da applicare al modello prima di eseguire la simulazione, specificato come stringa o vettore di caratteri.

Questa proprietà è applicabile ai modelli che utilizzano elementi della variante, come i blocchi della variante e i parametri della variante, nonché che presentano configurazioni della variante create per il modello Variant Manager for Simulink®. Per un modello di questo tipo, è possibile specificare una configurazione della variante che può attivare uno specifico percorso della variante attraverso la gerarchia del modello, prima dell'esecuzione della simulazione.

Per un esempio, vedere Run Simulations for Variant Models Using Variant Configurations.

Esempio "LinInterExpNoNoise"

Tipi di dati: char | string

Funzioni oggetto

applyToModelApply configuration in SimulationInput object to model
getVariantConfigurationGet name of variant configuration from SimulationInput object
loadVariablesFromExternalSourceLoad variables from a custom file into Simulink.SimulationInput object
loadVariablesFromMATFileLoad variables from MAT file into Simulink.SimulationInput object
removeVariableRemove variable from SimulationInput or Simulation object
setBlockParameterSet block parameter values for simulation using SimulationInput or Simulation object
setExternalInputSpecify external input data for top-level input ports using SimulationInput or Simulation object
setInitialStateSpecify initial state for simulation using SimulationInput or Simulation object
setPostSimFcn Set MATLAB function to run after each simulation
setPreSimFcnSpecify MATLAB function to run before start of each simulation on Simulink.SimulationInput object
setModelParameterSet model parameter values for simulation using SimulationInput or Simulation object
setVariableSet variable values for simulation using SimulationInput or Simulation object
setVariantConfigurationSet variant configuration for simulation using SimulationInput object
showContentsView summary of specification in SimulationInput or Simulation object
validateValidate contents of SimulationInput object

Esempi

comprimi tutto

Creare un oggetto SimulationInput per configurare una simulazione del modello sldemo_househeat.

Aprire il modello.

mdl = "sldemo_househeat";
openExample("simulink_general/sldemo_househeatExample",...
    SupportingFile=mdl)

Creare un singolo oggetto SimulationInput per il modello.

simin = Simulink.SimulationInput(mdl);

Questo esempio mostra come creare un array di oggetti SimulationInput per configurare diverse simulazioni del modello vdp.

Aprire il modello.

mdl = "vdp";
openExample("simulink_general/VanDerPolOscillatorExample",...
    SupportingFile=mdl)

Creare un array di oggetti SimulationInput utilizzando un for loop.

simin(1:10) = Simulink.SimulationInput(mdl);

Modificare il valore di un parametro del blocco per una simulazione del modello sldemo_househeat utilizzando un oggetto Simulink.SimulationInput.

Aprire il modello.

mdl = "sldemo_househeat";
openExample("simulink_general/sldemo_househeatExample",...
    SupportingFile=mdl)

Crea un array di oggetti SimulationInput per il modello.

simin(1:10) = Simulink.SimulationInput(mdl);

Specificare il parametro Value del blocco denominato Set Point utilizzando la funzione setBlockParameter.

blk = mdl + "/Set Point";
for k = 1:10
simin(k) = setBlockParameter(simin(k),blk,...
	Value=num2str(rand()*10+70));
end

Simulare il modello.

out = parsim(simin);

Questo esempio mostra come utilizzare gli oggetti Dataset per impostare gli input esterni con gli oggetti Simulink.SimulationInput.

Aprire il modello.

mdl = "sldemo_mdlref_counter";
openExample(...
    "simulink/ExamineMultipleReferencedModelInstancesExample",...
    SupportingFile=mdl)

Creare un oggetto Dataset per questo modello.

t = (0:0.01:10)';
ds = Simulink.SimulationData.Dataset;
ds = setElement(ds,1,timeseries(5*ones(size(t)),t));
ds = setElement(ds,2,timeseries(10*sin(t),t));
ds = setElement(ds,3,timeseries(-5*ones(size(t)),t));

Creare un oggetto Simulink.SimulationInput e impostare gli input esterni.

simin = Simulink.SimulationInput(mdl);
simin = setExternalInput(simin,ds);

Simulare il modello.

out = sim(simin);

Cronologia versioni

Introdotto in R2017a

espandi tutto