CD Construct Random Model VI

Control Design VI and Function

previous page next page
CD Construct Random Model VI

Owning Palette: Model Construction VIs

Installed With: Control Design and Simulation Module

Creates a random model in state-space, transfer function, or zero-pole-gain representation. You can specify the sampling time, location of uncontrollable or unobservable states (for state-space), and location of poles and zeros in the different regions of the complex plane. You must manually select the polymorphic instance to use.

Details  

Use the pull-down menu to select an instance of this VI.

 Place on the block diagram  Find on the Functions palette

CD Construct Random Model (State-Space)

If Strictly Proper? is TRUE, the model is strictly proper. For a state-space model to be strictly proper, the D matrix must be a null matrix. For a transfer function or a zero-pole-gain model to be strictly proper, the order of the polynomial of the numerator must be less than the order of the polynomial of the denominator. The default is TRUE.
Sampling Time (s) defines whether the model represents a continuous-time system or a discrete-time system. If the model represents a continuous-time system, Sampling Time (s) must equal zero. If the model represents a discrete-time system, Sampling Time (s) must be greater than zero and equal to the sampling rate, in seconds, of the discrete system. The default is 0.
Note  If you use the inputs to create a continuous-time system, setting the Sampling Time (s) to a value greater than zero does not yield the discrete-time equivalent of the system. You must use the CD Convert Continuous to Discrete VI to convert the continuous-time system to the discrete-time equivalent of the system.
Number of Inputs specifies the number of inputs for the random system this VI creates. The default is 1.
Number of Outputs specifies the number of outputs for the random system this VI creates. The default is 1.
System Order specifies the order (dimension of matrix A) of the multiple-input multiple-output (MIMO) system this VI uses for the random model generation. The default is 2. LabVIEW does not use this input if you wire values to the Poles input. By default, the poles that the System Order specifies are stable.
error in describes error conditions that occur before this VI or function runs. The default is no error. If an error occurred before this VI or function runs, the VI or function passes the error in value to error out. This VI or function runs normally only if no error occurred before this VI or function runs. If an error occurs while this VI or function runs, it runs normally and sets its own error status in error out. Use the Simple Error Handler or General Error Handler VIs to display the description of the error code. Use exception control to treat what is normally an error as no error or to treat a warning as an error. Use error in and error out to check errors and to specify execution order by wiring error out from one node to error in of the next node.
status is TRUE (X) if an error occurred before this VI or function ran or FALSE (checkmark) to indicate a warning or that no error occurred before this VI or function ran. The default is FALSE.
code is the error or warning code. The default is 0. If status is TRUE, code is a nonzero error code. If status is FALSE, code is 0 or a warning code.
source specifies the origin of the error or warning and is, in most cases, the name of the VI or function that produced the error or warning. The default is an empty string.
Element Range defines the absolute value of the range of the integer coefficients this VI uses to define the model. The default is 10.
Poles determines the number and location in the complex plane of randomly generated poles.
Non Random Poles specifies information about the controllability and observability of non-random poles.
Controllable and Observable Modes specifies the location of the controllable and observable poles of the system model.
Uncontrollable Modes specifies the location of the uncontrollable poles of the system model.
Unobservable Modes specifies the location of the unobservable poles of the system model.
Uncontrollable and Unobservable Modes specifies the location of uncontrollable and unobservable poles of the system model.
Random Real specifies the location of the stable, unstable, and marginally stable random real poles.
Real Stable specifies the number of stable random real poles.
Real Unstable specifies the number of unstable random real poles.
Real Marginally Stable specifies the number of marginally stable random real poles.
Random Complex Pairs specifies the location of the stable, unstable, and marginally stable random complex pair poles.
Complex Stable specifies the number of stable random complex pair poles.
Complex Unstable specifies the number of unstable random complex pair poles.
Complex Marginally Stable specifies the number of marginally stable random complex pair poles.
Random Model is the random model that this VI creates. To access and modify the data in the model, use the Model Information VIs.
Minimum Realization? indicates if the random model is a minimum realization. The model must be controllable and observable to be a minimum realization.
error out contains error information. If error in indicates that an error occurred before this VI or function ran, error out contains the same error information. Otherwise, it describes the error status that this VI or function produces. Right-click the error out front panel indicator and select Explain Error from the shortcut menu for more information about the error.
status is TRUE (X) if an error occurred or FALSE (checkmark) to indicate a warning or that no error occurred.
code is the error or warning code. If status is TRUE, code is a nonzero error code. If status is FALSE, code is 0 or a warning code.
source describes the origin of the error or warning and is, in most cases, the name of the VI or function that produced the error or warning.

