SPARROW Eastern United States Nutrient Loading

SPARROW is a modeling tool for the regional interpretation of water-quality monitoring data. The model relates in-stream water-quality measurements to spatially referenced characteristics of watersheds, including contaminant sources and factors influencing terrestrial and aquatic transport. SPARROW empirically estimates the origin and fate of contaminants in river networks and quantifies uncertainties in model predictions. This application provides a flexible viewer to visualise SPARROW watershed models. For more information about Sparrow visit: http://onlinelibrary.wiley.com/doi/10.1111/j.1752-1688.2011.00574.x/pdf

Prerequisites

This project is based on the USGS WiM Generator template for ESRI Javascript API web map applications. To work with the code you will need the following software:

• Node Package Manager
• Git

npm install

Getting Started

These instructions will get you a copy of the project up and running on your local machine for development and testing purposes. See deployment for notes on how to deploy the project on a live system.

Installing

To begin clone the repository from Github to your development machine.

git clone https://github.com/USGS-WiM/sparrow-eastern-us-js.git

Change to the new newly created directory

cd sparrow-eastern-us-js

Install dependencies using NPM

npm install

Building and testing

The application uses Gulp as a build system. You may need to install Gulp on your development machine.

 npm install -g gulp 

To view and test the application locally run the 'gulp watch' command. A new browser window will open with a running version of the application.

 gulp watch

To create a build run:

 gulp build

Built With

• jQuery - The main library used
• ESRI Javascript API - Mapping API
• Font Awesome - Scalable vector icons
• NPM - Dependency Management
• Tablesorter - HTML table sorting
• HighCharts - Interactive charting
• Lobipanel - jQuery plugin for bootstrap panels.
• Bootstrap Select - jQuery plugin to bring additional functionality to standard select elements.

Contributing

Please read CONTRIBUTING.md for details on the process for submitting pull requests to us. Please read CODE_OF_CONDUCT.md for details on adhering by the USGS Code of Scientific Conduct.

Updating the Application

Please read UPDATING_SPARROW.md for a checklist and description of how to add a new SPARROW model dataset or modify the application's configuration file.

Versioning

We use SemVer for versioning. For the versions available, see the tags on this repository.

Advance the version when adding features, fixing bugs or making minor enhancement. Follow semver principles. To add tag in git, type git tag v{major}.{minor}.{patch}. Example: git tag v2.0.5

To push tags to remote origin: git push origin --tags

*Note that your alias for the remote origin may differ.

Authors

• Erik Myers - Lead Developer - USGS Web Informatics & Mapping

See also the list of contributors who participated in this project.

License

This project is licensed under the Creative Commons CC0 1.0 Universal License - see the LICENSE.md file for details

Suggested Citation

In the spirit of open source, please cite any re-use of the source code stored in this repository. Below is the suggested citation:

This project contains code produced by the Web Informatics and Mapping (WIM) team at the United States Geological Survey (USGS). As a work of the United States Government, this project is in the public domain within the United States. https://wim.usgs.gov

About WIM

• This project authored by the USGS WIM team
• WIM is a team of developers and technologists who build and manage tools, software, web services, and databases to support USGS science and other federal government cooperators.
• WIM is a part of the Upper Midwest Water Science Center.