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
Step 2 - Start SAACR_raw2data
In SAASuite 3.0 or higher, the Raw2Data application is launched by clicking the Data Conversion button.
Figure 1: Raw2Data is launched by clicking the Data Conversion button
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
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:
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
- Superset ShapeArrays
- Convergence ShapeArrays
- Non-ShapeArray sensors
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 apply software adjustments to the raw data as it is being converted. 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
- 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 Back button, as shown in Figure 5 above, to close the export settings window. Click the Continue button, as shown in Figure 5 above to begin converting your data with the selected settings.
Step 7 - Optional, Configure Email Notifications
You can configure email notifications by selecting the Enable Email checkbox. When enabled, email notifications can be sent whenever SAACR_raw2data encounters a processing error or detects that there is a issue with the ShapeArray data, such as a low power condition. Once the Enable Email checkbox is selected, click on the Email Notifications button to configure the following options.
Figure 10: Configure email settings to receive notifications of issues while processing with Raw2Data
- SMTP Server Settings
- Server : The address of the mail server that will send the email notifications
- Port: The port number to be used for connecting to the mail server
- Username: The username to be used for signing into the mail server
- Password: The password to be used for signing into the mail server
- Use SSL checkbox: Enable SSL to be used for communicating with the mail server
- Test button: Send a test email with the currently configured email settings
- Reply-To-Address: The email to display as the sending address for the email notifications
- Left text box: A text box for entering a recipient's email address.
- Right text box: A list of the currently set recipients for email notifications.
- Right Arrow button: Add the email address entered in the left text box to the list in the right text box
- Left Arrow button: Remove the currently selected email address from the right text box
- Notification Types
- This section provides check boxes for enabling the different types of email notifications that can be sent
- If multiple notifications trigger at once, only a single email will be sent enumerating all issues
- There are typically two email notification types that can be selected
- Processing Errors: Send an email notification the the exit code from SAACR_raw2data when an error condition is detected. This corresponds to any exit code except 0 or 1.
- Power Issues: Send an email notification if the logger diagnostics file has listed low voltage for any new readings
- Cancel button: Closes the window and discards any changes to the configured settings
- Save button: Closes the window and keeps the configured settings
Step 8 - 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 11: 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 12: 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 9 - 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 13: 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 or use the exported DIY data to generate your own visualizations.