VDAS Help English
VDAS Help English
Software Help
Quick Start
VDAS® software has three primary windows: the Main Window, the Data Table Window and the Chart Window.
The Main Window shows real-time data, numerically or as an analogue trace, user data entry fields and
calculated data.
The Data Table Window shows the table of recorded data for the currently selected data series. Different data
series can be used for different experiments.
The Chart Windows shows a live line chart for visualisation of the captured data. Multiple variables can be
plotted on the chart and lines of best fit calculated and shown.
To change application, select Options ► Select VDAS® Application.
Some VDAS® applications have other additional windows (e.g., Psychrometric Chart Window with the EC1550
application).
• To record a row of data, click Data ►Record data row (or press F4).
• To export the recorded data to an Excel file, click File ► Export to Excel XLSX.
• Use the check boxes next to a field to show or hide the value in the Data Table.
See illustration below:
Advanced VDAS®
The VDAS® applications supplied with the equipment are designed to enable students to follow the
experiments laid out in the equipment user guides.
However, the equipment and VDAS® are often applicable to far more complex experimentation and user
defined experiments. This enables TecQuipment products to be utilised for advanced experiments, projects
and research to post undergraduate level.
Customising Charts
See Chart Window to find out how to create and manipulate charts of data.
Specialist Features
The VDAS® windows for some equipment have specialist extra items. For information on using Psychrometric
Charts, Heisler Charts or other special buttons where they exist, please see the extra VDAS® information in
the individual user guide for the equipment concerned.
The Main Window displays the Layout of Data Groups and Data Fields associated with the Selected
VDAS®Product. For some products it may also include the Trace Window within it.
Main Window Menus and Toolbar Buttons
Toolbar Keyboard
Menu Command Button Shortcut Details
Save Ctrl+S Saves the recorded data and current form layout to a data file.
Layout ► revert
Restores the default form layout of the current application.
File layout
Layout ► open Opens a custom layout file, which describes the layout of Data
layout Groups and Data Fields.
Layout ►save
Saves a custom layout file.
layout
Layout ►assign Assigns a font to the current layout. This setting is included in
layout font a saved Layout.
Export to Excel Saves the recorded data to an Excel XLSX file, so that it can
XLSX be processed further in other software.
Start
communications Starts receiving data from the VDAS® hardware.
Connection
Stop
communications Stops receiving data from the VDAS® hardware.
Display Data Opens the Data Table Window, which displays a table of the
Table current Data Series.
Records one row of data to the current Data Series. Each row
Record data row F4
contains a data value from all of the Data Fields.
Delete
highlighted data Remove highlighted row of data from the current Data Series
row
Data
Start timed data Opens a dialogue box, which allows timed data capture to be
acquisition configured.
Maintain Data
Series ► New Starts a new Data Series.
data series
Maintain Data
Series ► Delete Deletes the current Data Series.
data series
Maintain Data
Series ►
Opens a dialogue box to rename the current Data Series.
Change data
series name
Select VDAS®
Opens the "Select TecQuipment VDAS® Application" window.
application
About
Opens a window that shows details about the version of
TecQuipment
software that is being used
Help Software
Status Bar
The indicators on the left hand side of the the Status Bar show the connection state to VDAS® hardware and
data sharing.
The calculator icon indicates that the Data Field currently under the cursor is a calculated field.
The label on the right hand side of the Status Bar shows how many rows have been recorded in the current
Data Series.
Communications
All new VDAS® Hardware come with a USB interface. However, the serial communication options remain
available for users with legacy hardware.
Communication configuration and connection information can be view in the Communication Settings dialog.
The status of connected VDAS® devices is shown on the lower panel of the selected tab.
Data Sharing
VDAS® e-lab is a data sharing feature built in to VDAS®. The live data from the experiment is streamed via the
cloud to students, so that they can view, capture, manipulate and analyse it remotely on their own PCs.
The live data feed from a shared experiment is a licensed feature of VDAS® (contact TecQuipment or supplier
if it is required). A license is only needed, by the tutor, for data sharing. For standalone operation a license is
not needed. Students need to install a copy of VDAS® on their PC (free download from
www.TecQuipment.com). Students do not require a license to connect to a live data stream, they just log on.
The Tutor and Students need to configure their copies of VDAS® to share data.
2. Select the
7. The experiment data is now being shared. The details of the experiment name and the experiment
operator’s name are broadcast to the remote participants.
8. When a student connects to the shared experiment data their details will be listed. Each student can
independently view, record and analyse their copy of the live data.
Student Data Sharing Communication Settings
1. Select Connection ► Communication Settings, the Communication Settings dialog appears.
2. Select the Remote Participant tab and select 'Connect to a shared experiment'.
6. Once correctly connected the status box will contain a tick. Details of the shared experiment will be shown
in the lower status panel.
Data Groups and Fields
There is a specific VDAS® application for each piece of VDAS® equipment. Each application has a default
layout of controls.
The Data Group Expand button above displays all the variables within the data group.
The Data Group Collapse button above reduces a data group box to display its title only. Useful when
information on screen is becoming cluttered or at a premium.
A Data Group with the Caption 'User Defined' will appear. It will contain one new Data Field also captioned
'User Defined'.
To Customise a Data Group
1. Right-click at the top of the Data Group to open the Data Group context menu.
A 'Customise Properties' dialogue box will appear. It allows the Caption (title) of the Data Group to be changed
and it’s expanded or collapsed state.
Data Fields
A Data Field displays a single data value and represents one column in the Data Table. The source for any
given Data Field can be from a sensor input, user input or calculation.
• A numeric field displays numbers either from a sensor input, a user input, or a calculation. Any
numeric field can be used in a calculation for another field. (Circular references in calculations are
prohibited).
• A text field allows a short piece of text to be entered or selected from a drop-down list.
It is possible to resize the text boxes within each Data Field (in case of large numbers), by clicking and dragging
on the left-hand edge of the text box.
2. Select the 'Customise field' menu item. A dialogue box will appear to allow customisation of the properties
of the Data Field. These properties are described in the following sections.
Calculation
A Numeric User Input can be converted into a Calculated field by assigning a Calculation Definition. The result
of the calculation is updated whenever the inputs to the calculation are updated.
1. Click on the Calculation Definition box, it will become highlighted and a browse button (...) will appear to
the right. Click on the browse button to open the Equation Designer dialogue.
2. Complex equations can be created using the Equation Designer as described in the section on Building
Equations
The equation will now appear in the Calculation Definition text box of the Customise Properties Dialogue Box.
Data Logging
The "Export this field" property controls whether a Data Field is included in the Data Table and therefore
whether it is exported.
Data Presentation
The "Decimal Places" property sets the number of decimal places a numeric value is displayed to.
The "Maximum" and "Minimum" properties set the range of the Data Field numeric value. This property affects
the Numeric User Input Field and the display range of the Dial Meter, Bar Meter and Time Plot. It does not limit
the range of Sensor Input or Calculated fields.
Presentation
The ‘Caption’ and ‘Units’ text can be set by modifying these text boxes, Simple HTML (Hyper Text Markup
Language) may be used to format the displayed text.
Sample
Big font size <big></big> This is <big>big</big> text. This is big text.
Small font This is small text.
<small></small> This is <small>small</small> text.
size
Building Equations
The Equation Designer dialogue allows complex equations to be defined, which use other Data Fields as input
variables. Mathematical operators and functions can also be inserted into the equation.
Data Field Variables
Before a Data Field can be used as an input to an equation, it must be assigned a Variable letter. The list of
Variables for use in the equation is listed in the right-hand panel.
• To add and remove variables from the list select an item and click the add >> or remove << buttons
or double click on the item.
Equations
Equations are entered into the edit box. The equation uses normal mathematical rules. Variables must be
entered as upper case. Mathematical functions must be entered as lower case.
• Double click on a Data Filed in the right-hand list to insert the variable into the equation.
• Right click in the edit box and use the context menu to insert functions and operators.
Addition +
Subtraction -
Multiplication *
Division /
Power ^
Parentheses ()
Mathematical Constants
ϖ pi
Mathematical Functions
Logarithm log(X)
Exponential exp(X)
Sine sin(X)
Cosine cos(X)
Tangent tan(X)
Equation Validation
Below the Equation text box is a label which displays the state of the equation. This updates in real-time as the
equation is being entered, with helpful validation and error information.
Zero Offset
For some pre-defined data fields (with calculations) and any of the user defined Data Fields that have
calculations, the Data Field value can be offset to zero. This is like the "Tare" function found on most weighing
scales. This feature is useful for data that has a bias or constant error that does not need to be monitored.
• A zero offset can only be set when the VDAS® software is receiving data.
Right click on the Data Field to access the content menu to change the presentation.
A Dial Meter a Bar Meter or a Time Plot can also be shown with the normal or Large Display.
The minimum and maximum values of the Dial Meter, the Bar Meter and the Time Plot are specified by the
Data Presentation Minimum and Maximum Field Properties. See To Customise a Data Field.
Data Grid
If the TecQuipment product uses an instrument with a high number of sensor inputs, the VDAS® layout may
display the readings in a Data Grid. Just as with Data Fields, readings from the Data Grid can be included in
the Data Table and exported using the check box at its top right corner.
It is not possible for the user to add a Data Grid in their custom layouts.
Data Grid and Bar Chart
The live Data Grid values can be shown as a Bar Chart. Right click on the Data Grid and use the context menu
to show or hide the Bar Chart. The vertical scale of the Bar Chart is specified by the Data Presentation
Minimum and Maximum Field Properties. See To Customise a Data Field.
Only the Analogue Input Voltage connections can be displayed in the Trace
window.
The Trace Window plots the amplitude (Y axis) against time or angle (X axis). The amplitude is scaled to the
appropriate units for the experiment e.g. displacement as mm. Pairs of X and Y cursors can be positioned to
enable accurate measurements.
In some applications the x-axis span is too large to show in the Trace Window. In this case a horizontal scroll
bar will be visible to scroll along the x-axis.
Trace Toolbar
X axis Mouse
Position Displays the X axis value of the mouse.
Indicator
Trace Control Panel
Trace
Use to select a different name or colour for the trace.
Properties
Trace Enable / Use to control whether the trace appears in the Trace
Disable Window.
Units per Selects the units for each vertical division of the Trace
Division Window.
Reset
Resets the reference trace.
Reference
Y Axis Mouse
Displays the Y axis value at the point where the Only visible when there is a
Position
mouse vertical crosshair intersects the trace. trace.
Indicator
Cursors
The VDAS® Trace Window also contains Cursors, which can be used to accurately measure the difference
between two points in both the X and Y axis.
• Click and drag the cursor handles at the edge of the Trace Window to show and position the cursors.
• The differential Cursor values are displayed in the Trace Window Toolbar.
Some VDAS® applications may also include Data Fields based Cursor values.
If the timebase is greater than 5µs, the software uses decimation to reduce the effective sample rate. It also
uses digital low pass filters to prevent aliasing distortion. Therefore, higher frequency components of the
original signal may become attenuated.
Y Axis Scale
The user can manually select the Y axis Units per Division value or use the Autoscale button to automatically
fit the trace within the Trace window.
Y Axis Offset
Click and drag up or down on the zero-value label of a trace to apply an offset to the Y position of the trace on
the display.
Reference, Smoothed and Derived Traces
• A reference trace is an exact 'snapshot' copy of the trace it is based on. It will remain in position until
updated when it will make a new copy of the trace.
• A smoothed trace is a live copy of a base trace with an additional filter applied.
• A derived trace is a live mathematical derivation of the trace it is based on. A first derivative or a
second derivative can be selected. For example, the first derivative of a displacement trace is a
velocity trace, the second is an acceleration trace. A filter can also be applied to these traces.
To see the smoothed and derived traces more clearly, use the Trace Enable / Disable button to hide the Trace
that they are based on.
Filter
VDAS® uses a Savitzky-Golay digital filter to calculate estimates of the smoothed and derivative traces. The
filter coefficients are convolved with the input signal to produce the output trace data. The greater the number
of filter coefficients (the filter width) then the greater the level of smoothing. However, too much filtering will
reduce the amplitude and shape of the trace. Use just enough filtering to reduce any distortion on the trace
without affecting its amplitude or shape.
The filter is only available for the smoothed and derived traces.
Damping Models
Underdamped and overdamped models can be fitted to captured traces. Application of the use of damping
models is specific to certain VDAS® application and more information will be found in the associated User
Guide.
1. Make sure that the natural frequency of the waveform has been measured and entered.
2. Click on the Trace Toolbar Damping Model Button and select Fit Underdamped Model. A Viscous
Underdamped Model Fitting Dialogue Box will appear.
A model will be fitted to the trace. A tick symbol will appear if the software believes it has found a best fit
solution. As a double-check, the R2 value should be around 1.0. Some Data Fields may also be updated based
on the model fitting results. If the software cannot find a solution, try a different part of the waveform, or capture
a fresh trace.
The start of the curve and equilibrium state should be visible in the Trace Window. The model fitting tool only
works on the part of the waveform that can be seen. Adjust the Timebase and scroll the window as required.
1. Make sure that the natural frequency of the undamped waveform has already been measured and
entered.
2. Click on the Trace Toolbar Damping Model Button and select Fit Overdamped Model. A Viscous
Underdamped Model Fitting Dialogue Box will appear.
In the Data Table an additional column will appear on the right hand side for each visible trace. For each
recorded row of data with a trace a View button is available. Clicking the view button for the trace shows a plot
the recorded trace.
• Copy complete analogue trace window to Clipboard (copies the traces and the toolbar).
• Save complete analogue trace window to file (saves the traces and the toolbar as a jpg, bmp or png
image).
• Save analogue traces to file (saves just the traces as a jpg, bmp or png image).
TecQuipment occasionally needs to update the default Layouts, to make improvements or to add new features.
Whilst we try our best to maintain compatibility between VDAS® versions, occasionally layouts and Data files
saved in an old version of VDAS® may not be compatible with a newer version.
Save a Layout
VDAS® communications are disabled whenever the save function is used. This is to allow the Trace data to be
captured. Customise the Layout as required
Open a Layout
When opening a layout the current selected VDAS® application must be the same as the which the custom
layout is based on.
The layout font is only used for the Data Group and Data Field Captions and text boxes. To ensure that symbol
characters are displayed correctly, the Data Field Unit font does not change. After assigning a font the custom
layout should be saved.
Data Capture
When new data is recorded it is added as a new Data Row in the current Data Series. This can then be
displayed in the Data Table or on a Chart.
A row of recorded data captures all Data Fields including ones where the
export tick is unchecked. Ticking the export tick will show the Data Field in the
Data Table and include the data in an export.
b) For “Stop After” select the maximum number of readings or duration. The capture will stop
automatically when the limit is reached.
A new Data Set is created each time the “Start Timer” button is clicked.
Existing Data Sets are not affected.
Data Table Window
The Data Table displays data from the current Data Series. Each enabled Data Field in the Main Window is
represented as a column in the Data Table. When data is recorded a new row is appended to the current Data
Series and the Data Table is updated.
Data Table Toolbar Buttons
Toolbar Buttons Command Details
Toggle shrink to fit When enabled the printed Data Table will be resized to all fit on one page.
This is enabled by default.
Page Setup Opens a dialogue box, which allows the printer paper settings to be
configured.
Print Preview Displays a preview of how the Data Table will look when printed.
Record Data Row Records a row of data to the current Data Series.
Delete Selected Row Deletes the row that is selected in the Data Table.
Rename Current Data Opens a dialogue box to rename the current Data Series
Series .
Right click over the data in a column on the Data Table window and select Show Statistics (Min, Max…) from
the context menu.
Data Series
Data is recorded in a Data Series. One or more Data Series can be used. Data is recorded to the current
selected Data Series. Each Data Series can be named.
Use the dropdown list on toolbar of the Main Window, the Data Table Window or the Chart Window to select
current Data Series.
The VDAS® Software disables its communications to the hardware when the save function is used. This allows
the VDAS® trace to be recorded.
A VDAS® Data file contains all Data Fields including ones where the export tick is unchecked. The saved data
file contains all the information required by VDAS® to restore the session, including all the data, trace data and
layout information. Once data capture is complete.
An Excel ELSX file export only contains the Data Fields marked for export.
Chart Window
The Chart window is used to create and display a Chart based on the recorded data in the Data Table. Any
numeric Data Field can be plotted (sensor input or calculated field) against time or any other Data Field. The
Chart only displays data from the current Data Series.
It is not possible to create a Chart using data from more than one Data Series simultaneously.
Print Preview Displays a preview of how the Data Table will look when printed.
Opens the 'Chart Curves' dialogue box. This allows the display
Modify curves
settings for the curves to be modified.
Scale chart to fit data Resizes the chart to fit all the available data.
Right click anywhere on the Chart to open the Chart context menu. This gives access to the following features:
• Save the chart as an image file (*.png, *.gif, *.jpg, *.tif, *.bmp).
• Show Point Values. This displays the value of the data point when the mouse cursor is hovered near
it.
• Include the x and y axis zero. This ensures that the chart origin (zero) remains visible when the chart
is resized.
To Create a Chart
1. To view data in a chart, click Data ► Display Chart .
3. Click on the 'Assign Field' button to assign a Data Field to the X-axis.
Only one Data Field can be assigned to the x-axis. However, multiple Data
Fields may be assigned to the y-axis.
5. For each Y-Axis Curve select the line Colour, Symbol, Symbol Size and Joins Points.
• From the Main Window, right click on the Data Field and from the context menu select one of the
Assign to Chart options.
• From the Data Table Window, right click on numeric data in a column and from the context menu
select one of the Assign to Chart options.
To Add a Best Fit Curve
1. On the Chart Window, click on the 'Best Fit Line' Toolbar button. A new 'Data Fitting' Dialogue Box will
appear.
2. . Use the Data Fitting Dialogue Box to select the type of line required to fit around the data and press the
'Calculate' button. A small 'Best Fit Line Properties' window will appear that shows the equation of the line,
and a Best Fit Line will appear on the chart.
3. Click on the 'Modify Curves' Toolbar button to open the 'Chart Curves' Dialogue Box. Here, it is possible
to modify the colour of the 'Best Fit Line' or view its equation.
Polynomial - Gives a curve based on the sum of several terms that contain different powers of the same
variable.
Asymptote - A line that continually approaches a given curve but does not meet it at a finite distance.
Chart Zoom
• Select the chart zoom mode from the toolbar .
The line's equation will appear in the chart key and is calculated using the x axis and the left y axis. The
equation is updated as line is moved.
Only one line can be drawn on the chart at a time. Drawing a new line deletes the previously drawn line.
If the chart is closed or the data assigned to the x axis is changed, the line will be deleted.
Options
Select VDAS® Application
There is a specific VDAS® application for each piece of VDAS® equipment.
• To Click Options ► Select VDAS® Application and select the required application.
VDAS® will remember the last Layout used and re-load this the next time it opens.
Preferences
The Options ► Preferences menu allows the configuration of user and computer level settings.
Directories
The Directories tab allows the user to change the default directories used for Saved Data and Layout files. This
affects which directory the Save, Export and Open dialog boxes start in. These settings are unique to each
Windows user. These preferences can be reset to the user's Documents directory by right clicking on the text
box and pressing Reset.
If the chosen directory cannot be found, the File Browser will default to the user's Documents directory.
Help Files
The default VDAS® Help Files are in English. If a user creates their own translation of the Help Files (supplied
in pdf format). They can specify their own file in the ‘Help File’ dialogue box.
It is also necessary to specify the help reader application by navigating to the preferred pdf file viewer in the
The parameters needs to be specified so that the VDAS® Help opens in the correct place when F1 is pressed.
These are defined by selection from a drop down list:
If using a viewer as an application, select ‘View Type (e.g. Acrobat, Foxit)’. If using a Browser as an application,
select ‘Browser Type (e.g. chrome, Edge, Firefox, Opera)’. When selecting either of these options the
parameters are automatically assigned.
If using a different type of application select ‘Custom’. It will then be necessary to enter the parameters
manually.