Recent Releases of River Runner
River Runner - A couple of small style/window width bug fixes
Hydrosphere - Freshwater and Hydrology
- Svelte
Published by sdl60660 almost 3 years ago

River Runner - Incorporate Mapbox Globe Projection
- Incorporates Mapbox's new globe projection and cleans up some associates issues from the change
- Some general styling/UI cleanup
Hydrosphere - Freshwater and Hydrology
- Svelte
Published by sdl60660 almost 3 years ago

River Runner - Fixing Dependency
Updating version in package.json and fixing a dependency that causes deploy build issues
Hydrosphere - Freshwater and Hydrology
- Svelte
Published by sdl60660 about 3 years ago

River Runner - Updated Mapbox style
- Updated mapbox style to new custom style that incorporates city labels and 3D buildings (at high zoom)
- Automatically incorporates topo layer without having to load it in coade
Hydrosphere - Freshwater and Hydrology
- Svelte
Published by sdl60660 about 3 years ago

River Runner - Fixed path length issue
Fixed an issue with path lengths displaying as 0km on very short (one flowline) paths. It was due to an off-by-one error from my own misinterpretation of one of the flowline properties, which gave the length remaining in the path from the end of a flowline, rather than the beginning. This meant that for some short (~5km), single flowline paths, the total length was being interpreted as 0km instead of 5km. In other cases, the total length was off by the length of the first flowline.
This release also adds several river/stopping feature names.
Hydrosphere - Freshwater and Hydrology
- Svelte
Published by sdl60660 over 3 years ago

River Runner - Minor UI Fixes/River and Stopping Feature Names Added
- Have incorporated a number of suggested feature names
- Corrected some stopping feature names/added a little to the dataset
- Incorporated some UI fixes (allowing escape key to abort autoplay/exit run, some layout fixes for shorter windows, etc)
Hydrosphere - Freshwater and Hydrology
- Svelte
Published by sdl60660 over 3 years ago

River Runner - Small modal CSS fixes, incorporating some name suggestions, fixing some stopping features
Hydrosphere - Freshwater and Hydrology
- Svelte
Published by sdl60660 over 3 years ago

River Runner - Small, Post-Public Release Fixes
- Fixed some typos and some feature names
- Added full source URL to name suggestions to make it easier to vet
- Merged
global
branch intomain
Hydrosphere - Freshwater and Hydrology
- Svelte
Published by sdl60660 over 3 years ago

