geoh5py.data package

Submodules

geoh5py.data.blob_data module

class geoh5py.data.blob_data.BlobData(data_type: geoh5py.data.data_type.DataType, **kwargs)

Bases: geoh5py.data.data.Data

classmethod primitive_type() → geoh5py.data.primitive_type_enum.PrimitiveTypeEnum

geoh5py.data.color_map module

class geoh5py.data.color_map.ColorMap(**kwargs)

Bases: object

Records colors assigned to value ranges (where Value is the start of the range).

property name: str

str: Name of the colormap

property values: numpy.ndarray

numpy.array: Colormap defined by values and corresponding RGBA:

values = [
    [V_1, R_1, G_1, B_1, A_1],
    ..., [V_i, R_i, G_i, B_i, A_i]
]

where V (Values) are sorted floats defining the position of each RGBA. R (Red), G (Green), B (Blue) and A (Alpha) are integer values between [0, 255].

geoh5py.data.data module

class geoh5py.data.data.Data(data_type: geoh5py.data.data_type.DataType, **kwargs)

Bases: geoh5py.shared.entity.Entity

Base class for Data entities.

property association: DataAssociationEnum | None

DataAssociationEnum: Relationship made between the values() and elements of the parent object. Association can be set from a str chosen from the list of available DataAssociationEnum options.

property entity_type: geoh5py.data.data_type.DataType

DataType

classmethod find_or_create_type(workspace: workspace.Workspace, **kwargs) → DataType

Find or create a type for a given object class

Parameters

workspace (Current) – Workspace

Returns

A new or existing object type

property n_values: int | None

int: Number of expected data values based on association

abstract classmethod primitive_type() → geoh5py.data.primitive_type_enum.PrimitiveTypeEnum

property values

Data values

geoh5py.data.data_association_enum module

class geoh5py.data.data_association_enum.DataAssociationEnum(value)

Bases: enum.Enum

Known data association between values and the parent object. Available options:

CELL = 2

FACE = 4

GROUP = 5

OBJECT = 1

UNKNOWN = 0

VERTEX = 3

geoh5py.data.data_type module

class geoh5py.data.data_type.DataType(workspace: workspace.Workspace, **kwargs)

Bases: geoh5py.shared.entity_type.EntityType

DataType class

property color_map: ColorMap | None

ColorMap: Colormap used for plotting

The colormap can be set from a dict of sorted values with corresponding RGBA color.

color_map = {
    val_1: [r_1, g_1, b_1, a_1],
    ...,
    val_i: [r_i, g_i, b_i, a_i]
}

classmethod create(workspace: workspace.Workspace, data_class: type[data.Data]) → DataType

Creates a new instance of DataType with corresponding PrimitiveTypeEnum.

Parameters

data_class – A Data implementation class.

Returns

A new instance of DataType.

classmethod find_or_create(workspace: workspace.Workspace, **kwargs) → DataType

Find or creates an EntityType with given UUID that matches the given Group implementation class.

Parameters

workspace – An active Workspace class

Returns

A new instance of DataType.

classmethod for_x_data(workspace: workspace.Workspace) → DataType

classmethod for_y_data(workspace: workspace.Workspace) → DataType

classmethod for_z_data(workspace: workspace.Workspace) → DataType

property hidden: bool

bool: Hidden data [False]

property mapping: str

str: Color stretching type chosen from: ‘linear’, [‘equal_area’], ‘logarithmic’, ‘cdf’, ‘missing’

property number_of_bins: int | None

int: Number of bins used by the histogram [50]

property primitive_type: PrimitiveTypeEnum | None

PrimitiveTypeEnum

property transparent_no_data: bool

bool: Use transparent for no-data-value [True]

property units: str | None

str: Data units

property value_map: ReferenceValueMap | None

ReferenceValueMap: Reference value map for ReferenceData

The value_map can be set from a dict of sorted values with corresponding str description.

value_map = {
    val_1: str_1,
    ...,
    val_i: str_i
}

geoh5py.data.data_unit module

class geoh5py.data.data_unit.DataUnit(unit_name: Optional[str] = None)

Bases: object

Data unit

property name: str | None

geoh5py.data.datetime_data module

class geoh5py.data.datetime_data.DatetimeData(data_type: geoh5py.data.data_type.DataType, **kwargs)

Bases: geoh5py.data.data.Data

