hydRopUrban: Un package sur R pour la conception hydrologique urbaine préliminaire

[es] [en] [fr]

Traduit de https://github.com/hydrocodes/hydRopUrban/blob/main/README.md

1. C'est quoi hydRopUrban?

hydRopUrban est un package sur R pour la conception hydrologique préliminaire d'infrastructure de drainage urbain. hydRopUrban vise à aider l'utilisation de R dans l'automatisation de calculs en hydrologie urbaine. 

2. A quoi sert hydRopUrban?

Six fonctions principales sont implémentées dans hydRopUrban. Ses applications couvrent les sujets de l'hydrologie urbaine empirique et déterministe basé sur une théorie largement utilisé.

Les principales fonctions sont:

• rational(): Estimation de l'hydrogramme de débit avec la méthode rationnelle standard en considérant l'hydrogramme triangulaire avec une récession 1xTc, où Tc est le temps de concentration (Mulvany, 1851; Kuichling, 1889); par la méthode rationnelle modifiée en considérant l'hydrogramme triangulaire avec une récession 1.5xTc et la durée de l’événement de tempête (Poertner, 1974; Smith et Lee, 1984) et par la méthode rationnelle universelle en considérant une hydrogramme synthétique pour des zones urbaines (ASCE, 1996).

• caquot(): Estimation du débit maximal et de l'unité de drainage équivalente pour des unités de drainage en série et en parallèle par la méthode de Caquot (Caquot, 1941).

• routing(): Estimation de l'hydrogramme de sortie depuis un routage de l'hydrogramme entrante à travers d'un conduit à écoulement ouvert par la méthode de Muskingum-Cunge (USACE, 1991). Estimation de l'hydrogramme de sortie depuis un routage de l'hydrogramme entrante à travers d'un canal d'un largeur considérable par la méthode Convexe (USDA-SCS, 1965).  

• pollutant(): Estimation des pollutogrammes des contaminants sur des surfaces imperméables (Akan et Houghtalen, 2003). Estimation des pollutogrammes des contaminants sur des surfaces perméables (Huber et Dickinson, 1988).

• idf(): Estimation de la courbe IDF à partir des précipitations SCS (USDA-SCS, 1986).

• lagtime(): Estimation des temps de retard et de concentration sur des bassins avec 18 méthodes empiriques (Gericke et al, 2014).  
  
  

3. Comment installer hydRopUrban?

Le package hydRopUrban doit être installé à partir du référentiel hydrocodes dans Github, en suivant les 2 étapes suivantes.

Étape 1: Dans RStudio, installez le package devtools à partir de CRAN

Étape 2: Dans la console RStudio ou dans votre script de travail, saisissez
devtools::install_github ("hydrocodes/hydRopUrban")

Pendant l'installation, vérifiez la console R et ignorez les autres mises à jour.

C'est tout! Enfin, n'oubliez pas d'appeler le package dans votre script.

Exemple: En utilisant la fonction rational():

library(hydRopUrban)

rational(crunoff = 0.8, intensity = 1.7, area = 0.512, time.con = 0.91, delta.time = 0.05, duration =  2, method = 'modified', path = 'C:/')

SVP, regardez le dossier "tutorial" dans le référentiel Github, qui contient d'exemples de lignes de codes "codelines.R" et plus de détails.

4. Crédits

hydRopUrban a été développé par Pedro Rau et Leonardo Gutierrez. Pour tout problème ou suggestion écrivez à: pedro.rau.ing@gmail.com

5. Versions

v 1.0 - 18 nov, 2022

v 1.0 - 11 août, 2021

6. Comment citer?

Rau, P. 2021. hydRopUrban: An R package for preliminary urban hydrological design. figshare. Software https://doi.org/10.6084/m9.figshare.16200702, GitHub repository: https://github.com/hydrocodes/hydRopUrban

7. Références

Akan, A.O., Houghtalen, R.J. (2003). Urban hydrology, hydraulics and stormwater quality. John Wiley & Sons.

ASCE (1996). Hydrology Handbook. ASCE Manual of Practice No. 28. New York, NY.

Caquot, A. (1941). Sur la quantite des eaux pluviales à écouler dans les agglomerations urbaines modernes. Comptes Rendus hebdomadaires des Séances de l’Académie des Sciences, 213(16), 509–515.

Gericke, O., Smithers J. (2014). Review of methods used to estimate catchment response time for the purpose of peak discharge estimation. 59(11):1935-1971.

Huber, W.C., Dickinson, R.E. (1988). Stormwater Management Model. User’s Manual, Environmental Research Laboratory, EPA, USA.

Kuichling, E. (1889). The relation between the rainfall and the discharge of sewers in populous districts, Trans., ASCE, Vol. 20, pp. 1-60.

Mulvany, T.J. (1851). On the use of self-registering rain and flood gauges in making observations of the relations of rain fall and of flood discharges in a given catchment, Proceedings of Institution of Civil Engineers of Ireland, 4, 18-33.

Poertner, H.G. (1974). Practices in Detention of Urban Stormwater Runoff. APWA Special Report No. 43. Washington, D. C.: American Public Works Association.

Smith, A.A., Lee, K. (1984). The rational method revisited. Canadian Journal of Civil Engineering11(4): 854–862.

USACE (1991). A Muskingum-Cunge channel flow routing method for drainage networks. TP-135.

USDA-SCS (1986). Urban hydrology for small watersheds, tech release No 55.

USDA-SCS (1965). TR-20, Computer program for project formulation-Hydrology, Washington DC.