Metadata-Version: 2.1
Name: GRLP
Version: 1.5.0
Summary: Evolves gravel-bed river long profiles
Home-page: https://github.com/awickert/GRLP
Author: Andrew D. Wickert
Author-email: awickert@umn.edu
License: UNKNOWN
Project-URL: Model page, https://csdms.colorado.edu/wiki/Model:GRLP
Description: [![DOI](https://zenodo.org/badge/159710833.svg)](https://zenodo.org/badge/latestdoi/159710833)
        
        # gravel-river-long-profile
        Long-profile evolution of gravel-bed rivers
        
        `grlp.py` is module that contains the equations and solvers. `run_grlp.py` interfaces with these to, well, run a model based off of `grlp.py`. Comments inside `run_grlp.py` should help you learn how to write your own models. Please contact Andy Wickert for questions or assistance.
        
        
        When you use **grlp**, please cite:
        
        **Wickert, A. D. and T. F. Schildgen (2019), [Long-Profile Evolution of Transport-Limited Gravel-Bed Rivers](https://www.earth-surf-dynam.net/7/17/2019/esurf-7-17-2019.html), *Earth Surf. Dynam.*, *7*, 17–43, doi:10.5194/esurf-7-17-2019.**
        
        ## Installation
        
        ### Via pip and PyPI
        
        Releases will be sent to [PyPI](https://pypi.org/project/GRLP/).
        
        To download and install the release version within your python system, use:
        
        ```
        # Python 2
        pip2 install grlp # Python 2; deprecated :(
        
        # Python 3 (implicit, assuming your packages are updated)
        pip install grlp
        
        # Python 3 (explicit)
        pip3 install grlp
        ```
        
        ### Locally with pip and incorporating ongoing code modifications
        
        To install the unreleased code from this repository and/or to make changes to it locally and have this reflected immediately in how GRLP runs:
        
        ```
        # Download the repository
        gh repo clone awickert/GRLP
        
        # Install it
        # First, navigate to the root grlp directory. Then do one or both of:
        pip2 install -e . # Python 2; deprecated :(
        pip install -e . # Python 3; recommended
        pip3 install -e . # Python 3; command to explicitly use this version
        ```
        
        Of course, you may always just download the `grlp` source from here and run it as a local (rather than system-wide installed) module. But this can be inconvenient when needing to manage the directory of `grlp.py` relative to that of the driver `*.py` file that you are building to create your model run.
        
        ## Learning how to use GRLP
        
        ### 1-D river long profile
        
        For a tutorial run the [Jupyter notebook contained within this package](https://github.com/awickert/GRLP/blob/master/example_1d.ipynb). After installing Jupyter on your local machine, navigate to this directory in the terminal and type:
        ```
        jupyter notebook
        ```
        to launch it. Alternatively, a number of cloud-based services can help to host Jupyter notebooks.
        
        ### Network of 1-D river long profiles
        
        * A [complete example](examples/run_network_5_segments_2020.py) for a river network, with plotting and descriptions
        * An [example to set up synthetic river networks](https://github.com/awickert/GRLP/blob/master/examples/network_examples/network_examples.py
        
Keywords: fluvial geomorphology sediment transport landscape evolution
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Operating System :: OS Independent
Classifier: Topic :: Scientific/Engineering :: Hydrology
Classifier: Intended Audience :: Science/Research
Description-Content-Type: text/markdown
