representation context + colors

Author: valentin-gauthier-geosiris

energyml-utils/example/attic/main.py

@@ -91,7 +91,7 @@
     validate_epc,
     correct_dor,
 )
-from energyml.utils.xml import (
+from energyml.utils.xml_utils import (
     find_schema_version_in_element,
     get_class_name_from_xml,
     get_root_namespace,

energyml-utils/example/attic/main_data.py

@@ -39,7 +39,7 @@
     read_energyml_xml_tree,
 )
 from energyml.utils.validation import validate_epc
-from energyml.utils.xml import get_tree
+from energyml.utils.xml_utils import get_tree
 from energyml.utils.data.datasets_io import (
     HDF5FileReader,
     get_path_in_external_with_path,

energyml-utils/src/energyml/utils/data/__init__.py

@@ -6,4 +6,4 @@
 Contains functions to help the read of specific entities like Grid2DRepresentation, TriangulatedSetRepresentation etc.
 It also contains functions to export data into OFF/OBJ format.
 """
-from .crs import CrsInfo, extract_crs_info, apply_from_crs_info, apply_axis_order_swap  # noqa: F401
+from energyml.utils.data.crs import CrsInfo, extract_crs_info, apply_from_crs_info, apply_axis_order_swap  # noqa: F401

energyml-utils/src/energyml/utils/data/crs.py

@@ -181,7 +181,7 @@ def _resolve_dor(
     **and** the object has a ``uuid``/``uid`` attribute (i.e. it is a pointer,
     not a value type).
     """
-    
+
     if obj is None or workspace is None:
         return obj
     type_lower = type(obj).__name__.lower()
@@ -321,7 +321,9 @@ def _extract_vertical_crs_details(vertical_crs_obj: Any) -> dict:
     **must not** override a parent-level ``ZIncreasingDownward`` when this
     value is ``None``.
     """
-    logging.debug(f"Extracting vertical CRS details from object of type {type(vertical_crs_obj).__name__} with URI {get_obj_uri(vertical_crs_obj)}")
+    logging.debug(
+        f"Extracting vertical CRS details from object of type {type(vertical_crs_obj).__name__} with URI {get_obj_uri(vertical_crs_obj)}"
+    )
     result: dict = {
         "epsg_code": None,
         "wkt": None,
@@ -437,14 +439,10 @@ def _from_abstract_local3dcrs(
             z_increasing_downward = str(zid_raw).lower() in ("true", "1", "yes")
 
     # --- Projected UOM -----------------------------------------------------
-    projected_uom: Optional[str] = _uom_to_str(
-        get_object_attribute_no_verif(crs_obj, "projected_uom")
-    )
+    projected_uom: Optional[str] = _uom_to_str(get_object_attribute_no_verif(crs_obj, "projected_uom"))
 
     # --- Vertical UOM (length or time) ------------------------------------
-    vertical_uom: Optional[str] = _uom_to_str(
-        get_object_attribute_no_verif(crs_obj, "vertical_uom")
-    )
+    vertical_uom: Optional[str] = _uom_to_str(get_object_attribute_no_verif(crs_obj, "vertical_uom"))
     if vertical_uom is None:
         # time_uom only present on LocalTime3dCrs
         vertical_uom = _uom_to_str(getattr(crs_obj, "time_uom", None))
@@ -459,9 +457,7 @@ def _from_abstract_local3dcrs(
         projected_axis_order = ao.replace("_", " ").lower()
 
     # --- Projected CRS -----------------------------------------------------
-    projected_crs_obj = _resolve_dor(
-        get_object_attribute_no_verif(crs_obj, "projected_crs"), workspace
-    )
+    projected_crs_obj = _resolve_dor(get_object_attribute_no_verif(crs_obj, "projected_crs"), workspace)
     projected_details = _extract_projected_crs_details(projected_crs_obj)
 
     # Projected UOM from inline ProjectedCrs takes precedence if present
@@ -471,20 +467,20 @@ def _from_abstract_local3dcrs(
         projected_axis_order = projected_details["axis_order"]
 
     # --- Vertical CRS ------------------------------------------------------
-    vertical_crs_obj = _resolve_dor(
-        get_object_attribute_no_verif(crs_obj, "vertical_crs"), workspace
-    )
+    vertical_crs_obj = _resolve_dor(get_object_attribute_no_verif(crs_obj, "vertical_crs"), workspace)
     vertical_details = _extract_vertical_crs_details(vertical_crs_obj)
 
     # Direction from VerticalCrs overrides the top-level ZIncreasingDownward
     # only when explicitly set.
     logging.debug("z_increasing_downward before vertical CRS details: %s", z_increasing_downward)
-    logging.debug(f"Vertical CRS details: {vertical_details} -- vertical_crs_obj type: {type(vertical_crs_obj).__name__ if vertical_crs_obj else 'None'}")
+    logging.debug(
+        f"Vertical CRS details: {vertical_details} -- vertical_crs_obj type: {type(vertical_crs_obj).__name__ if vertical_crs_obj else 'None'}"
+    )
     if vertical_crs_obj is not None and vertical_details.get("z_increasing_downward") is not None:
         z_increasing_downward = vertical_details["z_increasing_downward"]
     if vertical_details.get("uom"):
         vertical_uom = vertical_details["uom"]
-        
+
     logging.debug("z_increasing_downward after vertical CRS details: %s", z_increasing_downward)
 
     return CrsInfo(
@@ -547,9 +543,7 @@ def _from_local_engineering2d_crs(
         azimuth_reference = ar.replace("_", " ").lower()
 
     # --- Horizontal UOM (HorizontalAxes.projected_uom or uom on ProjectedCrs) ---
-    projected_uom: Optional[str] = _uom_to_str(
-        get_object_attribute(crs_obj, "horizontal_axes.projected_uom")
-    )
+    projected_uom: Optional[str] = _uom_to_str(get_object_attribute(crs_obj, "horizontal_axes.projected_uom"))
 
     # --- ProjectedCrs — may be an inline object OR a DOR ------------------
     projected_crs_raw = get_object_attribute_no_verif(crs_obj, "origin_projected_crs")
@@ -920,10 +914,7 @@ def extract_crs_info(
     # ------------------------------------------------------------------
     # v2.0.1 types  (LocalDepth3dCrs, LocalTime3dCrs, AbstractLocal3dCrs)
     # ------------------------------------------------------------------
-    if any(
-        kw in type_name_lower
-        for kw in ("localdepth3dcrs", "localtime3dcrs", "abstractlocal3dcrs", "local3dcrs")
-    ):
+    if any(kw in type_name_lower for kw in ("localdepth3dcrs", "localtime3dcrs", "abstractlocal3dcrs", "local3dcrs")):
         return _from_abstract_local3dcrs(crs_obj, workspace)
 
     # ------------------------------------------------------------------

energyml-utils/src/energyml/utils/data/datasets_io.py

@@ -158,7 +158,6 @@ def extract_h5_datasets(
 
     @dataclass
     class HDF5FileWriter:
-
         def write_array(
             self,
             target: Union[str, BytesIO, bytes, "h5py.File"],
@@ -209,7 +208,6 @@ def extract_h5_datasets(
             raise MissingExtraInstallation(extra_name="hdf5")
 
     class HDF5FileWriter:
-
         def write_array(
             self,
             target: Union[str, BytesIO, bytes, Any],
@@ -631,9 +629,7 @@ def read_external_dataset_array(
         for s in sources:
             try:
                 if result_array is None:
-                    result_array = read_dataset(
-                        source=s, path_in_external_file=path_in_external, mimetype=mimetype
-                    )
+                    result_array = read_dataset(source=s, path_in_external_file=path_in_external, mimetype=mimetype)
                 else:
                     # TODO: take care of the "Counts" and "Starts" list in ExternalDataArrayPart to fill array correctly
                     result_array = result_array + read_dataset(
@@ -908,9 +904,7 @@ def read_array_view(
                 d_group = source[path_in_external_file]
                 if start_indices is not None and counts is not None:
                     # h5py reads only the required chunks/slabs from disk
-                    slices = tuple(
-                        slice(start, start + count) for start, count in zip(start_indices, counts)
-                    )
+                    slices = tuple(slice(start, start + count) for start, count in zip(start_indices, counts))
                     return d_group[slices]  # type: ignore
                 # np.array with copy=False returns a view for contiguous datasets
                 # Note: copy= kwarg on np.asarray requires numpy >=2.0;

energyml-utils/src/energyml/utils/data/export.py

@@ -14,7 +14,7 @@
 import numpy as np
 
 if TYPE_CHECKING:
-    from .mesh import AbstractMesh
+    from energyml.utils.mesh import AbstractMesh
 
 
 class ExportFormat(Enum):
@@ -97,7 +97,7 @@ def export_obj(mesh_list: List["AbstractMesh"], out: BinaryIO, obj_name: Optiona
     :param obj_name: Optional object name for the OBJ file
     """
     # Lazy import to avoid circular dependency
-    from .mesh import PolylineSetMesh
+    from energyml.utils.mesh import PolylineSetMesh
 
     # Write header
     out.write(b"# Generated by energyml-utils a Geosiris python module\n\n")
@@ -142,7 +142,7 @@ def export_geojson(
     :param options: GeoJSON export options
     """
     # Lazy import to avoid circular dependency
-    from .mesh import PolylineSetMesh, SurfaceMesh
+    from energyml.utils.mesh import PolylineSetMesh, SurfaceMesh
 
     if options is None:
         options = GeoJSONExportOptions()
@@ -195,7 +195,7 @@ def export_vtk(mesh_list: List["AbstractMesh"], out: BinaryIO, options: Optional
     :param options: VTK export options
     """
     # Lazy import to avoid circular dependency
-    from .mesh import PolylineSetMesh, SurfaceMesh
+    from energyml.utils.mesh import PolylineSetMesh, SurfaceMesh
 
     if options is None:
         options = VTKExportOptions()
@@ -260,7 +260,7 @@ def export_stl(mesh_list: List["AbstractMesh"], out: BinaryIO, options: Optional
     :param options: STL export options
     """
     # Lazy import to avoid circular dependency
-    from .mesh import SurfaceMesh
+    from energyml.utils.mesh import SurfaceMesh
 
     if options is None:
         options = STLExportOptions(binary=True)