Main Page: Difference between revisions

From Balto K9
Line 183: Line 183:


=== Generating a Grid Search Path ===
=== Generating a Grid Search Path ===
[[File:balto_grid_search.png|right|thumb|400px|A grid search path with direction arrows]]
[[File:balto_grid_search.png|right|thumb|300px|A grid search path with direction arrows]]


For area searches, Balto can generate a serpentine grid search path within an imported polygon.
For area searches, Balto can generate a serpentine grid search path within an imported polygon.

Revision as of 21:15, 30 May 2026

Welcome to Balto™

The Search and Rescue Canine Handler Training Log App

Introduction

This app will help you keep track of your training exercise details and generate the text for use in your training log forms. The database is stored locally on your iOS or Android device. No connection to the internet is required.

Several different types of logs are available depending on your needs and capabilities of your dog(s). These include Air Scent (Live Find), Human Remains Detection (HRD), Trailing, Articles, and GSAR (General Search and Rescue). In addition, a simple log for documenting search missions is also available.

The workflow is as follows: At the beginning of each training session, you open a new Mission. Each Mission contains one or more Exercises. Each Exercise has conditions such as the weather and environment. Set the conditions at the time you work the Exercise. Subsequent Exercises during the course of a single training session might have different conditions e.g. raining vs. not raining so you can adjust them as you go along. Each Exercise has a discipline log associated with it. Pick the discipline you are working on and then set the details of that discipline. For example, if you are working an HRD Exercise, you would specify things such as how the source is positioned and what type of source it is. You then work the exercise with your dog. When you complete the Exercise, you can enter information about you and your dog's performance along with notes for what went well and what you need to work on going forward. After you finish the Exercise, you can create additional Exercises. The software pre-populates the user interface with the previous Exercise's settings (which you can adjust as needed) to make the process faster. Finally, when you are finished the training for the day, you would close out the Mission.

Once you have a Mission with Exercises associated with it, you can review and edit the information. You might not have some piece of information at the time you worked the Exercise. For example, if you are working a blind HRD problem, the person who put the source out would know when it was placed, where it was placed, and the type of source but since it's blind, you would only get this information later.

When the logged information is complete, you can export the information to the mobile device's clipboard which you can then paste into whatever app or document form you use for long-term log keeping. For example, you could paste the log text into an email or a PDF form.


Getting started

You'll need to set the Handler Name to your name in order for the system to automatically fill this in to each Mission. You'll also need to add a dog to the Canine list. You can also have a list of often used training locations. This information becomes available in the associated popup menus. This information can be accessed by tapping on the gear icon in the upper right corner of the screen.

Entering Missions and Exercises

The above view is the starting screen. From here, you can create a new Mission along with associated Exercises of various discipline types.

The view on the left shows the Mission setup screen. In here, you set a mission number which is usually a tracking number issued by the agency overseeing Search & Rescue operations in your area. Any unofficial training can be indicated by clicking the Unofficial button. This button simply replaces the text in the edit box with the word "Unofficial". Internally, this field is plain text and anything can go in there.

In the Training Location section, the popup menu presents a list of your usual locations set up in the Locations Editor. Again, picking a choice from that menu simply inserts the text into the edit box. Clicking the GPS button will insert your current location in UTM format.

The Log-in Date/Time can be quickly filled in with the current time and date by clicking the Now button. The same applies to the Log-out edit box. Note, when you end the training for the day by clicking the button at the bottom of this screen, the time and date of the Log-out edit box will be updated to the current time and date.

Clicking the "Start a new exercise" button will bring up the Exercise Setup screen. Here you can set the overall information about the exercise such as the dog you were working, any human flankers who were with you, and the weather/environment/terrain conditions. At the bottom is a popup menu where you select the discipline you will be working on. Clicking the "Set discipline details" button will bring up one of several screens. Note that these discipline screens are all scrolling views to accommodate all the information and lets you fill in information as you get it easily.

Important: By scrolling all the way to the bottom, you will see a Finish button. You must click this button to complete the exercise and save it in the database. If you click the circle-X in the upper left corner, you will cancel this discipline and it won't be saved. This allows you to undo adding an incorrectly chosen discipline.

Training Disciplines

Each discipline has its own set of editing screens.

Air Scent

Here are the Air Scent screens:

HRD

Here are the HRD screens:

Trailing

Here are the Trailing screens:

GSAR (General Search & Rescue)

Here are the GSAR screens:

Articles

Here are the screens for Article work

From the Gear Menu in the upper right corner, you can access the Article editor which modifies the choices available in the Specific Articles popup menu.

Search Log

Here are the screens for a Search Log

Reviewing and Editing

Once you have Missions and Exercises recorded in the database, you can review and edit them as needed. By clicking on the Review button from the main screen, you will see a list of all of the Exercises, sorted by the date/time set in the Mission screen. To edit an exercise, double-tap on the desired item in the list.
All disciplines have a Mission editor and a Conditions editor.

