runcof

Description

runcof is a command line tool to calculate the runoff coefficient for watersheds that have different land use and soil type using the methodology from Mexican norm NOM-011-CONAGUA-2015. The watershed is divided in homogenous zones to get a coefficient of each one.

Features

A program to calculate the runoff coefficient:

  • Standard method (NOM-011-CONAGUA-2015)
  • Command line tool
  • Source code in Python 2.7
  • Multiplatform

Usage

Command line options

The program require some options:

  1. -a: to input a blank space delimited list of areas in hectares
  2. -l: to input a blank space delimited list of land uses (view help)
  3. -s: to input a blank space delimited list of soil types (view help)
  4. -p: to input the precipitation in millimeters

Using the executable on Windows:

  1. Download and extract the zip file.
  2. Open a System Prompt or a Power Shell
  3. Go to the extracted directory using the command cd. In the figure the commands are used to go into the directory Desktop > runcof:
    cd Desktop
    cd runcof

  4. Check that the program works properly by showing the help:
  5. Execute the program. The command for the example in the figure is:
     > runcof.exe -a 10 20 30 -l 13 7 8 -s 0 1 0 -p 800 -v

  6. The results should be like this:
    AREA - 0
      Area: 10.000
      Land use: Grassland
      Soil type: Permeable soil
      K parameter: 0.180
    AREA - 1
      Area: 20.000
      Land use: Forest (75%)
      Soil type: Medium permeability
      K parameter: 0.160
    AREA - 2
      Area: 30.000
      Land use: Forest (50-75%)
      Soil type: Permeable soil
      K parameter: 0.120
    The value of the total area is: 60.000
    The value of k parameter is: 0.143
    The runoff coefficient is: 0.039

Using the Python script on Unix-Like systems (GNU/Linux, macOS):

  1. Be sure you have Python installed. To use the code you need to have Python installed in your computer. In Linux and macOS systems Python is installed by default, in Windows you need to download and install it first.
  2. Open a Terminal application. (on Windows options are System Prompt or Power Shell)
  3. Go to the directory where the runcof.py file is located. Use the command cd to do this.
  4. Check the program works properly by showing the help:
    $ python runcof.py --help

  5. Execute the program. The command for the example in the figure is:
    $ python runcof.py -a 10 20 30 -l 13 7 8 -s 0 1 0 -p 800 -v
  6. The results should be like this:
    AREA - 0
      Area: 10.000
      Land use: Grassland
      Soil type: Permeable soil
      K parameter: 0.180
    AREA - 1
      Area: 20.000
      Land use: Forest (75%)
      Soil type: Medium permeability
      K parameter: 0.160
    AREA - 2
      Area: 30.000
      Land use: Forest (50-75%)
      Soil type: Permeable soil
      K parameter: 0.120
    The value of the total area is: 60.000
    The value of k parameter is: 0.143
    The runoff coefficient is: 0.039

Downloads

Available downloads:

Windows Binaries (64 bits)

Download

Unix-like (macOS, Linux)

Source Code

License

This program is free software, you can use or redistribute it under the terms of the MIT license. Copyright (c) 2012-2017 ecoslacker <ecoslacker@irriapps.com>.