Dataset and scripts for "Revealing the Topological Drivers of Hydraulic Transients in Water Distribution Networks".
Abstract
The characteristics of all the networks considered in this study are reported in three folders: · Networks_L, that contains the networks with non-homogenous lengths; · Networks_D, that contains the networks with non-homogenous diameters; · Networks_LD, that contains the networks with non-homogenous lengths and diameters. The considered network with homogeneous lengths and diameters can be obtained easily from the networks with non-homogenous lengths and diameters. The characteristics of each network are reported in a “.mat” MATLAB data file, that is characterized by the following code-name: N_s=A N_v=B P_c=C Topology=D Hydr_char=E.mat, for example N_s=4 N_v=10 P_c=0.5 Topology=2 Hydr_char=1. The parameters are as follows: · A= Number of junctions in one side of the square lattice ( in the main paper); · B=ID of the junction where the main valve is installed (index in the main paper); · C=Probability of nodal connectivity ( in the main paper); · D=Index that spans from 1 to 3, and identifies the random realization used to determine the topology of the network; · E=Index that spans from 1 to 3, and identifies the random realization used to determine the hydraulic characteristics of the pipes. For each file, the following variables are provided: · nodal_data_M: matlab array with 5 columns and rows, where is the number of nodes in the network. The th row refers to the th junction. The first column is the ID of the junction; the second column is a representative horizontal coordinate; the third column is a representative vertical coordinate; the fourth column is the junction’s elevation: the fifth column is the opening of the orifice at that junction ( or in the main manuscript). · connections_M: matlab array with 3 columns and rows, where is the number of pipes in the network. The th row refers to the th pipe. The first column is the ID of the node at the upstream end of the pipe; the second column is the the ID of the node at the downstream end of the pipe; the third column is the the ID of the pipe. · L_c: matlab cell array that list at the th position the length of the th pipe. · D_c: matlab cell array that list at the th position the diameter of the th pipe. · a_c: matlab cell array that list at the th position the pressure surge celerity of the th pipe. In addition, the file “Main_functions.m” contains three scripts that can be used to: (i) Calculate the hydrualic metrics; (ii) Calculate the topological metrics; (iii) Implement the regression analysis.