enDAQ Reporter

The enDAQ Reporter tool is a command-line executable that will generate two "reports." This tool will be incorporated into future software releases and can be customized for a fee to add different metrics, plots, and other features.

We recommend using files that are less than 100 MB to improve responsiveness although it can execute on larger files. If you have a particularly large dataset, we'd recommend using the splitter in enDAQ Lab (you must use version 2.1 or later).

Video Tutorial

This video shows the use of this tool with a 90 MB file.

Tool Overview

The tool is two part, the first helps summarize a larger file to see how things changed over time and find a particular "area of interest." And then the second part will analyze a specific time range.

Area of Interest (AOI)

User specifies a window length, then the tool breaks the file into 'n' number of windows of the specified length and computes and plots the following metrics. These will also show the resultant value along with the individual x, y, and z axis:

Peak acceleration
RMS acceleration
Peak pseudo velocity
RMS velocity
RMS displacement
Spectrogram

An example output from this tool is shown below.

Analyzer of Specific Time

Then the user can zero in on a particular time range of interest and specify that start and end time to generate a report of:

Raw acceleration data (with resultant)
Integrated velocity time history
Power spectral density
Psuedo velocity spectrum

This will also print out the following metrics for each axis and the resultant in the command prompt for the specified time range:

RMS acceleration
RMS velocity
RMS displacement
Peak acceleration
Peak PSD
Peak Pseudo Velocity

An example output is shown below.

RMS Acceleration:
  x-axis:    0.4784010787735149 G
  y-axis:    0.4498119108390788 G
  z-axis:    0.19826540938596288 G
  resultant: 0.6859355070728951 G
RMS Velocity:
  x-axis:    120.52094049340693 mm/s
  y-axis:    112.79001670606293 mm/s
  z-axis:    47.87898095274091 mm/s
  resultant: 171.86995602211056 mm/s
RMS Displacement:
  x-axis:    6.374805877824549 mm
  y-axis:    8.899748029655848 mm
  z-axis:    3.3112735448610544 mm
  resultant: 11.437141140171624 mm
Peak Acceleration:
  x-axis:    1.1967262023457241 G @ 1.9e+03 seconds
  y-axis:    1.0792951715009549 G @ 1.9e+03 seconds
  z-axis:    0.7448312250450937 G @ 1.9e+03 seconds
  resultant: 1.6444267073952976 G @ 1.9e+03 seconds
Peak PSD:
  x-axis:    0.14716342693863507 G²/Hz @ 6.0 Hz
  y-axis:    0.1279770401140491 G²/Hz @ 6.0 Hz
  z-axis:    0.015553432313611969 G²/Hz @ 6.0 Hz
  resultant: 0.2906938993662961 G²/Hz @ 6.0 Hz
Peak Pseudo Velocity:
  x-axis:    1525.3194633515395 mm/s @ 6.0 Hz
  y-axis:    1366.4956574139496 mm/s @ 6.0 Hz
  z-axis:    638.9457116716852 mm/s @ 6.0 Hz
  resultant: 2145.2648949427776 mm/s @ 6.0 Hz

Interface

The tool is run with the command prompt which can be found on the computer by searching for "cmd."

Once opened the user will need to call the executable which is most conveniently done by dragging and dropping from another window into the command prompt. It should look like this:

Microsoft Windows [Version 10.0.18363.1256]
(c) 2019 Microsoft Corporation. All rights reserved.

C:\Users\shanly>C:\Users\shanly\Desktop\enDAQ-Reporter.exe <br>

Then there are two options, one is an "area of interest" calculator which loops through the file to calculate and plot a series of metrics for the defined time range. To use that call the following command by replacing "##" with the window duration of your choosing in seconds.

aoi --winduration=##

The second is an "analyzer" which will dive deeper into a specified time range. The code to execute these commands are as follows, replacing "##" with the start and stop time in seconds.

analyze --start=## --stop=##

Finally the user most provide the IDE file they wish to analyze. Again the easiest way to do this is drag and drop into the command prompt. Two example full commands are shown below.

C:\Users\shanly>C:\Users\shanly\Desktop\enDAQ-Reporter.exe aoi --winduration=10 C:\Users\shanly\Desktop\TulsaFlowLoop-SSX10053_018_02.IDE

C:\Users\shanly>C:\Users\shanly\Desktop\enDAQ-Reporter.exe analyze --start=1900 --stop=1905 C:\Users\shanly\Desktop\TulsaFlowLoop-SSX10053_018_02.IDE<br>