Measurements: Difference between revisions

From LabNation Wiki
Jump to navigation Jump to search
(Created page with "Since v0.13.0.0, the SmartScope includes a more advanced Measurement subsystem. Each measurement now shows more information (min/max/mean/std), and you can even watch how thes...")
 
No edit summary
 
Line 4: Line 4:
The main GUI elements of the measurement subsystem are shown below, which will be used throughout the remainder of this page:
The main GUI elements of the measurement subsystem are shown below, which will be used throughout the remainder of this page:
<br>[[File:MCallouts.png]]
<br>[[File:MCallouts.png]]
=The Measurements menu=
The Measurements menu is used to show/hide measurements. The Measurements menu is integrated in the right part of the GUI. To open or hide the Measurements menu, hit the Ruler button at the bottom-right of the screen.
<br>Once opened, the Measurement menu shows at its top the channel, followed by the measurements which can be invoked for this channel. Cycle through the channels by tapping the '<' and '>' buttons next to the channel name.
=Measurement box=
=Measurement box=
The measurement box contains the currently active measurements. The Value column displays the value calculated on each incoming wave. This value can vary very rapidly, and therefore the Mean column was added which shows the averaged value over 1 second. Added to this are the Min and Max columns, which show the minumum and maximal value of the measurement of said 1 second period. Finally, the Std column shows the standard deviation (~noise or variation) of this value over the 1 second interval.
The measurement box contains the currently active measurements. The Value column displays the value calculated on each incoming wave. This value can vary very rapidly, and therefore the Mean column was added which shows the averaged value over 1 second. Added to this are the Min and Max columns, which show the minumum and maximal value of the measurement of said 1 second period. Finally, the Std column shows the standard deviation (~noise or variation) of this value over the 1 second interval.
<br>The measurement box can be dragged around freely over the screen.
<br>The measurement box can be dragged around freely over the screen.
==Removing the measurement box==
==Showing/hiding the measurement box==
By dragging the Measurement box out of the screen through the top or left side of the screen, it will be removed from the screen. Open the Measurement menu to show the measurement box again.
By dragging the Measurement box out of the screen through the top or left side of the screen, it will be removed from the screen.  
<br>To show the measurement box again, simply open the Measurement menu. If the Measurement menu was already open, simply close and open the menu by tapping the ruler twice.
==Docking the measurement box to the bottom of the screen==
==Docking the measurement box to the bottom of the screen==
Typically the measurement box will be floating on top of your screen; and even though it is semi-transparant it can hide some parts you want to keep an eye on. Therefore, you can dock the measurement box to the bottom of the screen, which will make sure it no longer obscures other elements.
Typically the measurement box will be floating on top of your screen; and even though it is semi-transparant it can hide some parts you want to keep an eye on. Therefore, you can dock the measurement box to the bottom of the screen, which will make sure it no longer obscures other elements.
Line 15: Line 19:
Sometimes you're really only interested in the mean value of the measurement. For such cases, you can dock the measurement box to the right side of the screen, which will show the mean value in a much larger font. This can also be useful if you want to monitor a certain value from a distance.
Sometimes you're really only interested in the mean value of the measurement. For such cases, you can dock the measurement box to the right side of the screen, which will show the mean value in a much larger font. This can also be useful if you want to monitor a certain value from a distance.
<br>[[File:DockedRight.png]]
<br>[[File:DockedRight.png]]
==Adding/removing measurement to/from the measurement box==
To add a measurement for a certain channel, follow these steps:
* Open the Measurement menu (by tapping the ruler at the bottom-right corner)
* Cycle to the desired channel (by tapping the '<' or '>' bottons at the top-right of the screen)
* Find your measurement, and hit the list icon to the left of the measurement's name
This will darken the list icon, and add the measurement to the Measurement box.
<br><br>To remove the measurement again, repeat the same procedure which will gray out the list icon, and remove the measurment from the Measurement box.
<br>[[File:AddMeasurement.png]]
=Long-term measurement graphs=
=Long-term measurement graphs=
=The Measurements menu=
Sometimes you want to monitor a value over a long time. Using the long-term measurement graphs, this can now be done from within the SmartScope app.
The Measurements menu is used to activate/deactivate measurements. The Measurements menu is integrated in the right part of the GUI. To open or hide the Measurements menu, hit the Ruler button at the bottom-right of the screen.
<br> In order to add the long-term graph for a measurement, follow these steps:
<br>Once opened, the Measurement menu shows at its top the channel, followed by the measurements which can be invoked for this channel.
* Open the Measurement menu (by tapping the ruler at the bottom-right corner)
==Add/remove to/from measurement box==
* Cycle to the desired channel (by tapping the '<' or '>' bottons at the top-right of the screen)
Each measurement has an icon to the left, which is grayed out by default. Tap it to become active, which means the measurment is now active in the measurement box. Tap it again to disable the measurement; thereby removing it from the measurement box (and if present, removing its long-term graph).
* Find your measurement, and hit the wave icon to the right of the measurement's name
==
This will darken the wave icon, and add the long-term graph of the measurement to the bottom of the main screen.
<br>[[File:AddLTGraph.png]]
<br><br>Each long-term graph presents the following information:
* Top-center: measurement title + color of the source channel
* x-axis: time axis (see below)
* Main trace: Mean value of that measurement
* Colored background behind trace: for each time-interval only the Mean value is shown on the main trace; but sometimes you need to follow the outliers as well. To this end, the colored background represent the Min and Max values of each interval.
==Extending the timebase of the long-term channel graphs==
By default up till 15 minutes of data will be shown on each long-term graph. This can be increased to any length you prefer, but keep in mind the lenght of the interval after which a new datapoint will be added to the graphs will increase.
<br>To do so, follow these steps:
*Open the main menu
*Go to System -> Measurement graphs and tap on the current timespan
*Enter any timespan you want through the keypad
<br>!!Warning: changing the timespan of the long-term graphs will clear all data of all active measurements!!
<br>[[File:ChangeTimebase.png]]

