La traduction de cette page n'est pas à jour. Cliquez ici pour voir la dernière version en anglais.

Simulink.SimulationInput

Créer des objets Simulink.SimulationInput pour modifier un modèle pour une ou plusieurs simulations

développer tous les éléments de la page

Description

L’objet Simulink.SimulationInput permet d’apporter des modifications à un modèle puis d’exécuter des simulations intégrant ces modifications. Les modifications sont temporairement appliquées au modèle. Vous pouvez utiliser un objet Simulink.SimulationInput pour modifier l’état initial, les paramètres du modèle ou des blocs, les entrées externes et les variables. L’objet Simulink.SimulationInput vous permet également de spécifier des fonctions MATLAB® à exécuter au début et à la fin de chaque simulation en utilisant les fonctions setPreSimFcn et setPostSimFcn.

Création

Syntaxe

simIn = Simulink.SimulationInput(mdlName)

Description

simIn = Simulink.SimulationInput(mdlName) crée un objet Simulink.SimulationInput pour configurer une simulation du modèle spécifié par mdlName.

exemple

Arguments en entrée

développer tout

Nom du modèle, spécifié en tant que chaîne de caractères ou vecteur de caractères. Lorsque vous spécifiez le nom du modèle, n’incluez pas l’extension .slx.

Propriétés

développer tout

Nom du modèle pour lequel l’objet SimulationInput est créé.

État initial du modèle dans une simulation, spécifié en tant qu’objet Simulink.op.ModelOperatingPoint.

Entrées externes ajoutées au modèle pour une simulation.

Paramètres de bloc à modifier dans le modèle.

Variables à modifier dans le modèle.

Paramètres du modèle à modifier.

Fonction MATLAB à exécuter avant le début de la simulation.

Fonction MATLAB à exécuter après chaque simulation.

Brève description de la simulation, spécifiée en tant que tableau de caractères ou chaîne de caractères.

Depuis R2024a

Nom de la configuration de variants à appliquer au modèle avant d’exécuter la simulation, spécifiée en tant que chaîne de caractères ou vecteur de caractères.

Cette propriété est applicable aux modèles qui utilisent des éléments de variants comme des variants de blocs et de paramètres, et pour lesquels des configurations de variants ont été créées avec Variant Manager for Simulink®. Pour un tel modèle, vous pouvez spécifier une configuration de variants qui activera un chemin de variants spécifique dans toute la hiérarchie du modèle avant l’exécution de la simulation.

Pour un exemple, consultez la rubrique Run Simulations for Variant Models Using Variant Configurations.

Exemple : "LinInterExpNoNoise"

Types de données : char | string

Fonctions d'objet

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

Exemples

réduire tout

Créez un objet SimulationInput pour configurer une simulation du modèle sldemo_househeat.

Ouvrez le modèle.

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

Créez un seul objet SimulationInput pour le modèle.

simin = Simulink.SimulationInput(mdl);

Cet exemple montre comment créer un tableau d’objets SimulationInput pour configurer plusieurs simulations du modèle vdp.

Ouvrez le modèle.

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

Créez un tableau d’objets SimulationInput avec une boucle for.

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

Modifiez la valeur d’un paramètre de bloc pour une simulation du modèle sldemo_househeat avec un objet Simulink.SimulationInput.

Ouvrez le modèle.

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

Créez un tableau d’objets SimulationInput pour le modèle.

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

Spécifiez le paramètre Value pour le bloc nommé Set Point avec la fonction setBlockParameter.

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

Simulez le modèle.

out = parsim(simin);

Cet exemple montre comment utiliser des objets Dataset pour définir des entrées externes avec des objets Simulink.SimulationInput.

Ouvrez le modèle.

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

Créez un objet Dataset pour ce modèle.

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

Créez un objet Simulink.SimulationInput et définissez les entrées externes.

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

Simulez le modèle.

out = sim(simin);

Historique des versions

Introduit dans R2017a

développer tout

Voir aussi

Fonctions

Outils

Objets

Rubriques