Input
Option to load external input data for simulation using top-level input ports
Model Configuration Pane: Data Import/Export
Description
The software loads the specified input data from a workspace for simulation. When you simulate a model hierarchy, only input ports in the top model load data from the workspace. The Input parameter value for referenced models is ignored except when you simulate a referenced model as a top model. To load data into a referenced model that is not simulated as a top model, use another block, such as the From Workspace block.
For more information, see Load Data to Root-Level Input Ports.
You can also stream input data from a file using a
matlab.io.datastore.SimulationDatastore
object or a
Simulink.SimulationData.DatasetRef
object. For more information,
see Load Big Data for Simulations.
Settings
off
(default) | on
off
By default, the Input parameter is disabled. Leave this parameter disabled when your model does not contain top-level input ports.
on
When your model contains top-level input ports, select the Input parameter to specify input data for the simulation. In the text box, specify the external input data to load as a MATLAB® expression, such as the name of a variable in the workspace.
The Input parameter does not include data dictionaries when resolving the expression you specify. When a model uses a data dictionary and you disable access to the base workspace, the Input parameter still accesses simulation input data in the base workspace. For more information about how the software resolves symbols in the expression, see Symbol Resolution.
Tips
You can use the Root Inport Mapper to facilitate mapping input data to top-level input ports in models with several top-level Inport or In Bus Element blocks. To open the Root Inport Mapper, click Connect Inputs.
Inport blocks in the top model interpolate and extrapolate input data values according to block parameter values.
In Bus Element blocks in the top model always linearly interpolate and extrapolate input data values.
Recommended Settings
The table summarizes recommended values for this parameter based on considerations related to code generation.
Application | Setting |
---|---|
Debugging | No impact |
Traceability | No impact |
Efficiency | No recommendation |
Safety precaution | No recommendation |
Programmatic Use
Parameter: LoadExternalInput |
Value: 'on' | 'off' |
Default: 'off' |
Parameter: ExternalInput |
Type: string | character vector |
Value: valid MATLAB expression |
Default: '[t,u]' |
Version History
Introduced before R2006a