Learning Center

Map water flow in the owner portal

Steps 1 to 4 in the Geo-Surface™ owner portal, one click at a time: find the field, outline it, load the LiDAR and show where water flows. Then read the flow lines, ponding, depressions and contours and set up a clean map for the tablet.

Steps 1 to 4 turn a field into a water map: where it drains, where it ponds and where the low spots are. Do them before you draw routes, because the routes follow the flow.

Before you start

  • You are logged in to the portal and past the welcome window (Open the portal)
  • The Country box at the top of the left panel shows your country
  • You can click, drag and zoom with the mouse. New to it? Read Computer basics for the portal first.
  • Optional: the field boundary as a KML, KMZ or zipped shapefile on the computer (see Upload an outline instead)

How long it takes: about 5 minutes for a quarter section.

Steps 1 to 4, click by click

Step 1, Find your field. The search box is the white box at the top middle of the map. It reads Search locations in USA... in grey (in Canada, Search locations in Canada...).

Click once inside it.

The portal right after the welcome window: a satellite map of North America with a white search box at the top middle reading Search locations in USA...
  1. Search box. Top middle of the map.

Type where the field is

Type the farm's address, the nearest town, or the field's coordinates. In the picture we typed Nevada, Iowa.

Coordinates work as decimals, for example 49.177, -97.953, or as degrees, minutes and seconds. A longitude typed without a minus sign is read as west.

The search box at the top of the map with Nevada, Iowa typed in it
  1. What you typed. A town, an address or coordinates.

Press Enter

Press the Enter key, or click the magnifying glass at the right end of the box. The map moves to the place you typed.

If you typed coordinates, a red pin marks the spot, and step 1 shows a line starting with Showing and the coordinates.

The map moved to the town of Nevada, Iowa: farmland with square fields, the town label Nevada in the middle; the search box now reads Nevada
  1. The search box now shows the name of the place it found.
  2. The place is in the middle of the map.

Zoom in on your field

Point the mouse at your field and roll the mouse wheel away from you, a little at a time. Or click + at the top left corner of the map. To move the map, drag it. (Help: Move and zoom the map.)

Stop when the field fills most of the map, like this.

Zoomed in on one quarter section of farmland with a few dark ponding spots, roads along its bottom and right edges and a drainage ditch along the top left; plus and minus buttons at the top left corner of the map 2
  1. + and –. Zoom in and out. The mouse wheel does the same.
  2. The field fills most of the map.

Click Draw an outline

Step 2, Outline your field. In the panel down the left side, find step 2. Click its orange Draw an outline button.

A dark bar appears across the top of the map: Click each corner of your field. Click the first corner again to close the outline. Esc cancels.

The left panel with step 2, Outline your field, and its orange Draw an outline button; the field is zoomed in on the map
  1. Draw an outline. Orange button in step 2 of the left panel.

Already have the boundary as a file? Skip to Upload an outline instead.

Click the first corner

Point at one corner of your field and click once. A small blue dot marks it.

Take in all the land that drains through the route you have in mind, not just the field you farm. The LiDAR is loaded for the outline only.

Drawing an outline: a dark bar across the top of the map with the drawing instructions and a Cancel button; a small blue dot at the top left corner of the field
  1. First corner. A small blue dot.
  2. Cancel. Right end of the dark bar. Stops drawing, the same as the Esc key.

Click the other corners

Click each of the other corners in turn, going round the field. A blue line joins the dots.

Clicked in the wrong place? Click Cancel on the dark bar (or press Esc), then click Draw an outline and start again.

Three corners clicked: a blue line runs along the top edge and down the right edge of the field, with a shaded triangle inside
  1. The latest corner. Each click adds a corner and a side.

Click the first corner again

After the last corner, point at the first blue dot and click it once. That closes the outline. A double-click on the last corner closes it too.

The outline turns orange-red and the map zooms to fit it.

All four sides of the field drawn in blue, the pointer back on the first corner at the top left
  1. The first corner. Click it to close the outline.

Check the outline

