Manual

Input		Can be wired to any input or output node. There is no explicit limit to the number of inputs that can be connected together. If multiple input nodes are wired together, but without an output node, a warning is displayed and those wires are ignored. To change the value of an unwired input node, place cursor over node and double-click. Alternatively, the value can be changed by placing cursor anywhere in block, right clicking to display a pop-up menu, and selecting "Properties." The value of a wired input node cannot be changed, but it can be viewed with same procedures as above.
Output		Can be wired to any input node. Two output nodes cannot be wired together. The value of an output node cannot be changed. To view the value of an output node, place cursor over node and double-click. Alternatively, the value can be viewed by placing cursor anywhere in block, right clicking to display a pop-up menu, and selecting "Properties."
No-connection		Set values that are fixed at the time the model is compiled. To change, stop model and place cursor over node and double-click. Alternatively, the value can be changed by placing cursor anywhere in block, right clicking to display a pop-up menu, and selecting "Properties." Changing the value of a No-connection node will force a recompile to continue model execution.
Documentation		Store information about the use of the block for reference.

Node Types

double	Most Visual ModelQ nodes are of type double.
Boolean	Some Visual ModelQ nodes are Boolean. When viewing or changing values, these nodes show as "True" or "False." For the case where these nodes are input nodes, and so can be wired to non-Boolean nodes, any value less than 0.5 is translated as False while all other values are translated as True.
String	Some Visual ModelQ nodes are strings. When viewing or changing values, these nodes show as one of a list of strings. When these nodes are transmitted on wires (wires carry only double) the value of the node is translated as the integer value of the string’s placement in the string list. Actually, Boolean is a string variable where the string list consists of "True" and "False."
Documentation	Documentation nodes accept strings with no specific length limit.

Instruments Tab

Oscilloscope

Graphic
Function	Provide 8-channel oscilloscope display.
Tab	Instruments
Special behavior.	After compile, oscilloscope display window is hidden. Double click on the Oscilloscope block to view the display window. All default settings can be changed using controls in the display. However, recompilation will restore the default values.
Requirements	At least one oscilloscope is required in every model. There is no explicit limit on the number of oscilloscopes one model can have.

Node List	1	Time/Div Select default Time/Division.
	2	Trigger Source Select variable to be used for default trigger channel
	3	Trigger Level Select default trigger level.
	4	Positive Trig? Select default trigger slope (positive or negative).
	5	Trigger Position Select default trigger position in percent of screen size.
	6	Trigger Mode Select default trigger position from Auto, Normal, and Cont. With Normal, scope triggers only after trigger channel meets trigger criterion. With Auto, trigger will automatically trigger after two screens full of data pass without a trigger. With Cont (continuous), the scope runs continuously.
	7	AC Trigger Select default value of AC Trigger. If true, Trigger Source is passed through a high-pass filter to remove DC component. Approximately 3 screens of data must pass for the filter to settle out (Boolean).
	8	Roll? Select default value of Roll. If true, display rolls across screen.
	9	Single Shot Select default value of Single Shot. If true, model stops executing after screen fills. Restart execution by clicking the Run button.
	10	x vs y? Select default value of x-vs-y. If true, display shows all channels versus the variable specified in H-Channel.
	11	H-Channel Select default horizontal channel. See x vs y (node 10).
	12	Documentation node
See also: Live Scope, Two-Channel Live Scope

Dynamic Signal Analyzer (DSA)

Graphic
Function	Provide Frequency-Response Function (FRF) or Bode plot of system. Provides temporary excitation signal.
Tab	Instruments
Special behavior.	After compile, DSA display window is hidden. Double click on the DSA block to view the display window. All default settings can be changed using controls in the display. However, recompilation will restore the default values.
Requirements	If a DSA is present, at least two variables must be present in model. There is no specific limit on the number of DSAs than can be present.

