# This file contains metadata for your plugin.

# This file should be included when you package your plugin.# Mandatory items:

[general]
name=QGISRed
qgisMinimumVersion=3.28
qgisMaximumVersion=4.99
description=Free professional software to build and analyze advanced water distribution network models and Digital Twins.
version=0.18
author=Fernando Martínez. REDHISP Group (IIAMA- UPV). Developers: WaterPi, Ingeniousware
email=fmartine@hma.upv.es

about=<p align="justify">QGISRed is a freeware QGIS plugin developed to assist in building and analyzing hydraulic models of water distribution networks of any complexity, up to the level of detail required by Digital Twins. The plugin works seamlessly with QGIS which enables the user to georeference all network elements, use geographic background layers, edit graphical and alphanumeric data, use geoprocessing tools, visualize data by layers, customize the symbology, etc.</p><p align="justify">QGISRed relies on an easy-to-use relational database of SHP and DBF files based on the EPANET data model, which has been extended to add new capabilities. Starting from the EPANET data model significantly reduces the learning curve.</p><p align="justify">In fact, the previous skills required on QGIS are minimal because QGISRed provides numerous tools to help build hydraulic models, to manage demand scenarios and to analyze the results without the need to use the QGIS environment, such as:</p><li>Project manager for easy project loading and storage</li><li>Automatic creation of new empty projects</li><li>Import/export EPANET INP files</li><li>Import basic network components from Shapefiles and other auxiliary components managed by the Digital Twin (DT) such as service connections, isolation valves and sensors.</li><li>Automatic generation of topological relationships between all the network elements</li><li>Graphical editing tools for all network elements including those of the DT (add, delete, move, edit vertices and nodes, reverse links, multiple selection, etc.)</li><li>Tools to debug the network layout and verify its connectivity</li><li>Default values for newly created elements</li><li>Property editor for all model and DT component attributes, including a browser</li><li>Complete editor of analysis options and default values</li><li>Automatic calculation of pipe lengths from the coordinates of the vertices</li><li>Automatic interpolation of node elevations from DTM</li><li>Automatic estimation of pipe roughness from the material and age of pipes</li><li>Conversion of roughness coefficients between different headloss formulas and unit systems</li><li>Visualization of multiple demands and quality sources as distinct layers and edition of their properties integrated with those of nodes</li><li>Automatic nodal demand allocation from punctual or sectoral consumptions</li><li>Managing scenarios with multiple demands by category</li><li>Automatic pattern and hydraulic efficiency allocation by sector</li><li>Scenario builder for various model parameters by importing/exporting files</li><li>Powerful editors for curves, patterns, controls and rules</li><li>Validation of any of the model properties against typical data entry errors</li><li>Management of service connections and isolation valves as differentiated elements</li><li>Load of demands to service connections from the meter readings, and move them to the closest nodes</li><li>Detection of isolated zones when closing the isolation valves and cancelling the demands on them</li><li>Optional integration of service connections into the model</li><li>Declaration of the meter sensors as distinct elements and the association of signals to them</li><li>Reading field data for the simulation period from files and exporting to EPANET</li><li>Automatic identification of hydraulic sectors and demand zones</li><li>Model simulation by using the EPANET toolkit 2.3</li><li>The inclusion of a timeline to view how results have changed over time, along with the status report</li><li>Visualization of simulation results by means of tables, colour-coded layers, arrows and floating or static labels</li><li>Automatic creation of legends and symbols for the data and results (customizable  with QGIS tools)</li><li>Exploring the properties of any element—whether data or results—from a permanent window</li><li>Running queries based on one or more criteria, either on the data, the results, or both</li><li>Analysing the trends in the results over time, for one or more variables on the same graph</li><p align="justify">Nevertheless, if the user decides to use the QGIS tools to edit the data, QGISRed provides powerful facilities to detect potential editing errors before simulating the model, or to fill in the missing information.</p><p align="justify">The development of the new QGISRed plugin is an initiative of the <a href="https://iiama.webs.upv.es/en/research/research-groups/hydraulic-networks-and-pressurised-systems/">REDHISP</a> Research Group of the Institute of Water and Environmental Engineering (<a href="https://iiama.webs.upv.es/en/home/">IIAMA</a>) of the Polytechnic University of Valencia, <a href="http://www.upv.es/index-en.html">UPV</a> (España), led by Professor <a href="https://www.researchgate.net/profile/Fernando_Martinez_Alzamora">Fernando Martínez Alzamora</a>. Its implementation was carried out up to 2022 by the <a href="https://waterpi.com/">WaterPi</a> company under the direction of <a href="https://www.researchgate.net/profile/Nestor_Lerma">Néstor Lerma</a>, PhD Eng. Subsequently, <a href="https://ingeniousware.com/">Ingeniousware</a> GmbH has collaborated in the development. QGISRed versions after 0.17 are being funded by the <a href="https://www.iadb.org/en">InterAmerican Development Bank</a> (IDB) through contract C-RG-T4041-P001.</p><p align="justify">The QGISRed extension for QGIS is an update of the old GISRed application developed by our group for the ArcView 3.1 environment (<a href="https://www.researchgate.net/publication/336170857_Upgrade_of_the_GISRed_application_for_the_free_analysis_of_WDN_under_GIS_environment">see launching paper</a>). Currently, the name GISRed has been kept in relation to the libraries developed in .net, which are used by QGISRed to improve the processing time and constitute the core of the GISRed standalone application.</p><p align="justify">For more information the user can check the official website of <a href="https://qgisred.upv.es/en">QGISRed</a> or the <a href="https://plugins.qgis.org/plugins/QGISRed/">section of QGISRed</a> in the official QGIS plugin repository.</p><p><b>Requeriments</b>  .Net Framework 4.8 - Windows OS.</p>