To delete an exercise, swipe left on the item in the list you wish to delete and tap the trash can button to confirm. Note, when there are no more exercises for a given Mission, that Mission record is also deleted.

If you need to add an exercise to a Mission after the Mission has been closed, you can do so by tapping and holding on any of the other exercises in that Mission.

Exporting Information

To generate and export logs as a block of text for use in log forms, you first bring up the Review screen. From there you can select specific logs to export by checking the Select for export in the upper left corner. This presents check boxes for all of the exercises in the list. Check the logs you want to export and click the Export Logs button. The app will notify you that the clipboard now contains the log text.

You can also select a date range by clicking on the Filter icon button in the upper left corner. This will bring up the filter screen.

From here, you can specify a date range of logs and show them in the Review list or automatically export them to the clipboard.

Logs are exported in Rich-Text Format (RTF). You can paste that information into any app that supports RTF such as Microsoft Word.

If you are using an iPhone and a Mac computer, the phone's clipboard is automatically shared (via iCloud) to your Mac. Once on your Mac, you can paste the information into Word or other editor. Some editors don't retain the formatting by default so you may have to specifically choose a Paste command from the Edit menu. It may be handy to create a template document in Word that has a useful header and footer for a signature line or a unit insignia as a watermark. The paste operation will automatically add new pages as needed with the header/footer/watermark on each page.

Statistics

Each Mission has an edit box for entering the number of miles you traveled as well as the start and end times. You can have the app generate a report that includes the mileage, the number of hours worked, and the number of exercises for each log type in the specified date range. Note: the app expects dates and times to be in ISO8601 format (YYYY-MM-DD hh:mm:ss). If you entered dates by hand and use a different format, the calculation won't work.

Interactive Map

The Interactive Map is a powerful tool for visualizing search areas, planning grid searches, dividing areas into sectors, and analyzing trailing dog tracks. It supports importing geographic files from CalTopo and other mapping applications.

Opening the Map

Tap the map icon in the toolbar to slide the map view in from the side. The map displays your current GPS position as a blue pulsing marker, with an accuracy circle and heading indicator. Tap the map icon again to slide the map view away.

The interactive map view

Importing a Geo File

Balto supports importing GPX and GeoJSON files from other applications.

From CalTopo

  1. Open CalTopo on your device
  2. Select the map object you want to share (polygon, line, or waypoint)
  3. Tap the share button
  4. Choose "Balto" from the share sheet
  5. The file will be imported and displayed on the map

From Other Apps

Any app that can share GPX or GeoJSON files via the system share sheet will work the same way. Tap the share button in the source app, then select Balto from the list.

After import, the map will automatically center and zoom to show all imported features. The status bar at the top of the map shows what was imported (number of polygons, lines, and points).

A polygon imported from CalTopo

Generating a Grid Search Path

A grid search path with direction arrows

For area searches, Balto can generate a serpentine grid search path within an imported polygon.

  1. Import a polygon defining your search area
  2. Tap the polygon on the map to select it (it will highlight)
  3. Tap the grid search button in the zoom column on the right
  4. The Grid Search panel will appear at the bottom of the map

In the Grid Search panel:

Wind Direction slider
Set the direction the wind is blowing FROM. The grid path will start at the downwind corner of the area so the dog works into the wind. Tap the compass rose buttons (N, NE, E, SE, S, SW, W, NW) for quick wind direction selection.
Spacing slider
Set the distance between parallel lanes of the grid. Smaller spacing gives more thorough coverage but takes longer to execute. The slider range is from 10 metres to 200 metres.
Reverse direction
Tap to reverse the path direction if needed.
Chamfer corners
Tap to add rounded transitions at the lane endpoints instead of sharp turns.

Direction arrows appear at the midpoint of each segment showing which way to walk. Arrow size can be adjusted using the arrow size slider.

Exporting a Grid Search

To save the grid search for use in another application:

  1. Generate the grid search as described above
  2. Tap the export button in the panel
  3. Choose where to save or share the GPX file

The exported GPX file can be loaded into Garmin devices, CalTopo, Google Earth, or other GPS applications.

Generating Sectors

For evidence searches or systematic area coverage, Balto can subdivide an imported polygon into a grid of square sectors with unique labels.

  1. Import a polygon defining the area
  2. Tap the polygon on the map to select it
  3. Tap the sector generator button in the zoom column
  4. The Sector Generator panel will appear

In the Sector Generator panel:

Sector size slider
Set the area of each sector in acres. Sectors are square and rotated together to fit the polygon.
Rotation slider
Set the orientation of the sector grid. Sectors are labeled with column letters and row numbers (A1, A2, B1, B2, etc.) that follow the rotation.
Sectors generated over a search area