Node List	1	Switched Input Input signal, which is normally passed through DSA to Output. However, when DSA excitation is active, switched input is disconnected from Output.
	2	Unswitched Input Input signal, which is passed through DSA to Output, whether or not DSA excitation signal is active. Should only be used for DC signals, or DSA analysis will be corrupted.
	3	Excitation Output of DSA. If DSA excitation is inactive, equal to sum of Switched Input and Unswitched Input. I If DSA excitation is active, equal to sum of Switched Input and Excitation.
	4	DSA Inactive True (1) when DSA excitation is inactive; False (0) when active. Can be used to disable any waveform generators that are not connected to the switched input (these generators are effectively disconnected automatically so there is no need to disable them) (Boolean).
	5	Excitation Amplitude Amplitude of excitation output. If excitation amplitude is too small, signal-to-noise ration will be too large, corrupting the DSA output; if it is too large, it will drive system into saturation, also corrupting the DSA output. If DSA output is noisy in appearance, experiment with this value.
	6	Input Channel Select default Input channel for DSA.
	7	Output Channel Select default Output channel for DSA.
	8	TSample Select default value of sample time for DSA. Normally should be equal to sample time of digital controller, if one is used.
	9	Start Zero Time Select default value of start zero time. Start zero time gives the system time to settle out after DSA becomes active. System must be fully settled before excitation starts, or DSA output will be corrupted. If DSA output is noisy in appearance, experiment with this value.
	10	End Zero Time Select default value of end zero time. End zero time gives the system time to settle out after DSA becomes inactive. System must be fully settled before data-gathering concludes, or DSA output will be corrupted. If DSA output is noisy in appearance, experiment with this value.
	11	Order Select default DSA order. When DSA collects data, 2^Order points are stored for each channel. Larger order allows the DSA to measure lower frequencies. Larger order also allows longer End Zero Time values.
	12	Auto Frequency Default value of Auto Frequency span. If true, frequency span is automatically set at compile time based on Order and TSample. If false, Minimum Frequency (node 13) and Maximum Frequency (node 14) are used to set frequency span.
	13	Minimum Frequency Default minimum of frequency span if Auto Frequency (node 12) is false; ignored otherwise.
	14	Maximum Frequency Default maximum of frequency span if Auto Frequency (node 12) is false; ignored otherwise.
	15	Gain Scale Default gain scale of DSA output.
	16	Gain Offset Default gain offset of DSA output.
	17	Phase Scale Default phase scale of DSA output.
	18	Phase Offset Default phase offset of DSA output.
	19	Button Setup Set up as many as 10 buttons, which automatically load input and output channels when clicked. Simplifies ability to view many FRFs (Bode plots).
	20	Documentation node
See also: Variable, Live Scope, Two-Channel Live Scope, Oscilloscope

Variable

Graphic
Function	Non-display data channel for Oscilloscopes and DSAs.
Tab	Instruments

Node List	1	Input Input value in model units
	2	Scale Set default scale of variable on Oscilloscope.
	3	Offset Set default offset of variable on Oscilloscope.
	4	Show Set default of whether variable displays on Oscilloscope. If more than 8 variables default to Show = true, all variables after the either default to not showing (Boolean).
	5	AC Couple Set default AC Coupling of variable on Oscilloscope (Boolean).
	6	Mult Convert model units to user units. This allows the model to execute in SI units with data display convenient units.
	7	Documentation node
See also: Live Scope, Two-Channel Live Oscilloscope, DSA

Live Scope

