Skip to content

Uses USGS NHDPlus data and their NLDI API to visualize the path of a rain droplet from any point in the contiguous United States to its endpoint.

License

Notifications You must be signed in to change notification settings

kklinges/river-runner

 
 

Repository files navigation

River Runner

This uses USGS NHDPlus data and their NLDI API to visualize the path of a rain droplet from any point in the contiguous United States to its end point (usually the ocean, sometimes the Great Lakes, Canada/Mexico, or another inland water feature). It'll find the closest river/stream flowline coordinate to a click/search and then animate along that flowline's downstream path.

I've used mapbox to animate the downstream path, but needed to make all sorts of adjustments for elevation and bearing changes to prevent jerkiness/nausea (just moving from point to point feels a little like flying through turbulence while shaking your head side-to-side).

I've hosted a dataset with NHDPlus Value Added Attributes on Firebase, which allows me to group flowlines into their parent features and determine distances quickly.

Examples

Here are a couple of examples of what it looks like in action.

This is a section of the path from Yellowstone National Park out to the Atlantic Ocean:

Screenshot of the river runner in progress from Yellowstone National Park to the Atlantic Ocean. Mountain features and river are visible.

Here's part of the path from Southwest Arizona down to the Mexican border:

Screenshot of the river runner in progress from Southwest Arizona to Mexican border. Mountain features, desert, and river are visible.

Running this on your own

If you'd like to run this locally and play around with it, just run the following commands in your terminal (assuming you have npm installed):

  1. git clone https://github.com/sdl60660/river-runner.git
  2. cd river-runner
  3. npm install
  4. npm run dev (then follow the link to the local server, probably http://localhost:5000).

About

Uses USGS NHDPlus data and their NLDI API to visualize the path of a rain droplet from any point in the contiguous United States to its endpoint.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Svelte 77.5%
  • JavaScript 12.3%
  • Python 5.9%
  • HTML 2.8%
  • CSS 1.5%