Each sector is drawn with a unique color from a palette of 12 colors that cycle through the grid for easy visual distinction.

Exporting Sectors

To save the sectors for use in another application:

  1. Generate the sectors as described above
  2. Tap the export button in the panel
  3. Choose GPX or GeoJSON format
  4. Choose where to save or share the file

GPX files include the Garmin DisplayColor extension so sector colors are preserved in compatible applications. GeoJSON files use the stroke and fill properties recognized by CalTopo and other web mapping tools.

Track Analysis

For trailing dog training, Balto can compare the dog's GPS track to the subject's track to compute deviation statistics.

  1. Import a GPX file containing both the subject's track and the dog's track
  2. Tap the track analysis button in the zoom column
  3. The Track Analysis panel will appear

In the Track Analysis panel:

  1. Select the subject's track from the first combo box
  2. Select the dog's track from the second combo box
  3. The analysis runs automatically when both tracks are selected

The dog's track is colored based on its deviation from the subject's track at each point:

Green
Less than 5 metres deviation
Amber
5 to 15 metres deviation
Red
More than 15 metres deviation

The panel displays maximum and average deviation in metres.

Track analysis with deviation coloring

Geofencing

When a polygon is loaded, you can enable geofencing to receive an audible warning if you walk outside the search area.

  1. Import a polygon defining the search area
  2. In the status bar at the top of the map, toggle the Geofence switch to On
  3. Balto will speak "Warning, you are outside the search area" if you exit the polygon

Geofencing continues to work when Balto is running in the background, allowing you to put your phone in your pocket while working.

Clearing the Map

To remove all imported data from the map, tap the Clear button in the status bar at the top of the map view.

Mission Summary

The Mission Summary provides a quick formatted view of all completed exercises for your current training mission. This is useful for reviewing what you've already documented during a long training day without having to navigate through individual exercises.

Opening the Mission Summary

  1. Tap the Options menu in the toolbar
  2. Select Mission Summary
  3. The summary will appear with all exercises from the current mission

Availability

The Mission Summary menu item is only enabled when:

  • A mission is currently open
  • At least one exercise has been completed and saved
  • No exercise is currently in progress

If you start a new exercise but have not yet finished it, the menu item will be disabled. Finish the current exercise first to access the summary.

Display

The summary shows all completed exercises in reverse chronological order, with the most recently completed exercise at the top. Each exercise is displayed in the same rich-text format used by the log export, including:

  • Mission identification and date
  • Exercise type and timing
  • Discipline-specific details (Air Scent, HRD, Trailing, GSAR, Search, Article, or Water HRD)
  • Performance ratings and notes

The summary is read-only — you cannot edit exercises from this view. To edit an exercise, use the Logs view from the main menu.

Scrolling

If you have many exercises in your current mission, use the scrollbar on the right side to scroll through the summary.

Tips

  • Use the Mission Summary to verify all exercises have been logged correctly before ending a training day
  • The summary updates automatically each time you open it, reflecting the current state of all exercises in the mission
  • For a permanent record, use the Log Export feature from the Logs view instead

Graham Tools

The Graham Tools calculator

The Graham Tools provide search planning calculators based on the methods developed by Hatch Graham for canine search and rescue operations. They help handlers estimate scenting conditions, plan grid spacing for area searches, and compute coverage rates.

Opening the Graham Tools

  1. Tap the Options menu in the toolbar
  2. Select Graham Tools
  3. The Graham Calculator screen will appear

The screen contains four sections that work together to plan an area search.

Section 1: Scenting Conditions

This section computes the estimated Probability of Detection (POD) based on the current conditions where the search will take place.

Location

Enter UTM coordinates for the search location in the format "12S 0379774E 3821798N", or tap the GPS button to use your current location. Balto validates the UTM format and shows red text if the format is invalid.

Date and Time

Enter the date and time for the search in YYYY-MM-DD hh:mm format, or tap the Now button to use the current time. This is used along with the location to compute the sun angle and shadow length.

Shadow Length

Balto automatically computes the expected shadow length in feet based on the location and time. This serves as a quick visual check — you can compare against an actual shadow you measure on a 6-foot stick to verify your inputs.

Check the Night box if the search is at night or in deep shade, which significantly affects scenting conditions.

Surface Type

Select the dominant ground cover from the dropdown. This adjusts wind speed based on the vegetation in the area.

Get Current Weather

Tap this button to fetch current weather conditions from the internet (when available) for the location coordinates. After the weather is fetched, a dialog displays temperature, humidity, wind speed and direction, and cloud cover at different altitudes. The wind speed and cloud cover dropdowns are automatically populated based on the weather data.

Wind Speed and Cloud Cover

These dropdowns are automatically set by Get Current Weather but can also be set manually. They feed into the POD calculation.

Estimated POD