CD Construct Random Model (Transfer Function)

Zeros determines the number and location in the complex plane of randomly generated zeros.
Random Number of Zeros? determines if this VI generates the number and location of the zeros randomly. If Random Number of Zeros? is TRUE, the random system is strictly proper.
Non Random Zeros determines the location of non-random zeros.
Random Real specifies the location of the minimum phase, non-minimum phase, and marginally minimum phase random real zeros.
Real Minimum Phase specifies the number of minimum phase random real zeros.
Real Non Minimum Phase specifies the number of non-minimum phase random real zeros.
Real Marginally Minimum Phase specifies the number of marginally minimum phase random real zeros.
Random Complex Pairs specifies the location of the minimum phase, non-minimum phase, and marginally minimum phase random complex pair zeros.
Complex Minimum Phase specifies the number of minimum phase random complex pair zeros.
Complex Non Minimum Phase specifies the number of non-minimum phase random complex pair zeros.
Complex Marginally Minimum Phase specifies the number of marginally minimum phase random complex pair zeros.
Sampling Time (s) defines whether the model represents a continuous-time system or a discrete-time system. If the model represents a continuous-time system, Sampling Time (s) must equal zero. If the model represents a discrete-time system, Sampling Time (s) must be greater than zero and equal to the sampling rate, in seconds, of the discrete system. The default is 0.
Note  If you use the inputs to create a continuous-time system, setting the Sampling Time (s) to a value greater than zero does not yield the discrete-time equivalent of the system. You must use the CD Convert Continuous to Discrete VI to convert the continuous-time system to the discrete-time equivalent of the system.
Number of Inputs specifies the number of inputs for the random system this VI creates. The default is 1.
Number of Outputs specifies the number of outputs for the random system this VI creates. The default is 1.
System Order specifies the number of poles for each element of the transfer function or zero-pole-gain system this VI uses for the random model generation. The default is 2. LabVIEW does not use this input if you wire values to the Poles input. By default, the poles System Order specifies are stable.
error in describes error conditions that occur before this VI or function runs. The default is no error. If an error occurred before this VI or function runs, the VI or function passes the error in value to error out. This VI or function runs normally only if no error occurred before this VI or function runs. If an error occurs while this VI or function runs, it runs normally and sets its own error status in error out. Use the Simple Error Handler or General Error Handler VIs to display the description of the error code. Use exception control to treat what is normally an error as no error or to treat a warning as an error. Use error in and error out to check errors and to specify execution order by wiring error out from one node to error in of the next node.
status is TRUE (X) if an error occurred before this VI or function ran or FALSE (checkmark) to indicate a warning or that no error occurred before this VI or function ran. The default is FALSE.
code is the error or warning code. The default is 0. If status is TRUE, code is a nonzero error code. If status is FALSE, code is 0 or a warning code.
source specifies the origin of the error or warning and is, in most cases, the name of the VI or function that produced the error or warning. The default is an empty string.
Element Range defines the absolute value of the range of the integer coefficients this VI uses to define the model. The default is 10.
Poles determines the number and location in the complex plane of randomly generated poles.
Non Random Poles specifies the location of the non-random poles.
Random Real specifies the location of the stable, unstable, and marginally stable random real poles.
Real Stable specifies the number of stable random real poles.
Real Unstable specifies the number of unstable random real poles.
Real Marginally Stable specifies the number of marginally stable random real poles.
Random Complex Pairs specifies the location of the stable, unstable, and marginally stable random complex pair poles.
Complex Stable specifies the number of stable random complex pair poles.
Complex Unstable specifies the number of unstable random complex pair poles.
Complex Marginally Stable specifies the number of marginally stable random complex pair poles.
Random Model is the random model that this VI creates. To access and modify the data in the model, use the Model Information VIs.
error out contains error information. If error in indicates that an error occurred before this VI or function ran, error out contains the same error information. Otherwise, it describes the error status that this VI or function produces. Right-click the error out front panel indicator and select Explain Error from the shortcut menu for more information about the error.
status is TRUE (X) if an error occurred or FALSE (checkmark) to indicate a warning or that no error occurred.
code is the error or warning code. If status is TRUE, code is a nonzero error code. If status is FALSE, code is 0 or a warning code.
source describes the origin of the error or warning and is, in most cases, the name of the VI or function that produced the error or warning.

CD Construct Random Model (Zero-Pole-Gain)

