H2i format (#400)

[FORMATS] add H2i support

README.md

@@ -49,7 +49,8 @@ You can use MDAL to load the following file formats:
 - [PLY](https://en.wikipedia.org/wiki/PLY_(file_format)): Stanford Polygon Format also useful for mesh created from point clouds by [PDAL](https://pdal.io)
 - [DFSU*](https://www.dhigroup.com):DHI Flexible File Format (External Driver)
 - [DFS2*](https://www.dhigroup.com):DHI Grid Series File (External Driver)
-
+- [H2i*](https://github.com/d2hydro/H2i_code_factory/blob/main/docs/data_format.md): Outputs of the H2i modelling package
+
 \* Data lazy loaded
 
 \*\* Formats can be preprocessed using QGIS [Crayfish](https://plugins.qgis.org/plugins/crayfish/) Mesh processing algorithm to one of supported formats
@@ -69,11 +70,12 @@ You can use MDAL to load the following file formats:
 | 3Di   |  READ-ONLY | NO |  READ-ONLY | READ-ONLY | NO | NO | 
 | UGRID   |  READ-WRITE | NO | READ-ONLY | READ-ONLY | NO | NO | 
 | FLO-2D   |  READ-ONLY  | NO | READ-ONLY | READ-WRITE | NO | NO  | 
-| Selafin   |  READ-ONLY | NO | NO | READ-ONLY | NO | NO | 
+| Selafin   |  READ-WRITE | NO | NO | READ-WRITE | NO | NO | 
 | SWW   |  READ-ONLY | NO | NO | READ-ONLY | NO | NO | 
 | PLY   | READ-WRITE | N/A | READ-WRITE | READ-WRITE | READ-WRITE | N/A |
 | DFSU  | READ-ONLY | N/A | NO | READ-ONLY | READ-ONLY | YES | 
 | DFS2  | READ-ONLY | N/A | NO | READ-ONLY | N/A | YES |
+| H2i | READ-ONLY | NO | NO | READ-ONLY | N/A | YES |
 
 # Standalone Installation
 

docs/source/drivers/h2i.rst

@@ -0,0 +1,24 @@
+.. _driver.h2i:
+
+================================================================================
+H2I -- H2i format
+================================================================================
+
+.. shortname:: H2I
+
+.. built_in_by_default::
+
+MDAL supports reading of the H2i mesh format.
+
+This driver can be used to read FLO-2D mesh (1D, 2D).
+H2i mesh structure is a quad tree structure defined by nodes a the center of quad and by links that, at each side of quads, represents the interface between quad.
+
+Files of H2i format are:
+* a json file with some information about the mesh (mesh name, crs, reference time and time steps) and relative path of the  other files defining the mesh and its dataset groups.
+* text file containing the nodes information
+* text file containing the links information
+* text file containing the time step
+* one binary file per dataset group, dataset group can be relied to nodes or links.
+
+.. _H2I: https://github.com/d2hydro/H2i_code_factory/blob/main/docs/data_format.md
+

docs/source/drivers/index.rst

@@ -39,3 +39,4 @@ MDAL drivers
    xms-tin
    dfsu
    dfs2
+   h2i