TopoDroid features

FEATURES

1. TopoDroid is and will be free, open source, and ad-free
  - full sources available on github
  - officially released only on SpeleoApks
2. Run on Android 4.3 up (old apks run on Android 2.2 up)
3. Footprint 6.9 MB (download), 10 MB (in memory)
4. Highly customizable, but with "reasonable" default values
  - Setup dialogs for the most important settings
5. Supported devices
  - DistoX (version 1, version 2), DistoXBLE
  - BRIC4, BRIC5
  - SAP5, SAP6
6. Activities:
  - main window (survey list),
  - shot data list,
  - survey info,
  - sketch drawing,
  - map overview,
  - device list,
  - DistoX and DISTOXBLE calibration
7. Five different levels of user-interface
  - Basic
  - Normal
  - Advanced
  - Expert
  - Testing
8. Geek settings (for esoteric features)
9. Export of current settings to file (in human readable form)
10. Selectable current work directory (under the base directory "Documents/TDX")
11. Cave Manager for cave projects with surveys in TopoDroid database
12. Button bars for frequent actions, menu for the other actions
13. Adjustable text size and button size (suitable for 5" phones and 7" tablets)
14. Custom keypads for easier input
15. Default export formats (for data and for sketches)
16. Supported languages (besides English):
  - Chinese (H.J. Luo)
  - Hungarian (B. Holl)
  - Italian (F. Toso)
  - Russian (A. Kozhenkov)
  - Spanish (M. Guerrero, J. Pardo)
  - French (D. Ros)
  - Portouguese (R. Severo)
17. Quick help (in-app)
18. All survey data stored in the primary external memory (sdcard) so that they remain even if the app is accidentally uninstalled. App files stored in the private app space.
19. Survey data stored in a sqlite database
20. User manual (in-app English. Translations can be installed via web if available)
  - Up-to-date PDF of all man pages can be created from the repo.
21. Documentation on the web:
  - Texts in English, French, German, Spanish, Portuguese, and Italian
  - Video tutorials
22. Log system (all logs disabled by default, except errors)
  - Log on syslog or on file

Survey functions:

1. DistoX and DistoXBLE data download
  - On-demand batch download
  - Continuous download
  - on-demand Multi-DistoX
  - on-demand Two-DistoX
  - DistoX2 (firmware >= 2.3) laser remote control for survey shots
2. BRIC data download
  - Continuous download
  - Laser remote control for survey shots and scan
3. SAP data download
  - Continuous download
4. Data modes
  - normal

- - diving (manual data only: depth, azimuth, length)

1. Inline shot station editing (optional)
2. Manually entered data
  - azimuth/clino with Android sensors / camera (normal mode only)
  - optional back-sight (normal mode only)
  - LRUD (converted to splays)
  - instrument calibrations for input data
    - optionally also for LRUD
3. Additional at-station LRUD (manually entered)
4. "Arbitrary" station names (spaces are replaced with underscore).
5. Automatic leg/splay identification for downloaded data
6. Automatic incremental station-name assignment (seven different policies)
7. Calibration-check shots with calibration analysis dialog

- 1. foresight + back-sight
  2. triangle loop

1. Station renaming (renumbering)
2. Splay group station renaming

Splay classes
- special splay X-V-H classes auto identification

1. shot flag: duplicate, surface, commented, ...
2. shot extend (for extended profile sketch)

- fractional extend for idealized profile view

1. data display modes: can hide splays, repeated-leg shots, blank shots
  - splay shot can be displayed as a whole or on a per-station basis

- latest splays display
- splay coloring

1. multi-shot selection with actions
  - set-extend
  - renumber
  - delete

- coloring
- splay plane interpolation
- splay classes

1. Inaccurate shots highlight (red) [only DistoX2, DistoXBLE, and BRIC4]
2. Oversize shot auto deletion
3. Extra-short leg highlight (orange)
4. Statistics: length, depth, S-N, W-E displacement, etc.
5. Length units: m, ft
6. Angle units: degrees, grads
7. Global survey notes
8. "Active" station
9. Saved stations, for the most relevant stations
  - flags: painted, marked
  - comment
  - continuing survey from a saved station
