The Revision Management tool allows users to have more control over how they manage their data, allowing users to update configuration parameters for devices and sensors multiple times with a timestamp associated with each configuration change.
Updates made from the standard Edit Configuration page are done by saving settings to the sensor. Any change applied here will update the property and apply it to the entire data set of the sensor. This is referred to as a Universal Update.
Updates made from the Revision Management tab utilize a concept that is meant to compensate for field or installation-related changes. First, the user will define the date to apply the record change. Once the configuration settings appear, any changes made will not overwrite the property universally but will keep the original value stored for the data before the date selected, and only update the value for sensor data after the date chosen. This type of change is referred to as a Revision.
**Important Note** Revisions can only be applied to certain sensor parameters. Parameters that use Revisions are:
Sensor Depth (Vibrating Wire Piezometers)
Collar Elevation (Vibrating Wire Piezometers)
Easting, Northing, and Height Offset (Prisms)
Install Elevation (Vibrating Wire Settlement Sensor)
Navigating to Revision Management
1. Navigate to the Connectivity Module.
2. Select the sensor for making configuration changes.
3. Click on the "Revision Management" tab on the left side of the Sensor page.
How to Use Revision Management
The Revision Management window is illustrated below. Beneath the image is a description of the elements of the page.
1. Sensor Attributes- On the left side of the timeline, the edited sensor attributes are populated in a row format.
2. Timeline- The timeline displays the history of Revisions for the sensor. Revisions will appear as blue circles on the Revision Management Timeline. Clicking on a Revision opens a Revision Details window, illustrated below.
This window allows the user to view the Revision details. The pencil icon on the upper right corner allows the user to modify the Record Details.
3. Show Editors- The person icon shows the User who made the Revision on the timeline.
4. Show All Records- Use the expansion icon to view all Revisions on the timeline.
5. Add Revision Record- Click the "+Revision" button to add a new Revision record.
Select the date and time to create your record change. Once a date has been chosen, the existing sensor settings will appear as they exist at that date selected. Settings can be changed in the opened window. Click apply after the settings have been changed to save the changes. A new point will be visible on the timeline. The setting changes will be applied for the date selected and forward unless another Revision is implemented at a later date.
Use Case Scenario
Below is an example of each scenario for a Piezometer that has been installed in a borehole at a depth of 50m below the surface.
The Edit Configuration page was configured at 50' Sensor Depth. This setting is applied to the entire dataset for this piezometer.
Elevation of H20 is now calculated using a sensor depth of 50m: Elevation of H20 = (Collar Elevation - Sensor Depth) + Pressure read by the Piezometer.
If during service, the Piezometer was removed from the hole at its previous depth of 50m and reinstalled at a depth of 43m. This change in installation depth results in a change in water pressure the Piezometer is reading, in turn resulting in a change in the Elevation of H20 calculation.
Updating the Sensor depth to 43m using the traditional universal update is not ideal in this scenario as it would update the value for all data in the time series. This would result in a correct value for the Elevation of H20 after the change was made but an incorrect value for Elevation of H20 calculations before the sensor service. This is because the raw pressure reading from the Piezometer has now changed.
Using Revision Management, we can compensate for this change by keeping the sensor depth value at 50m before the change and setting it to 43m after the change.
Now that the sensor is using each setting for its appropriate epoch of time, you can now see the elevation of H20 metric has been equalized. The algorithm calculating Elevation of H20 uses the value of 50m for data before the field disturbance and the value of 43m for data after the service.