The Merge Raw Data Utility (MRD) is a utility that can be used to merge raw ShapeArray data spread across several files into a single file for easier processing of historical records.


This utility will always create raw data files in the combined/unified data format. This format contains all of the information about the ShapeArray™ including the ShapeArray™ diagnostics and logger diagnostics information. 


NOTE: The Merge Raw Data Utility requires the ShapeArray™ calibrations files to be installed. You can find more information on how to download and install calibration files in the How to Download and Install SAASuite guide.


The Merge Raw Data Utility is installed with the SAASuite and resides of the following folder location:

C:\Measurand Inc\Utilities


Executing the Merge Raw Data Utility from the command line with the Help parameter will provide information details on the command line usage as follows:

C:\Measurand Inc\Utilities>MergeRawDataUtility.exe -help
Merge Raw Data Utility v0.02 (Copyright 2022)
- merge raw data from a project into a single file.


 MergeRawDataUtility.exe -source "<directory>" -destination "<directory>"
 MergeRawDataUtility.exe -help


Parameters:
   source         Specifies the original project directory
   destination    Specifies the location for new files


   help           This menu


In the destination folder, a separate data file will be created for each ShapeArray found in the data files from the source folder. A single data file for each ShapeArray will be produced containing all readings for that array with the following file name (where ####### is the serial number of the ShapeArray).


SAA######_SAA_DATA.dat


An example of a common command line invocation of the Merge Raw Data Utility is as follows:

C:\Measurand Inc\Utilities>MergeRawDataUtility.exe -source "C:\Folder1" -destination "C:\Folder2"


The above invocation will take all of the .dat files found within the source directory (C:\Folder1) and combine them into a single .dat file for each separate ShapeArray in the destination directory (C:\Folder2).


The operation will sort the readings in the output files by timestamp and remove any readings that are duplicated by timestamp or the reading itself.