Displays the estimated Probability of Detection at 100 meters based on the current conditions. This represents the percentage chance that a dog will detect a subject when working at 100m spacing.

Cumulative POD at Distances

A grid showing cumulative POD at decreasing grid spacings: 100m, 75m, 50m, 25m, and 12.5m. As grid spacing decreases (more thorough coverage), POD increases. Use this table to choose a grid spacing that meets your target detection probability.

Section 2: Required Grid Spacing for Target POD

This section calculates the grid spacing needed to achieve a target Probability of Detection.

Target POD

Set the target POD percentage using the slider or text field. Typically you'd choose a value that matches your mission requirements (e.g. 70%, 80%, or 90%).

Grid Spacing Result

Balto displays the required grid spacing in meters and in paces (based on your configured pace count in Settings). Use this spacing when planning your search lanes.

Section 3: Grid Area Time Calculator

This section helps you understand the relationship between acres covered, hours spent, walking speed, and grid spacing.

Acres

Set the area to be searched in acres using the slider or text field. Range is 1 to 200 acres.

Time (hours)

Set the time available for the search using the slider or text field. Range is 0.1 to 4.0 hours.

Speed (mph)

Set the realistic walking speed for the search terrain using the slider or text field. Range is 0.5 to 3.0 mph.

Grid Spacing Result

Balto calculates the grid spacing in meters (and paces) that fits within these constraints. If the spacing is too small for adequate POD, you'll need to either increase available time, increase walking speed, or reduce the area.

Using the Speed Monitor

The realistic speed value can be measured in the field using the Speed Monitor feature. Walk a typical section of the search area and use the average speed reading.

Section 4: Acres Per Hour

This section computes search productivity given speed and grid spacing.

Speed (mph)

Set the walking speed using the slider or text field.

Grid Spacing (m)

Set the grid spacing using the slider or text field.

Acres Per Hour Result

Balto displays the acres covered per hour for the given speed and spacing. Use this to estimate how long a search will take given the area and desired coverage.

Tips

  • Run Get Current Weather just before the search to use the most accurate conditions in your POD calculations
  • The pace count used for converting grid spacing to paces is set in Settings under Handler Information
  • Save your scenting condition assessment as part of the exercise notes so you can reference it later when reviewing logs
  • For best results in the field, set up your Section 1 inputs at the start of training, then use the other sections to plan specific exercises

Speed Monitor

The Speed Monitor measures your walking or movement speed using GPS, displaying real-time speed, average speed, distance traveled, and elapsed time. Periodic speech announcements let you keep track of your pace without looking at the screen, even when the phone is in your pocket.

This feature is useful for determining how quickly you can move through different terrain types, which helps in planning grid spacing for area searches and estimating coverage time.

Opening the Speed Monitor

  1. Tap the Options menu in the toolbar
  2. Select Speed Monitor
  3. The Speed Monitor screen will appear
The Speed Monitor screen

Display

The Speed Monitor screen displays four metrics:

Current Speed
Your current speed, smoothed to reduce GPS noise. Displays 0.0 when you are stationary.
Average Speed
Your average speed since starting the monitor, computed over the total elapsed time including any stopped time.
Distance
The total distance you have traveled since starting the monitor, accumulated only when moving.
Elapsed
The total elapsed time since starting the monitor, formatted as hours:minutes:seconds.

Starting and Stopping

Start
Tap the Start button to begin measuring. The button changes to Stop while the monitor is running.
Stop
Tap the Stop button to pause measuring. All metrics retain their current values. Tapping Start again will resume from where you stopped.
Reset
Tap the Reset button to clear all metrics and start fresh.

Configuring Units

The Speed Monitor supports three unit systems:

mph
Miles per hour with distance in miles
km/h
Kilometers per hour with distance in kilometers
kts
Knots with distance in nautical miles

Select your preferred units from the Units combo box at the bottom of the screen. The display updates immediately.

Speech Announcements

The Speed Monitor can periodically announce your current speed using your device's text-to-speech engine. This lets you keep your phone in your pocket while working.

Set the announcement interval using the "Announce every" combo box:

  • 1 min
  • 5 min
  • 10 min

The announcement says "Current speed: [value] [units]" — for example "Current speed: 2.5 miles per hour".

Background Operation

The Speed Monitor continues to measure speed and make announcements when:

  • The phone is locked
  • Balto is in the background
  • You are using another app

To ensure background operation works, grant Balto the "Always" location permission when prompted.

Tips

  • Walk for at least 30 seconds before reading the speed value to allow the internal filter to stabilize
  • GPS accuracy varies with terrain — heavy tree cover or urban canyons may reduce accuracy
  • Distance accumulation requires GPS accuracy better than 15 metres to filter out noise
  • The Speed Monitor uses battery when in the background since it relies on the same GPS updates used by other Balto features

MediaWiki