resqpy.derived_model.add_one_blocked_well_property¶
- resqpy.derived_model.add_one_blocked_well_property(epc_file, a, property_kind, blocked_well_uuid, source_info='imported', title=None, discrete=False, uom=None, time_index=None, time_series_uuid=None, string_lookup_uuid=None, null_value=None, indexable_element='cells', facet_type=None, facet=None, realization=None, local_property_kind_uuid=None, count_per_element=1, points=False, extra_metadata={}, new_epc_file=None)¶
Adds a blocked well property from a numpy array to an existing resqml dataset.
- Parameters
epc_file (string) – file name to load model resqml model from (and rewrite to if new_epc_file is None)
a (1D numpy array) – the blocked well property array to be added to the model
property_kind (string) – the resqml property kind
blocked_well_uuid (uuid object or string) – the uuid of the blocked well to which the property relates
source_info (string) – typically the name of a file from which the array has been read but can be any information regarding the source of the data
title (string) – this will be used as the citation title when a part is generated for the array
discrete (boolean, default False) – if True, the array should contain integer (or boolean) data; if False, float
uom (string, default None) – the resqml units of measure for the data; not relevant to discrete data
time_index (integer, default None) – if not None, the time index to be used when creating a part for the array
time_series_uuid (uuid object or string, default None) – required if time_index is not None
string_lookup_uuid (uuid object or string, optional) – required if the array is to be stored as a categorical property; set to None for non-categorical discrete data; only relevant if discrete is True
null_value (int, default None) – if present, this is used in the metadata to indicate that this value is to be interpreted as a null value wherever it appears in the data (use for discrete data only)
indexable_element (string, default 'cells') – the indexable element in the supporting representation (the blocked well); valid values are ‘cells’, ‘intervals’ (which includes unblocked intervals), or ‘nodes’
facet_type (string) – resqml facet type, or None
facet (string) – resqml facet, or None
realization (int) – realization number, or None
local_property_kind_uuid (uuid.UUID or string) – uuid of local property kind, or None
count_per_element (int, default 1) – the number of values per indexable element; if greater than one then this must be the fastest cycling axis in the cached array, ie last index; if greater than 1 then a must be a 2D array
points (bool, default False) – if True, this is a points property with an extra dimension of extent 3
extra_metadata (dict, optional) – any items in this dictionary are added as extra metadata to the new property
new_epc_file (string, optional) – if None, the source epc_file is extended with the new property object; if present, a new epc file (& associated h5 file) is created to contain a copy of the blocked well (and dependencies) and the new property
- Returns
uuid.UUID of newly created property object