resqpy.multiprocessing.find_faces_to_represent_surface_regular_wrapper

resqpy.multiprocessing.find_faces_to_represent_surface_regular_wrapper(index: int, parent_tmp_dir: str, use_index_as_realisation: bool, grid_epc: str, grid_uuid: Union[UUID, str], surface_epc: str, surface_uuid: Union[UUID, str], name: str, title: Optional[str] = None, agitate: bool = False, feature_type: str = 'fault', trimmed: bool = False, is_curtain=False, extend_fault_representation: bool = False, retriangulate: bool = False, related_uuid=None, progress_fn: Optional[Callable] = None, consistent_side: bool = False, extra_metadata=None, return_properties: Optional[List[str]] = None, raw_bisector: bool = False) Tuple[int, bool, str, List[Union[UUID, str]]]

Wrapper function of find_faces_to_represent_surface_regular_optimised.

Used for multiprocessing to create a new model that is saved in a temporary epc file and returns the required values, which are used in the multiprocessing function to recombine all the objects into a single epc file.

Parameters
  • index (int) – the index of the function call from the multiprocessing function.

  • parent_tmp_dir (str) – the parent temporary directory path from the multiprocessing function.

  • use_index_as_realisation (bool) – if True, uses the index number as the realization number on the property collection.

  • grid_epc (str) – epc file path where the grid is saved.

  • grid_uuid (UUID/str) – UUID (universally unique identifier) of the grid object.

  • surface_epc (str) – epc file path where the surface (or point set) is saved.

  • surface_uuid (UUID/str) – UUID (universally unique identifier) of the surface (or point set) object.

  • name (str) – the feature name to use in the grid connection set.

  • title (str) – the citation title to use for the grid connection set; defaults to name

  • agitate (bool) – if True, the points of the surface are perturbed by a small random offset, which can help if the surface has been built from a regular mesh with a periodic resonance with the grid

  • feature_type (str, default 'fault') – one of ‘fault’, ‘horizon’, or ‘geobody boundary’

  • trimmed (bool, default True) – if True the surface has already been trimmed

  • is_curtain (bool, default False) – if True, only the top layer is intersected with the surface and bisector is generated as a column property if requested

  • extend_fault_representation (bool, default False) – if True, the representation is extended with a flange

  • retriangulate (bool, default False) – if True, a retriangulation is performed even if not needed otherwise

  • related_uuid (uuid, optional) – if present, the uuid of an object to be softly related to the gcs (and to grid bisector and/or shadow property if requested)

  • progress_fn (Callable) – a callback function to be called at intervals by this function; the argument will progress from 0.0 to 1.0 in unspecified and uneven increments

  • consistent_side (bool) – if True, the cell pairs will be ordered so that all the first cells in each pair are on one side of the surface, and all the second cells on the other

  • extra_metadata (dict, optional) – extra metadata items to be added to the grid connection set

  • return_properties (List[str]) – if present, a list of property arrays to calculate and return as a dictionary; recognised values in the list are ‘triangle’, ‘depth’, ‘offset’, ‘normal vector’, ‘flange bool’, ‘grid bisector’ and ‘grid shadow’; triangle is an index into the surface triangles of the triangle detected for the gcs face; depth is the z value of the intersection point of the inter-cell centre vector with a triangle in the surface; offset is a measure of the distance between the centre of the cell face and the intersection point; normal vector is a unit vector normal to the surface triangle; each array has an entry for each face in the gcs; grid bisector is a grid cell boolean property holding True for the set of cells on one side of the surface, deemed to be shallower; grid shadow is a grid cell int8 property holding 1 for cells neither above nor below a K face, 1 for above, 2 for beneath, 3 for between; the returned dictionary has the passed strings as keys and numpy arrays as values

  • raw_bisector (bool, default False) – if True and grid bisector is requested then it is left in a raw form without assessing which side is shallower (True values indicate same side as origin cell)

Returns

Tuple containing – - index (int): the index passed to the function. - success (bool): whether the function call was successful, whatever that

definiton is.

  • epc_file (str): the epc file path where the objects are stored.

  • uuid_list (List[str]): list of UUIDs of relevant objects.