Programmatische Bearbeitung von Modellen

Verwenden von APIs zur Durchführung grundlegender Modellierungsaufgaben wie das Hinzufügen, Konfigurieren und Verbinden von Blöcken

Sie können Simulink^®-Modelle programmgesteuert erstellen, bearbeiten, suchen und überprüfen. Um mit einem Modell programmgesteuert zu interagieren, muss das Modell geladen werden. Durch das Erstellen oder Öffnen eines Modells wird das Modell auch geladen. Verwenden Sie die unter „Create Models“ aufgeführten Funktionen, um ein Modell zu erstellen, zu laden oder zu öffnen. Verwenden Sie dann die anderen Funktionen auf dieser Seite, um das Modell und seinen Inhalt programmgesteuert zu bearbeiten. Geben Sie in der Funktion zur Eingabe von Argumenten das Objekt, das die Funktion bearbeiten soll, als Handle, Pfad oder Dateinamen an. Dieses Zielobjekt kann ein Modell, eine Komponente wie ein Subsystem oder eine Bibliothek oder ein Modellelement wie ein Block oder eine Signalleitung sein. Sie können Zielobjekte angeben, deren Namen und Position Sie kennen, oder Sie können programmgesteuert nach Zielobjekten suchen, die bestimmte Kriterien erfüllen. Weitere Informationen finden Sie in der Funktionsdokumentation und unter Get Handles and Paths.

Wenn Sie ein Modell mit Dritten teilen möchten, ohne geistiges Eigentum preiszugeben, erstellen Sie mithilfe der Funktion Simulink.ModelReference.protect (Embedded Coder) eine geschützte Version Ihres Modells. Siehe Protect Models to Conceal Contents (Embedded Coder) für weitere Informationen.

Informationen zur programmgesteuerten Ausführung von Simulationen finden Sie unter Run Simulations Programmatically. Informationen zum programmgesteuerten Erstellen und Bearbeiten von Projekten finden Sie unter Create and Edit Projects Programmatically. Informationen zur programmgesteuerten Konfiguration des Simulink-Editors finden Sie unter Programmatic Model Editor Appearance Parameters. Informationen zum Debuggen von Simulationen aus dem MATLAB^®-Befehlsfenster finden Sie unter Simulationen programmatisch debuggen.

Funktionen

alle erweitern

Handles und Pfade abrufen

`getSimulinkBlockHandle`	Get block handle from block path
`getfullname`	Get path that identifies block or line
`get_param`	Get parameter names and values
`gcs`	Get path name of current system
`gcb`	Get path name of current block
`gcbh`	Abrufen des Handle des aktuellen Blocks
`gcbp`	Get `Simulink.BlockPath` object for current block
`bdroot`	Top-level model of current system
`getCurrentAnnotation`	Get current annotation object
`getCallbackAnnotation`	Get annotation executing callback

Suche

Modellelemente suchen

`find_system`	Find models, blocks, lines, ports, and annotations
`Simulink.findBlocks`	Suchen von Blöcken in Simulink-Modellen
`Simulink.findBlocksOfType`	Suchen nach einem bestimmten Blocktyp in Simulink-Modellen
`Simulink.FindOptions`	Specify options for finding blocks in models and subsystems
`hilite_system`	Highlight block, signal line, port, or annotation

Modelle suchen

`find_system`	Find models, blocks, lines, ports, and annotations
`Simulink.allBlockDiagrams`	Find loaded Simulink models and libraries
`modelfinder`	Search and open examples, models, and projects (Seit R2022a)
`modelfinder.importDatabase`	Import database to Model Finder (Seit R2023b)
`modelfinder.createDatabase`	Create new database to index models (Seit R2023b)
`modelfinder.setDefaultDatabase`	Set default database to index models (Seit R2023b)
`modelfinder.setSearchDatabase`	Set search scope to find models (Seit R2023b)
`modelfinder.searchFilter`	Create Model Finder search filter (Seit R2025a)
`modelfinder.registerFolder`	Index models in Model Finder (Seit R2022a)
`modelfinder.unregisterFolder`	Remove models from Model Finder (Seit R2022a)
`modelfinder.deleteDatabase`	Remove database from Model Finder (Seit R2023b)

Modell-Metadaten abrufen

`Simulink.MDLInfo`	Extract SLX, SLXP, or MDL file information without loading file
`Simulink.MDLInfo.getDescription`	Extract SLX, SLXP, or MDL file description without loading file
`Simulink.MDLInfo.getMetadata`	Extract SLX, SLXP, or MDL file metadata without loading file

Modelle erstellen

Simulink starten

`simulink`	Öffnen Sie die Simulink-Startseite
`start_simulink`	Start Simulink without opening any windows
`isSimulinkStarted`	Check whether Simulink is started
`slLibraryBrowser`	Open, load, and close Simulink Library Browser, create and get handle of Library Browser object

