data input

File


The data input mode "File" allows to select the files for the evaluation manually. You can either add your own files or select prepared example files from the demo data browser.

The demo data browser provides examples files for each single test, including a detailed description. All demo files have the standard MXeval data format, which allows the demo data browser to also switch to the correct channel configuration accordingly.



The imported files can be combined to file clusters, which will deliver a single KPI result for all of the files in the cluster. The method can be changed in the options menu at the "Data processing" Section.



The "From file" mode also offers a sample based crop editor, which allows to easily crop all files in an interactive way. Each crop setting can be evaluated for every single file by looking at the contained data signal by signal.



The "Crop files" feature only works for .mat, .erg and .mdf files!
These files must contain equally sampled 1D arrays as channels.
If those requirements are not fulfilled, the data cropping will not work!



Observer


The observer modes objective is to automatically detect new specific files and evaluate them automatically. This is necessary when using the "Online" mode.

The observer checks a defined working directory for prefix, suffix, and file extension and triggers either on any directory change or on adds only.

The automatic export of the evaluation results closes the loop e.g. to interface with other tools in a optimization loop.


  • Working directory

Folder that is being observed for new files

  • Trigger mode
  • add: The evaluation will be trigered, once a new file has been added into the working directory after starting the observer.
  • change: The evaluation will be trigered, once there is any change in the working directory after starting the observer.
  • add (unlocked); Same as "add", but only with unlocked files.
  • change (unlocked): Same as "change", but only with unlocked files.


The "unlocked" modes can be helpful when the software that generates the data uses data streams to popolate the files. 
In this case the files are being created at the beginning but without any data. The unlocked mode then only gets triggered when the software has finished writing into the data file.


  • History

Defines how many previous files (including the current one) are evaluated at one.

E.g. When set to 2, MXeval will automatically evaluate the latest file and the previous one.


The history setting can be useful for application purposes. It allows a direct comparions between the latest and the previous results.


  • File extenstion

Defines the file formats to be observed within the working directory.

e.g. "mat" for a single format or "mat;csv" for multiple formats.

MXeval will only trigger the evaluation when files with the specified extension appear in the folder.

  • Prefix filter

Files without the specified prefix will be ignored when the prefix filter is activated.

  • Suffix filter

Files without the specified suffix will be ignored when the suffix filter is activated.

  • Auto KPI export

Automatically export the calculated KPIs in the specified file format directly after the evaluation. The results will be stored in the "results" folder which will be created directly within the working directory.

  • Auto report generation

available in a future release!