993fcb409d2944dfa45967e4bb9.../README.md
2025-06-12 20:09:19 +00:00

3.7 KiB

Dynamic segmentation function

The ILI Comparison module is a valuable tool designed to compare anomalies found in two separate ILIs of the same pipeline. This module operates on an intelligent method that incorporates user-defined criteria to ensure precision in the comparison process. The workflow of this module begins with a girth-weld alignment step, which is crucial for identifying and aligning the correct girth welds from the two in-line inspection reports. In this case, the girth-weld alignment is applied to ILI reports conducted on 2011-06-01 and 2015-12-21, ensuring accurate alignment between the inspections. Both ILIs were performed by Rosen using the MFL (Magnetic Flux Leakage) technology.

Subsequently, the module matches metal loss corrosion anomalies based on the user's specified criteria. This matching process evaluates the evolution of anomalies over a 5.5-year interval, the time gap between the two ILIs. The output includes detailed reports that categorize the results into matched features, matched anomalies, unmatched features, and unmatched anomalies.
In its final output, the module generates a comprehensive KPI Dashboard that showcases the percentage of matched anomalies, providing users with an overview of the comparison results. Furthermore, six charts visually illustrate the growth of matched anomalies over the 5.5-year time interval between the two inspections. These visualizations provide valuable insights into how anomalies have evolved and help users track changes in pipeline integrity over time.

In addition, the validated results from this module are used in the Local Growth Rate Module for calculating the Final ACR and conducting future integrity assessments. The ILI Comparison module, through the integration of historical and recent inspection data, offers an essential framework for monitoring pipeline conditions and supporting maintenance decisions.

Input

Arguments

  • org_id: as string which should be a valid uuid for the organization
  • project_id: the id of the data project where the pipeline data is found
  • pipeline_id: a array of string values representing a valid uuid for a pipeline
  • older_ili_id: a array of string values representing a valid uuid for an ili report sequence
  • newer_ili_id: a array of string values representing a valid uuid for an ili report sequence
  • weld_location_threshold: a float value
  • feature_location_threshold: a float value
  • upstream_girth_threshold: a float value
  • orientation_threshold: a float value
  • minimum_depth_growth_threshold: a float value
  • minimum_length_growth_threshold: a float value
  • surface_location_criteria: an array of string each value should be one of
    • matching
    • any
  • target_minimum_match_rate: a float value

Creating the function on the platform

To create this function on the platform using the cli set up the port forwarding as shown in README.

Then run the following command to create the function.

cargo run functions create \
  -f functions/ili_comparison \
  -d "Compare two ILI reports" \
  -i org_id=string \
  -i project_id=string \
  -i pipeline_id=array \
  -i older_ili_id=array \
  -i newer_ili_id=array \
  -i weld_location_threshold=float \
  -i upstream_girth_threshold=float \
  -i feature_location_threshold=float \
  -i orientation_threshold=float \
  -i minimum_depth_growth_threshold=float \
  -i minimum_length_growth_threshold=float \
  -i surface_location_criteria=string \
  -i target_minimum_match_rate=float

Testing the function locally

You can run and test the function locally by running

cargo run

Then you can check it work with curl as follows

curl localhost:8080 -d $(jq '. | tojson' functions/ili_comparison/example_input.json)