10. Station search
11. Leg search
12. Shot text comment
13. Shot audio comment
14. Shot photos
  - custom camera or any Camera app
  - comment
  - time
  - azimuth and clino in exif (custom camera)

Shot sensor data (Android sensors or external)
- value
- comment
- time

1. Geo-location of entrance points
  - coordinates with Android GPS
  - manually entered coordinates (arbitrary CRS with Proj4)
  - coordinates imported from MobileTopographer, GPStest and other apps
2. Location units: decimal degrees, ddmmss
3. Coordinate conversion (through the app Proj4)
4. Geo-point viewed on maps
5. Altimetric altitude (Earth Gravitational Model)
6. Magnetic declination (World Magnetic Model 2020-2025)

Loop closure analysis and optional compensation

1. Local magnetic anomaly compensation

Trilateration azimuth correction [experimental]
Data export formats (only Therion export is guaranteed)

- Compass
- cSurvey
- GHTopo (untested)
- Polygon
- Survex
- Therion
- Topo (untested)
- TopoRobot
- VisualTopo
- Walls
- dxf (AutoCAD)
- csv (also as raw data export)
- KML (GoogleEarth)
- track file
- Shapefile (QGIS)

1. Zip archive of all the data of a survey, including sketches, photos, and audios
2. Import: survey
  - zip archive
  - Therion (limited syntax)
  - Compass

- - - convertible to "diving" data-mode
- VisualTopo
- Survex
- PocketTopo (with sketches)
- CaveSniper (text file)

1. 3D viewer, Cave3D , included in TopoDroid

Sketch functions:

1. Plan and profile (extended or projected) view sketches
2. Multi-sketch: arbitrary number of sketches per survey
3. Multi-scrap: arbitrary number of scraps per sketch
4. Origin station on a per sketch basis or common to all sketches (setting)
5. Shot extend: left, right, vertical, ignore (to open loops in extended section)

- - fractional extend

1. Cross-sections: photo and/or sketch
  - vertical if attached to the plan-view
  - vertical or horizontal if attached to the profile view
  - x-section sketch outline can be displays in plan/profile
2. Drawing references
  - mid-line
  - splay shots

- latest splays
  - station names
  - grids at 1, 10, 100 units, or graph-paper
  - scale-bar
  - outline of another sketch
  - optional display of x-section outline at section point
  - leg intersection point, for leg x-sections

1. Grid-units: meters, yards, 2-feet, decimeter
2. Graph-paper scale: 1:100 1:200 1:300 1:400 1:500
3. Mid-line display clippable at "break" stations
  - customizable for each sketch
4. Splay shots
  - displayed as a whole or on a per-station basis
  - color transparency setting

- splay coloring

1. Zoom controls ( none, temporary, permanent )
2. Side-drag (optional)
3. Drawing tools library
  - 45 iconic symbols (points): label, blocks, debris, sand, stalactite, pillar, etc.
  - orientable points (eg, entrance, etc. )
  - five point scales: XS, S, M, L, XL
  - optional text/value for points (eg, continuation, danger)
  - 14 line types: wall, pit, slope, arrow, ...
  - oriented lines: lines have left and right sides, and can be reversed
  - closed lines (eg, rock-border)
  - possible join/continue within line groups (eg, wall subtypes)
  - straight lines (segments) [option]
  - 8 areas (closed regions): water, sand, clay, ice, snow, ...
  - orientable areas [option]
  - areas with horizontal top (eg, water in profile view) [option]

Extra sets of drawing tools (for a total of over 200 drawing tools)
1. [X] speleology (additional tools)
  1. - special "photo" point
    - special "audio" comment point
2. [A] archeology
3. [B] biology
4. [G] geology
5. [H] anthro (artifacts)
6. [K] karst
7. [M] mining
8. [P] paleonthology karst
9. Optional "text/value" point attribute
10. Drawing tools editable and further extensible with custom drawing tools
11. Drawing tools palette configuration; to enable only the relevant drawing tools
12. Bottom bar with the six most recently used drawing tools, and picker for the others

- - list (tool graphics and name) [default]
  - grid (only tool graphics)
  - triple-grid