classmethod primitive_type() → geoh5py.data.primitive_type_enum.PrimitiveTypeEnum

geoh5py.data.filename_data module

class geoh5py.data.filename_data.FilenameData(data_type: geoh5py.data.data_type.DataType, **kwargs)

Bases: geoh5py.data.data.Data

classmethod primitive_type() → geoh5py.data.primitive_type_enum.PrimitiveTypeEnum

geoh5py.data.float_data module

class geoh5py.data.float_data.FloatData(data_type: geoh5py.data.data_type.DataType, **kwargs)

Bases: geoh5py.data.numeric_data.NumericData

Data container for floats values

classmethod ndv() → float

No-Data-Value

classmethod primitive_type() → geoh5py.data.primitive_type_enum.PrimitiveTypeEnum

geoh5py.data.geometric_data_constants module

class geoh5py.data.geometric_data_constants.GeometricDataConstants

Bases: object

classmethod primitive_type() → geoh5py.data.primitive_type_enum.PrimitiveTypeEnum

classmethod x_datatype_uid() → uuid.UUID

classmethod y_datatype_uid() → uuid.UUID

classmethod z_datatype_uid() → uuid.UUID

geoh5py.data.integer_data module

class geoh5py.data.integer_data.IntegerData(data_type: geoh5py.data.data_type.DataType, **kwargs)

Bases: geoh5py.data.numeric_data.NumericData

classmethod ndv() → int

No-Data-Value

classmethod primitive_type() → geoh5py.data.primitive_type_enum.PrimitiveTypeEnum

geoh5py.data.numeric_data module

class geoh5py.data.numeric_data.NumericData(data_type: geoh5py.data.data_type.DataType, **kwargs)

Bases: geoh5py.data.data.Data, abc.ABC

Data container for floats values

check_vector_length(values) → numpy.ndarray

Check for possible mismatch between the length of values stored and the expected number of cells or vertices.

classmethod primitive_type() → geoh5py.data.primitive_type_enum.PrimitiveTypeEnum

property values: numpy.ndarray

Returns

values: An array of float values

geoh5py.data.primitive_type_enum module

class geoh5py.data.primitive_type_enum.PrimitiveTypeEnum(value)

Bases: enum.Enum

Known data type.

Available options:

BLOB = 6

DATETIME = 8

FILENAME = 5

FLOAT = 2

GEOMETRIC = 9

INTEGER = 1

INVALID = 0

REFERENCED = 4

TEXT = 3

VECTOR = 7

geoh5py.data.reference_value_map module

class geoh5py.data.reference_value_map.ReferenceValueMap(color_map: dict[int, str] = None)

Bases: abc.ABC

Maps from reference index to reference value of ReferencedData.

property map

dict: A reference dictionary mapping values to strings

geoh5py.data.referenced_data module

class geoh5py.data.referenced_data.ReferencedData(data_type: geoh5py.data.data_type.DataType, **kwargs)

Bases: geoh5py.data.integer_data.IntegerData

Reference data described by indices and associated strings.

classmethod primitive_type() → geoh5py.data.primitive_type_enum.PrimitiveTypeEnum

property value_map

Pointer to the data.data_type.DataType.value_map

geoh5py.data.text_data module

class geoh5py.data.text_data.CommentsData(data_type: geoh5py.data.data_type.DataType, **kwargs)

Bases: geoh5py.data.data.Data

Comments added to an Object or Group. Stored as a list of dictionaries with the following keys:

comments = [
    {
        "Author": "username",
        "Date": "2020-05-21T10:12:15",
        "Text": "A text comment."
    },
]

classmethod primitive_type() → geoh5py.data.primitive_type_enum.PrimitiveTypeEnum

property values: list[dict] | None

list List of comments

class geoh5py.data.text_data.TextData(data_type: geoh5py.data.data_type.DataType, **kwargs)

Bases: geoh5py.data.data.Data

classmethod primitive_type() → geoh5py.data.primitive_type_enum.PrimitiveTypeEnum

property values: str | None

str Text value.

geoh5py.data.unknown_data module

class geoh5py.data.unknown_data.UnknownData(data_type: geoh5py.data.data_type.DataType, association: geoh5py.data.data_association_enum.DataAssociationEnum, name: str, uid: Optional[uuid.UUID] = None)

Bases: geoh5py.data.data.Data

classmethod primitive_type() → geoh5py.data.primitive_type_enum.PrimitiveTypeEnum

Module contents