SAACR_raw2data application takes raw data files, usually created by a Campbell Scientific data logger, and converts them into Cartesian data files that can be viewed in SAAView or exported to other applications. 



Step 1 - Download and Install Required Software


Review the SAASuite manual and installation guide. Download and install SAASuite, SAACR_raw2data, Runtime Environment, and Calibration Files.



Step 2 - Start SAACR_raw2data


From SAASuite, click the SAACR_raw2data button to start SAACR_raw2data.



Figure 1: SAASuite



In the SAACR_raw2data start dialog, click the appropriate button to continue.


  • Run Last - This will perform a new conversion on the last project converted with SAACR_raw2data without prompting for any user intervention or configuration.
  • Auto - Use Auto only after an initial conversion using Reset. You will only be prompted to select the project. The application will run without interruption based on previously configured settings.
  • Reset - Use Reset for initial setup and troubleshooting. This option enables file selection and configuration of settings.
    • If your ShapeArray has magnetometers, you must use Reset the first time you convert magnetometer data and select what magnetometer data you wish to use for correction purposes
    • You should also use the Reset button immediately after selecting magnetometer data, then you can use the OK button to only process newly acquired data
  • Quit - Close SAACR_raw2data
  • For more information on these buttons and when to use them review the Getting Started section of the SAACR_raw2data manual.

Figure 2: The start dialog in SAACR_raw2data



Step 3 - Select Project Files


Click the New Project button. In the file browser window that opens, browse to your Project folder and click any file within it.
NOTE: Measurand recommend storing your data logger project files in the following default location: C:\Measurand Inc\SAA3D\Logger Files



Figure 3: Selecting data logger project files



Step 4 - Optional, Select a Site File


If required, click the Browse button next to the Site File field near the bottom of window, as shown in Figure 3 above. Select your site file, and click the Open button.

NOTE: Site files are only required if you have one or more of the following:
  • Superset ShapeArrays 
  • Convergence ShapeArrays 
  • Non-ShapeArray sensors
Measurand recommends storing your site files in the project folder with the raw data files collected from the logger. You can find example site files that can be modified for your projects in the following folder: C:\Measurand Inc\SAA3D\logger_files\site_file_examples

To read more about Site Files or how to make them, go to the Site Files section in the SAACR_raw2data manual.



Step 5 - Continue and Configure Settings


Once you have your project files and site file (if required) selected, click the OK button near the bottom, right corner of the window, as shown in Figure 3 above. 

NOTE: If your calibration files are missing, it most likely the case that they were not downloaded and installed as required in step 1. Close SAACR_raw2data and restart from step 1. Ensure the calibration files are downloaded and installed before moving on from step 1. If you still have a problem after restarting from step 1, please contact Measurand Support.



In the Settings window, configure appropriate settings for your ShapeArrays. The settings must match the physical state of the ShapeArray or the conversion will be incorrect! Detailed information on all these choices can be found in the Selecting Settings section of the SAACR_raw2data manual.

  • Vertical - Select this if the ShapeArray is within 60 degrees of vertical, rather than mostly horizontal. Do not select this option for convergence ShapeArrays.
  • Ref=far - Select this if the data are to be calculated from the FAR end (cable is at NEAR end).
  • Az. deg - Enter any desired Azimuth offset (degrees, clockwise is positive) for each ShapeArray.
  • Adjustments - Allows you to set the data adjustments that were enabled in SAAView. This will apply the enabled adjustments to the raw data. Please refer to the ADJUSTMENTS Tab section of the SAAView manual for more information.
  • StartSeg / EndSeg - Segment = 1 at cable (near) end. If a number larger than 1 is entered then all previous segments will be ignored.
  • SlaveSegments - Use ‘Edit Slaved’ button to enter any desired Slaved Segments (slaved segments will be assigned the tilt of the previous segment in order of calculation).

Figure 4: Configure settings for converting the data




Step 6 - Configure the Export Format


Click the Export Format button, as shown in Figure 4 above, to configure the export format. For details on the format choices, see the Data Types and the DIY Output sections in the SAACR_raw2data manual. 

WARNING: Do not use Legacy Formats unless directed to do so by Measurand. These formats are no longer supported. For details on the Legacy Formats, see the Legacy Formats section in the SAACR_raw2data manual. 



Figure 5: Configuring Export Formats




Select any number of data types you want to export. The more data types you include in the export, the larger the export files. For more details on each format and data type go to Data Types section in the SAACR_raw2data manual.

NOTE: Ensure that the Use a Legacy Format checkbox is cleared. 


Figure 6: Selecting data types for export



Choose the export file format of the data. For more details on each format go to DIY Output section in the SAACR_raw2data manual. For example, by default, the export will use the following settings: 


  • ASCII *.DAT File - ASCII format text file 
  • Metric Units - Metric units, with lateral deflections given in millimetres, axial position along the ShapeArray in metres, and temperature readings (if selected) in Celsius 
  • allXallYallZ - Columns will be arranged with all X data, followed by all Y data, then all Z data 
  • All Data - All data will be kept in a single data file. Every time data is converted, the new data will be appended to the existing export data file 

Figure 7: Selecting export file format settings 



The following export file format settings are not as commonly used, but may be required by certain programs. Ensure you contact the software manufacturer to determine what data format they are expecting when importing into their software (e.g. Use a Header is mandatory when exporting to VDV). For more details on each format go to DIY Output section in the SAACR_raw2data manual.


  • Chunk the Files
  • Seglength/Ref=Far
  • Use a Header (Mandatory for VDV)


If you are exporting data for VDV or GTilt, it is possible to use a predefined template to automatically select the correct data and data format. Click on the Use Template checkbox, as shown in Figure 9 below. Select a template from the dropdown list, as shown in Figure 9 below. It is still possible to make changes to the export format selections, but it is recommended that this be limited to selecting the Units, unless you are familiar with SAACR_raw2data.



Figure 8: Confirming the selection of a predefined template



Figure 9: Selecting a predefined template



Once you have finished choosing the options for the export file, click the Save button, as shown in Figure 5 above, to close the export settings window. Click the OK button, as shown in Figure 4 above to begin converting your data with the selected settings. 


Step 7 - Optional, Configure Magnetometer Settings


If your ShapeArray has magnetometers, the Settings window shown in Figure 4 above will have a Magnetometer button to configure magnetometer settings. This button will only appear if magnetometers are present. If magnetometers are present and you do not click this button to configure them, the Magtool will launch automatically on the first conversion of the data. For more information on using the Magtool to configure magnetometer settings, please refer to the Magtool guide.



Figure 10: The Magtool for configuring magnetometers



Once all your settings and formats are selected, click the OK button, as shown in Figure 4 above, to begin converting the data. If this is the first time conversion has occurred on raw data that includes magnetometers, SAACR_raw2data will prompt you to reconvert the data after you configure the magnetometers. Click the Yes button, as shown in Figure 11 below, to continue.



Figure 11: Reconvert the data after magnetometer setup


NOTE: Step 8 will be skipped when working with data from a ShapeArray with magnetometers. In this case, the program will close without prompting. The program has not crashed, and the converted data will appear in the DIY folder in the project folder.



Step 8 - Complete Conversion and View Data


Once the conversion is complete, a dialog will be presented with the path to the converted files. Click the OK button to continue.



Figure 12: The path to the converted files



You can now view the data with Measurand's SAAView application as described in the Using SAAView to Visualize ShapeArray Data guide.