tracker=https://github.com/qgisred/QGISRed/issues
repository=https://github.com/qgisred/QGISRed
homepage=https://qgisred.upv.es/

# End of mandatory metadata

# Recommended items:

hasProcessingProvider=no
# Uncomment the following line and add your changelog:
changelog=version 0.18:
      * Improvements to the Project Manager. New buttons for moving and exporting projects, and new options for renaming projects.
      * Identification of all layers managed by QGISRed using a unique ID, rather than by name, enabling work in multiple languages.
      * Revision of the map symbols, labels and warnings associated with all layers managed by QGISRed.
      * Greater integration of the Element Properties Editor, maintaining layer properties and refreshing data in all affected windows, including the attribute table.
      * Storage of the style of all layers managed by QGISRed in .qml files at three levels: default, user level and project level.
      * Storage in a dedicated table of all measurements handled by QGISRed, specifying the units and decimal places to be displayed in the various unit systems and according to specific cases.
      * Creation of a dedicated Legend Editor to customise ranges or classes, colours and sizes of all legends handled by QGISRed.
      * Wizards to customise legends automatically.
      * Addition of a new menu and a new toolbar to house new options for querying data and results.
      * Reorganisation of the layers in the Queries group, and of the storage of the corresponding SHP files within the project’s folder structure.
      * New tool for locating any element on the map using its ID and identifying connected elements, with the option to navigate between them.
      * New panel for viewing the data and results of any selected network element. Synchronisation of results with the current point in time of the simulation.
      * New dialogue box for creating thematic maps of certain parameters associated with the different types of elements managed by QGISRed.
      * New panel for locating elements on the map that meet specific criteria relating to data or results. Synchronisation with the results for the current simulation time.
      * Improvement to the format in which the INP file is exported from QGISRed, similar to that exported from the EPANET Toolkit.
      * Replacement of the EPANET 2.2 calculation engine with the new version 2.3, up to the latest revision 2.3.5.
      * Reading of simulation results directly from EPANET binary files for faster and more responsive navigation.
      * Incorporation of the Status Report into the results panel in a new tab, always accessible.
      * Export of all simulation results to a structured CSV file.
      * New option to display various statistics on the results throughout the entire simulation period.
      * New window to display the time-series curve for any parameter of an element throughout the simulation period. Option to overlay multiple curves for the same or different parameters.
      * Improvements to the Demand Builder for point demands. Revision of algorithms and automatic loading of links. New theme for demand points.
      * Revision of the tool for identifying hydraulic sectors and detecting isolated consumption points.
      * Revision of the algorithm for identifying blockages. Detection of isolated consumption points.
      * New project-level options to transfer demand from connections to nodes. Classification of demand by patterns.
      * Compatibility of version 0.18 with the new versions of QGIS 4.0.
      * Translation of all QGISRed dialogues, panels, messages and layer names into Spanish.
      * Redesign of all icons managed by QGISRed with a more uniform and appealing appearance.
      * Web hosting of the provisional QGISRed manual in English and Spanish for online consultation via the collaborative platform GitBook.
      * Acknowledgement to the Inter-American Development Bank (IDB) for its financial support for all the improvements made in this version 0.18.
      * Resolved an issue when loading field data related to the decimal separator.
      * Fixed a bug that prevented the cancellation of requests for areas that remain isolated.
      * Limit on the size of the ‘Description’ field, used to provide information on the load demands on each node.





# Tags are comma separated with spaces allowed
tags=Hydraulic models, Water Distribution Networks, EPANET, GISRed, Detailed Model, Digital Twins

category=Plugins
icon=images/qgisred.svg
# experimental flag
experimental=False

# deprecated flag (applies to the whole plugin, not just a single version)
deprecated=False

# Since QGIS 3.8, a comma separated list of plugins to be installed
# (or upgraded) can be specified.
# Check the documentation for more information.
# plugin_dependencies=.Net Framework==4.5,GISRed

Category of the plugin: Raster, Vector, Database or Web
# category=

# If the plugin can run on QGIS Server.
server=False