Model graphic (during model execution)
Select Graphic
Function	Displaying data on model screen; also provide data channel for Oscilloscopes and DSAs.
Tab	Instruments
Special behavior.	The Live Scope creates a variable of the same name as the block name that can be displayed on the Oscilloscope or measured with a DSA. After compile, double click on the Live Scope block to view the control panel. The control panel simplifies adjustment of standard scope variables such as scale, offset, and trigger settings. Single-shot operation is supported through the S-Shot checkbox. Single-shot causes the model to stop running after the scope screen fills; if you select “Must click OK” you must acknowledge the S-Shot announcement window; otherwise, the window will go out of view after 10 seconds. Click the Run button to continue model execution. Supports Hot Connect, which allows temporary connection Input to any node or wire while the model is running, and without forcing a recompile. All scope settings are restored to pre-hot connection values when normal (non-Hot- Connect) operation is restored. Supports Autoscale, where the scale is set to ±X where X is large enough to show all points of display. Supports Fill Screen, where the scale is set to just show the waveform minimum and maximum values. Supports copying scope display to a bitmap file. You can copy the complete scope display ("Copy Image") or just the plot ("Copy Graph"). If you click the escape key mid sequence, the bitmap is copied to the clipboard where it can be pasted to other applications, for example Microsoft Word documents.	Live Scope Control Panel
See also: Variable, Two-Channel Live Scope, Oscilloscope

Node List	1	Input Input value in model units
	2	Scale Set scale.
	3	Offset Set offset.
	4	AC Couple Set AC Coupling of variable (Boolean). .
	5	Mult Convert model units to user units. This allows the model to execute in SI units with data display convenient units.
	6	Time/Div Select Time/Division
	7	Show Set default of whether variable displays on Oscilloscopes. If more than 8 variables default to Show = true, all variables after the either default to not showing (Boolean).
	8	Ext External input (can be used to trigger the scope).
	9	Ext Mult Multiplier for external input
	10	Trigger Channel Select trigger channel, either External Input or Input (Node 1). Two- and Four-Channel scopes allow any available channel to be used to trigger the scope.
	11	Trigger Level Select trigger level. Note that the trigger level is not scaled by Mult.
	12	Positive Trig? Select trigger slope (positive or negative).
	13	Trigger Position Select trigger position in percent of screen size.
	14	Trigger Mode Select trigger position from Auto, Normal, and Continuous. With Normal, scope triggers only after trigger channel meets trigger criterion. With Auto, trigger will automatically trigger after two screens full of data pass without a trigger. With Continuous, the scope displays data continuously. Note: using Continuous with a small time step can significantly slow model operation.
	15	AC Trigger Select AC Trigger. If true, trigger source (node 1) is passed through a high-pass filter to remove DC component. Approximately 3 screens of data must pass for the filter to settle out (Boolean).
	16	Single Shot Select Single Shot mode, either 0 (off), 1 (on, don’t require user to click OK) or 2 (on, require user to click OK).
	17	Height Select height of Live Scope display in pixels.
	18	Width Select width of Live Scope display in pixels.
	19	Documentation node
See also: Variable, Two-Channel Live Scope, Oscilloscope

Two-Channel Live Scope

Model graphic (during model execution)
Select Graphic
Function	Displaying two channels of data on model screen; also provide one data channel (Channel 1 only) for Oscilloscopes and DSAs.
Tab	Instruments
Special behavior.	The Two-Channel Live Scope creates a variable of the same name as the block name that can be displayed on the Oscilloscope or measured with a DSA. Channel 1 is used for data for the variable. See Live Scope for more details.	Two-Channel Live Scope Control Panel
See also: Variable, Live Scope

Node List	In addition to the Nodes for the Live Scope , the Two-channel Live Scope provides the following five nodes on the right side of the block.
	20	Input2 Input value for Channel 2 (red) in model units
	21	Scale2 Set scale for Channel 2.
	22	Offset2 Set offset for Channel 2.
	23	AC Couple2 Set AC Coupling of Channel 2 (Boolean).
	24	Mult2 Convert model units to user units for Channel 2. This allows the model to execute in SI units with data display convenient units.
See also: Variable, Live Scope, Oscillocope

Four-Channel Live Scope

Model graphic (during model execution)	Four-Channel Scope with Scales turned off using Control Panel (shown below)
Select Graphic
Function	Displaying four channels of data on model screen; also provide one data channel (Channel 1 only) for Oscilloscopes and DSAs.
Tab	Instruments
Special behavior.	The Four-Channel Live Scope creates a variable of the same name as the block name that can be displayed on the Oscilloscope or measured with a DSA. Channel 1 is used for data for the variable. See Live Scope for more details.	Four-Channel Live Scope Control Panel
See also: Variable, Live Scope

