SexyTopo is an app for surveying caves and underground spaces. It is designed to work with an electronic measuring device which the surveyor uses to measure out survey legs. It is also possible (though significantly less convenient) to use SexyTopo as a tool for manual entry of survey data.
SexyTopo runs on Android devices (the newer/more powerful the better). For obvious reasons a water- and dust-proof device is recommended. Both phones and tablets are supported. It is possible to control SexyTopo with finger movements but it is designed for use with a stylus.
A full description of surveying is beyond the scope of this document but this is a brief overview of how to survey with SexyTopo.
Surveying consists of moving through the cave along a series of locations known as stations. These points are connected together through measurements known as legs (or shots in some countries). This collection of stations and legs make up the skeleton of the survey, or centreline. The survey may also contain legs that do not connect to a station but help measure out the shape of the cave (known as splays).
Typically, a surveyor will start at a station and take several splays (ideally the job will be split between at least one caver taking the measurements and another piloting SexyTopo). A common method is to use the LRUD mnemonic and do Left, Right, Up and Down splays from the station, but additional splays are often useful, especially in complex parts of the cave. Then the surveyor will look for the next station. You can instruct SexyTopo to create a new station (rather than a splay) by repeating a measurement three times. If the readings are sufficiently close, a new station is added. The surveyor then updates the sketches of the plan and profile on the graph screens, before moving to the new station and repeating the process.
Legs are added to the survey at the active station. By default the active station is the newest station added to the survey. In the standard order of things (as described above) the active station should automatically be the one you want, but you will want to change it in case of a mistake or to make a branch in the cave. For example, you may have created a new station but forgotten to take splays at the station before. Here you can select the previous station as the active station, take any required splays, then set the new station as the active station.
Branches are just as easy to add. Select the station you wish to branch off as the active station, and then create a new station as before.
SexyTopo supports a wide range of cave surveying instruments including DistoX, DistoX BLE, CavwayX1, Bric4, Bric5, SAP5, SAP6, FCL, and DiscoX.
To connect an instrument, open the Device menu and select Connect. The instrument connection page guides you through the pairing and connection process. A console at the bottom displays status messages from the device.
This is a tabular view of the collected data. It can be accessed through the first icon on the Action Bar. SexyTopo is designed with the intention that most interaction should be through the sketch screens but it is occasionally useful to check the raw data.
There are onscreen buttons for manually inputting data: there are two buttons for adding new stations and splays.
Tapping on a table row opens the view/edit dialog for that row, where the data can be seen in detail and updated if necessary.
Long-pressing on a table row or selecting a station in the graph views activates a unified context menu.
The sketch views (plan and extended elevation) can be accessed through buttons on the Action Bar at the top of the screen. These show a projection of the calculated survey on a canvas so that a sketch of the cave can be drawn on top. The plan view is an intuitive map of the cave whilst the extended elevation is an "unrolled" view of the vertical layout of the cave.
A selection of sketching tools are provided via a toolbar at the bottom of the screen:
A legend at the bottom right of the view provides a scale bar, basic stats, and a reminder of the survey name.
SexyTopo provides several menus accessible from the Action Bar ("hamburger" button for extended menus) for managing surveys, configuring behaviour, and accessing various views and tools.
Controls how measurements from the instrument are interpreted:
Opens the settings screen for configuring app preferences, display options, and behaviour.
A unified context menu is available from the table view and graph views. Long-press a table row or select a station in the sketch views to access it. The menu is organized into submenus with options depending on what's selected.
In elevation view, controls which direction to draw the passage:
Jump to the selected station in different views:
SexyTopo stores survey data on your device and provides various options for managing survey files through the File menu.
Surveys are saved in their own folder (directory) on your device. A survey may contain several files, including survey data files (measurements, stations, legs), sketch data (plan and elevation drawings), and metadata (trip information, comments).
After creating a survey (File -> New Survey), it is recommended to save it. Previous versions of SexyTopo handled this for you, but Android now requires the user to manage the file handling. When saving a file for the first time, SexyTopo opens a file selector for you to choose a folder to save it in. Important: you almost certainly want to create a new folder to save the survey in rather than selecting an existing one (otherwise both you and SexyTopo will get confused, and it might overwrite data you want to keep).
SexyTopo attempts to default the save location to a folder in Documents/SexyTopo/Surveys, but this doesn't work on all devices, and you are free to choose your own folder structure. At the time of writing, SexyTopo doesn't care about where linked surveys are saved, but this may change in the future.
To manage the complexity of anything other than very small caves, you will likely need to break the overall survey of a cave into smaller individual surveys. This provides several advantages, including managing the cognitive load of understanding how the survey fits together, improving rendering performance in SexyTopo, and aligning with the standard workflow of cave drawing packages such as Therion.
SexyTopo provides UI controls such as fading out or hiding the parts of the survey not currently being worked on. This is particularly helpful for dealing with extended overlapping sections of cave passage, and starting a new linked survey is the recommended way of handling this kind of continuation.
To start a new linked survey, select a station from the context menu and select Survey → Start New Survey Here. There is also an option to link to an existing survey and to unlink a survey.
SexyTopo can exchange data with other cave surveying software through import and export functions.
To import survey data from other software, select an action from File → Import in the menu.
Export allows you to save your survey in various formats for use with other software, sharing, or publishing. Select File → Export and choose your desired format.
The exported file or folder will be produced in an Exported folder inside your survey folder with a name of the export selected (e.g. Exported/therion).
In typical caver fashion, you've probably cajoled someone into lending you their shiny measuring device, completely failed to have a practice with it and assumed you'd just wing it. Now you've found yourself in the sharp end of some crappy hole somewhere realising that you have no idea why your surveying kit doesn't work. Luckily you've found SexyTopo has a help file and you're desperately trying to scan through it looking for some hope. First of all, don't panic...
Check the following are true: Bluetooth is turned on on the device, the device is paired with your instrument and the Connect switch is on. Check the on-screen console on the Instrument page: it may show an error message or give some clue as to what is wrong.
If that fails, try turning your instrument off and back on. Try unpairing and re-pairing, or even turning Bluetooth off and on again. It shouldn't make a difference but you could kill SexyTopo and reopen it. Check you haven't paired with the wrong device (the Unpair dialog shows which devices are paired).
For DistoX devices: if all else fails a factory reset may be necessary. Press CLEAR, FUNC and MEM (the latter has a floppy disk or save icon) for five seconds. Note that this is an option of last resort and requires recalibrating the device.
Your instrument may need calibrating. Consult your instrument's documentation for calibration procedures. Some devices (such as DistoX) provide calibration tools within SexyTopo accessible from the Instrument menu.