Zeros determines the number and location in the complex plane of randomly generated zeros.
Random Number of Zeros? determines if this VI generates the number and location of the zeros randomly. If Random Number of Zeros? is TRUE, the random system is strictly proper.
Non Random Zeros determines the location of non-random zeros.
Random Real specifies the location of the minimum phase, non-minimum phase, and marginally minimum phase random real zeros.
Real Minimum Phase specifies the number of minimum phase random real zeros.
Real Non Minimum Phase specifies the number of non-minimum phase random real zeros.
Real Marginally Minimum Phase specifies the number of marginally minimum phase random real zeros.
Random Complex Pairs specifies the location of the minimum phase, non-minimum phase, and marginally minimum phase random complex pair zeros.
Complex Minimum Phase specifies the number of minimum phase random complex pair zeros.
Complex Non Minimum Phase specifies the number of non-minimum phase random complex pair zeros.
Complex Marginally Minimum Phase specifies the number of marginally minimum phase random complex pair zeros.
Sampling Time (s) defines whether the model represents a continuous-time system or a discrete-time system. If the model represents a continuous-time system, Sampling Time (s) must equal zero. If the model represents a discrete-time system, Sampling Time (s) must be greater than zero and equal to the sampling rate, in seconds, of the discrete system. The default is 0.
Note  If you use the inputs to create a continuous-time system, setting the Sampling Time (s) to a value greater than zero does not yield the discrete-time equivalent of the system. You must use the CD Convert Continuous to Discrete VI to convert the continuous-time system to the discrete-time equivalent of the system.
Number of Inputs specifies the number of inputs for the random system this VI creates. The default is 1.
Number of Outputs specifies the number of outputs for the random system this VI creates. The default is 1.
System Order specifies the number of poles for each element of the transfer function or zero-pole-gain system this VI uses for the random model generation. The default is 2. LabVIEW does not use this input if you wire values to the Poles input. By default, the poles System Order specifies are stable.
error in describes error conditions that occur before this VI or function runs. The default is no error. If an error occurred before this VI or function runs, the VI or function passes the error in value to error out. This VI or function runs normally only if no error occurred before this VI or function runs. If an error occurs while this VI or function runs, it runs normally and sets its own error status in error out. Use the Simple Error Handler or General Error Handler VIs to display the description of the error code. Use exception control to treat what is normally an error as no error or to treat a warning as an error. Use error in and error out to check errors and to specify execution order by wiring error out from one node to error in of the next node.
status is TRUE (X) if an error occurred before this VI or function ran or FALSE (checkmark) to indicate a warning or that no error occurred before this VI or function ran. The default is FALSE.
code is the error or warning code. The default is 0. If status is TRUE, code is a nonzero error code. If status is FALSE, code is 0 or a warning code.
source specifies the origin of the error or warning and is, in most cases, the name of the VI or function that produced the error or warning. The default is an empty string.
Element Range defines the absolute value of the range of the integer coefficients this VI uses to define the model. The default is 10.
Poles determines the number and location in the complex plane of randomly generated poles.
Non Random Poles specifies the location of the non-random poles.
Random Real specifies the location of the stable, unstable, and marginally stable random real poles.
Real Stable specifies the number of stable random real poles.
Real Unstable specifies the number of unstable random real poles.
Real Marginally Stable specifies the number of marginally stable random real poles.
Random Complex Pairs specifies the location of the stable, unstable, and marginally stable random complex pair poles.
Complex Stable specifies the number of stable random complex pair poles.
Complex Unstable specifies the number of unstable random complex pair poles.
Complex Marginally Stable specifies the number of marginally stable random complex pair poles.
Random Model is the random model that this VI creates. To access and modify the data in the model, use the Model Information VIs.
error out contains error information. If error in indicates that an error occurred before this VI or function ran, error out contains the same error information. Otherwise, it describes the error status that this VI or function produces. Right-click the error out front panel indicator and select Explain Error from the shortcut menu for more information about the error.
status is TRUE (X) if an error occurred or FALSE (checkmark) to indicate a warning or that no error occurred.
code is the error or warning code. If status is TRUE, code is a nonzero error code. If status is FALSE, code is 0 or a warning code.
source describes the origin of the error or warning and is, in most cases, the name of the VI or function that produced the error or warning.

CD Construct Random Model Details

This VI supports delays. To represent a delay in the model, you must specify the delay in this VI. Refer to the LabVIEW Control Design User Manual for more information about delays.

previous page start next page