qc_load_model :: QUARC MATLAB Functions

navigation bar

qc_load_model

Loads the generated code for a model on a QUARC target.

Syntax

result = qc_load_model(target_uri, model, arguments) % Load code for model with specified arguments on given target
result = qc_load_model(target_uri, model)            % Load code for model with external mode arguments on given target
result = qc_load_model(model, arguments)             % Load code for model with specified arguments
result = qc_load_model(model)                        % Load code for model with external mode arguments
result = qc_load_model                               % Load code for the current model with external mode arguments

Description

Loads the code generated from a model on a QUARC target. The code is assumed to be downloaded to the target already. If no arguments are specified then the arguments specified in the external mode MEX arguments in the Code Generation/Interface configuration pane are used. If no model is specified then the currently selected model is used. The target is identified by the settings for the active configuration for the model if no target URI is provided. Substitutions on the model arguments are performed as described in the help for qc_get_model_arguments.

If the model is not open then then first form of the command must be used so that the target URI and model arguments are known. Furthermore, the model arguments must not contain any format specifiers that require information from the model, such as the model URI. If the model is open then none of these restrictions apply.

Parameters

target_uri

A string containing the URI of the target. eg. 'shmem://quarc-target:1'. If no target URI is specified then the target URI associated with the model's active configuration is used.

model

A string indicating the name of the model to load. eg. 'q_a_lpbk'. Use bdroot to specify the current model if arguments will also be specified.

arguments

A string containing the model arguments. These arguments will override the arguments specified for Code Generation. Format specifiers are still permitted.

Outputs

result

Returns 0 on success and a negative error code on failure. See qc_error and qc_get_error_message for handling error codes. If no output is assigned it issues an error on failure.

Examples

result = qc_load_model('q_a_lpbk'); % Loads the q_a_lpbk model on the target.