Simulink.SimulationInput

Crear objetos Simulink.SimulationInput para hacer cambios en modelos para simulaciones múltiples o individuales

expandir todo en la página

Descripción

El objeto Simulink.SimulationInput permite hacer cambios en un modelo y ejecutar simulaciones con esos cambios. Estos cambios se aplican temporalmente al modelo. Si usa un objeto Simulink.SimulationInput, puede cambiar el estado inicial, parámetros de modelo, parámetros de bloque, entradas externas y variables. Mediante el objeto Simulink.SimulationInput, también puede especificar funciones de MATLAB® para que se ejecuten al inicio y al final de cada simulación utilizando la función setPreSimFcn y setPostSimFcn.

Creación

Sintaxis

simIn = Simulink.SimulationInput(mdlName)

Descripción

simIn = Simulink.SimulationInput(mdlName) crea un objeto Simulink.SimulationInput para configurar una simulación del modelo especificada por mdlName.

ejemplo

Argumentos de entrada

expandir todo

Nombre del modelo, especificado como una cadena o un vector de caracteres. Cuando especifique el nombre del modelo, no incluya la extensión .slx.

Propiedades

expandir todo

Nombre del modelo para el que se crea el objeto SimulationInput.

Estado inicial del modelo para una simulación, especificado como un objeto Simulink.op.ModelOperatingPoint.

Entradas externas añadidas al modelo para una simulación.

Parámetros de bloque del modelo que se modifican.

Variables del modelo que se modifican.

Parámetros de modelo del modelo que se modifican.

Función de MATLAB que se ejecuta antes de iniciar la simulación.

Función de MATLAB que se ejecuta después de cada simulación.

Breve descripción de la simulación, especificada como un arreglo de caracteres o una cadena.

Desde R2024a

Nombre de una configuración de variantes que se va a aplicar al modelo antes de ejecutar la simulación, especificado como una cadena o un vector de caracteres.

Esta propiedad es aplicable a los modelos que usan elementos de variantes como bloques de variantes y parámetros de variantes, y que también tienen configuraciones de variantes creadas para el modelo utilizando Variant Manager for Simulink®. Para un modelo de este tipo, puede especificar una configuración de variantes que puede activar una ruta de variante específica en toda la jerarquía del modelo antes de que la simulación se ejecute.

Para ver un ejemplo, consulte Run Simulations for Variant Models Using Variant Configurations.

Ejemplo: "LinInterExpNoNoise"

Tipos de datos: char | string

Funciones del objeto

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

Ejemplos

contraer todo

Cree un objeto SimulationInput para configurar una simulación del modelo sldemo_househeat.

Abra el modelo.

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

Cree un objeto SimulationInput único para el modelo.

simin = Simulink.SimulationInput(mdl);

Este ejemplo muestra cómo crear un arreglo de objetos SimulationInput para configurar múltiples simulaciones del modelo vdp.

Abra el modelo.

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

Cree un arreglo de objetos SimulationInput utilizando un bucle for.

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

Modifique el valor de un parámetro de bloque para una simulación del modelo sldemo_househeat utilizando un objeto Simulink.SimulationInput.

Abra el modelo.

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

Cree un arreglo de objetos SimulationInput para el modelo.

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

Especifique el parámetro Value para el bloque denominado Set Point utilizando la función setBlockParameter.

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

Simule el modelo.

out = parsim(simin);

Este ejemplo muestra cómo usar objetos Dataset para establecer entradas externas con objetos Simulink.SimulationInput.

Abra el modelo.

openExample("simulink_features/ComponentBasedModelingUsingModelReferenceExample")
openProject("ModelReference");
mdl = "sldemo_mdlref_counter";
open_system(mdl)

Cree un objeto Dataset para este modelo.

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));

Cree un objeto Simulink.SimulationInput y establezca las entradas externas.

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

Simule el modelo.

out = sim(simin);

Historial de versiones

Introducido en R2017a

expandir todo

Consulte también

Funciones

Herramientas

Objetos

Temas