PetroVisor Package
      Back to home
      1. Weatherford Knowledge Base
      2. Packages
      3. PetroVisor Package

      Voronoi Package

      This package generates a set of Voronoi polygons around well locations using Rserve.

      Usage

      First set all Input Arguments for the R Activity generateVoronois, then run the workflow Generate Voronoi. If a valid email address was entered for the R Activity input argument ​sendto​, then an email will be sent containing a log file, a data file, and a GeoJSON file with the polygon information.

      The produced GeoJSON file can be used in any standard GIS mapping software. If you would like the Voronoi polygons to display as a layer on your Petrovisor Maps, please contact your system administrator.

      Details

      Activity Input Arguments

      • drilltype: wellbore profile
      • plotsymbol: mapping plot symbol. This signal should be a character that defines the mapping symbol that should be output in the GeoJSON file. If the signal is left empty, a default symbol of a circle will be used. The workspace dictionary value Mapping Plot Symbol Lookup can be used to assign standard plot symbols if desired.
      • dofp_tags: set Argument Type to Tag Entries and select the Active tag
      • latbh: bottomhole latitude
      • longbh: bottomhole longitude
      • latsurf: surface latitude (must be specified, but values in this signal can be NULL)
      • longsurf: surface longitude (must be specified, but values in this signal can be NULL)
      • latheel: lateral heel latitude (must be specified, but values in this signal can be NULL)
      • longheel: lateral heel longitude (must be specified, but values in this signal can be NULL)
      • stop_on_malformed_coords:​ set to the Workspace Value TrueString or FalseString. This is a logical determining if you want to stop the Voronoi calculations if there are malformed bottomhole latitude/longitude coordinates in the dataset. If TRUE, the Voronoi calculation will stop when it encounters an entity with malformed coordinates. If FALSE, the entities with malformed coordinates are removed from the dataset and Voronoi calculations continue.
      • stop_on_duplicate_coords:​ set to the Workspace Value TrueString or FalseString. This is a logical determining if you want to stop the Voronoi calculations if there are duplicate latitude/longitude coordinates in the dataset. For vertical well, the bottomhole coordinates are checked. For horizontal wells, the bottomhole, heel and surface coordinates are checked together for duplicates. If TRUE, the Voronoi calculation will stop if it encounters a duplicate coordinate set. If FALSE, the entities with duplicate coordinates are listed in the output, and the Voronoi calculation continues. No entities are removed from the dataset.
      • simplify_polygons:​ set to the Workspace Value TrueString or FalseString. This is a logical determining if you want to simplify polygons to reduce the size of the GeoJSON files.
      • simplify_keep:​ set to the Workspace Value CVPSimplifyKeep. Must be a numeric value that is greater than zero and less than or equal to 1.0. Defines the fraction of points to keep in the Voronoi polygons during the simplification process. Only used when simplify_polygons​ = TRUE.
      • simplify_weight:​ set to the Workspace Value CVPSimplifyWeight. Must be a numeric value that is greater than zero and less than or equal to 1.0. Defines the weighting of points to keep in the Voronoi polygons during the simplification process. Only used when simplify_polygons​ = TRUE.
      • geofile: user-defined character string; can be treated as a project name. If you do not want to use a geofile, then use "none" for this parameter (without the quotes).
      • sendto: user-defined email address list to send the results to when the Voronoi polygon calculations complete. Multiple email addresses can be included, separated by commas, with no spaces in between. If you do not want to specify an email, then use "none" for this parameter (without the quotes).

      Activity Output Arguments

      • output_area_all_entities: voronoi area all entities
      • output_area_dofp: voronoi area on date of first production

      Data Requirements

      The following data is required:

      wellbore profile
      mapping plot symbol
      bottomhole latitude
      bottomhole longitude

      Further Comments

      The Generate Voronoi workflow can only run in an Rserve cloud-based R environment.

      The R activity contained in this package uses an R package that is only available on Petrovisor's Rserve instance. This package can be requested if needed for an on-premise installation.