gempy.add_orientations

gempy.add_orientations(geo_model: GeoModel, x: Sequence[float], y: Sequence[float], z: Sequence[float], elements_names: Sequence[str], pole_vector: Sequence[ndarray] | None = None, orientation: Sequence[ndarray] | None = None, nugget: Sequence[float] | None = None) → StructuralFrame[source]

Add orientation data to the geological model.

This function adds orientation data to the specified geological elements in the model. The orientation can be provided directly as pole vectors or as orientation angles (azimuth, dip, polarity). Optional nugget values can also be specified for each orientation point.

Parameters:

  • geo_model (GeoModel) – The geological model to which the orientations will be added.

  • x (Sequence[float]) – Sequence of x-coordinates for the orientation points.

  • y (Sequence[float]) – Sequence of y-coordinates for the orientation points.

  • z (Sequence[float]) – Sequence of z-coordinates for the orientation points.

  • elements_names (Sequence[str]) – Sequence of element names corresponding to each orientation point.

  • pole_vector (Optional[Sequence[np.ndarray]]) – Sequence of pole vectors for the orientation points.

  • orientation (Optional[Sequence[np.ndarray]]) – Sequence of orientation angles (azimuth, dip, polarity) for the orientation points.

  • nugget (Optional[Sequence[float]]) – Sequence of nugget values for each orientation point. If not provided, a default value will be used for all points.

Returns:

The updated structural frame of the geological model.

Return type:

StructuralFrame

Raises:

ValueError – If neither pole_vector nor orientation is provided, or if the length of the nugget sequence does not match the lengths of the other input sequences.