Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
learn:instrumentation:tutorials:analog-discovery-studio-data-logger [2019/06/07 20:48] – [3. Logger User Interface Overview] Boris Leonov | learn:instrumentation:tutorials:analog-discovery-studio-data-logger [2021/05/14 23:07] (current) – ↷ Links adapted because of a move operation Arthur Brown | ||
---|---|---|---|
Line 1: | Line 1: | ||
- | ======Using the Data Logger (Under Construction)====== | + | ======Using the Data Logger (Page has Moved) ====== |
- | {{: | + | <WRAP round important 660px> |
- | + | This guide has been replaced by [[test-and-measurement: | |
- | ===== Introduction ===== | + | |
- | This guide explains the use of the //Logger// instrument in WaveForms. This instrument is used to log potentially large amounts of analog voltage data over time. | + | |
- | ---- | + | |
- | ===== Prerequisites ===== | + | |
- | * A Digilent Test & Measurement Device with Analog Input and Output Channels | + | |
- | * A Computer with WaveForms Software Installed | + | |
- | + | ||
- | ---- | + | |
- | + | ||
- | ====1. Opening the Logger==== | + | |
- | <WRAP group> | + | |
- | <WRAP column half> | + | |
- | === 1.1 === | + | |
- | Plug in your Test & Measurement Device, then start WaveForms | + | |
- | + | ||
- | If no device is connected | + | |
- | + | ||
- | **Note:** //" | + | |
- | + | ||
- | **Note:** //The Device Manager can be opened by clicking on the " | + | |
</ | </ | ||
- | <WRAP column half> | ||
- | {{ : | ||
- | </ | ||
- | </ | ||
- | ---- | ||
- | <WRAP group>< | ||
- | === 1.2 === | ||
- | Once the Welcome page loads, in the instrument panel at the left side of the window, click on the **Logger** button to open the //Data Logger// instrument. | ||
- | </ | ||
- | {{ : | ||
- | </ | ||
- | ---- | ||
- | <WRAP group> | ||
- | <WRAP column half> | ||
- | ===1.3=== | ||
- | Once the //Logger// instrument opens, the window contains the data plot on the right side and the default data measurements listed on the left side. | ||
- | </ | ||
- | <WRAP column half> | ||
- | {{ : | ||
- | </ | ||
- | </ | ||
- | ---- | ||
- | |||
- | |||
- | ====2. Using the Logger==== | ||
- | //This section walks through setting up the //Logger// to capture data from the Scope channels.// | ||
- | |||
- | <WRAP group> | ||
- | <WRAP column half> | ||
- | ===2.1 Hardware Setup=== | ||
- | Connect the Test & Measurement Device' | ||
- | </ | ||
- | <WRAP column half> | ||
- | {{ : | ||
- | </ | ||
- | </ | ||
- | ---- | ||
- | |||
- | <WRAP group> | ||
- | <WRAP column half> | ||
- | ===2.2 Software Setup=== | ||
- | In WaveForms' | ||
- | |||
- | For more detail on how to use the //Wavegen// instrument, please see the [[learn: | ||
- | |||
- | Return to the //Logger// instrument by clicking on its tab in the bar at the top of the screen. | ||
- | |||
- | </ | ||
- | <WRAP column half> | ||
- | {{ : | ||
- | </ | ||
- | </ | ||
- | ---- | ||
- | |||
- | <WRAP group> | ||
- | <WRAP column half> | ||
- | ===2.3 Run the Logger=== | ||
- | Click the Run button ({{: | ||
- | </ | ||
- | <WRAP column half> | ||
- | {{ : | ||
- | </ | ||
- | </ | ||
- | ---- | ||
- | |||
- | <WRAP group> | ||
- | <WRAP column half> | ||
- | ===2.4 Plot Plane Axes=== | ||
- | By default, measurement 1 (named C1 DC) is selected and therefore the vertical axis will automatically display an appropriate range for viewing that particular logged signal data in the same color associated with that data (yellow for C1 DC). | ||
- | </ | ||
- | <WRAP column half> | ||
- | {{ : | ||
- | </ | ||
- | </ | ||
- | |||
- | <WRAP group> | ||
- | <WRAP column half> | ||
- | Selecting a different measurement in the list to the left of the plot plane (for example, measurement 2) will adjust the vertical axis such that the selected measurement will be displayed along with all the other desired measurements with an appropriate range for viewing the logged signal data magnitude and change its color to reflect the currently selected data (light blue for measurement 2). | ||
- | </ | ||
- | <WRAP column half> | ||
- | {{ : | ||
- | </ | ||
- | </ | ||
- | |||
- | <WRAP group> | ||
- | <WRAP column half> | ||
- | To manually set your own range for a measurement: | ||
- | - Click the Utilities ({{reference: | ||
- | - Uncheck the //Auto// box | ||
- | - Enter your desired //Top// and //Bottom// values | ||
- | </ | ||
- | <WRAP column half> | ||
- | {{ : | ||
- | {{ : | ||
- | {{ : | ||
- | </ | ||
- | </ | ||
- | |||
- | <WRAP group> | ||
- | <WRAP column half> | ||
- | The bottom axis default is time in seconds with a minute long window where zero seconds is on the right side of the bottom axis and sixty seconds is on the left. The default sampling frequency is one second, which means that the displayed data will update once every second. Using the **History** drop-down menu located at the top of the data plot, you can select to increase or decrease this displayed time window. | ||
- | </ | ||
- | <WRAP column half> | ||
- | {{ : | ||
- | </ | ||
- | </ | ||
- | |||
- | <WRAP group> | ||
- | <WRAP column half> | ||
- | Using the **Update** drop-down menu, you can select to increase or decrease your sampling frequency. | ||
- | </ | ||
- | <WRAP column half> | ||
- | {{ : | ||
- | </ | ||
- | </ | ||
- | ---- | ||
- | |||
- | ====3. Logger User Interface Overview==== | ||
- | //This section walks through the wide variety of controls and features present in the //Logger// instrument.// | ||
- | |||
- | <WRAP group> | ||
- | <WRAP column half> | ||
- | ===3.1 Control Buttons=== | ||
- | As seen in Section 2, the control bar near the top of the window can be used to stop and start the capturing of data from the analog input pins. In addition to the Run/Stop button, the Single button can be used to start data acquisition. In the //Logger// window, these buttons both start the data acquisition but a second click on the Single button will simply restart the acquisition whereas the Run button will now display Stop and a second click will stop the data acquisition. These options can also be accessed in the **Control** drop-down menu located above the control bar. | ||
- | </ | ||
- | <WRAP column half> | ||
- | FIXME image: device manager? | ||
- | </ | ||
- | </ | ||
- | ---- | ||
- | |||
- | <WRAP group> | ||
- | <WRAP column half> | ||
- | ===3.2 Data Export=== | ||
- | To export data from the //Logger// tool, click the Export ({{learn: | ||
- | </ | ||
- | <WRAP column half> | ||
- | FIXME image: device manager? | ||
- | </ | ||
- | </ | ||
- | |||
- | <WRAP group> | ||
- | <WRAP column half> | ||
- | The Data tab allows you to export a .csv file containing all of the current data points in the plot plane with comments, headers, and labels as default or an image of the current plot plane. You can remove comments, headers, and/or labels by unchecking the corresponding box located in the upper left section of this window. | ||
- | </ | ||
- | <WRAP column half> | ||
- | FIXME image: device manager? | ||
- | </ | ||
- | </ | ||
- | |||
- | <WRAP group> | ||
- | <WRAP column half> | ||
- | The Image tab will allow you to save an image of the //Logger// tool interface including the plot plane, measurements list, and the control bar with the option of displaying the device, serial number, and time that the image was taken. To change the background color of the plot for printing, see Plot Utilities in section 3.10. | ||
- | |||
- | </ | ||
- | <WRAP column half> | ||
- | FIXME image: device manager? | ||
- | </ | ||
- | </ | ||
- | ---- | ||
- | |||
- | <WRAP group> | ||
- | <WRAP column half> | ||
- | ===3.3 Measurement Maximum/ | ||
- | To the left of the Single acquisition button described in section 3.1 is a drop-down menu that says **Show**. Click on this to select whether or not to add columns to display the minimum and/or maximum of all the measurements. | ||
- | </ | ||
- | <WRAP column half> | ||
- | FIXME image: device manager? | ||
- | </ | ||
- | </ | ||
- | ---- | ||
- | |||
- | <WRAP group> | ||
- | <WRAP column half> | ||
- | ===3.4 Edit Measurement=== | ||
- | To edit a current measurement, | ||
- | </ | ||
- | <WRAP column half> | ||
- | FIXME image: device manager? | ||
- | </ | ||
- | </ | ||
- | ---- | ||
- | |||
- | <WRAP group> | ||
- | <WRAP column half> | ||
- | ===3.5 Remove Measurements=== | ||
- | The far left side of the control bar has a green plus ({{learn: | ||
- | </ | ||
- | <WRAP column half> | ||
- | FIXME image: device manager? | ||
- | </ | ||
- | </ | ||
- | ---- | ||
- | |||
- | <WRAP group> | ||
- | <WRAP column half> | ||
- | ===3.6 Add Measurements (Basic)== | ||
- | From the control bar, click the green plus button to add a new measurement. A new window will open with two tabs that titled " | ||
- | |||
- | The Item tab contains commonly used, predefined measurements for channel 1 and channel 2: DC voltage, True RMS voltage, and RMS voltage. These are the default measurements that are displayed when opening the Logger instrument but if they were to be deleted, you can quickly add them again here. | ||
- | ---- | ||
- | The Function tab by default displays the script editor window where you can manually type a mathematical function or click on desired functions displayed below the Insert window to insert them into your measurement function (all trigonometric functions operate on radian values, not degrees). To hide the built in functions, uncheck the Insert box. Click the Evaluate Script button ({{learn: | ||
- | </ | ||
- | <WRAP column half> | ||
- | FIXME image: device manager? | ||
- | </ | ||
- | </ | ||
- | ---- | ||
- | |||
- | <WRAP group> | ||
- | <WRAP column half> | ||
- | ===3.7 Add Measurements (Advanced)== | ||
- | Within the Function tab of //Add Measurements//, | ||
- | in the script editor window. Debug gives you an environment to step through complex scripts to ensure proper functionality, | ||
- | </ | ||
- | <WRAP column half> | ||
- | FIXME image: device manager? | ||
- | </ | ||
- | </ | ||
- | ---- | ||
- | |||
- | <WRAP group> | ||
- | <WRAP column half> | ||
- | ===3.8 Sampling Utilities=== | ||
- | On the control bar, to the right of the **Update** drop-down menu is a Utilities Icon({{learn: | ||
- | </ | ||
- | <WRAP column half> | ||
- | FIXME image: device manager? | ||
- | </ | ||
- | </ | ||
- | ---- | ||
- | |||
- | <WRAP group> | ||
- | <WRAP column half> | ||
- | ===3.9 Plot Plane Cursors=== | ||
- | To add a vertical bar cursor to the plot plane, click the Add Cursor ({{learn: | ||
- | ---- | ||
- | Additional cursor types are available by clicking either the Free({{learn: | ||
- | </ | ||
- | <WRAP column half> | ||
- | FIXME image: device manager? | ||
- | </ | ||
- | </ | ||
- | ---- | ||
- | |||
- | <WRAP group> | ||
- | <WRAP column half> | ||
- | ===3.10 Plot Utilities=== | ||
- | The Utilities Icon ({{learn: | ||
- | </ | ||
- | <WRAP column half> | ||
- | FIXME image: device manager? | ||
- | </ | ||
- | </ | ||
- | ---- | ||
- | |||
- | <WRAP group> | ||
- | <WRAP column half> | ||
- | ===3.11 Other Plot Plane Options=== | ||
- | To clear the plot plane of all data without removing measurements, | ||
- | </ | ||
- | <WRAP column half> | ||
- | FIXME image: device manager? | ||
- | </ | ||
- | </ | ||
- | |||
- | ---- | ||
- | ==== Next Steps ==== | ||
- | |||
- | /* | ||
- | If captured voltage values are significantly different from the expected voltage output, please calibrate the device by following the **Calibration Guide**. FIXME link | ||
- | */ | ||
- | |||
- | For more guides on how to use the Digilent Test & Measurement Device, return to the device' | ||
- | |||
- | For more information on WaveForms visit the [[reference: | ||
- | |||
- | For technical support, please visit the [[https:// | ||
- | {{tag>analog-discovery-studio tutorial}} | + | {{tag>to-be-removed}} |