hydRopUrban: Un paquete en R para el diseño hidrologico urbano preliminar

[es] [en] [fr]

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

1. ¿Qué es hydRopUrban?

hydRopUrban es un paquete en R para el diseño hidrologico preliminar de infraestructura de drenaje urbano. hydRopUrban busca ayudar a usuarios no expertos en R en la automatizacion de calculos en hidrologia urbana.

2. ¿Para qué sirve hydRopUrban?
Siete funciones principales se encuentran implementados en hydRopUrban. Sus aplicaciones cubren los temas de la hidrologia urbana empirica y determinista basado en teoria de amplio uso.

Las funciones principales son:

• rational(): Estimación del hidrograma de descarga por el método racional estandar con un hidrograma triangular con una recesion de 1xTc, siendo Tc el tiempo de concentracion. (Mulvany, 1851; Kuichling, 1889), por el  método racional modificado con un hidrograma triangular con una recesion de 1.5xTc y considerando la duracion de la tormenta (Poertner, 1974; Smith y Lee, 1984) y por el método racional universal con un hidrograma sintético para zonas urbanas (ASCE, 1996).

• caquot(): Estimación de la descarga maxima para unidades de drenaje en serie y en paraleo y valores equivalentes para la unidad de drenaje resultante (Caquot, 1941).

• routing(): Estimación de la descarga de salida resultante de un transito del hidrograma a través de un conducto a flujo abierto por el método de Muskingum-Cunge (USACE, 1991). Estimación de la descarga de salida resultante de un transito del hidrograma a través de un canal ancho abierto por el método Convexo (USDA-SCS, 1965).

• pollutant(): Estimación de polutogramas, descarga y concentracion del contaminante por remoción en superficies impermeables (Akan y Houghtalen, 2003). Estimación de polutogramas por remoción en superficies permeables (Huber y Dickinson, 1988).

• idf(): Estimación de la curva IDF a partir de tormentas SCS (USDA-SCS, 1986).

• lagtime(): Estimación de los tiempos de retardo y de concentracion en una cuenca mediante 18 métodos empiricos (Gericke et al, 2014).

• scheme(): Esquema de la cuenca de drenaje por el metodo racional y flujo uniforme en canales abiertos.

3. ¿Cómo instalar hydRopUrban?

El paquete hydRopUrban debe instalarse desde el repositorio Github de hydrocodes, siguiendo los siguientes 2 pasos.

Paso 1: En RStudio, instale el paquete remotes desde CRAN. En el menu Tools - Install Packages.

Paso 2: En la consola de RStudio o en vuestro script de trabajo, escriba:
remotes::install_github ("hydrocodes/hydRopUrban")

Durante la instalación, verifique la consola R y omita otras actualizaciones.

¡Eso es todo! Finalmente, no olvide llamar al paquete en su script.
Ejemplo: usando la funcion 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:/')

Por favor, ver la carpeta "tutorial" del repositorio Github, el cual contiene ejemplos de lineas de codigo "codelines.R" y mas detalles.

4. Créditos

hydRopUrban fue desarrollado por Pedro Rau y Leonardo Gutierrez. Para cualquier problema o sugerencia escribir a: pedro.rau.ing@gmail.com

5. ¿Cómo citar?

Rau, P. 2024. hydRopUrban: An R package for preliminary urban hydrological design.  Advances in Science, Technology and Innovation. Figshare. Software https://doi.org/10.6084/m9.figshare.16200702, GitHub repository: https://github.com/hydrocodes/hydRopUrban

6. Referencias:

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.