[ENH] Add name_id_map support in orientation data manipulation

Integrated optional `name_id_map` parameter to the `add_orientation` method for mapping orientation names to IDs. Updated Hecho example with serialization validation and added save/load functionality for models.

Author: Leguark

examples/examples/real/Hecho.py

@@ -12,6 +12,7 @@
 
 # Aux imports
 import pandas as pn
+from gempy.modules.serialization.save_load import _validate_serialization
 
 # Importing gempy
 import gempy as gp
@@ -149,7 +150,8 @@
         y=new_orientations.data['Y'],
         z=new_orientations.data['Z'],
         pole_vector=new_orientations.grads,
-        elements_names=fn
+        elements_names=fn,
+        name_id_map=element.surface_points.name_id_map 
     )
 
 # %%
@@ -216,6 +218,11 @@
 # Setting verbose and condition number options for debugging
 geo_model.interpolation_options.kernel_options.compute_condition_number = True
 
+gp.save_model(geo_model, 'Hecho.gempy')
+model_deserialized = gp.load_model('Hecho.gempy')
+
+_validate_serialization(geo_model, model_deserialized)
+
 # %% 
 gp.compute_model(
     gempy_model=geo_model,

gempy/modules/data_manipulation/manipulate_points.py

@@ -96,7 +96,8 @@ def add_orientations(geo_model: GeoModel,
         elements_names: Sequence[str],
         pole_vector: Optional[Union[Sequence[np.ndarray], np.ndarray]] = None,
         orientation: Optional[Union[Sequence[np.ndarray], np.ndarray]] = None,
-        nugget: Optional[Sequence[float]] = None
+        nugget: Optional[Sequence[float]] = None,
+        name_id_map: Optional[dict[str, int]] = None  #: A mapping between orientation names and ids.
 ) -> StructuralFrame:
     """Add orientation data to the geological model.
 
@@ -176,6 +177,7 @@ def add_orientations(geo_model: GeoModel,
             G_z=data['pole_vector'][..., 2],
             names=[element_name] * len(data['x']),
             nugget=data['nugget'],
+            name_id_map=name_id_map
         )
 
         element: StructuralElement = geo_model.structural_frame.get_element_by_name(element_name)