Step 2 folds down to one line with a green tick: Outline · 137.9 ac (your field's acres). The yellow line now reads Get the LiDAR for your outline.

The field outlined in orange-red and filling the map; in the left panel, Field found and Outline · 137.9 ac with green ticks, the yellow line reading Get the LiDAR for your outline, and step 3 Get LiDAR open
  1. Outline · 137.9 ac. Step 2 is done. Change draws it again.
  2. The yellow line. The next thing to do.

Click Get LiDAR

Step 3, Get LiDAR. Step 3 is now open under the folded lines. Click its orange Get LiDAR button.

A window opens in the middle of the screen called Choose elevation resolution.

Step 3 Get LiDAR open in the left panel with its orange Get LiDAR button; the outlined field on the map
  1. Get LiDAR. Orange button in step 3.

The window lists four levels of detail: 1 m, 2 m, 3 m and 5 m. The one that suits your outline has a green Recommended tag, and its round dot is already filled in. Leave it.

For a field up to about a section that is 1 m. A bigger outline gets a coarser recommendation, because each load is limited to 3,000 cells on its longest side (about 1.9 mi at 1 m). Coarser loads faster with less detail.

Choose elevation resolution window: four choices, 1 m with a green Recommended tag and its dot filled in, then 2 m, 3 m and 5 m; a note about the 3,000-cell limit; Cancel and Fetch buttons
  1. 1 m, Recommended. Already picked. Leave it.

Click Fetch

Click the blue Fetch button in the bottom right corner of the window. (Cancel closes the window without loading anything.)

The same window with the blue Fetch button in its bottom right corner
  1. Fetch. Starts loading the LiDAR.

Wait for the LiDAR

A window with a turning circle shows the LiDAR coming in. Elapsed counts the seconds. A quarter section takes a few seconds; a large field a minute or two.

That is the government elevation server working, not a freeze. Leave the window alone; it closes by itself.

LiDAR loading window: a turning circle, Reading USGS 3DEP 1 m LiDAR tiles directly from the USGS cloud archive, a progress bar, Elapsed: 2s, a note that large fields can take a minute or two, and a red Cancel button
  1. Elapsed. Counts up while the LiDAR loads.

Check the LiDAR loaded

The field turns to colours: purple is the low ground, yellow the high. A legend at the top right gives the heights in feet. A purple 3D View button appears at the bottom right.

Step 3 folds to LiDAR · 1 m. Click its Change to see which LiDAR project it came from, for example LiDAR · 1 m · IA NorthCentral 2020.

LiDAR loaded: the outlined field in elevation colours from purple (low) to yellow (high), an Elevation (ft) legend at the top right, a 3D View button at the bottom right; the left panel shows LiDAR · 1 m with a green tick and step 4 Show water flow open
  1. LiDAR · 1 m. Step 3 is done, at 1 m detail.
  2. Elevation (ft). Yellow is high, purple is low.

Click Show water flow

Step 4, Show water flow. Step 4 is now open. Click its orange Show water flow button. There is nothing to set first.

Step 4 Show water flow open in the left panel with its orange Show water flow button
  1. Show water flow. Orange button in step 4.

Wait 5 to 30 seconds

A window called Showing where water flows counts up to 100 %. The work happens on your computer. It usually takes 5 to 30 seconds.

Cancel stops it. You can run it again, or go on and draw routes.

Showing where water flows window: Tracing where water flows…, a progress bar at 25 %, Elapsed 0s, Typical 5-30s, and a red Cancel button 1
  1. Cancel. Stops the run. You don't need it.

Read the result

Dark lines and coloured patches appear inside your outline. Step 4 folds to Flow lines, depressions, ponding and wetness, step 5 opens, and the yellow line reads Draw a route along the flow you want to drain.

  • Dark lines are flow lines: where surface water runs. The thicker the line, the more land drains through it.
  • Follow the thickest line to where it leaves the field. That is your outlet.
  • Red, orange and yellow patches are the Ponding Predictor: red gets wet first in a big rain, then orange, then yellow.
Water flow result over the elevation colours: dark flow lines that get thicker downstream, red and orange ponding patches, and the thickest line leaving the field at the top right corner; the left panel shows step 4 done and step 5 Plan routes open 3
  1. Step 4 done. Change runs it again.
  2. The outlet. Where the thickest flow line leaves the outline.
  3. Ponding Predictor. Red patches get wet first.

Next: Plan ditch and tile routes (step 5).

Upload an outline instead

Use this when you already have the field boundary as a file: a KML, a KMZ, or a zipped shapefile (all the shapefile's parts in one ZIP). It replaces the drawing steps.

  1. Click Upload an outline

    In step 2 of the left panel, under Draw an outline and the word OR, is a box with a dashed edge and a cloud icon: Upload an outline. Click it.

    Step 2 in the left panel: the orange Draw an outline button, the word OR, and a dashed box with a cloud icon reading Upload an outline, KML, KMZ or zipped shapefile
    1. Upload an outline. The dashed box in step 2.
  2. Pick the file

    Your computer's own window for opening files appears. Find the boundary file (it is often in Downloads or Documents, in the list on the left of that window). Double-click the file.

  3. Check the outline

    The outline appears on the map and step 2 folds to Outline · 137.9 ac (your acres). Carry on at Click Get LiDAR.

    A file with no outline in it gives That file doesn't contain a field outline. Use a KML, KMZ or zipped shapefile.

In Canada: use a quarter as your outline

In Canada, step 1 has a Find a Canadian quarter box. It finds a quarter from your land description and can make it your outline, so you skip drawing.

  1. Pick the quarter

    Click the Quarter box and pick NE, NW, SE or SW from the list.

  2. Type the section, township and range

    Click in Section and type the number. Do the same for Township and Range.

  3. Check the meridian

    Meridian starts on W1 (west of Principal), which is most Manitoba land. For land elsewhere, click the box and pick E1 or W2 to W6.

  4. Click Find quarter

    A red square marks the quarter on the map, and a line under the button reads, for example, NW-32-2-4-W1 found. Where LiDAR exists, the map turns to grey shaded relief after a few seconds.

  5. Click Use this quarter as my outline

    The square becomes your outline and step 2 folds to Outline · 162.3 ac (that quarter's acres). Carry on at Click Get LiDAR.

    Find a Canadian quarter box filled in: Quarter NW, Section 32, Township 2, Range 4, Meridian W1 (west of Principal), the Find quarter button, the message NW-32-2-4-W1 found, and the orange Use this quarter as my outline button 1 2 3 4 5
    1. Quarter and Section.
    2. Township and Range.
    3. Meridian. W1 to start with.
    4. Find quarter. The message under it says when it's found.
    5. Use this quarter as my outline.

Is there LiDAR for my field?

Most of the United States has detailed LiDAR; Canada has it in parts. You can check before you outline.

  1. Click Show LiDAR coverage

    It's the orange button in step 1. If step 1 is folded to Field found, click its Change first to open it.

    Step 1 opened again in the left panel, with its orange Show LiDAR coverage button and the note To switch it off, pick another base layer from the layers button on the map
    1. Show LiDAR coverage. Orange button in step 1.
  2. Zoom out and look

    Roll the mouse wheel toward you to see your area. In the United States, places with published LiDAR are shaded orange; gaps keep the normal photo. In Canada, the map turns to grey shaded relief wherever LiDAR exists.

    The upper Midwest with LiDAR coverage on: almost everything shaded orange, a few green gaps without LiDAR in North Dakota and Minnesota; Iowa is fully shaded
    1. A gap. Green, unshaded patches have no detailed LiDAR.
    2. Orange shading. Detailed LiDAR is published here (all of Iowa).
  3. Put the photo back

    Click the round layers button at the bottom left corner of the map. In the Map Layers panel, roll down to Base Layer, click the box and pick Satellite Imagery. Then click the ✕ at the top right of the panel to close it. (Loading LiDAR in step 3 also puts the photo back by itself.)

    The Map Layers panel scrolled to the bottom: the Base Layer box, with Regional Flow and PLSS Overlay switches below it 1
    1. Base Layer. Pick Satellite Imagery for the photo.

Change the outline later

A new outline clears the LiDAR and the water maps, so the portal asks before it lets you draw one. Your routes stay.

  1. Click Change on the Outline line

    In the left panel, click the blue word Change at the end of the line Outline · 137.9 ac. Step 2 opens again.

    The left panel with the finished steps folded to lines with green ticks: Field found, Outline · 137.9 ac, LiDAR · 1 m, and the flow line, each ending in Change
    1. Outline · 137.9 ac · Change. Second line in the left panel.
  2. Click Draw an outline

    Click the orange Draw an outline button in step 2 (or Upload an outline to use a file). A window asks Change the outline?

    Step 2 Outline your field opened again in the left panel, with the orange Draw an outline button and the dashed Upload an outline box; Hide at the top right of the step
    1. Draw an outline. Hide, at the top right of the step, folds it again without changing anything.
  3. Click Change the outline, or Keep it

    The window says Changing the outline clears the LiDAR and the water maps. Your routes stay.

    • Change the outline (red, bottom right): draw the new outline, then run steps 3 and 4 again.
    • Keep it (grey, to its left): leaves everything as it was.
    Change the outline? window: Changing the outline clears the LiDAR and the water maps. Your routes stay. A grey Keep it button and a red Change the outline button 1 2
    1. Keep it. Nothing changes.
    2. Change the outline. Clears the LiDAR and water maps; your routes stay.

Read and tune the water map

What the map shows is set in the Map Layers panel. Changing it never reruns the water flow, so try settings freely.

  1. Click the layers button

    It's the first of the three round buttons in the bottom left corner of the map: white, with an orange icon of stacked layers. The Map Layers panel opens above it.

    The water map with three round white buttons in the bottom left corner of the map; the first has an orange stacked-layers icon
    1. Layers button. Bottom left corner of the map, first of the three.
  2. Tick or untick a layer

    Click the tick box in front of a layer's name to switch it on or off. The slider on the same line sets how see-through it is. Roll the mouse wheel over the panel to see the rest of it. Click ✕ at its top right corner to close it.

    Map Layers panel, top part: Field Boundary; HD Elevation with its colour ramp; HD Hillshade; Field Contours with Spacing set to Off and Lines White or Black; Flow Lines with the Show drains slider; Ponding Predictor with the Wet last to Wet first slider; Depressions; Wetness Index 1 2 3 4 5
    1. HD Elevation. Tick box, then the see-through slider. Under it, the colour ramp.
    2. Field Contours, Spacing. Off to start. Pick 1 or 2 ft for contour lines.
    3. Show drains ≥ N ac. Drag right to hide the small flow lines.
    4. Wet last ↔ Wet first. Drag right to see only the first spots to get wet.
    5. ✕ closes the panel.
    Map Layers panel rolled to the bottom: the analysis layers, then Base Layer set to Satellite Imagery, and the Regional Flow and PLSS Overlay tick boxes 1 2
    1. Base Layer. The background: Satellite Imagery to start.
    2. Regional Flow (public stream lines) and, in the US, PLSS Overlay (section lines).

What each layer shows:

  • Flow Lines: Where surface water runs. Lines get thicker as more area drains through them. Controls: On/off, see-through slider (75 % to start), Show drains ≥ N ac. The slider's range follows your field, from the smallest drainage area in it up to the largest, and it starts at the low end (0 ac on most fields).
  • Ponding Predictor: Where water shows first in a big rain: the bottoms of low spots first, then flat ground that a lot of the field drains onto. Red, then orange, then yellow. Controls: On/off, see-through slider, Wet last ↔ Wet first slider (move right to see only the first spots, left to see how far wet ground spreads).
  • Depressions: Hollows at least 6 in deep and 0.025 ac (1,080 ft²) across, shaded by depth: under 3 in, 3–6 in, 6–12 in, over 12 in. Off to start. Controls: On/off, see-through slider, Show under 3 in.
  • Wetness Index: Ground that tends to stay wet, from its slope and the area draining onto it. Off to start. Controls: On/off, see-through slider.
  • Field Contours: Contour lines from the LiDAR inside your outline, labelled in feet, with a count such as 85 contours (1ft). Controls: Spacing: Off, 0.1, 0.2, 0.25 ft, 6 in, 1, 2, 5, 10, 20 ft. Lines: White / Black.
  • HD Elevation / HD Hillshade: The LiDAR as colours, and as grey shaded relief. Both on to start. Controls: On/off, see-through slider; colour ramp for HD Elevation.
Depressions layer: the low spots in the field shaded in blues, darker where deeper, over the satellite photo, with the flow lines
Depressions on, shaded by depth. Use it when leveling or filling is the job.
Wetness Index layer: the whole field in bands from tan (drier) through yellow and green to dark blue (wetter) along the flow paths
Wetness Index on: dark blue stays wettest.
White contour lines every foot over the satellite photo, every fifth line thicker and labelled, such as 975.0 and 980.0 feet
Contours at 1 ft, white lines, labelled in feet.

Set up a clean map for the tablet

The picture you save in step 6 shows exactly the layers that are switched on. A busy map is hard to read on a tablet in a moving cab. Before you save, in Map Layers:

  • HD Elevation and HD Hillshade both unticked, so the satellite photo shows through. With only HD Elevation off, the field stays grey.
  • Flow Lines ticked, Show drains at 5 to 10 ac (at 0 ac every small rill shows)
  • Ponding Predictor ticked, slider at the start position or a little right; or Depressions instead if you are leveling or filling
  • Field Contours Spacing Off, or 1 to 2 ft on flat ground (0.25 ft clutters the picture)
Map Layers set for the tablet: HD Elevation and HD Hillshade unticked, Field Contours Off, Flow Lines ticked with Show drains at 5 ac, Ponding Predictor ticked, Depressions and Wetness Index unticked 1 2 3
  1. HD Elevation and HD Hillshade unticked.
  2. Show drains ≥ 5 ac.
  3. Ponding Predictor ticked.
The clean tablet look: the satellite photo of the field with only the bigger flow lines and the red, orange and yellow ponding patches
The result: the photo, the flow lines that matter and the ponding.

The Show drains slider only changes what is drawn; the water flow is not run again. Move it as often as you like.

Look at it in 3D

  1. Click 3D View

    It's the purple button in the bottom right corner of the map (it appears once the LiDAR is loaded). The 3D Terrain Viewer fills the window.

    The field in elevation colours with a purple 3D View button in the bottom right corner of the map
    1. 3D View. Bottom right corner of the map.
  2. Turn it with the mouse

    Drag with the left mouse button to turn the field round. Drag with the right button to slide it. Roll the wheel to zoom. Exag stretches the height (10x to start) so a few feet of fall is easy to see; Home goes back to the first view.

    3D Terrain Viewer: the field surface tilted in 3D in blues and yellows on a dark background, with a toolbar across the top ending in a red Close button
    1. Exag. Drag the slider to stretch or flatten the height.
    2. Close. Red button, top right corner. Back to the map.
  3. Click Close

    The red Close button in the top right corner takes you back to the map.

If it doesn't work

Coarse national elevation, not LiDAR

No published LiDAR for this outline. Check Show LiDAR coverage. Survey with RTK instead.

The LiDAR didn't load“The LiDAR didn't load. Check your connection and try again.” or “Government Elevation Server Not Responding”

Check the internet and retry. Try a coarser resolution.

This area is too big for this computer at this resolution. Pick a coarser resolution in step 3 and try again.

Click Change on the LiDAR line, click Get LiDAR and pick a coarser detail (2 m or more). Or make the outline smaller, close other web pages and programs, or use a computer with more memory.

The flow run finished but found no flow lines in this outline.

Make the outline bigger so it takes in the land that drains through. You can still go on and draw routes.

Showing water flow didn't finish. Try again, or go on and plan routes.

Run step 4 again. If it keeps failing, use a coarser resolution.

Flow lines run in straight, parallel lines

Not an error: the ground there is nearly level.

Canada: only grey relief in places, or the picker starts at 2 m

Some Canadian areas are published at 2 m only. Take 2 m. No relief at all means no LiDAR to map.

Did this answer your question?

Still stuck? Talk to a product specialist. 1-833-DITCH-AS · support@ditchassist.com · Monday to Friday, 8 a.m.–5 p.m. Central.

Calling about a problem? Send your app logs first so support can see what happened.