Node List	In addition to the Nodes for the Two-Channel Live Scope, the Four-Channel Live Scope provides the following ten nodes bottom of the block, where Channel 3 parameters are below Channel 1 parameters on the left and Channel 4 parameters are below Channel 2 parameters on the right.
	25	Input3 Input value for Channel 2 (black) in model units
	26	Scale3 Set scale for Channel 3.
	27	Offset3 Set offset for Channel 3.
	28	AC Couple3 Set AC Coupling of Channel 3 (Boolean).
	29	Mult3 Convert model units to user units for Channel 3. This allows the model to execute in SI units with data display convenient units.
	30	Input4 Input value for Channel 4 (green) in model units
	31	Scale4 Set scale for Channel 4.
	32	Offset4 Set offset for Channel 4.
	33	AC Couple4 Set AC Coupling of Channel 4 (Boolean).
	34	Mult4 Convert model units to user units for Channel 4. This allows the model to execute in SI units with data display convenient units.
See also: Variable, Live Scope, Two-Channel Live Scope, Oscillocope

Waveform Generator

Graphic
Function	Provide constant numerous waveforms with control of frequency, amplitude, offset, and other waveform parameters.
Tab	Instruments
Special behavior	After compile, double click on the Waveform Generator block to view the Waveform Generator control panel. Control panel allows easy adjustment of parameters such as waveform type, frequency, and amplitude while model is running.

Node List	1	Output Output in model units
	2	Waveform Select default waveform from one of: Sine Triangle Sawtooth Pulse Bi-polar Pulse Trapezoid S-Curve DC (None)
	3	Frequency Set default frequency of waveform in Hz.
	4	Amplitude Set default peak-to-peak (Sine, Triangle, Sawtooth, Pulse, Bi-polar Pulse) or peak (Trapezoid, S-Curve) amplitude in user units.
	5	Offset Set default center (Sine, Triangle, Sawtooth, Pulse, Bi-polar Pulse) or low level (Trapezoid, S-Curve) of waveform in user units.
	6	Phase Set default phase (time offset) of waveform in degrees.
	7	Duty Cycle Set default duty cycle in percent for Pulse, Bi-polar Pulse, Trapezoid, and S-Curve waveforms.
	8	Mult Convert user units to model units. This allows convenient data entry while allowing the model to execute in SI units.
	9	Enable When false, output is 0. If true, waveform generator operates as normal (Boolean).
	10	Documentation node

Data Logger

Graphic
Function	Log 16 channels of data to a file in CSV (comma separated variable) format.
Tab	Instruments

Node List	1-16	Channel1-Channel16 Data to be logged.
	17	Enable Store data if Enable = 1
	18	Reset Clear data in file when Reset = 1.
	19	File Write Interval Specifies how many samples of data are collected before data is written. Defaults to 10.
	20	Ask before overwrite If set to 1, ask user before overwriting the data file.
	21-52	Name1-Name16 and Multipiler1 – Multiplier 16 (in pairs) Specify name under which channel data will be stored; names are written in the first line of the data file. Multiplier allows storage of data in user units. Multipliers are written in second line of data file.
	53	Controller Select a digital controller. Note that if only one digital controller is used in the model, Visual ModelQ automatically selects that controller for this node. Data logger saves data on each cycle of controller except the following conditions: t = 0 Enable = 0 Reset = 1
	54	Mult Convert user units to model units. This allows convenient data entry while allowing the model to execute in SI units.
	55	Documentation node

Constants Tab

Simple Constant

Model graphic
Select graphic
Function	Provide constant input with on-screen display. Value can be changed at any time by double clicking on the input node (left on icon).
Tab	Constants