River Runner - Global Paths
Changes
This incorporates the new MERIT River Runner API for generating global flowpaths (more information here).
Additionally, addresses a whole host of issues associated with expanding globally, given that there were a lot of assumptions made in building the US-only version that do not hold here. A partial list is documented here:
Some features of notes besides geographic expansion:
- Fixes the clipped beginnings/ends of paths that came about as a result of path smoothing
- Expands stopping feature list significantly, particularly for ocean features, and incorporates inland lakes into navigation path
- Adds a modal for suggesting names when missing (name data coverage is lacking significantly on non-US paths, relatively)
- Fixes disjointedness from flight to path start by accurately gathering terrain-exaggeration-adjusted elevation data prior to run start
Issues of Concern
Note: due to some lingering issues, this version is considered in beta and will not yet be merged into main. It will also exist on a separate URL, here: https://river-runner-global.samlearner.com/, while the original US-only version persists on the original URL, here: https://river-runner.samlearner.com/. Some of these issues will be addressed in the front-end in this repo, others are issues being addressed in the underlying data/API. A few of these issues are notably worse in the global app than in the US-only app, for US flowpaths, which is part of the rationale of maintaining both, for the time being.
A partial list of issues being addressed:
- Incomplete feature name coverage, particularly outside of the United States
- Issues with over-grouping on feature names for paths that run through large inland lakes (many of these are documented here: https://github.com/ksonda/global-river-runner/issues/25)
- Paths may not reflect true river paths when affected by engineered features such as dams, canals, and conduits (the Chicago Sanitary and Ship Canal is a notable example of this)
- The current Mercator projection is not ideal for the global view. Currently, it's the only available Mapbox GL projection suitable for this application, but that is due to change soon with a release of a 3D globe view. When this feature is ready from Mapbox, it will be incorporated into the app.
Full Changelog: https://github.com/sdl60660/river-runner/compare/v1.6.2...v2.0.0
Hydrosphere - Freshwater and Hydrology
- Svelte
Published by sdl60660 over 3 years ago

River Runner - Made some mobile fixes and added Delaware Bay stopping feature
Hydrosphere - Freshwater and Hydrology
- Svelte
Published by sdl60660 over 3 years ago

River Runner - Added (disabled) advanced features
Added some optional advanced features, such as a flowlevel gauge that have been disabled by default, to eventually work into the project in an options box UI item. Many of theses significantly slow down the app, so will need to be implemented carefully. Some other small changes that smooth elevation sampling and the transition between flyTo and the river run, as well as broadly re-factoring a lot of the code that was in Map.svelte
Hydrosphere - Freshwater and Hydrology
- Svelte
Published by sdl60660 over 3 years ago

River Runner - Added start timer
Added a start timer for the run that will allow users to pause and sit in overview mode if they'd like, or automatically start the run after five seconds. A lot of people had requested that it not go straight into the run, but I needed a way to balance this with people who may not be familiar with the site/know to hit a play button, so this was the compromise I landed on.
Hydrosphere - Freshwater and Hydrology
- Svelte
Published by sdl60660 almost 4 years ago

River Runner - Using new tile elevation queries/fixed Chesapeake Bay bug/inland feature false positives
Incorpoorated new Mapbox v2.3 map elevation queries to save a lot of API calls/complexity on elevation sampling. This new function also accounts for terrain elevation, which made the true camera elevation calculation much more straightforward. When jumping from a finished run with a zoomed point to a new run, the tile elevation query often fails, so it will fall back on the old method of elevation API calls/more complex camera elevation calculation. Also fixed a bug in determining Chesapeake Bay as a stopping feature and greatly reduced the threshold for a found inland stopping feature from 100km to 10km after hearing multiple complaints of false positives (may need to keep tinkering with this/adjust it later).
Hydrosphere - Freshwater and Hydrology
- Svelte
Published by sdl60660 almost 4 years ago

River Runner - Added explicit zoom buttons to desktop version
Added explicit zoom buttons to desktop version and fixed some small styling/usability issues
Hydrosphere - Freshwater and Hydrology
- Svelte
Published by sdl60660 almost 4 years ago

River Runner - Fixed SF Bay stopping feature
Ocean vector data wasn't capturing San Francisco Bay and it was causing weird stopping feature issues in that drainage area. Added a separate SF Bay polygon and some conditional logic to capture it if the ending point is around there.
Hydrosphere - Freshwater and Hydrology
- Svelte
Published by sdl60660 almost 4 years ago

River Runner - Fixed a styling and camera elevation bug
Replaced the zeroed out final elevation coordinate with the final known elevation coordinate. On short paths that don't end at sea-level/the ocean, this was causing really weird camera behavior and there's not much downside to just using the second to last point. It may think the camera should be at like 50ft above sea level when it should be at 0, but that shouldn't visibly affect things much.
Hydrosphere - Freshwater and Hydrology
- Svelte
Published by sdl60660 almost 4 years ago

River Runner - Fixed Chesapeake Bay bounding box bug
Forgot to add a west latitude bound on bounding box for Chesapeake bay stopping feature, so it was incorrectly identifying some west coast ocean area as the Chesapeake Bay
Hydrosphere - Freshwater and Hydrology
- Svelte
Published by sdl60660 almost 4 years ago

River Runner - Mobile map sizing/path calculation error fixes
Fixed a few bugs with path calculations due to a property name I had forgotten to switch from a name to ID, and occasional unexpected errors in querying elevations. Also fixed the dimensions of the map on mobile so that the footer isn't covering up the OSM attribution and the very bottom of the map isn't cut off.
Hydrosphere - Freshwater and Hydrology
- Svelte
Published by sdl60660 almost 4 years ago

River Runner - Flight Overview/Path Sharing
Added an "overview" at the end of a flight path (or on abort) that allows a user to replay, share a path link, or exit, and also to explore the path with navigation controls while it's still displayed. On desktop, a user can also highlight over one of the navigation box features and the section of the flowpath will highlight yellow. Also added functionality to receive a URL with lat/lng URL parameters and jump into the navigation so that it can handled the shared paths.
Hydrosphere - Freshwater and Hydrology
- Svelte
Published by sdl60660 almost 4 years ago

River Runner - Full Playback Controls
Added rewind/fast-forward controls and added progress points/full playback controls for mobile (with skips). Also made some layout changes for tablets and fixed some persistent feature group bugs.
Hydrosphere - Freshwater and Hydrology
- Svelte
Published by sdl60660 almost 4 years ago

River Runner - Playback Control
Adding in first, basic control features, allowing a user to pause/play and to tinker with the speed/zoom.
I'm still constraining the relationship between camera altitude and speed here, which I'm sure will not make everyone happy, but (at least for now), I want to play it safe and not allow a user to push the controls into places that will induce nausea. If I provide both zoom and speed controls separately, the majority of combinations would be either unusably slow or nausea-inducing fast with very few sweet spots in between (and even more so if I allow control over pitch). By doing it this way, I'm limiting the user's ability to make (mostly) bad speed/zoom selections.
I've also fixed some issues that arose from the more variable camera pitch and re-worked the way that the camera path is calculated from the target path. To have variable speed/zoom, you also have to have variable path smoothing, with a smoother path at lower zoom levels and a more exact path at higher zoom levels, so the path had to be recalculated on zoom/speed change.
Finally, I've fixed a few lingering bugs that were mostly rare or difficult to notice (for example, there were some issues under the hood with feature grouping that may have been difficult to spot unless you were very familiar with a section of a river path).
There are probably more control features to come, including an ability to move in reverse and maybe an ability to pick an exact spot in the flowpath. There are also a lot of related features on the horizon, like start/exit buttons at the beginning and end of navigation to allow users to inspect the path pre/post-flight and an ability to view upstream paths.
Hydrosphere - Freshwater and Hydrology
- Svelte
Published by sdl60660 almost 4 years ago

River Runner - Initial Release
This is the project as it originally went public before gathering a lot of feedback from users. I'll work on incorporating feature requests over the next couple of weeks and release a new version.
Hydrosphere - Freshwater and Hydrology
- Svelte
Published by sdl60660 almost 4 years ago