Modelle erstellen, laden, öffnen, speichern und schließen

`new_system`	Create Simulink model or library in memory
`load_system`	Simulink-Modell in Speicher laden
`open_system`	Open model, library, subsystem, or block dialog box
`save_system`	Save Simulink model
`close_system`	Close Simulink model window or block dialog box
`bdclose`	Close any or all Simulink model windows unconditionally

Blöcke hinzufügen, ersetzen und löschen

`add_block`	Hinzufügen von Blöcken zu einem Modell
`addterms`	Add terminators to unconnected ports in model
`replace_block`	Replace blocks in Simulink model
`delete_block`	Delete blocks from Simulink system
`Simulink.BlockDiagram.deleteContents`	Delete graphical contents of model
`Simulink.SubSystem.deleteContents`	Delete contents of subsystem

Blöcke verbinden

`Simulink.connectBlocks`	Connect blocks with signal lines (Seit R2024b)
`add_line`	Add line to Simulink model
`delete_line`	Delete line from Simulink model

Parameter bearbeiten

`get_param`	Get parameter names and values
`set_param`	Einstellen eines Simulink-Parameterwerts
`add_param`	Add parameter to Simulink model
`delete_param`	Delete model parameter added with `add_param` function
`docblock`	Get or set editor invoked by Simulink DocBlock block

Modelle formatieren

Modell-Layout konfigurieren

`Simulink.BlockDiagram.arrangeSystem`	Improve layout of block diagram
`Simulink.BlockDiagram.routeLine`	Route existing lines of model
`Simulink.BlockDiagram.resizeBlocksToFitContent`	Adjust block size to fit displayed value (Seit R2024b)

Modellelemente in Subsysteme gruppieren

`Simulink.BlockDiagram.createSubsystem`	Create subsystem containing specified set of blocks
`Simulink.BlockDiagram.expandSubsystem`	Replace subsystem with subsystem contents
`Simulink.SubSystem.copyContentsToBlockDiagram`	Copy graphical contents from subsystem to another model
`Simulink.SubSystem.deleteContents`	Delete contents of subsystem
`bdIsSubsystem`	Determine whether model is subsystem

Modelle prüfen

`isSimulinkStarted`	Check whether Simulink is started
`bdIsLoaded`	Determine whether model, subsystem, or library is loaded
`bdIsDirty`	Determine whether model, subsystem, or library has unsaved changes
`slIsFileChangedOnDisk`	Determine whether model has changed since it was loaded
`bdIsLibrary`	Determine whether model is library
`bdIsSubsystem`	Determine whether model is subsystem
`edittime.getDisplayIssues`	Check whether model design warnings and errors are on
`edittime.setDisplayIssues`	Detect model design errors and warnings

Modelle teilen

Modellvorlagen verwenden

`Simulink.exportToTemplate`	Create template from model or project
`Simulink.createFromTemplate`	Create model or project from template
`Simulink.findTemplates`	Find model or project templates with specified properties
`Simulink.defaultModelTemplate`	Set or get default model template

Modelle exportieren

`Simulink.ModelReference.protect`	Obscure referenced model contents to hide intellectual property
`Simulink.exportToVersion`	Export model, library, or project for use in previous version of Simulink
`Simulink.exportToTemplate`	Create template from model or project
`slCharacterEncoding`	Specify encoding to use in code generated from Simulink models

Drucken von Modellen

`frameedit`	Open PrintFrame Editor to edit print frames for Simulink and Stateflow block diagrams
`orient`	Paper orientation for printing or saving
`print`	Print figure or save to specific file format

Objekte

`ModelFinderFilter`	Model Finder search filter (Seit R2025a)
`Simulink.Annotation`	Create and specify properties of text, image, and area annotations

Themen

Objekte für die programmatische Bearbeitung festlegen

Get Handles and Paths
Programmatically specify models, components, and model elements you want to edit.
Search Programmatically
Find models, blocks, signal lines, ports, and annotations.

Modelle erstellen

Create, Load, Open, Save, and Close Models Programmatically
Run model file operations.
Add, Copy, Replace, and Delete Blocks Programmatically
Populate models with blocks.
Connect Blocks Programmatically
Connect blocks with signal lines.
Programmatically Specify Block Parameters and Properties
To write scripts that modify block behavior, determine the programmatic names and supported values of block parameters and properties.

Modelle formatieren

Configure Model Layout Programmatically
Change the position and arrangement of blocks.
Group Blocks into Subsystems Programmatically
Use subsystems to organize large models.
Configure Model Element Names and Labels Programmatically
Name blocks, and label signal lines and ports.
Create and Edit Annotations Programmatically
Create and edit text, image, and area annotations programmatically.
Configure Model Style Elements Programmatically
Change model fonts and colors.
Control Masks Programmatically
Specify and edit block masks programmatically.

Modelle teilen

Print Models Programmatically
Use the MATLAB print command to print Simulink models.