Node List	1	Input Input value to constant in user units
	2	Mult Convert user units to model units. This allows convenient data entry while allowing the model to execute in SI units (recommended).
	3	Output Output in model units
	4	Documentation node Contents of documentation node are displayed for the user when the help button on the Adjustor box is clicked.
See also: Live Constant, Scale-by Constant, Inspector

Live Constant

Model graphic
Select graphic
Function	Provide constant input with on-screen display. Value can be changed at any time by double clicking on the block after compile, which brings an adjustor box into view. Output is scaled from user units by Mult (node 4).
Tab	Constants
Special behavior.	After compile, double click on the Live Constant block to view the adjustor box. Adjustor box simplifies adjustment of constants through use of six logarithmic adjustments. For example, "<<" reduces the value by approximately 50% to an even value of 1, 2, or 5 x 10^N. Value is copied into InitValue (node 1) after clicking "Save value as initial value " button immediately right of value. Value is restored to InitValue after each compile. Text color in edit box changes to red when keystrokes are entered. This indicates that the value in the model block is not equal to the value in the edit box. Actions that store the value (for example, striking the enter key) load the value and change the text back to the standard color.	Adjustor Box Model block, value and initial value (above) equal and (below) unequal.

Node List	1	InitValue Initial value of constant in user units.
	2	Minimum Minimum user can set input value to.
	3	Maximum Maximum user can set input value to.
	4	Mult Convert user units to model units. This allows convenient data entry while allowing the model to execute in SI units (recommended).
	5	Output Output in model units.
	6	Documentation node Contents of documentation node are displayed for the user when the help button on the Adjustor box is clicked.
See also: Simple Constant, Scale-by Constant, String Constant

Inverse Live Constant

Model graphic
Select graphic
Function	Provide inverted constant input with on-screen display (if value is zero, output is zero). Value can be changed at any time by double clicking on the block after compile, which brings an adjustor box into view. Output is scaled from user units by Mult (node 4), and then inverted.
Tab	Constants
Special behavior.	After compile, double click on the Live Constant block to view the adjustor box. Adjustor box simplifies adjustment of constants through use of six logarithmic adjustments. For example, "<<" reduces the value by approximately 50% to an even value of 1, 2, or 5 x 10^N. Value is copied into InitValue (node 1) after clicking "Save value as initial value " button immediately right of value. Value is restored to InitValue after each compile. After model is compiled, model block is painted white when the value is equal to the initial value and silver when not equal. Text color in edit box changes to red when keystrokes are entered. This indicates that the value in the model block is not equal to the value in the edit box. Actions that store the value (for example, striking the enter key) load the value and change the text back to the standard color.	Adjustor Box Model block, value and initial value (above) equal and (below) unequal.
Requirements	None

Node List	1	InitValue Initial value of constant in user units.
	2	Minimum Minimum user can set input value to.
	3	Maximum Maximum user can set input value to.
	4	Mult Convert constant from user units to model units and then invert (1/x). This allows convenient data entry while allowing the model to execute in SI units (recommended).
	5	Output Output in model units
	6	Documentation node Contents of documentation node are displayed for the user when the help button on the Adjustor box is clicked.
See also: Live Constant, Scale-by Inverse Live Constant

Scale-by Simple Constant

Model graphic
Select graphic
Function	Provide constant input with on-screen display. Value can be changed at any time by double clicking on the scale node (top left).
Tab	Constants

Node List	1	Input Input value to be scaled
	2	Scale Scale to be applied to input.
	3	Mult Convert user units to model units. This allows convenient data entry while allowing the model to execute in SI units (recommended).
	4	Output Output in model units
	5	Documentation node Contents of documentation node are displayed for the user when the help button on the Adjustor box is clicked.
See also: Simple Constant, Scale-by Live Constant

Scale-by Live Constant

