Getting started with events
Deuteron loggers contain continuous data alongside events that are triggered at specific times. These events are stored in a special format and require translation. There are many ways to translate and handle this information, and we highly recommend you consult the manual for further instructions on how to extract events into a readable format.
In flat file format, the events are stored separately from other data in a single file with the default name “EventLog.NLE”.
In block file format the events are stored alongside the continuous data, thus many files contain events that you may wish to view simultaneously. Due to the potentially large number of files containing events, we have provided an application that will compress the event data into a small number of files (typically a single file). You can then read these compressed files using the Event_File_Reader_7_2 application or dll.
We recommend you use the events compressor application if you wish to view more than 10 files at a time. Instructions on how to use the events compressor can be found in chapter 2.2 of the manual. The events compressor application can be downloaded from the links below in 32 and 64 bit versions:
There are a few ways to parse an event log file using the event file reader. The user can launch the utility program to view the events and write them in a readable format to a CSV file, run it from the command line in Matlab, or retrieve information from an event log file using the event file viewer DLL from Matlab, Python, C++ or C# environments.
The Event_File_Reader_7_2.exe utility program has two functions:
- It allows you to see the list of recorded events and their timestamps. You can choose which events are of interest to you and display only those events.
- Translates and saves the event log file into a readable text file for further processing.
Instructions on how to use the Event file reader program can be found in the manual in chapter 3.
If you wish to call this program from the command line in Matlab, you can use the version in the above link as well. Instructions on how to use the command line functionality can be found in chapter 4 of the the event file reader manual.
The capabilities of the event file viewer can be accessed via DLL directly from the user’s code. When accessing the DLL from Matlab or C#, only the main dll is required. From Python and C++, the main DLL needs to be accessed via a wrapper DLL thus you will need to download both the main and wrapper DLLs. The links for downloading the main and wrapper dlls are below:
Instructions on how to use the DLLs from the various programming environments are detailed in chapter 5 of the instruction manual. Programming examples in each language can be downloaded below (you will need to download the required DLLs in addition to the programming examples).