Prepare a field with LiDAR & Mapping
Draw the field once on the tablet while it has internet, name it, and the app saves offline imagery, the raw LiDAR elevation (DEM) and the flow, depression and ponding layers for that field.
- Full Automation Kit
- Guidance Only Kit
- Ditch Assist Lite
- DIG™ Kit
In the app Home › LiDAR & Mapping › Prepare Field
LiDAR Drainage Mapping is the feature's name; on the tablet its Home card reads LiDAR & Mapping. Prepare Field is the one-stop way to get a field ready. You draw the field once, type its name once, and the app fetches public LiDAR for it. It saves three things on the tablet: offline imagery, the raw LiDAR elevation surface (the DEM, a digital elevation model) and the drainage layers.
All of it needs internet. Do it at the shop or the house, on farm Wi-Fi or a phone hotspot, before you join the control module Wi-Fi.
Before you start
Time: about 10 minutes per field, most of it finding the field on the map. The run itself takes seconds.
- LiDAR & Mapping is unlocked on this tablet (see Unlock it once)
- The tablet is on Wi-Fi or a hotspot with internet, not the control module, DIG module or Reach network (Wi-Fi on the tablet)
- You know roughly where the field is. The map has satellite imagery with road and place labels to help you find it.
- The field is in the US (USGS 3DEP covers the lower 48) or in a part of Canada that NRCan HRDEM covers
Unlock it once
LiDAR & Mapping is for Ditch Assist® owners. Until this install of the app has seen a real kit, tapping the card opens a window called LiDAR & Mapping is for Ditch Assist owners. It lists the one-time steps:
On your tablet, open WiFi settings and connect to your Ditch Assist Control Module's WiFi network. The password is 12345678.
Come back to this app, tap any workflow card, and choose Connect to link the tablet to the controller. That activates LiDAR Mapping.
Switch the tablet back to your normal internet (cellular or home WiFi) and open LiDAR Mapping any time.
Any one of these unlocks it for good:
- Connect once to a control module (Full Automation or Guidance Only Kit), the normal way: Connect to your kit.
- Connect once to a DIG™ module.
- Activate a Ditch Assist Lite receiver (Activate your receiver).
The simulator and a Bluetooth GPS don't unlock it. The unlock stays through app restarts and updates, but not through an uninstall: after a reinstall, connect once more.
Prepare the field
Tap LiDAR & Mapping
On the Home screen, tap the LiDAR & Mapping card. It's the bottom-right card in the grid of nine, with a mountain-peaks picture. A window called LiDAR & Mapping opens with five choices.
If a survey or job is open, a window called Start New Session? comes first. Tap Start New: it clears what's on screen, but saved files stay on the tablet.
- LiDAR & Mapping. Bottom-right card on Home.
Tap Prepare Field
It's the first of the five choices, with a list-and-tick icon. The map opens.
1
2
3
- Prepare Field. Everything in one run. Use this one.
- Single jobs. Imagery only, DEM only, or drainage layers only. See One product at a time.
- Saved Fields / DEMs. Opens the fields you already made. Works offline.
The map opens. Before you can draw, three things happen. None of them changes the buttons on the map:
-
Wait while it checks the internet
A banner reads
Checking internet…
for a moment. Being on Wi-Fi isn't enough: the app checks it can really reach the internet.
1
- Checking internet…. Goes away by itself after a second or two when the internet works.
-
Allow location, if Android asks
The first time, Android asks:
Allow Ditch Assist to access this device's location?
Tap While using the app, the top button of the Android window. The map then centres on where the tablet is. More on these Android windows: Tablet basics.
1
- While using the app. The first of the three buttons, under the two round map pictures. Leave Precise selected.
If you tap Don't allow, nothing breaks: the map starts where it was last, and you move it to the field yourself.
-
Tap OK on the Prepare Field note
A short white window called Prepare Field explains the job:
Locate the field, draw one rough boundary, then enter the field name once and choose whether to cache imagery, save a LiDAR DEM, generate mapping products, or run all selected products together.
Tap the green OK at its bottom right. The window closes and the map is ready.
- OK. Green, bottom right corner of the window.
Find the field
Drag the map with one finger to move it. Pinch two fingers apart to zoom in (Pinch to zoom). Stop when the field fills most of the map. Road and place names help you find it.
You should see the hint in the top-left corner: Tap to draw a field boundary for combined prep
.
- Hint. Changes to a corner count and acres once you start tapping.
- Prepare Field, Undo, Clear. Greyed until you've tapped some corners.
Tap each corner of the field
Tap the map once at each corner, going round the field in order. Each tap drops a white dot. The box at the top left counts them, for example 4 vertices · 251 ac
. From the third corner the outline is drawn closed and filled orange.
- A rough outline is fine. Take in the ground that drains toward your ditch, not only the fence line.
- Corners can't be dragged. Tap Undo (third button down the right side) to take back the last corner. Tap Clear (fourth) to start over.
- The edges must not cross each other (no bow-tie shapes).
- Up to 800 acres. Past that the count turns red and adds
(over 800 ac limit)
.
- Corners and acres. Updates with every tap.
- Undo and Clear. Take back the last corner, or start over.
Tap Prepare Field
Look at the column of buttons down the right-hand side of the screen. The second button from the top says Prepare Field. Tap it.
First check the size readout in the top-left corner of the map. It shows how many corners you placed and the field's size, for example 4 vertices · 251 ac
.
- Prepare Field. Second button in the right-hand column. Tap it when the outline is finished.
- Size readout. Corners placed and the field size. It must stay under 800 acres.
A window called Prepare Field opens. That's the next step.
- Red size readout. The outline is over the 800-acre limit.
- Message bar. Says how big it is and the limit.
Type a field name
In the Prepare Field window, tap the Field name box near the top. The keyboard opens (Typing and the keyboard). Type a name you'll recognise in a list, for example the farm and field number.
If the keyboard covers the window, press the Back button once to hide it (The Back button). A second press closes the window; your outline stays on the map, and you tap Prepare Field again.
1
- Field name. Shown in every list and on the map. With no name you get
Enter a field name.
Leave the three boxes ticked
All three products are ticked to start with. Leave them ticked unless you have a reason not to.
| Tick box | What you get |
|---|---|
| Cache Satellite Imagery | Imagery and labels for the field saved on the tablet, so the map isn't blank on the module Wi-Fi. See Offline imagery. |
| Save LiDAR DEM for contours | The raw LiDAR elevation surface. Levee, Contour Tiling, Contour-Guided Terracing and the elevation check use it offline. Greyed and marked Included with mapping productswhile the next box is ticked; untick the mapping and you can choose it on its own. |
| Generate flow and depression mapping | Flow lines, depressions and ponding, worked out on the tablet. See Read the drainage layers. |
With nothing ticked you get Select at least one field-prep product.
1
- The three products. All ticked; the DEM is included with the mapping.
Leave LiDAR source on Auto
LiDAR source is the row of three choices under the tick boxes. Auto is selected (filled) to start with.
- Auto picks US or Canada from where the field is. Right almost every time.
- US (3DEP): USGS 3DEP, which covers the lower 48 states.
- Canada (HRDEM): NRCan HRDEM. It covers only parts of Canada; the app finds out after the download whether your field has data.
Pick one by hand only for a field right on the border. With only imagery ticked, the row disappears: no LiDAR is fetched.
1
- LiDAR source. Leave it on Auto.
Tap Run Selected
The green button at the bottom right of the window. The run starts.
1
- Run Selected. Starts the run.
Wait for it to finish
A progress bar runs through the stages. Keep the app open on screen and the tablet on the same Wi-Fi until it finishes. A quarter or half section usually takes a few seconds; a big field with imagery takes longer.
Fetching elevation (2.8 m/px)…
downloads the LiDAR. The detail is picked for you: 2 m per pixel on a quarter section, coarser (up to 5 m) on the biggest fields.Checking LiDAR coverage…
makes sure the download really has elevation in it.Analyzing drainage…
, thenTracing flow paths…
,Finding depressions…
,Ranking where water ponds first…
andSaving layers…
. This all runs on the tablet; nothing is sent away for processing.Caching satellite imagery (N tiles)...
andCaching map labels...
, with a tile count.
1
- Stage. There are no buttons while it runs. If it sits on one stage for minutes, see Stuck on Saving layers.
Tap Close, or Open Drainage Planner
The window now reads Field Prep Complete: Selected field products are saved and available offline.
The flow lines and ponding are already on the map. Depressions are added to Map Layers switched off, one tap away.
- Open Drainage Planner (green, right): thin the flow lines down to the ones worth a ditch and save them as a plan. See Drainage Planner.
- Close (left): back to the map. Draw the next field, or tap Done in the column down the right side to go Home.
1
2
- Open Drainage Planner. Pick the flow lines worth a ditch.
- Close. Back to the map with the layers on.
Then go to the field
Join the module Wi-Fi and connect
As usual (Connect to your kit). Everything you prepared stays on the tablet.
Show the layers on your survey or grade map
Add them from Map Layers, with My LiDAR Fields or Drainage plan in its + menu. Step by step: Open My LiDAR Fields. Overlays are not kept after the app closes, so add them again each session.
Use the DEM
Levee, Contour Tiling and Contour-Guided Terracing offer Saved LiDAR DEM as a contour source, and the height button on the map checks LiDAR elevation. See Saved fields and DEMs and Check LiDAR elevation.
No internet where you are?
Nothing in LiDAR & Mapping can fetch or generate without internet. Your choices:
- Phone hotspot. Turn on your phone's hotspot and join it from the tablet (Wi-Fi on the tablet). Prepare the field. Then go back to the module Wi-Fi.
- Prepare ahead. Do every field you expect to work this season at home. Saved fields work offline for as long as you keep them.
- Office route. Plan on a computer in the Geo-Surface™ owner portal and copy the map ZIP to the tablet.
- No LiDAR coverage at all? Drive a field survey instead; Levee and the contour workflows build their surface from it.
If you start a LiDAR download from Levee or a contour workflow while the tablet is on the module Wi-Fi, the app shows Internet Required for LiDAR. Tap Disconnect Controller. Switch the tablet to internet Wi-Fi. Then come back and fetch.
One product at a time
The other choices on the LiDAR & Mapping list do one job each. You draw a boundary the same way; the sidebar button names the job.
| Choice | Sidebar button and result |
|---|---|
| Cache Satellite Imagery | Cache Imagery. Imagery and labels only, with a tile count, then Satellite Imagery Cached. No LiDAR. |
| Fetch LiDAR DEM | Save DEM. Asks for a DEM name, saves the raw elevation, then LiDAR DEM Saved. |
| Generate Mapping Products | Generate Products. Opens Generate LiDAR Layers: name, LiDAR source, Generate. Saves the DEM and the layers, no imagery. |
| Saved Fields / DEMs | View mode: no drawing, no internet needed. See Saved fields and DEMs. |
If you reached Save DEM from Levee or a contour workflow and a control module or activated receiver is connected, LiDAR DEM Saved offers Generate Contours Now. Otherwise it reads DEM saved. Reconnect to the controller, then choose Saved LiDAR DEM in Levee, Tiling, or Terracing.
Good to know
- Same name twice: both fields show with the same name in the list (only the second one's folder gets
-2on the end), so they are hard to tell apart. Use a new name or delete the old field first. - LiDAR is a snapshot. It shows the ground on the day it was flown, which can be years ago. Ditches dug or filled since, tile and culverts don't show.
- Grading still uses your RTK survey. The LiDAR helps you pick the route; the design comes from what you survey on the ground.
- Where it's kept:
Documents/DitchAssist/lidar-fields/, one folder per field. See Files on the tablet.
Prepare each field on internet Wi-Fi before you go. Everything it makes works offline on the control module Wi-Fi.
- Draw the field. Tap its corners on the map, up to 800 acres. Steps 1 and 2 need internet: farm Wi-Fi or a phone hotspot, not the control module.
- Fetch LiDAR. Public elevation data: USGS 3DEP in the lower 48 states, NRCan HRDEM where it covers Canada.
- Tablet maps the water. Flow lines, depressions and ponding are worked out on the tablet and saved with the field. Nothing is sent away.
- Plan drains. The Drainage Planner turns the flow lines into a plan you save.
- Use it in the field. No internet needed. Add the layers from Map Layers, again after each app restart. Levee, Contour Tiling and Contour-Guided Terracing load the saved LiDAR DEM.
If it doesn't work
The card says LiDAR & Mapping is for Ditch Assist owners“LiDAR & Mapping is for Ditch Assist owners”
Connect once to a control module or DIG module, or activate your Ditch Assist Lite receiver. After a reinstall, do it again. See Unlock it once.
Stuck on Saving layers…, no buttons, nothing saved“Saving layers…”
The app doesn't have All files access Most likely
Check: the run normally finishes in seconds. If it sits on Saving layers…
for minutes, the app can't write its LiDAR field list. It happens most after the app was uninstalled and installed again: Android won't let the new install write files the old one made. My LiDAR Fields also shows no fields although you made some.
Fix:
- Press the Back button to close the stuck window (The Back button).
- Switch on All files access for the app: Check All files access.
- Close the app fully and open it again (Close an app fully).
- Run Prepare Field again.
Your older fields come back in the list.
Internet Required, or taps don't add corners“Offline — connect to internet to draw”
The tablet is on a network with no internet (module, DIG or Reach Wi-Fi). Switch to farm Wi-Fi or a hotspot and tap Retry.
No LiDAR coverage in this area“No HRDEM LiDAR coverage in this area. HRDEM only covers parts of Canada.”
The public LiDAR has no data for that spot. Check the field is where you think, try Auto, or use a field survey instead.
Could not reach the elevation server“Could not reach the elevation server.”
Weak or dropped internet, or the public server is busy. Try again on a better connection.
Processing failed“Processing failed: …”
The field is saved with Job failed (DEM retained)
and the elevation is kept for support. Try again later; if it fails again, contact Ditch Assist support.
Imagery cache failed but LiDAR was saved“Satellite imagery cache failed. LiDAR data was saved.”
The internet dropped during the tile download. Run Cache Satellite Imagery for the field again. See Offline imagery.
Did this answer your question?
Thanks. That tells us which pages to improve.
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.