Model graphic
Select graphic
Tab	Constants
Function	Provide scaling constant with on-screen display. Value can be changed at any time by double clicking on the block after compile, which brings an adjustor box into view. Output is scaled from user units by Mult (node 5).
Special behavior.	After compile, double click on the Live Constant block to view the adjustor box. Adjustor box simplifies adjustment of constants through use of six logarithmic adjustments. For example, "<<" reduces the value by approximately 50% to an even value of 1, 2, or 5 x 10^N. Value is copied into InitValue (node 2) after clicking "Save value as initial value " button immediately right of value. Value is restored to InitValue after each compile. After model is compiled, model block is painted white when the value is equal to the initial value and silver when not equal. Text color in edit box changes to red when keystrokes are entered. This indicates that the value in the model block is not equal to the value in the edit box. Actions that store the value (for example, striking the enter key) load the value and change the text back to the standard color.	Adjustor Box Model block, value and initial value (above) equal and (below) unequal.
Requirements	None

Node List	1	Input Input value, which is scaled by the inverse of the constant (1/x) and then scaled by Mult to convert from user units to model units.
	2	InitValue Initial value of constant in user units
	3	Minimum Minimum user can set input value to.
	4	Maximum Maximum user can set input value to.
	5	Mult Convert user units to model units. This allows convenient data entry while allowing the model to execute in SI units (recommended).
	6	Output Output in model units
	7	Documentation node Contents of documentation node are displayed for the user when the help button on the Adjustor box is clicked.
See also: Live Constant, Scale-by Inverse Live Constant

Scale-by Inverse Live Constant

Model graphic
Select graphic
Tab	Constants
Function	Provide scaling inverse constant with on-screen display (if value is zero, output is zero). Value can be changed at any time by double clicking on the block after compile, which brings an adjustor box into view. Output is scaled from user units to model units by Mult (node 5) and then inverted.
Special behavior.	After compile, double click on the Live Constant block to view the adjustor box. Adjustor box simplifies adjustment of constants through use of six logarithmic adjustments. For example, "<<" reduces the value by approximately 50% to an even value of 1, 2, or 5 x 10^N. Value is copied into InitValue (node 2) after clicking "Save value as initial value " button immediately right of value. Value is restored to InitValue after each compile. After model is compiled, model block is painted white when the value is equal to the initial value and silver when not equal. Text color in edit box changes to red when keystrokes are entered. This indicates that the value in the model block is not equal to the value in the edit box. Actions that store the value (for example, striking the enter key) load the value and change the text back to the standard color.	Adjustor Box Model block, value and initial value (above) equal and (below) unequal.
Requirements	None

Node List	1	Input Input value, which is scaled by the inverse of the constant (1/x) and then scaled by Mult to convert from user units to model units.
	2	InitValue Initial value of constant in user units
	3	Minimum Minimum user can set input value to.
	4	Maximum Maximum user can set input value to.
	5	Mult Convert user units to model units. This allows convenient data entry while allowing the model to execute in SI units (recommended).
	6	Output Output in model units
	7	Documentation node Contents of documentation node are displayed for the user when the help button on the Adjustor box is clicked.
See also: Inverse Live Constant, Scale-by Live Constant

String Live Constant

Model graphic
Select graphic
Tab	Constants
Function	Provide selection from user-defined list of strings. String can be changed at any time by double clicking on the block after compile, which brings a string adjustor box into view.
Special behavior.	After compile, double click on the Live Constant block to view the string adjustor box. Adjustor provides list box to allow string selection. Value is copied into InitValue (node 2) after clicking "Save value as initial value" button right of "OK" button. String is restored to InitValue (node 2) after each compile. After model is compiled, model block is painted white when the value is equal to the initial value and silver when not equal.	String Adjustor Box Model block, value and initial value (above) equal and (below) unequal.
Requirements	None

Node List

Strings
String list from which one string can be chosen.

Hint: for boolean output, make string list False, True. This will output 0 when False is selected and 1 for True.

Visual ModelQ Reference Manual

Documentation node

Frequency Set default frequency of waveform in Hz.

Reset Clear data in file when Reset = 1.

Frequency
Set default frequency of waveform in Hz.

Reset
Clear data in file when Reset = 1.