Auriga, cave survey freeware




Required hardware

History of changes

Reference manual





Report a problem

A low-traffic multilingual e-mail list is used to announce new Auriga releases and for exchange between users (comments, suggestions and bug reports). In order to avoid spam, messages from new members are moderated.

To subscribe, send an e-mail to:

Installing Auriga in a PDA

Auriga can be installed in a PDA using various ways:

  1. Performing a HotSync under Windows from the Palm Desktop
  2. Copying the PRC and PDB files on an SD card in the following directory structure starting at the card root:
                PRC Files
                    PDB Files
    that can later be transferred on the PDA with the App/Copy menu (opened by tapping the time on the PDA desktop)
  3. Copying the PRC and PDB files anywhere on an SD card, that can later be transferred on the PDA with a program like FileZ
  4. By IR transmission from PilotInstall under Windows
  5. By IR transmission from within Auriga installed on another PDA (Cave/Transmit menu in Main form)
  6. By Bluetooth transmission from this icon in the Windows status bar

Data stuck in a PDA with a broken screen?

The Auriga2SD app (in Download page) performs an automatic backup of Auriga caves and networks on an SD card.

  1. Take an empty SD card of 2 Gbytes or less (a Palm OS limit)
  2. At the card root, create a PALM directory
  3. Copy the Auriga2SD app as 'start.prc' in this directory:


  4. Insert the SD card

The app will start automatically and backup every cave and network from the PDA to the SD card, beeping at each cave or network and playing a 2s beep at the end. The PDA will then turn itself off. The beep is not reliable as it depends on the current volume setting, but the screen turning itself off should be noticeable. The PDA may reboot, but this is without consequence.

Files will be in:


Syncing a Palm OS PDA under 64-bit Windows Vista or Windows 7

To download Aceeca's USB drive that solves the problem, go to the Download page

ProfondeurPuits.pdf document explaining the physical model and the mathematical treatment underlying the Pit Sounder form by its author, Pierre Beauchemin (in French)

A 4'-video on sketch elements grouping in Auriga 2.03+

A 12'-video on sketching in Auriga 2.00+

A 10'-video of what's new in Auriga 1.24+

A 5'-video of videowhat's new in Auriga 1.18+

Brandon Kowallis' five excellent video tutorials

The Grupo Espeleológico G40 (Priego de Córdoba, Spain) publishes various Auriga manuals in Spanish in its Topografía section

The Grup d'Espeleologia de Badalona (Barcelona, Spain) publishes an Auriga manual in catalan in its Manual Topografia section

Installing StyleTap and Auriga into an Android device (tablet or smartphone)

Here is a simple procedure to install StyleTap and Auriga from a PC connected to the device over a USB link. StyleTap and Auriga can also be installed directly (and sometimes with better success) from the Internet (skipping step 5).

  1. Turn on the Android device
  2. Start the Settings app and go to the Security item
  3. Select Unknown sources in the Device Admin tab to allow installing StyleTap from outside the Google Play app store
  4. Download StyleTap
  5. Start the Windows Explorer on the PC (right-clicking on the Start button), drag the StyleTap APK file to [Root/sdcard/]Download on the Android device (depending on whether an SD card is actually mounted, the part between [] may be different or irrelevant)
  6. Start the My Files or Downloads app on the Android device
  7. Open [Root/sdcard/]Download and click on StyleTap to install it
  8. Go to the Android device desktop (My Apps) and start StyleTap; the [Root/sdcard/]Android/data/com.StyleTap.Styletap directory and the Import, Export and Inbox subdirectories get automatically created
  9. Tap the Menu button and select the Applications/Exit item of the emulated PDA to stop StyleTap and return to the Android device desktop
  10. Refresh the view in the Windows Explorer (PC) to see these new directories; if it does not work, unplug and plug the Android device again to force a refresh in the Windows Explorer
  11. Drag Auriga PRC and PDB files into the Import subdirectory of the StyleTap directory
  12. Start StyleTap and Auriga should be there; if not, tap the Menu button and select the Applications/Exit item to stop StyleTap and return to the Android device desktop, then start StyleTap again

To link StyleTap's Keyboard icon to the Auriga Keypad (instead of the Android keyboard):

Create a StyleTapInit.ini file (with Notepad for example - upper/lowercase is important) containing this line:


To connect a Bluetooth device (like a DistoX or a GPS), also add this line in the StyleTapInit.ini file:


Copy this file into the Import subdirectory of the StyleTap directory; you may proceed as in step 11

To enlarge the StyleTap window so as to use the whole PDA screen:

Enable Android developer options:

  1. Settings
  2. About Phone
  3. Tap the Build Number 7 times. An alert pops up to warn it's reaching 7 times
  4. Use the Back arrow to reach Developer Options in Settings
Change the minimum app window size:
  1. Settings
  2. Developer Options
  3. Input a smaller width (reducing this width will enlarge the StyleTap window)

Connecting a Bluetooth device (like a DistoX or a GPS) under Windows Mobile with StyleTap

  1. Create a StyleTapInit.ini file (with Notepad for example) containing this line:


  2. Copy this file into the /Program Files/StyleTap/db directory

  3. Connect the Palm OS RFcomm port ('rfcm') to the host device's communications (COM) port that supports a Bluetooth RFcomm session. In some implementations of Windows Mobile, no preparation is required: when a Bluetooth COM port is opened, the driver pops up a dialog allowing you to choose which available Bluetooth device you want to connect to. Other implementations use a different driver that requires that you create the Bluetooth connection between the device and the Bluetooth device in advance. This may then require that you use the StyleTap SerialUtility program to map the Palm  'rfcm' port to the correct COM port for the connection you defined.

Importing raw data into an Auriga database


  1. Create a Sample cave database (DB) on POSE, inputting a survey shot and session similar to those to be imported
  2. Right-click on POSE and use the Export database menu item to transfer the DB as a Windows file
  3. Run PAR to extract the DB records using the following command:
    par x Sample_Cave.pdb -A Sample_info
    This will extract the cave parameters into the Sample_info file and the survey shot and sessions records into .pdr files (in this order.) You may use these files as templates for the next step

  4. Using the public Auriga file format, write a Windows executable to create a single file for each survey shot and session records, perhaps reading the data from a text file. Be aware of C structures of unions and the fact that Palm OS devices use a little-endian processor (i.e. the lowest byte in a word is the least significant)
  5. Create the target cave database:
    par c -n Target_Cave.pdb -v 56 -I AURI -T Cave -a backup
  6. Append cave parameters:
    par a Target_Cave.pdb -A Sample_info
  7. Repeatedly append survey shot records from Shotnnn files:
    par a Target_Cave.pdb -c 1 Shotnnn
  8. Repeatedly append session records from Sessionnnn files:
    par a Target_Cave.pdb -c 2 Sessionnnn
  9. Load the DB into POSE, reorganize it using the Maintenance form in Auriga and extract it back from POSE using its Export database menu item

Contact Auriga's authors:
Luc Le Blanc (Palm OS software)
Christian Chénier (HotSync conduit)

©Luc Le Blanc 2003