1. Five line styles (normal, fine, coarse, smooth, simplified)
2. Line retracing and join
3. Adjustable point icon size (XS, S, M, L, XL)
4. Point icon orientation defined at point chose time
5. Settings
  1. - label text size
    - station text size
    - adjustable line width, and ticks length
Canvas views (5 layers)

- show/hide by symbol type
- show/hide by individual item

1. Sketch window modes
  1. moving
  2. drawing
  3. erasing
  4. editing (moving points, etc.)
2. Sketch orientation: portrait or landscape
3. Erase filter: all, points, lines, areas
4. Select filter: all, points, lines, areas, shots, stations
5. Erase and select tool sizes: small, medium, large
6. Sketch items attributes: size, direction, etc.
7. Sketch item editing:

- - moving a point, a line-point, or a portion of the line
  - adjusting Bezier control points
  - snapping a point to another point

- snapping a line to pass thru the nearby splays
- snapping a portion of an area border to another line
  - duplicating a line point
  - cutting a line in two lines
  - removing a line point
- making a line segment straight
- making a line segment curved (inserting control points)
  - multi-item actions (for items of the same class)
    - merging lines with others of same type
    - joining lines
    - decimating the line points
    - deleting all the selected items

1. Easy set of point orientation by a short draw on putting the point
2. Quick edit of point orientation with the side drag action
3. Quick edit of shot "extend" with the extend line in profile view
4. Undo/redo of drawing, erasing, delete
5. Sketch operations:
  1. statistics
  2. rename
  3. delete (with recovery)
6. split, with copy/move a portion to the new sketch
7. merge: including a sketch into another
8. shift and scale as a whole with respect to the mid-line

- 1. extended profile sketch flipping (mid-line either fixed or flipped)

1. Sketch export formats:

- - cSurvey (includes survey data, photo, audio, and x-sections)

- Therion
  - pdf file
  - dxf
  - svg
  - shapefile (QGIS), optionally geo-referenced
  - xtherion (xvi)
  - Tunnel (xml)

1. Optional inclusion of x-sections in svg/dxf/xvi
2. Map overview
  - outline only
  - all details
3. Map overview measuring tool
  - single segment: length, displacement, angle
  - poly-line length, displacement, angle
4. Map overview references
  - stations
  - mid-line
  - splays
  - grid
  - scale-bar
5. Map overview export:
  - Therion (multi-scrap)
  - svg
  - dxf (LibreCAD)
  - shapefile (QGIS)
  - xvi (xtherion)

Device functions:

1. Supported devices:
  - DistoX (A3), DistoX2 (X310), and DistoXBLE
  - BRIC 4 and 5
  - SAP 5 and 6
2. DistoX properties info
3. Scanning and pairing
  - RFcomm DistoX
  - BLE device
4. Packet logging (optional)
5. Data recovery (DistoX1 only): re-read data, reset for transmission
6. Memory dump (DistoX's
  - optionally saved to file
7. Calibration mode toggle on/off (DistoX's)
8. Remote control (DistoX2 firmware >= 2.3 only, DistoXBLE, BRIC's)
  - also calibration shots
9. Calibration data (DistoX's)
  - distribution analysis (direction of laser axis, G-axis, M-axis, or roll)
  - saturation alert
  - highlight when error over 1 degree
  - data search on calibration error
10. Calibration computation (linear and non-linear algorithms)
11. Calibration coefficients validation
12. Calibration coefficients upload (DistoX's)
  - warning if calibration quality is not good
13. Calibration coefficients and data export
  - format: csv
14. Calibration import (csv)
15. Firmware download (DistoX2, DistoXBLE)
16. Firmware upload (DistoX2, DistoXBLE)
  - bundled firmware versions 2.1, 2.2, 2.3, 2.4, 2.5, 2..4c, 2.5c, 2.51, 2.6.1, 2.6.3, 2.6.4
  - firmware signature identification
  - firmware checksum control

Experimental features not enabled in the distribution

sketch auto-walls
- two experimental algorithms

Experimental features not compiled in the app

1. experimental calibration algorithm
2. virtual DistoX (to plug in another device)
3. co-surveying

3D modeling
1. - 3D sketching
  - model algorithms
    - pseudo convex-hull
    - powercrust
  - export formats: Therion, dxf