Latest revision as of 21:17, 16 September 2017

Since v0.13.0.0, the SmartScope includes a more advanced Measurement subsystem. Each measurement now shows more information (min/max/mean/std), and you can even watch how these values change over longer periods of time (even hours!) inside the SmartScope app itself.
MOverview.png

Overview

The main GUI elements of the measurement subsystem are shown below, which will be used throughout the remainder of this page:
MCallouts.png

The Measurements menu

The Measurements menu is used to show/hide measurements. The Measurements menu is integrated in the right part of the GUI. To open or hide the Measurements menu, hit the Ruler button at the bottom-right of the screen.
Once opened, the Measurement menu shows at its top the channel, followed by the measurements which can be invoked for this channel. Cycle through the channels by tapping the '<' and '>' buttons next to the channel name.

Measurement box

The measurement box contains the currently active measurements. The Value column displays the value calculated on each incoming wave. This value can vary very rapidly, and therefore the Mean column was added which shows the averaged value over 1 second. Added to this are the Min and Max columns, which show the minumum and maximal value of the measurement of said 1 second period. Finally, the Std column shows the standard deviation (~noise or variation) of this value over the 1 second interval.
The measurement box can be dragged around freely over the screen.

Showing/hiding the measurement box

By dragging the Measurement box out of the screen through the top or left side of the screen, it will be removed from the screen.
To show the measurement box again, simply open the Measurement menu. If the Measurement menu was already open, simply close and open the menu by tapping the ruler twice.

Docking the measurement box to the bottom of the screen

Typically the measurement box will be floating on top of your screen; and even though it is semi-transparant it can hide some parts you want to keep an eye on. Therefore, you can dock the measurement box to the bottom of the screen, which will make sure it no longer obscures other elements.
DockedBottom.png

Docking the measurement box to the right side of the screen

Sometimes you're really only interested in the mean value of the measurement. For such cases, you can dock the measurement box to the right side of the screen, which will show the mean value in a much larger font. This can also be useful if you want to monitor a certain value from a distance.
DockedRight.png

Adding/removing measurement to/from the measurement box

To add a measurement for a certain channel, follow these steps:

  • Open the Measurement menu (by tapping the ruler at the bottom-right corner)
  • Cycle to the desired channel (by tapping the '<' or '>' bottons at the top-right of the screen)
  • Find your measurement, and hit the list icon to the left of the measurement's name

This will darken the list icon, and add the measurement to the Measurement box.

To remove the measurement again, repeat the same procedure which will gray out the list icon, and remove the measurment from the Measurement box.
AddMeasurement.png

Long-term measurement graphs

Sometimes you want to monitor a value over a long time. Using the long-term measurement graphs, this can now be done from within the SmartScope app.
In order to add the long-term graph for a measurement, follow these steps:

  • Open the Measurement menu (by tapping the ruler at the bottom-right corner)
  • Cycle to the desired channel (by tapping the '<' or '>' bottons at the top-right of the screen)
  • Find your measurement, and hit the wave icon to the right of the measurement's name

This will darken the wave icon, and add the long-term graph of the measurement to the bottom of the main screen.
AddLTGraph.png

Each long-term graph presents the following information:

  • Top-center: measurement title + color of the source channel
  • x-axis: time axis (see below)
  • Main trace: Mean value of that measurement
  • Colored background behind trace: for each time-interval only the Mean value is shown on the main trace; but sometimes you need to follow the outliers as well. To this end, the colored background represent the Min and Max values of each interval.

Extending the timebase of the long-term channel graphs

By default up till 15 minutes of data will be shown on each long-term graph. This can be increased to any length you prefer, but keep in mind the lenght of the interval after which a new datapoint will be added to the graphs will increase.
To do so, follow these steps:

  • Open the main menu
  • Go to System -> Measurement graphs and tap on the current timespan
  • Enter any timespan you want through the keypad


!!Warning: changing the timespan of the long-term graphs will clear all data of all active measurements!!
ChangeTimebase.png