more downstreamtrace doc edits

Author: smnorris

Diff for: docs/04_functions.md

@@ -132,9 +132,9 @@ FWA_DownstreamTrace(
 
 ### Description
 
-Return data from streams_vw downstream of provided location.
+Return all data from [`whse_basemapping.streams_vw`](https://smnorris.github.io/fwapg/03_tables_views.html#whse-basemapping-fwa-streams-vw) downstream of provided location.
 
-Provides a simple interface to the basic use case of `FWA_Downstream()`, removing the need to work joins or watershed codes.
+Provides a simpler interface to the basic use case of `FWA_Downstream()`, removing the need to use joins or watershed codes.
 
 Notes:
 - this is a draft function that has not been extensively optimized/tested, performance may suffer when working with major rivers
@@ -144,46 +144,46 @@ Notes:
 
 Return stream data downstream of Sheilds Lake:
 
-
   ```sql
   SELECT
     blue_line_key,
     downstream_route_measure,
     stream_order_parent,
-    channel_width
+    channel_width,
+    geom
   FROM
     FWA_DownstreamTrace(354146454, 3150)
   ```
   ```
-   blue_line_key | downstream_route_measure | stream_order_parent | channel_width
-  ---------------+--------------------------+---------------------+---------------
-       354146454 |         3127.20524239473 |                   3 |
-       354146454 |         2965.37071386052 |                   3 |
-       354146454 |         2842.60982622329 |                   3 |
-       354146454 |         2679.16744750456 |                   3 |
-       354146454 |         2629.74618714613 |                   3 |
-       354146454 |         2609.65517389417 |                   3 |          2.15
-       354146454 |         2502.91937533387 |                   3 |          2.15
-       354146454 |         2394.95066476193 |                   3 |          2.15
-       354146454 |         2352.13213028193 |                   3 |          2.15
-       354146454 |         2240.02438811748 |                   3 |          2.15
-       354146454 |         2169.25535011117 |                   3 |          2.15
-       354146454 |         2138.31957468439 |                   3 |          2.62
-       354146454 |         2025.39804344686 |                   3 |          2.91
-       354146454 |         1992.73137196029 |                   3 |          2.91
-       354146454 |          1847.8788247426 |                   3 |          2.91
-       354146454 |         960.782490852403 |                   3 |          2.91
-       354146454 |         660.760737217136 |                   3 |          3.17
-       354146454 |                        0 |                   3 |          3.46
-       354148774 |          3059.9040521127 |                   5 |          5.94
-       354148774 |         2744.26659482523 |                   5 |          6.04
-       354148774 |         1431.17077828375 |                   5 |          6.28
-       354148774 |         1376.10785016488 |                   5 |           6.6
-       354148774 |         1243.32075546327 |                   5 |           6.6
-       354148774 |         710.353826210263 |                   5 |           6.6
-       354148774 |         15.1842503508841 |                   5 |           8.5
-       354148774 |                        0 |                   5 |           8.5
-       354153927 |         4568.48427688637 |                     |         32.26
+   blue_line_key | downstream_route_measure | stream_order_parent | channel_width | geom
+  ---------------+--------------------------+---------------------+---------------+------
+       354146454 |         3127.20524239473 |                   3 |               |
+       354146454 |         2965.37071386052 |                   3 |               |
+       354146454 |         2842.60982622329 |                   3 |               |
+       354146454 |         2679.16744750456 |                   3 |               |
+       354146454 |         2629.74618714613 |                   3 |               |
+       354146454 |         2609.65517389417 |                   3 |          2.15 |
+       354146454 |         2502.91937533387 |                   3 |          2.15 |
+       354146454 |         2394.95066476193 |                   3 |          2.15 |
+       354146454 |         2352.13213028193 |                   3 |          2.15 |
+       354146454 |         2240.02438811748 |                   3 |          2.15 |
+       354146454 |         2169.25535011117 |                   3 |          2.15 |
+       354146454 |         2138.31957468439 |                   3 |          2.62 |
+       354146454 |         2025.39804344686 |                   3 |          2.91 |
+       354146454 |         1992.73137196029 |                   3 |          2.91 |
+       354146454 |          1847.8788247426 |                   3 |          2.91 |
+       354146454 |         960.782490852403 |                   3 |          2.91 |
+       354146454 |         660.760737217136 |                   3 |          3.17 |
+       354146454 |                        0 |                   3 |          3.46 |
+       354148774 |          3059.9040521127 |                   5 |          5.94 |
+       354148774 |         2744.26659482523 |                   5 |          6.04 |
+       354148774 |         1431.17077828375 |                   5 |          6.28 |
+       354148774 |         1376.10785016488 |                   5 |           6.6 |
+       354148774 |         1243.32075546327 |                   5 |           6.6 |
+       354148774 |         710.353826210263 |                   5 |           6.6 |
+       354148774 |         15.1842503508841 |                   5 |           8.5 |
+       354148774 |                        0 |                   5 |           8.5 |
+       354153927 |         4568.48427688637 |                     |         32.26 |
        ...
   ```