Difference between revisions of "Auriga"

From Ανοικτό Σπηλαιολογικό Εγχειρίδιο
Jump to: navigation, search
(minor updates)
m (Ανάκληση των αλλαγών MariaScott (επιστροφή στην προηγούμενη αναθεώρηση Caspex))
 
Line 144: Line 144:
 
## Go to the *Stations* tab and select the station naming scheme  
 
## Go to the *Stations* tab and select the station naming scheme  
 
## Go to the *Computations* tab and set the map scale and the global magnetic deviation (optional)  
 
## Go to the *Computations* tab and set the map scale and the global magnetic deviation (optional)  
−
## Go to th ... \n
+
## Go to the *Map* tab and set the grid size
 +
## If you want to save these settings so that future caves inherit them by default, drop down the *Defaults* menu and select the *Save Settings as Defaults* item
 +
## Save the cave details with the *OK* button
  
−
== Rats Walking Again After Spinal Cord Injury ==
+
# The [Session|] form pops up automatically (sessions are also known as "surveys" in some other cave surveying software)
 +
## Enter the session name (optional)
 +
## Select length and angle units for instruments set 1
 +
## Tap the *Set 2* pushbutton and select length and angle units for instruments set 2
 +
## Go to the *Shots* tab and set default dimension, azimuth and slope direction
 +
## Set the session\-specific magnetic deviation (optional)
 +
## Select the backsight azimuth and slope behavior
 +
## If you want to save these settings so that future sessions use them as default, drop down the *Defaults* menu and select the *Save Settings as Defaults* item
 +
## Save the session with the *Save* button and exit the form with the *Done* button
  
−
Scientists in Switzerland have restored full movement to rats paralyzed by spinal cord injuries in a study that spurs hope that the techniques may hold promise for someday treating people with similar injuries.
+
# Input survey shots with the [Survey Shot|] form
 +
## Enter start and end stations
 +
## Enter length, azimuth and slope data
 +
## If you enabled passage dimensions in the [Session|] form, enter passage dimensions
 +
## Enter a note (optional, but convenient to find your way in your survey data)
 +
## Tap on the *Save* icon (checkmark)
 +
## Tap on the *New* icon (square with a star) to create a new survey shot
 +
## Repeat entering survey shot data
 +
## Tap on the *Map* icon (network\-like) to view the cave [Map|]
 +
## Tap on the *Form* icon (rightmost at the bottom of the screen) to return to the [Survey Shot|] form
 +
## Tap on the *Home* icon to return to the [Main|] form
 +
Countless other features are available and are fully described in this manual. This manual is easy to read and the text is accompanied by helpful screen shots. It contains:
 +
# valuable information on key surveying concepts used in Auriga
 +
# details on how to use the _Assistant_ to enable you to enter data more quickly and more accurately
 +
# description of all map features tools (zoom, pan, survey shot information, queries, ...)
 +
# use of lists to review or navigate within the data
 +
# and much much more!
 +
To be informed about the frequent updates to Auriga, you should definitely subscribe to the Auriga e\-mail list by sending an e\-mail to: [auriga\-topo\-subscribe@yahoogroups.com|mailto:auriga-topo-subscribe@yahoogroups.com], or at least check back with the Auriga Web site regularly: [www.speleo.qc.ca/Auriga|http://www.speleo.qc.ca/Auriga].
  
−
[[http://goodvillenews.com/Rats-Walking-Again-After-Spinal-Cord-Injury-nBLFSB.html Rats Walking Again After Spinal Cord Injury]]
+
h2.Auriga key concepts
 +
*Stations* are survey locations (virtual or physical, that is, placed anywhere in a cave passage, or located on a cave wall or some other physical feature. Survey shots are taken from one station toward another station.
 +
Auriga supports station names of up to 8 characters, with an optional separator. In the latter case, the station name is input as 2 parts of at most 4 characters each, with the separator in the middle. Example: 12.41
 +
As with any cave survey software, one of the difficulties is to be able to manipulate as a whole a series of survey stations that correspond to a single *cave leg* or *passages* This requires to be able to group survey stations into *Series*. One way to let the cave survey software know which survey stations belong to the same series is to use survey station names that share a common identifiable root.
 +
In addition to 8\-character station names, Auriga also offers a station name format called "4.4" where both the series name and the station number in that series can each use between 1 and 4 characters.
 +
Auriga can discriminate series in station names in the 4.4 format if either:
 +
# An explicit separator (dot or slash) separates between the leg "prefix" (called the "series") and the station number within that series (ex. station LAKE.6B represents station number 6B in series LAKE)
 +
# Exclusive character sets are used for the series name and the station number (ex. A\-Z for series name, 0\-9 for station numbers, so station LAKE66 represents station 66 in series LAKE)
 +
# A character type change occurs between series name and station number. (ex. LAKE66B represents station 66B in series LAKE). Note that in this case, the series prefix is detected when, starting from the leftmost character in the station name, a character type change occurs (ex. in LAKE66B, characters A\-Z can occur in both the series name and station number, but when letters in LAKE change to a digit (6), the series name is detected).
 +
*Note:* With or without separator, with the "4.4" station name format, a 4\-character limit applies to the length of both series name and station number. Station names like LAKEHERE, LAKE2.66B or LA.665544 are thus invalid.
 +
*Survey shots* are links between a pair of stations. Auriga differentiates 3 types of survey shots:
 +
# regular survey shots
 +
# virtual survey shots
 +
# series beginnings
 +
*Regular survey shots* are physical measurements between a start station and an end station. They consist of:
 +
# a length (distance between two stations) or a pair of Topofil readings
 +
# a compass azimuth (horizontal angle between two stations relative to North, true or magnetic, or absolute if a theodolite is used)
 +
# a slope (vertical inclination between two stations), an altimeter, or a depthmeter reading
 +
# optionally, the passage dimensions (height below and above the reference station and width left and right of that station perpendicular to the survey shot; the station where these dimensions are taken, either start or end, is user\-selectable)
 +
*Note:* The *Topofil* is a length\-measuring device originally used in agriculture and forestry and involving a disposable cotton thread rolling onto a wheel connected to a numeric odometer; the thread is cut after each measurement and can be picked up or left to rot on the ground. The Vulcain Caving Group in Lyon, France, makes a popular [model especially designed for caving|http://groupe.vulcain.free.fr/com/btopo.pdf]. Their compact sturdy box also provides azimuth data by aligning the thread with the embedded compass, and slope data, measured with a protractor glued on the side of the box and placed against the thread while the box is maintained horizontal with the help of an embedded bubble level.
 +
*Virtual survey shots* are zero\-length survey shots that link two stations together. Virtual survey shots can act as milestones (the start and end stations can be the same.) Virtual shots can be used to mark an entrance or hold a geographic position; they are also convenient for joining cave legs together when junctions are made. Virtual shots can also be used to record passage dimensions at the beginning (or end) of a passage when dimensions are recorded on end (or start) stations.
 +
*Series beginnings* are virtual survey shots representing the beginning of a series. *Series* are logical groupings of contiguous stations. Their use in Auriga is optional. Stations composing a single passage, or "cave leg", would likely be part of the same series, while another cave branch would be part of another series.
 +
Each series has a unique name; stations pertaining to the same series share this common series prefix. Ex. stations 3.1 and 3.2 are both part of series 3.
 +
Survey shots do not have to be continuously numbered (without gaps) to be part of the same series; their start station only needs to share a common series name. Ex. survey shots 3.1\-3.2, 3.2\-3.6 and 3.6\-4.2 constitute a possible series 3.
 +
Although series can start at any shot number, a *Series Beginning* shot is necessary to hold settings that apply to a whole series (add to cave development, draw or color in map, etc.) Series beginnings are thus special virtual (zero\-length) survey shots linking a cave passage to the rest of the cave.
 +
Using series beginnings imposes 3 minor constraints:
 +
# there can only be one series beginning per series
 +
# the series beginning station must have the smallest station number within the series (ex. 2.2 cannot be a series beginning station if there also exists a survey station numbered 2.1)
 +
# series beginnings survey shots must be entered as: _series beginning station \- connecting station_ (ex. 2.0 \- 1.4 is the beginning shot for series 2) and not the opposite
 +
Series beginnings are often given a station number of '0', '1', 'A' or 'a'. Although not required by Auriga, this may be convenient as it can allow automatic recognition of series beginning shots by the software. These options can be selected in the [Stations|] tab of the [Cave Details|] form.
 +
Even if series beginnings are not used by the target cave survey desktop software, they improve Auriga navigation by making it easier to distinguish cave legs and browse survey shots faster. Series become transparent to cave survey desktop software that do not recognize them: the Auriga conduit simply converts them into virtual survey shots when syncing with these desktop software.
 +
*Geographic positions* given to virtual survey shots or series beginnings are used to compute the geographical position of the current survey shot's stations as well as that of other stations that depend on them. An entrance is usually such a milestone, as well as any other station where a precise position can be determined (likely with a GPS or through radio\-location techniques.)
 +
If the Cartesian coordinates of the stations of a virtual survey shot or a series beginning cannot be computed (because no computed station links to this survey shot), the UTM position of this survey shot, if available, is used to compute the XY coordinates of its stations relative to the cave geo\-reference (if a geo\-reference is available).
 +
*Warning*: In order to minimize data storage, survey shots can only be *either*:
 +
# a regular survey shot
 +
# a virtual survey shot (2 stations virtually made equal)
 +
# a series beginning
 +
and *not* a simultaneous combination of these. Thus, for example, in order to give a geographic position to the entrance station 1.0 and survey from station 1.0 to station 1.1, the user should input:
 +
# a virtual survey shot or a series beginning for stations 1.0\-1.0, holding a geographic position
 +
# a regular survey shot 1.0\-1.1
 +
Survey shots can be saved as *Incomplete*. This allows "reserving" their name, while measuring some or all of the actual survey shot data at a more convenient time. These incomplete survey shots are considered neutral during computations. Survey shots computed from such incomplete survey shots are then part of an incomplete leg. These survey shots are reported in the log produced with the _Shots Errors_ item in the [Cave|] menu.
 +
Survey shots are said to be *Orphan* when there is no "path" between their stations and other computed stations. In order to be able to compute these survey shots and display the related cave legs in the cave map (albeit at an arbitrary location), the computation algorithm arbitrarily sets their start station to be at position 0,0,0. Survey shots computed from such orphan survey shots are then part of an orphan leg. Such orphan survey shots are reported in the log produced with the _Shots Errors_ item in the [Cave|] menu.
 +
*Survey sessions* are actual time periods during which survey shots are taken. The time period is up to the user (a day, a caving trip, an expedition or a whole cave survey.) Each survey session has a given instruments calibration and units choice. Each shot belongs to a session. A survey session can cover several series. Not every shot in a given series needs to be associated with the same survey session. Even with same instruments, sessions can be used to differentiate survey teams or periods of different magnetic declination over time.
 +
An Auriga caves must have at least one session. A session numbered 1 is automatically created with default settings and calibration when the first survey shot is input. Using different Auriga sessions for actual different survey sessions is convenient should instrument calibration or team precision differences later be discovered: modifying the instruments calibration for that given session could fix the interpretation of all survey shot data input during that session.
 +
Sessions are transparent to the cave survey desktop software used: if the target desktop software does not recognize sessions, or a subset of session settings, the Auriga conduit simply applies the instruments calibration or subset of it to every shot and passes corrected data to the desktop software. (Not fully implemented yet.)
 +
The *active session* is the session to which new survey shots are to be added. It is set with the [Session|] menu in the [Session|] form.
 +
The *current session* is the session to which belongs the current survey shot.
 +
Auriga keeps cave survey data in Palm OS *Databases* ("PDB" in the Palm OS vocabulary). Each cave has its own database, named with the name of the cave (up to 26 character) completed with the "\_Cave" suffix. Each cave is complete in itself, containing its settings, survey shots and sessions. Survey shots are automatically kept sorted in caves in increasing alphanumeric order of start and end stations; this is the order one can observe using the navigation arrows in the [Survey Shot|] and the [Map|] forms.
  
−
[[http://goodvillenews.com/wk.html GoodvilleNews.com - good, positive news, inspirational stories, articles]]
+
h3.Customizing Auriga
 +
Auriga is extremely customizable; some people would say "too much", but no one would be willing to drop one's preferred options for the sake of reducing their overall number. Nonetheless, much effort takes place to keep things coherent and understandable. Here's a trick to help you find your way among these many options:
 +
# If an option is relevant to the whole of Auriga (sound, backlight use, Topofil behavior, keypad preferences, Assistant, general display features or the measuring device connected to the Palm, etc.), it belongs to the Auriga [Preferences|] form
 +
# If an option is specific to a cave (display units, target, datum, station names format, geography\-related data, grid, vertical factor, etc.), it belongs to the [Cave Details|] form
 +
# If an option is specific to a survey session (choice of instruments, instruments units or calibration, handling of backsights, etc.) it belongs to the [Session|] form
  
−
== 7 Choices You Always Have (that you dont always give yourself) ==
+
h3.Series vs Sessions
 +
As of version 0.16, Auriga offers sessions the same passage\-related setting as with series. Sessions can thus be used to view a given set of survey shots as representing a cave passage and to act selectively upon these passages (map draw color, sum to/exclude from cave development or show/hide in the map). So, why bother with series if sessions can do the same' Because, in my opinion, series were made just for that, while sessions rather correspond to a given time period when a given team of surveyors used a given set of instruments with a given calibration to survey a cave, or part of it, but not necessarily only a single passage. In other words, sessions relate to the survey process (team and instruments), while series relate to the physical arrangement of cave locations (survey stations). Thus, hijacking the concept of sessions to make it correspond to cave passages requires to create or duplicate a session every time surveyors hit a new passage they could later wish to manipulate selectively. It is cumbersome, and also risky: if you later discover you had an instrument problem that day, you would have to find all relevant sessions to fix the instrument calibration for each of them. To sum up, sessions relate to the survey process (team and instruments) while series relate to the physical arrangement of the cave, the object of cave surveying. Hence my recommendation to use both series and sessions, each for its distinct purpose.
 +
But the choice remains yours, Auriga clearly lets you do it your way.
  
−
I believe the choice to be excellent begins with aligning your thoughts and words with the intention to require more from yourself. ~ Oprah WinfreyMaking choices is probably the most stressful thing that we do as humans. Or perhaps more accurately, the stressful thing we do is to choose avoidance when we dont like what choices were facing. This is what creates the stress.
+
h3.Coordinates
 +
Survey stations are computed into Cartesian coordinates, where:
 +
# X is the horizontal axis (West\-East); positive X values are located East of the origin; negative values West of the origin
 +
# Y is the vertical axis (South\-North); positive Y values are located North of the origin; negative values South of the origin
 +
# Z is the depth axis; positive Z values are located above the origin; negative values below the origin
 +
# C is the cumulative distance (normally drawn along the X\-axis) and is used in combination with the Z\-axis to draw Extended Extended Profiles.  
  
−
[[http://goodvillenews.com/7-Choices-You-Always-Have-that-you-dont-always-give-yourself-RRF.html 7 Choices You Always Have (that you dont always give yourself)]]
+
h3.Data input
 +
In every form where data can be input, it is possible to pop up the [Auriga custom keypad|] with the *1\-2\-3* or *a\-b\-c* buttons in the Graffiti area (depending on field type.)
 +
If a field contains invalid data, upon tapping on the *OK* or *Save* button, the insertion point is moved to the invalid field, its contents, if any, is selected, and a beep sound is played.
  
−
[[http://goodvillenews.com/wk.html GoodvilleNews.com - good, positive news, inspirational stories, articles]]
+
h3.The Input Assistant
 +
The input _Assistant_ is an operation mode designed to ease data input by automating repetitive tasks involved with inputting survey shots. The _Assistant_ can automatically:
 +
# create a new blank survey shot every time a new survey shot is saved, applying proper auto\-incrementation to current station names
 +
# pop up the [Auriga custom keypad|]
 +
# display the cave map
 +
# turn off the device after a new survey shot is saved
 +
# handle the device backlight
 +
While the _Assistant_ options can be set in the [Assistant|] tab of the [Preferences|] form, the _Assistant_ mode is started/stopped in the [Survey Shot|] form.
 +
Under _Assistant_ control, the behavior of the device hardware buttons is altered (see tables at the end of this manual), again to concentrate on the task of inputting survey shots. To prevent mishaps, leaving the _Assistant_ mode must be explicitly confirmed.
  
−
== The Power of Words and Emotional Bonding! ==
+
h3.Launching Auriga
 +
When Auriga is launched, the 4 hardware buttons on the front of the device (or 2 on the Palm Zire) usually assigned to the built\-in organizer applications are automatically reassigned to Auriga. This prevents accidentally exiting Auriga while letting Auriga use these buttons to ease survey shot navigation, map handling, data input, etc. After the device is turned off, either manually or automatically, hitting any hardware button wakes up Auriga, left in its previous state; the same result is obtained if the power button is depressed. Thus, the proper way to leave Auriga is to hit the *Home* button in the Graffiti silkscreen area. Upon exiting Auriga, hardware buttons are restored to their previous assignment (Agenda, Addresses, etc.)
 +
If Auriga is not exited properly (i.e. after a crash or device reset), hardware buttons remain assigned to Auriga. Simply re\-launching and exiting Auriga restores the buttons to their previous assignment.
 +
Conversely, when tapping the *Calculator* button in the Graffiti silkscreen area (a *star* button on some Palm devices), this button gets temporarily reassigned to Auriga so as to allow a quick return from the calculator back into Auriga by simply tapping this button again. This button gets reassigned to its previous state when returning to Auriga.
 +
When Auriga is launched, it re\-opens the cave and the form it was left in when last exited. If the *PageUp* button is held down while the Auriga icon is tapped, an alert offers to start Auriga without opening the previously open cave, or to reset of all Auriga preferences is also offered; note that this does not affect cave\-specific settings.
  
−
If you become steadfast in your abstentions of thoughts of harm directed toward others, all living creatures will cease to feel enmity in your presence. PatanjaliWords have power, incredible power, and this power lies in each and every one of us. Of course, its up to us to use this power for the greater good of all or not.
+
h3.Coordinates computation
 +
Station coordinates are automatically computed when necessary. The following actions trigger this automatic computation process:
 +
# Displaying the [Map|]
 +
# Displaying the _Stations_ or _Graph_ views in the [List|] form
 +
# Selecting the _Statistics_, _Shot Errors_ or _Closure Errors_ items of the [Cave|] menu
 +
The computation process can also be triggered manually by selecting the _Re\-compute Coordinates_ of the [Map|] or [List|] menus.
 +
If coordinates are already computed, saving a survey shot causes its coordinates to be incrementally computed; this is faster than re\-computing the whole cave. Deleting and, in some case, modifying an existing survey shot requires a full re\-computation, this is done automatically if the _Compute Shots on Save_ is selected in the [Map|] tab of the [Preferences|] form. If the new survey shot closes a loop, an alert reports the closure error. If saving a survey shot connects an orphan leg to the rest of the cave, an alert is displayed.
  
−
[[http://goodvillenews.com/The-Power-of-Words-and-Emotional-Bonding-2wgncv.html The Power of Words and Emotional Bonding!]]
+
h3.Passage dimensions
 +
Auriga interprets passage dimensions (left, right, up and down) as being taken perpendicular to survey shots. Passage dimensions are associated to survey stations, and each station can only have a single set of passage dimensions. When station coordinates are computed, even if several survey shots provide passage dimensions for the same station, only the first set of passage dimensions found while computing survey shots is kept for a given station in the cave graph for map display purposes (but the input data remains untouched).
  
−
[[http://goodvillenews.com/wk.html GoodvilleNews.com - good, positive news, inspirational stories, articles]]
+
h3.Cave diving data
 +
Survey shots taken while cave diving differ from other survey shots in their use of a depthmeter as the instrument for slopes. When taking cave diving data, the associated session must thus use a depthmeter. If a dive survey shot connects to a non\-dive survey shot, it is assumed that the start station is at depth = 0 (feet or meters). For clarity to humans reading the data, it is suggested (but not required) that a zero\-length shot be used to mark the beginning of a dive leg at depth 0. This zero\-length shot can be a normal shot with length = 0 or, even better, a virtual ("=") shot or a series beginning (when series are used). With virtual shots or series beginning, it is also possible to input an arbitrary depth (other than 0) with a position of type _Depth (diving)_.
 +
Note that all underwater shots should have a negative value for depth. If a positive depth is provided, Auriga understands that the station is sitting above the water surface. Positive depths can therefore be used for short sections above water between two sumps (assuming of course that one has the ability to accurately measure the distance above water and that the surface of both sumps is at the same height.)
 +
*Notes regarding cave diving survey data:*
 +
# Depthmeter readings entered as foresight or backsight slopes are always assumed to correspond to the end station of a survey shot, regardless of the state of the _Direct_ checkbox for the slope data in the [Survey Shot|] form.
 +
# The backsight slope is not displayed (see the [Shots|] tab of the [Session|] form) if the slope instrument for one set is a depthmeter while the other set is not a depthmeter (but if two depthmeters are used, even with different units, the expected depth for the second instrument can be displayed, taking into account both instrument calibrations). The expected backsight slope is not displayed if both depthmeters are the same (see the _Instrument Set #2=#1_ checkbox in the [Instruments|] tab (set #2) of the [Session|] form) because this would only repeat the entered value.
 +
# The projected length of the survey shot is not displayed if the slope instrument for set 1 is a depthmeter.
  
−
== Rats Walking Again After Spinal Cord Injury ==
+
h2.Auriga forms
  
−
Scientists in Switzerland have restored full movement to rats paralyzed by spinal cord injuries in a study that spurs hope that the techniques may hold promise for someday treating people with similar injuries.
+
h3.The Main form
 +
 +
The Main form is Auriga's default entry point.
 +
The view drop\-down list in the title bar allows switching between a view of caves or networks present on the device.
 +
The list displays the name of caves/networks present on the device. Read\-only caves or networks (see the [Cave Details|] form) appear with a *padlock* icon next to their name. Tapping a list entry selects it. Tapping again on a selected cave opens the cave and leads to the [Survey shot|] form, showing a survey shot, if any. Tapping again on a selected network opens the network and leads to the [Network Details|].
 +
*Note:* Auriga memorizes its previous state and automatically skips the _Main_ form to go directly to the active form and current shot when Auriga was last exited. Holding the PageUp hardware key while starting Auriga opens the Main form (forgetting the previously open cave/network and active form).
 +
Icons allow to:
 +
# Create a *New* cave/network (leads to the [Cave Details|] or [Network Details|] form)
 +
# *Delete* the selected cave/network
 +
# Display the [Survey Shot|] form with a survey shot from the selected cave
 +
# Display the selected cave/network [Map|]
 +
# Display the [List|] form for the selected cave
 +
# *View/Edit* the note associated with the selected cave/network
 +
*Note:* Holding down the Map or List buttons pops up a list of available views prior to opening the corresponding form.
 +
The *EN* selector allows to toggle the language under which Auriga operates (Auriga is available in French, English and Spanish). This option requires to load on the device the proper supplementary *Auriga''\_rsrc.prc* resource files (where '' is the language abbreviation.) Toggling the language restarts Auriga. This setting is retained for subsequent Auriga start\-ups. *Note:* The version of the resource file must match that of Auriga to be usable; otherwise Auriga falls back to the native language of its PRC file.
 +
*Up/Down* scroll buttons scroll the cave list by one page.
 +
Entering text in the *Lookup* field moves the list selection the first cave/network with its name starting with this text (characters other than alphanumeric are skipped.) The field can be scrolled horizontally using the hardware buttons located on either side of the Up/Down scroll buttons.
 +
Menus: [Cave|] or [Network|], [Edit|] and [Options|].
  
−
[[http://goodvillenews.com/Rats-Walking-Again-After-Spinal-Cord-Injury-nBLFSB.html Rats Walking Again After Spinal Cord Injury]]
+
h3.The Preferences form
 +
Preferences set in this form are global to Auriga and used throughout all caves.
 +
This form has 4 tabs, selected with pushbuttons in the title bar.
  
−
[[http://goodvillenews.com/wk.html GoodvilleNews.com - good, positive news, inspirational stories, articles]]
+
h4.The General tab
 +
 +
Select the *Sound* level for Auriga warnings and errors (used when no other visual clue is given to the user.) This sound level overrides the system sound level set in the built\-in Prefs application.
 +
Select the *Backlight* checkbox so that Auriga automatically turns on the backlight (if not already on) when launched.
 +
Select the desired *type of data save* behavior:
 +
# _Manual Shot/Session Save_ requires a manual save of modified survey shot or session data before leaving the window or the current shot/session, otherwise it is lost; this is the least safe option.  
 +
# _Warn if Data Save Needed_ warns the user when unsaved data is about to be overwritten or abandoned
 +
# _Automatic Shot/Session Save_ automatically saves modified survey shot or session data when needed; this is a convenient choice when inputting new cave data.  
 +
# _Automatic Save\+Overwrite_ automatically saves modified survey shot or session data when needed and automatically updates existing survey shots when modified; this is a convenient choice when reviewing existing cave data.  
 +
Select the calculator thats gets launched when tapping the *Calculator* button (or *Star* on some Palm Zire devices) in the Graffiti area while Auriga is active. Tapping this button again while using the calculator returns to Auriga.
 +
Select the *Enable Global Find* checkbox so that Auriga searches the cave notes, survey shot names and notes, session names and notes and network notes in all its caves and networks when the Palm OS Global Find is launched outside of Auriga. If the Palm OS Global Find is launched within Auriga while a cave is open, the search only takes place in the current cave or network.
 +
*Note:* Global Find is always enabled when launched while Auriga is running.
 +
If measuring lengths with a Topofil, select the *Continuous Topofil* checkbox to have Auriga automatically initialize the start Topofil reading of a survey shot with the end Topofil reading of the previous shot. This reading can be overridden for each individual survey shot
 +
Select the *Show Projected Length* checkbox to display in the [Survey Shot|] form the net shot length projected over horizontal ground (useful for sketching.)
 +
Select the *Notes Keyboard* to use when editing notes. If the Palm OS keyboard is selected, it opens within the [Auriga custom keypad|]. If _None_ is selected, when field navigation reaches a note field, the [Auriga custom keypad|] closes automatically.
 +
Select the *Toggle keyboards*, i.e. the Auriga keyboard layouts that stay on for a single character (with a subsequent automatic return to the alphabetic layout.) See the [Auriga custom keypad|].
 +
Select the input order of numeric fields of the survey shot. This determines the order in which fields are navigated with the PageUp/Down buttons or Up/Down arrows in the [Survey Shot|] form or the [Auriga Keypad|].
 +
# *Length (including Topofil) \+ Angles (Azimuth and Slope) \+ Dimensions Left, Right, Up, Down*
 +
# *Length (including Topofil) \+ Angles (Azimuth and Slope) \+ Dimensions Up, Down, Left, Right*
 +
# *Length (including Topofil) \+ Dimensions Left, Right, Up, Down \+ Angles (Azimuth and Slope)*
 +
# *Length (including Topofil) \+ Dimensions Up, Down, Left, Right \+ Angles (Azimuth and Slope)*
 +
Select the *Auto Decimal Lengths* checkbox to let Auriga complete length data (including passage dimensions) when the decimal sign is skipped during input (whether in Graffiti or through the [Auriga custom keypad|].) The data is then interpreted in hundredths of length unit:
 +
7 becomes 0.07
 +
70 becomes 0.70
 +
700 becomes 7.00
 +
Select the *Auto LRUD* (Dimensions) checkbox to let Auriga complete missing passage dimensions (Left, Right, Up, Down) upon saving the survey shot when the opposite dimension has been input (e.g. insert 0.00 in Left dimension if a Right dimension is provided, or vice versa, and conversely for Up/Down dimensions.) This can be convenient when survey stations tend to be located on cave walls.
 +
Select the appearance of the numeric layout of the top row of the [Auriga custom keypad|] with the *123* or *789* pushbuttons.
  
−
== How To Let Go of Insecurities 7 Steps To Build Your Confidence ==
+
h4.The Assistant tab
 +
 +
The _Assistant_ provides an automated input mode while surveying a cave (see the [Assistant|] section and the [Survey Shot|] form.)
 +
The Assistant tab is used to configure the behavior of the input _Assistant_. The _Assistant_ itself is started by selecting the *Assistant* pushbutton in the [Survey Shot|] form.
 +
Select the *Auto Popup Auriga Keypad* checkbox to automatically display the Auriga custom keypad when inputting a new survey shot.
 +
Select the *Use Passage Size Fields* checkbox to make the Auriga keypad navigate into the passage size fields of the [Survey Shot|] form. when writing an up/down Graffiti symbol, scrolling with the *Up/Down* scroll buttons or using *Arrow* buttons. *Note:* If the current session makes passage sizes mandatory (see the [Shots|] tab of the [Session|] form), passage size fields are always navigated into.
 +
Select the automatic _Assistant_ behavior *After Saving a Survey Shot*:
 +
# *No special action*
 +
# *Create New Survey Shot* creates a new empty survey shot with auto\-incrementation applied to the survey stations of the save survey shot
 +
# *Create New Shot; Power Off* same as option above, with device powering itself off
 +
# *Show Map* computes the new survey shot and displays the Map
 +
# *Map; New Shot\->Power off* computes the new survey shot and displays the Map; upon returning, creating a new empty survey shot also powers off the device
 +
*Note:* A new survey shot is automatically created only if the saved survey shot was itself new. Saving a modified existing survey shot does not automatically create a new survey shot.
 +
Select the *Keep Backlight On* checkbox to automatically activate the backlight while in _Assistant_ mode (only available on monochrome devices.) This option differs from the one in the [General|] tab as it only applies to the _Assistant_.
  
−
Self-worth comes from one thing thinking that you are worthy. Wayne DyerIts okay to have insecurities, we all do and its crucial for us to observe and understand the impact these insecurities have on the quality of our lives.
+
h4.The Map tab
 +
 +
Select the *Full Screen Cave Map* checkbox to use the full screen height to draw the cave map. Controls at the bottom of the [Map|] form can then be show/hidden by tapping in the Graffiti area as they overlap the cave map.
 +
Survey shot coordinates are incrementally computed every time a survey shot is saved, if other survey shots are already computed. This is faster than re\-computing the whole cave, but only works with new survey shots. Modifying or deleting an existing survey shot may require a total computation. Selecting the *Compute Shot on Save* checkbox allows Auriga to perform coordinates computations even if this requires a full re\-computation of the cave.
 +
Select the *Grid*, *Default Trace*, *Current Shot* and *Walls* colors.
 +
Select the *Black Background* checkbox to display the map against a black background.
 +
*Note:* Color\-related options are only available on devices with halftones of color.
 +
Indicate the *Paper Grid Size* in the notebook where sketching is to take place (i.e. the actual physical size of printed squares; ex. 1 mm) as well as the number of *Decimals* used to display coordinates in the [Sketch to Scale|] form.
  
−
  [[http://goodvillenews.com/How-To-Let-Go-of-Insecurities-7-Steps-To-Build-Your-Confiden-APt.html How To Let Go of Insecurities 7 Steps To Build Your Confidence]]
+
h4.The Link tab
 +
   
 +
The _Link_ tab allows configuring an electronic measuring device connected to Auriga.
 +
Select the *Device* connected to Auriga. If no device is selected, the rest of the form is blank. Auriga currently support any NMEA\-capable GPS (i.e. most GPSes) as well as a [Disto|http://auriga.neopages.org/www.leica-geosystems.com/cpd/], the [Revolution|http://www.tntc.com/Products/revolution.htm] electronic compass/clinometer module from [True North Technology|http://www.tntc.com/] or the Toposcan prototype. Depending on the selected device, some form options may be locked or hidden if irrelevant.
 +
If the *Link* type is _RS\-232 (serial)_, select the *Baud* rate to match that of the connected device.
 +
In order to connect a serial device via the HotSync cable, a null\-modem adapter is usually required betwwen this cable and the one supplied with the device (2\-3, 3\-2, 5\-5 on a 9\-pin connector.)
 +
*Note:* All Palm OS USB device connectors, with the Palm Zire and Tungsten E as the only (') exception, feature both USB and serial pins. It is thus possible to buy or assemble a serial cable for a USB device.
 +
After a first connection was established with a Bluetooth device, a *Bluetooth* button allows to know its device id and to clear it to provoque a new device discovery (necessary when using another device of the same type.)
 +
Select the *Data Use Mode*:
 +
# *Input Survey Data* fills the relevant [Survey Shot|] form input fields with the received data
 +
# *Input Survey Data \+ Dimensions* fills the relevant [Survey Shot|] form input fields (including passage dimensions) with the received data. This option only applies to devices allowing the measurement of length data and requires five consecutive data measurements (one for the survey shot length, four for passage dimensions)
 +
# *Input GPS Position* fills the relevant [Survey Shot|] form position input fields with the received GPS location
 +
# *Display/Track Acquired Data* displays the received data. In the [Survey Shot|] form, survey data or GPS locations are displayed in a popup form.
 +
\[not implemented\] In the [Map|] form, the current GPS location is marked with a cross\-line (\+).
 +
The _Input GPS Position_ option can only be selected if the connected device is a GPS. Conversely, options _Input Survey Data_ and _Input Survey Data \+ Dimensions_ can only be selected if the connected device is a TNT Revolution module.
 +
With the first three data modes, if the survey shot currently displayed already exists when data is received, an alert asks whether to create a new survey shot or to replace the data of the existing one. If the current survey shot is incompatible with the type of received data (ex. a virtual survey shot vs azimuth data), an alert asks whether to create a new survey shot or to adapt the existing survey shot to the type of data received.
 +
*Note:* The received survey data can only be copied into relevant input fields of the [Survey Shot|] form if the connect device corresponds to the measurement instrument selected for these fields in the [Session|] form.
 +
In _Display/Track Received Data_ mode, Auriga can operate in a *Cyclical Measurement* mode, fetching data in a *Continuous* manner (as fast as it can) or repeatedly after a user\-selectable time period varying between 5 and 900 seconds (15 minutes). The *Suspend Auto\-Off* checkbox may be selected to suspend the Palm OS auto\-off timer that would otherwise halt data reception.
 +
When a device is selected, the *Dimensions* icon (4 arrows) in the center of the [Survey Shot|] form is replaced by an *Connect* pushbutton 
 +
This pushbutton is used to toggle the data link. The device beeps every time new data is received. Holding down this pushbutton pops up a list of possible actions:
 +
# *Continue sequence* measures the next field in the measurement sequence
 +
# *Repeat Last Input* repeats the measure of the previous field in the measurement sequence
 +
# *Stop Sequence* stops the measurement sequence
 +
# *Restart at Current Field* restarts the measurement sequence at the current field (where the cursor is)
 +
If the device needs to be prompted for data (currently only the TNT Revolution module works that way), a *2\-step* process can be selected; this allows to pause between the link connection and the actual data measurement. The pause is interrupted when tapping again on the *Connect* pushbutton. It is also possible to select a *Delay* between the connection and the actual data measurement. In this case, the device beeps one second before the measurement takes place.
 +
Select the *Auto Create New Shot* checkbox to automatically create a new survey shot when data is received while an existing survey shot is displayed.
 +
Select the *Auto Detect Retries* checkbox to automatically detect that a measurement has been repeated when the measured azimuth is within ±45° of the previous one. In this case, an alert asks whether to replace the data in the _Survey Shot_ form by the new measurement. This option is only available with the Toposcan.
 +
Select the *Accept Retries* checkbox to automatically accept the data of a repeated measurement when it is detected (see previous checkbox.) This option is only available with the Disto and the Toposcan.
 +
Select the *Auto Detect Sequence* checkbox to automatically detect that passage dimension fields are skipped during the measurement sequence. This can be convenient when survey stations tend to be located against cave walls.
  
−
[[http://goodvillenews.com/wk.html GoodvilleNews.com - good, positive news, inspirational stories, articles]]
+
h5.Connecting a GPS
 +
Select the *Format* used to display or store the received location. Until geodesic conversions are implemented, only latitude\-longitude formats are supported. Make sure the data communication protocol is set to NMEA on the GPS side (many units default to proprietary protocols). The NMEA protocol standardizes the baud rate at 4800.
 +
Select the *Link* type used to connect to the GPS, either _Serial_ (RS\-232), _Bluetooth_ or _Internal_ if Auriga is running on a Garmin iQue Palm OS PDA (featuring an internal GPS.)
 +
The current time on a device running Palm OS 4.0 or better can be synchronized with the GPS time by selecting the *Sync Device with GPS Time*. This operation is performed only once after the connection is established. This option is not offered with the Garmin iQue, where the device already performs this operation automatically.
 +
The altitude unit is set by the current session; the GPS always transmits in meters, possibly causing an automatic conversion in Auriga.
 +
When using GPS data to fill survey shots, select the *Use GPS Altitude* checkbox to fill the altitude field with the altitude data reported by the GPS (if available).
 +
 
 +
h5.Connecting a TNT Revolution module
 +
When received azimuth/slope data from the TNT Revolution module, the azimuth and slope units in the current session may be selected among degrees, grads or %; the module must be set to report degrees (default selection), possibly causing an automatic conversion in Auriga.
 +
 
 +
h5.Connecting a Disto
 +
If the _Input Survey Data \+ Dimensions_ mode is selected, an input order where passage dimensions immediately follow the length data should be selected in the [General|] tab, so as to perform all Disto measurements in a row, followed by angular measurements.
 +
It is advisable to let Auriga automatically move from field to field every time new data is received. Otherwise (i.e. if the _Manual Sequence_ checkbox is selected), it is necessary to manually move the insertion point from field to field (ex. with the PageDown button.) In manual sequence mode, if a measurement is repeated for a non\-empty field, if the _Accept Retries_ checkbox is selected, the previous data is silently overwritten, otherwise an alert pops up. Note that even in automatic sequence mode, it is always possible to move the insertion point backwards to repeat a measurement, or forward to skip a measurement (e.g. when the survey station is against a wall, this zero\-length measurement can be skipped \- it it then advisable to have the _Auto LRUD_ checkbox selected in the [General|] tab so as to let Auriga automatically fill the skipped field with 0.00).
 +
When the *2nd* button is hit on the Disto A6, 8 buttons can now transmit an arrow character:
 +
# the 4 *corner* arrows write an 'X' (unknown) in the current passage dimension field of the [Survey Shot|] form
 +
# the *Up* arrow moves the cursor to the previous length or passage dimension field of the [Survey Shot|] form
 +
# the *Down* arrow moves the cursor to the next passage dimension field of the [Survey Shot|] form. If the skipped field is a passage dimension field, 0.0 is written
 +
 
 +
h3.The Cave Details form
 +
This form displays information on a cave, either existing or being created.
 +
This form has 4 tabs, selected with the pushbuttons in the title bar.
 +
 
 +
h4.The Cave tab
 +
 +
The *Name* of the cave can be any string of 26 characters or less and may include spaces. This corresponds to the name of the Auriga cave PDB on the Palm OS device (with a 5\-character suffix to distinguish it between PDB types.) Editing the name of an existing cave actually renames it (an alert is issued before proceeding.)
 +
The *Category* selector allows selecting the cave category. Categories are edited in the usual Palm OS way by selecting the _Edit categories..._ list item.
 +
If you do not intend to modify the cave data and wish to prevent accidental modifications, select the *Read\-only* checkbox (implicitly prevents adding survey shots.) A new cave cannot be set as read\-only.
 +
*Note:* In read\-only mode, survey data (survey shots or sessions) or details that could affect computations cannot be modified. Nonetheless, details that determine the cave map presentation can still be modified.
 +
Select the *Public* checkbox to store the synchronized cave in the public Palm Desktop directory on the desktop computer (as opposed to the user directory.)
 +
Select measurement units to be used for computing coordinates:
 +
# *Lengths* unit (_meters_ or _feet_)
 +
# *Angles* unit (_degrees_ or _grads_) for azimuths and projection angle
 +
# *Slopes* unit (_degrees_, _grads_ or _%_)
 +
# *Slope 0* setting (_up_, _level_ or _down_)
 +
*Note:* Measurements units selected in this form are used throughout Auriga to report coordinates, lengths and angles between stations and statistics.
 +
Select the *Target* desktop software this cave is going to be synchronized with and indicate the *version* number. This information is used to suggest usage in survey management or to enforce rules dictated by the target desktop software constraints. If no desktop software syncing is to take place (other than a backup with the HotSync Manager), select *None* to ensure proper internal handling of deleted records.
 +
Select the format to be used to display *Positions* in the cave map (_XYZ_ (relative to the origin station), _UTM_, _d°m's"_ or _d°m.m'_.)
 +
If latitude/longitude or UTM geographical positions are to be input, select the proper topographical *Datum* to use for conversions.
 +
Tap the *Note* button to edit the cave note. 255 characters are permitted.
 +
 
 +
h4.The Stations tab
 +
 +
Select the appropriate name format pushbutton: *4.4* or *8* characters. In 4.4 format, the separator (usually a dot) does not count as a character. In 8\-character free format, all characters are counted.
 +
*Note:* Series support is possible in the 8\-character by actually choosing the 4.4 format with a null separator. It is then necessary to select distinct non\-overlapping character sets for the root (series) and shot number subparts (e.g. "HM12") so that Auriga can discriminate series prefixes. Overlapping character sets require the *Auto Split Series in Name* option below.
 +
Select the character set allowed for the left and right subparts of station names and the separator used between station name subparts (if 4.4 format is selected.)
 +
Select whether punctuation characters are allowed for the right subpart of station names. Supported characters are:
 +
 
 +
*.,;:\-\+/=!@$%'&\*()<>\[\]\{\}\|\~'\*
 +
Select the *Auto Split Series in Name* to automatically split 4.4 station names into series and station number upon the first leftmost change in character type (digit\->letter or vice\-versa). Each resulting subpart remains limited to 4 characters in length.
 +
Select *Use Alpha Keypad* checkbox to launch the alphabetic layout of the Auriga keypad to edit station names.
 +
*Note:* Alphabetic characters can also be input with Graffiti strokes.
 +
Select the *Enforced Series Beginnings* checkbox to indicate that series beginnings can only use the allowed start station number among "0", "1", "A" or "a". Otherwise, series beginnings can be any first survey shot of the series.
 +
Select the *Shot Navigation Mode* with navigation arrows in the [Survey Shot|] and [Map|] forms. Choices are:
 +
# *Go to the next or previous series beginning* (default if the 4.4 format is selected)
 +
# *Go to Next Series* (determined by a station naming change in the left subpart of the station name if the 4.4 format is selected)
 +
# *Go to Next Session*
 +
# *Move by n shots*, where n is user\-chosen value between 1 and 255
 +
*Note:* If series are not allowed, that is, the naming scheme is not 4.4, the only available behavior is to *Move by n shots*
 +
Select the *Auto\-incrementation* mode for station names when creating new survey shots. Options are:
 +
# *None* (station fields are left blank)
 +
# *Repeat Shot* stations (and let user edit them manually)
 +
# *Add one* to previous start station (start station is set as the end station of the previous shot and the end station is incremented by 1; this works with both numbers and letters)
 +
# *Leap Frog*; if the previous shot is "forward" (start station < end station), then the new start station is set to the previous end station \+ 1 and the new end station is set to the previous end station. If the previous shot is "backward", then the new start station is the same as the previous shot's start station, and the end station is the start station \+ 1.
 +
 
 +
Example: 1.2\->1.1, 1.2\->1.3, 1.4\->1.3, 1.4\->1.5, 1.6\->1.5, 1.6\->1.7
 +
*Note :* Auto\-incrementation can be performed equally on digits or letters, but if the rightmost character is a digit, only digits get incremented, or vice\-versa with letters (where case is sensitive). Eventually, characters may be added by the auto\-incrementation process. If series are enabled, only the station number within the series is incremented.
 +
Examples:
 +
 
 +
ANA99y increments to ABA99z, which increments to ANA99aa
 +
ANA999 increments to ANA1000, but ANA99999 fails (8\-character limit)
 +
ANA.999 increments to ANA.1000, but ANA.9999 fails (series limit reached)
 +
 
 +
h4.The Computations tab
 +
 +
Select the *Sessions override Series* checkbox so that _Draw in Map_ and _Sum to cave length_ session attributes override those of series.
 +
Input the cave map *Scale* used to compute coordinates reported in the [Sketch to Scale|] form; for example:
 +
 
 +
1 cm = 1 m corresponds to a scale of 1:100
 +
1 inch = 20 feet corresponds to a scale of 1:240 (there are 12 inches in a foot)
 +
*Note:* This scale does not affect coordinates reported in the [List|] or [Map|] forms.
 +
Input the *Maximum Loop Error* that triggers the station XYZ position error detection algorithm.
 +
Select the *Save XYZC Computations* checkbox to retain computed coordinates when closing the cave, thus making map display faster when re\-opening the cave (at the price of accrued storage requirements.)
 +
\[not implemented\] Select the *Loop Close* mode (_Never_, _On demand_ or _Always_) to determine when the loop closure is to be applied. Selecting _Always_ applies the loop closure algorithm every time coordinates are computed. If this feature is never going to be used, select _None_ to quicken coordinates computations.
 +
Input the *Magnetic Deviation* that is going to be applied to survey shots that belong to session that does not hold a magnetic deviation. A westward magnetic deviation must be set as negative; an eastward deviation as positive.
 +
Select the *Geo\-Reference* station of the cave, that is the station whose geographic location is to be used to compute other locations. If this field is left blank, or if the selected station does not have a geographic location, the coordinates computation algorithm uses the start station of the first series beginning with a geographic location as the geographic reference station.
 +
Select the *Origin* station of the cave as well as its XYZ coordinates (0,0,0 by default), expressed in map units. If this field is left blank, the coordinates computation algorithm uses the first station of the cave as the origin station, and assumes a 0,0,0 initial position.
 +
 
 +
h4.The Map tab
 +
 +
Select the cave\-specific map *Grid* value. See the [Map|] tab of the [Preferences|] form for general grid preferences (that apply to all caves).
 +
Select the *Automatic Grid Resize* checkbox so that the map grid gets resized when it cannot be displayed within the user\-defined minimum and maximum number of lines. The grid value is then multiplied or divided by 2 and rounded to the lowest integer. Otherwise, the grid is hidden.
 +
Select the *Wall Color same as Shot* checkbox so walls and dimensions are drawn in the map using the color of their corresponding survey shot. Otherwise, they are drawn using the default color selected in the [Map|] tab of the [Preferences|] form.
 +
Select the default direction to *Develop* survey shots in the extended profile view with the *Left* or *Right* pushbuttons.
 +
Select the *Vertical* factor used in profile maps and coordinate computations to exaggerate the verticality of the cave for display purposes. A factor less than 1 (ex. 0.5) actually flattens out a vertical cave. This factor is applied to coordinates reported in the [List|] form for drawing, but coordinates reported in the [Map|] form are not affected.
 +
Menus: [Edit|] and [Defaults|].
 +
 
 +
h3.The Survey Shot form
 +
This form is used to input and display survey shot data. It can be used in a manual mode or automated input with the help of an _Assistant_. The _Assistant_ makes input easier and faster by automatically and optionally:
 +
# popping up a smart keypad allowing to input digits without the help of the stylus
 +
# creating a new empty shot when the current one is saved
 +
# performing a smart incrementation of station numbers
 +
# preventing accidental escapes from the input mode
 +
The _Assistant_ can be toggled on/off with the *Assistant* pushbutton in the form title bar (upper right corner.)
 +
3 types of survey shots can be input with this form, which self\-adapts by hiding or showing different user interface controls (checkboxes, pushbuttons or drop\-down lists) depending on that type:
 +
# [Regular survey shots|], with actual survey data (length, azimuth and slope) between two stations
 +
# [Series beginnings|], linked onto themselves (cave entrance) or to other series, and usually determining the start of a cave leg. Series beginnings have no proper survey data (length, azimuth and slope) but can hold a geographic (UTM or latitude/longitude) or absolute position (XYZ)
 +
# +Virtual shots+, where two survey stations are virtually made the same (convenient to close loops)
 +
*Form features common to all survey shot types*
 +
 +
The *Station IDs* are displayed as "series.number". The topmost station ID is the start station while the bottommost station ID is the end station. The direction that determines the start and end of survey shots is the direction of the surveying process, regardless of whether survey shots use direct or reverse azimuths.
 +
Depending on settings configured in the [Station|] tab of the [Cave Details|] form, any first survey shot of a series or only those survey shots with a start station numbered "0", "1", "a" or "A" (ex. 6.0) may be automatically set as series beginnings.
 +
*Passage sizes* (above, below, left and right of the survey station) can be associated with either the *Start* or the *End* station of the survey shot using the corresponding pushbutton in front of them.
 +
*Note :* Auriga supports the input of letter 'X' to signal an unknown or undetermined passage dimension, for example when crossing another passage. This is similar to inputting a 'P' (Passage) in Compass.
 +
Select the *Gray halftone* or *Color* this survey shot or survey shots in this series (depending on case) will take in the map (offered only if device permits.)
 +
Tapping the *Attributes* icon displays a list of attributes:
 +
# *Entrance on Start/End Station (Es/Ee)*: the start/end station is a cave entrance; the [Map|] form can display a 'E' next to these stations
 +
# *Permanent Start/End Station (Ps/Pe)*: the start/end station is marked permanently (cairn o other); the [Map|] form can display a 'P' next to these stations
 +
# *Lead on Start/End Station (Ls/Le)*: the start/end station has a possible lead; the [Map|] form can display a ''' next to these stations
 +
# *Surface Survey Shot (S)*
 +
# *Dead Survey Shot (D)*: this survey shot is ignored by computations and map display (similar to 'X' shots of Compass)
 +
# *Hide in Map (H)*: hides this individual survey shot from the map
 +
# *Flip Development Direction (F)* flips the development direction of this survey shot in the Developed Profile view
 +
# *Exclude from development (X)* excludes the length of this survey shot from the total developement of the cave
 +
# *Ignore Azimuth (Ia)*: the foresight azimuth of this survey shot is ignored by computations \- selecting this attribute displays the azimuth field with a small font
 +
# *Ignore Backsight Azimuth (Ia\-)*: the backsight azimuth of this survey shot is ignored by computations \- selecting this attribute displays the backsight azimuth field with a small font
 +
# *Ignore Slope (Is)*: the foresight slope of this survey shot is ignored by computations \- selecting this attribute displays the slope field with a small font
 +
# *Ignore Backsight Slope (Is\-)*: the backsight slope of this survey shot is ignored by computations \- selecting this attribute displays the backsight slope field with a small font
 +
Abbreviations in parenthesis are those used in the list of attributs in the _Survey Shots_ view of the [List|] form.
 +
The *Attributes* icon is highlighted when at least one setting is set.
 +
Parallel or duplicate survey shots that would otherwise exaggerate total cave length can be ignored when computing this length. This can be done at the survey shot level by selecting the _Exclude from Development_ attribute.
 +
*Note:* If the *Sum Series to Cave Length* checkbox is unselected in the series parameters, the _Exclude from Development_ attribute is ignored for all shots within this series.
 +
Tapping the *Alarm clock* icon displays the date the survey shot was saved. This date should only be modified with caution.
 +
The type of survey shot is determined by the following pushbuttons;  these determine which form controls must be hidden or shown:
 +
# the *Link* pushbutton  creates a regular survey shot
 +
# the  pushbutton creates a virtual shot (station equal to another one)
 +
# the *Series* pushbutton creates a series beginning
 +
*Note:* If series are disabled (i.e. the station names format selected in the [Stations|] tab of the [Cave Details|] form is 8\-character), the *Series* pushbutton does not appear in the form.
 +
Arrow pushbuttons  allow to navigate between survey shots within the cave. From left to right, they load:
 +
# the first survey shot in the cave
 +
# the previous series beginning/beginning of current series *or*
 +
## first shot in previous series or cave leg *or*
 +
## move backward by a user\-chosen number of shots
 +
depending on settings configured in the [Stations|] tab of the [Cave Details|] form
 +
# the previous shot
 +
# the next shot
 +
# the next series beginning *or*
 +
## first shot in next series or cave leg *or*
 +
## move forward by a user\-chosen number of shots
 +
depending on settings configured in the [Stations|] tab of the [Cave Details|] form
 +
# the last survey shot in the cave
 +
The *Gofer (running man)* button  left of these arrows launches the [Survey Shot Search|] form.
 +
The *Session Number* selector leads to the [Session|] form, which allows selecting and configuring the current session.
 +
The *4 hardware application buttons* mimic navigation arrows (previous series/cave leg, previous shot, next shot and next series/cave leg.) On the Palm Zire, which has only 2 such hardware application buttons, these only mimic the previous shot and next shot arrows.
 +
While in _Assistant_ mode:
 +
# the second leftmost hardware application button (Address Book, or Date Book on a Palm Zire) pops up the built\-in keyboard or the [Auriga custom keypad|], depending on the field into which the insertion point is blinking
 +
# the second rightmost hardware application button (To Do, or Address Book on a Palm Zire) saves the current shot and creates a new shot
 +
The *Up/Down* scroll buttons scroll the insertion point between fields in the form and scroll the note field when the insertion point is in the note field.
 +
Icons  at the bottom of the form allow (from left to right) to:
 +
# save the current shot (this button is only available when the survey shot data has been modified)
 +
If the input data is erroneous, the field in error is highlighted and the save operation is hampered. It is however possible to save an incomplete survey shot by inputting at least the start and end station and leaving one or more field empty. The survey shot is then marked as incomplete and ignored during coordinates computation. This survey shot can be modified later with the complete survey data. This can prove useful when a survey shot is planned but currently impossible to take (required climb, water too high, etc.)
 +
# create a new shot
 +
By default, stations of the new survey shot are generated by applying to the last displayed survey shot the auto\-incrementation mode selected in the [Stations|] tab of the [Cave Details|] form. However, holding the stylus on the _New_ button displays a list of auto\-incrementation options:
 +
## *Default Auto\-incrementation*
 +
## *Radiant shot (from center)* creates a survey shot that keeps the previous start station, but increments the end station; this incrementation mode is useful when surveying a room by taking several survey shots from the center to the walls
 +
## *Convergent shot (to center)* creates a survey shot that keeps the previous end station, but increments the start station; this incrementation mode is useful when surveying a room by taking several survey shots from the walls to the center
 +
*Note:* The survey shot auto\-incrementation can be applied until it is saved.
 +
# delete the current shot
 +
# load the [Sketch to Scale|] form
 +
# display the cave [Map|]
 +
If the cave is already computed and the *Map* icon is held down, a list of zoom options is displayed:
 +
## *Previous Zoom* displays the map with the previous zoom ratio and pan factor
 +
## *Full Map* displays the entire cave or network map within the size of the screen
 +
## *Current Shot* displays the map zoomed on the current survey shot
 +
## *Current Shot\+neighbors* displays the map zoomed on the current survey shot and its immediate neighbors
 +
## *Current Series or Session* displays the map zoomed on the series or session of the current survey shot. The choice between series or session is determined by the status of the _Sessions Over Series_ checkbox in the [Computations|] pane of the [Cave Details|] form
 +
## *Current Cave* displays the network map zoomed on the cave to which belongs the current survey shot
 +
# display the [List|] form
 +
If the *List* icon is held down, a list of List views is displayed before displaying the [List|] form
 +
# close the cave and return to the [Main|] form
 +
# display the note associated with the survey shot (in a full\-screen edit form)
 +
*Note:* If the _Assistant_ is active, any operation that would close the current cave or load another survey shot is disabled.
 +
*Note:* When handling a network, the _Assistant_ pushbutton is replaced by an arrow that pops up a list of caves in the network for quick navigation.
 +
 
 +
h4.Regular survey shots
 +
 +
Enter the survey shot *length*, *azimuth* and *slope*. Select the *Direct* checkboxes if direct azimuth and/or slope are taken (from start station toward end station, as opposed to reverse.)
 +
If the option is selected in the [General|] tab of the [Preferences|] form, the projected length is displayed in bold on the right of the length field. This field is updated when the length or slope changes.
 +
*Note:* When taking Topofil data, selecting the *Length* icon displays the net survey shot length, taking into account Topofil calibration.
 +
Depending on session settings, *backsight azimuth and slope* are ignored, displayed in bold for purpose of self\-validation and/or stored. If option *Show and Store* was selected in the [Shots|] tab of the [Session|] form, the backsight azimuth and slope displayed for self\-validation purposes can be overwritten with actual survey data. The backsight measurement is stored for averaging if it was edited, otherwise it is ignored.
 +
When, due to physical constraints, the slope cannot be measured as an angle but as a height above the horizontal baseline that joins start and end stations, you may enter this height (in dimension units, i.e. the measurement unit set for passage dimensions in the [Instruments|] tab (set #2) of the [Session|] form) into the slope field and then hit the *Calculator* silkscreen button to call the [Slope Calculator|] to compute the resulting angular slope. Hitting the *OK* button or the *Calculator* silkscreen button again pastes the computed slope into the slope input field.
 +
 
 +
h4.Virtual survey shots
 +
 +
If a geographic position is available for this virtual shot, it can be given to that station. First select a position type with the position popup list. UTM positions require an easting, a northing, a gore (1\-60) and a zone (A\-Z) while DMS (degrees, minutes, seconds: ddd°mm'ss.ss") or DM (degrees minutes: ddd°mm.mmm') positions require a latitude and a longitude. These must be entered with a blank or appropriate symbol as separator between degrees, minutes and seconds values. Every position type other than XYZ may be accompanied by an *Altitude* reading ( ).
 +
 
 +
h4.Series beginnings (cave legs or passages)
 +
     
 +
Series beginnings act as milestones and are thus not related to a real survey shot. Rather, these are kept in the Auriga cave to store settings that apply to all shots belonging to that series.
 +
Toggle the *Details/Position* list to display either series details or start station geographic position. If a position is already input, the _Position_ selector is highlighted.
 +
Select whether shots pertaining to this series will be displayed, or not, in the cave map with the *Show Series in Map* checkbox.
 +
Indicate with the *Flip Extended Profile* checkbox whether survey shots in this series must be extended in a direction opposite to the cave default in the extended profile view.
 +
Select the *Add Series to Cave Length* checkbox to sum the length of survey shots in this series to total cave development (convenient to exclude surface survey data from cave development.)
 +
If a geographic position is available for the series beginning, it can be given to that station. First select a position type with the position popup list. UTM positions require an easting, a northing, a gore (1\-60) and a zone (A\-Z) while DMS (degrees, minutes, seconds: ddd°mm'ss.ss") or DM (degrees minutes: ddd°mm.mmm') positions require a latitude and a longitude. These must be entered with a blank or appropriate symbol as separator between degrees, minutes and seconds values. Every position type other than XYZ may be accompanied by an *Altitude* reading ( ).
 +
Menus: [Cave|], [Edit|] and [Options|].
 +
 
 +
h4.The Survey Shot Search form
 +
This form is used to find survey shots related to a station.
 +
 +
Edit the station ID field and tap the *OK* button to find related survey shots. Tapping on one of the found shots in the results list of related survey shots loads that survey shot.
 +
The *Wildcards* checkbox allows performing a search using wildcards:
 +
# *\** substitutes any character string of 0, 1 or more characters
 +
# *'* substitutes exactly one character
 +
The *Ignorer Case* checkbox allows performing a search while ignoring lowercase/uppercase or accented letters.
 +
Tapping on the  button pastes the other station (start or end) of the current survey shot into the station field.
 +
 
 +
h4.The Slope Calculator
 +
 +
When, due to physical constraints, the slope cannot be measured as an angle but as the height of the triangle which hypotenuse joins start and end stations, you may enter this height (in dimension units, i.e. the measurement unit set for passage dimensions in the [Instruments|] tab (set #2) of the [Session|] form) into the slope field of the [Survey shot|] form or the [Auriga custom keypad|] and then hit the *Calculator* silkscreen button to call this Slope Calculator to compute the resulting angular slope. The *Up* and *Down* pushbuttons can be used to indicate whether the slope heads upwards or downwards. Hitting the *OK* button or the *Calculator* silkscreen button again pastes the computed slope into the slope input field of the calling form. The same works for the secondary slope.
 +
 
 +
h4.The Sketch to Scale form
 +
     
 +
The Sketch to Scale form displays the coordinates necessary to report, on paper, the current survey shot and its passage dimensions. The selector at the bottom of the form allow to toggle between *Relative* and *Absolute* coordinates.
 +
In relative mode, the form displays:
 +
# X, Y, Z and C (extended profile) offset of the survey shot
 +
# X, Y segments of left and right passage dimensions relative to the reference station of these dimensions
 +
# Z segments of up and down passage dimensions relative to the reference station of these dimensions
 +
*Note: *An arrow appears next to the reference station for passage dimensions.
 +
In absolute mode, the form displays:
 +
# absolute X, Y, Z and C coordinates of the stations of the survey shot (if the cave coordinates are computed, otherwise, ''' are shown)
 +
# the length of left, right, up and down passage dimensions segments
 +
*Note:* Left/right passage sizes may be swapped in order to always correspond to a direct survey shot.
 +
*Note:* In absolute mode, if the _Ignore Origin_ option is selected with the selector, the origin X, Y, Z and C coordinates are substracted from the station coordinates, thus displaying origin\-relative absolute coordinates.
 +
*Note:* All numeric data shown takes into account the map scale indicated in the [Computations|] tab of the [Cave Details|] form, as well as the size of the notebook grid indicated in the [Map|] tab of the [Preferences|] form. An overly large map scale or paper grid may lead to very large offsets, overflowing the available display width.
 +
The *Shot* button allows to quickly show raw data of the current survey shot without having to return to the [Survey Shot|] form.
 +
*Usage*
 +
Sketching to scale in the notebook first requires to position the start and end stations on paper before sketching walls and other features. Prior to Auriga, this was done with a ruler and a protractor:
 +
# position the start station; location can be arbitrary
 +
# apply the center of the protractor against the start station and mark the edge of the protractor at the angle corresponding to the azimuth of the survey shot (when sketching in top view)
 +
# place the start of the ruler on the start station and align it on the azimuth mark
 +
# with the ruler, measure the projected length over ground of the survey shot from the start station and position the end station, correctly reducing this length as the slope increases (using a cosine table or a special protractor)
 +
# repeat the process with the slope angle to sketch a profile
 +
With the _Sketch to Scale_ form in Auriga, the X and Y offsets represent the number of paper grid squares to count horizontaly and verticaly, respectively, from the start station to position the end station. Positive offsets grow up and right, negative offsets grow down and left. For sketching a profile, use the Z offset for the vertical axis. For sketching a West\-East profile, use the X offset for the horizontal axis. For sketching a South\-North profile, use the Y offset for the horizontal axis. For sketching an extended profile, use the C offset for the horizontal axis.
 +
Relative coordinates correspond to the type of work performed with a ruler and protractor. Absolute positionning is best suited when using very large gridded paper or to avoid cumulative sketching mistakes when one station gets misplaced. Note that the _Sketch to Scale_ form opens in the last used mode (Relative or Absolute.)
 +
 
 +
h3.The Session form
 +
 +
This form is used to manage survey sessions and to select the current session.
 +
This form has three tabs, selected with pushbuttons in the title bar.
 +
Existing survey session numbers can be cycled through with the *Up/Down arrow* pushbuttons.
 +
A session numbered 1, initialized with default instrument calibration and units, is automatically added when creating a new cave. If the displayed session is the active session, an *Asterisk* is displayed on the left of the session number.
 +
A 31\-character name can be given to the session.
 +
The *Date* shown is that of the creation of the session. It is optionally updated when the first survey shot is taken during this session. Tapping on the date selector allows to change it.
 +
The *Done* button exits the _Session_ form. If the _Session_ form was launched with the _Session number_ selector in the [Survey Shot|] form, changing the session associated to the current survey shot must be confirmed. Calling the [Session|] form with the _Sessions_ item in the [Cave|] menu does not affect the session number to which the current survey shot (if any) is associated.
 +
The *Save* button saves the current session.
 +
The *New* button creates a new session, initialized with default data and numbered with the next available session number. It is possible to create a session from an existing session by merely editing the session number and saving this new session (provided the new session does not already exist.)
 +
The *Note* button allows linking a note to the session (name of surveyors, details of instruments used, etc..) 255 characters are permitted.
 +
*Note:* All tabs are then refreshed or saved as defaults.
 +
Several session calibrations may be edited sequentially by saving modifications before selecting another session number.
 +
 
 +
h4.The Instruments tabs
 +
     
 +
These tabs allow to select instruments and set their calibration values.
 +
Select instruments used for surveying (*Tape* vs *Topofil*, *Compass* vs *Theodolite*, *Clinometer* vs *Theodolite*, *Altimeter* or *Depthmeter*.) The handling of angular instruments other than compass and clinometer is not implemented yet.
 +
When selecting a Topofil, also select the *number of digits* on its counter. Repeatedly tapping on the selector next to the _Topofil_ instrument cycles though possible choices (3 to 6, default is 5).
 +
Select *Lengths*, *Azimuths* and *Slopes* units.
 +
*Note:* Auriga supports the following angular units and universal notations:
 +
# *d°m's"*: degrees in base 360 written in sexagesimal format with seconds (ex. 20°30'17" means 20 degrees, 30 minutes and 17 seconds)
 +
# *d°m.m'*: degrees in base 360 written in sexagesimal format without seconds (ex. 20°30.4' means 20 degrees, 30 minutes and 4 tenths of minuto)
 +
# *degrees*: degrees in base 360 written in decimal format (ex. 20.8 means 20 degrees and 8 tenths of degree)
 +
# *grads*: grads in base 400 writtent in decimal format (ex. 370.4 means 370 grads and 4 tenths of grad, in base 400)
 +
For convenience, with unit *d°m's"* and *d°m.m'*, Auriga allows to input a space instead of of the °, ' o " symbols. Furthermore, it is posible to input a decimal value even if the selected unit format is sexagesimal (ex. 20.5, equivalent to 20°30'). However, when showing the input value, Auriga uses the selected unit format, and the appropriate symbols, if any.
 +
Select the proper orientation for *Slope angle 0* (_Up_, _Down_ or _Level_.)
 +
Select the *Shift* or *Precision* pushbuttons to toggle between shift and precision input. *Length*, *Azimuth* and *Slope shifts* will be added to surveyed values to obtain the correct value.
 +
*Note:* In case of a Topofil, the shift is taken as a multiplying factor applied to the measurement to obtain exact data.
 +
\[not implemented\] *Length*, *Azimuth* and *Slope precisions* are used to redistribute errors when performing loop closure.
 +
Azimuths taken with a *Compass* are relative to the North (magnetic or geographic, depending on whether a magnetic deviation was input.)
 +
\[not implemented\] Azimuths taken with a *Theodolite* are absolute angles relative to the previous survey shot.
 +
Auriga simultaneously supports 2 instrument set calibrations, numbered 1 and 2. Instrument set 1 is used for primary shots (regardless of their direction), while set 2 is used for backsights. Respective calibrations can be reached by selecting either the *Set 1* or the *Set 2* tab pushbutton.
 +
If only one instrument set is actually used for both direct and backsight azimuths or slopes, as is often the case, select the appropriate *Instrument Set #1 = #2* checkbox in the secondary instrument set calibration. By default, only one instrument set is assumed.
 +
Length measurements are associated with instruments set 1, while passage dimensions are associated with instruments set 2.
 +
*Note:* When a Topofil is used for lengths in instruments set 1, Auriga assumes dimensions (instruments set 2) are input with a tape. For any other length instrument selected in instruments set 1, a tape is assumed for dimensions only if the *Instrument Set #2 = #1* checkbox is not set for dimensions.
 +
 
 +
h4.The Shots tab
 +
 +
The *Number of Shots* associated with this session is displayed at the top of the form.
 +
Select the *Gray halftone* or *Color* this session will take in the map (offered only if device permits.)
 +
Select whether shots pertaining to this session will be displayed, or not, in the cave map with the *Draw* checkbox.
 +
Indicate with the *Flip* checkbox whether survey shots in this session must be extended in a direction opposite to the cave default in the extended profile view.
 +
Select whether shots pertaining to this session will be summed to the total cave development *\+ (Sum)* pushbutton.
 +
Select the *Passage sizes* checkbox to indicate passage sizes are mandatory. Select either the *Start* or the *End* pushbutton to indicate which side of the survey shot is to be associated, by default, with size measurements. This association can be overridden in each individual survey shot. Select the *Direct* checkbox if passage sizes are "seen" from the start station.
 +
Input the *Magnetic Deviation* to be added to compass (magnetic) azimuths to obtain geographic (true) azimuths. This setting can be different for each individual survey session as it can vary over time and space. A westward magnetic deviation must be set as negative; an eastward deviation as positive.
 +
Select the behavior for *Reverse Azimuths* and *Reverse Slopes*:
 +
# *Ignore*: backsight azimuths/slopes are ignored (neither shown nor input)
 +
# *Show*: backsight azimuths/slopes are automatically computed while the direct measurement is input and displayed for self\-validation purposes
 +
# *Store*: backsight azimuths/slopes are to be input by the user and stored in the shot data
 +
# *Show and Store*: backsight azimuths/slopes are automatically computed and displayed while the direct measurement is input but may be overwritten by the user with the actual measured backsight data and then gets stored in the shot data
 +
*Note:* With options _Show_ and _Show and Store_, Auriga shows what the expected backsight (azimuth or slope) should be, taking into account the calibration of both instruments sets. For instance, if the foresight azimuth is 35°, assuming neutral calibrations, the expected backsight azimuth should be 215° (35° \+ 180°).
 +
*Note:* Some compasses offer two reading scales, one direct and one corrected (i.e. reverse). The Auriga user may find more natural to compare the foresight azimuth with a corrected backsight (ex. 35° vs 36° rather than 35° vs 216°); in this case, option _Show_ becomes irrelevant. Auriga accepts either a true backsight azimuth or a corrected backsight azimuth. When computing the survey shot (and averaging azimuths, if both exist), if its foresight and backsight azimuths do not fall within 90°, Auriga assumes the backsight azimuth is not corrected. The backsight is always considered normal (not corrected) if the foresight azimuth is missing or if the survey shot has the _Ignore Azimuth_ attribute.
 +
Select the *Direct* checkboxes in the *Azimuths* and *Slopes* groups to indicate direct azimuths and slope measurements by default. These options can be overridden for each individual survey shot in the [Survey Shot|] form.
 +
Select *Altitude* units.
 +
*Warning:* Modifying existing sessions modifies the interpretation of input data for the shots associated with the modified sessions.
 +
Menus: [Session|], [Edit|] and [Defaults|] The latter can be used to store or retrieve default values.
 +
 
 +
h3.The Auriga Keypad
 +
 +
The Auriga keypad overrides the built\-in Palm OS alphabetic and numeric keypads in every Auriga form where text data can be input. It pops up when the *1\-2\-3* or *a\-b\-c* keyboard button is tapped in the silkscreen area. This custom keypad self\-adjusts to the type of field being edited; thus some buttons (like "*\-*", "*.*", "*North*", "*Direct*" or "*Series*") may not always be present. Buttons are big enough to make a stylus unnecessary when surveying. The name of the currently edited field along with its measurement unit, if any, is displayed in the Keypad form title.
 +
When editing sexagesimal coordinates (d°m's"), tap the *West*, *East*, *North* or *South* selector to invert the coordinate. The symbol key at the bottom self\-adjusts into *°*, *'* and *"* to allow separation of degrees, minutes and seconds.
 +
Use the *OK* button to leave the keypad; saving the input field is automatic. Tap the *left arrow* (backspace) button to erase one character, or hold it to erase the input field.
 +
Press the *Up/Down arrow* buttons to save the input field and move to the previous/next field.
 +
When editing a survey shot, holding the stylus on the *i* button (upper right corner) displays the contents of the [Survey Shot|] form input fields.
 +
When editing a survey shot, holding the stylus on the *Up* or *Down* buttons displays a list of the [Survey Shot|] form input fields to speed up navigation.
 +
If the edited field is the azimuth or slope field, a *Direct* pushbutton is displayed left of the input field. Conversely, if the edited field is the start station and the automatic detection of series beginnings is not selected (see the [Stations|] tab of the [Cave Details|] form), a *Regular/Virtual/Series* pushbutton is displayed to allow selecting the type of survey shot.
 +
Depending on the type of data input, alphabetic, symbolic or international keyboard layouts may be offered.
 +
When editing a series beginning or a virtual survey shot, the type of position, if any, can be selected with the [Position|] menu while editing the start station.
 +
Menus: [Edit|] and [Position|] when relevant.
 +
 
 +
h3.The List form
 +
     
 +
The List form displays surveyed and computed cave data in list views.
 +
Displayed data is in read\-only mode except for the attributes list, checkboxes and color selectors that can be modified by maintaining the stylus on them for a short delay; modifications take effect immediately. If the cave is open in read\-only mode or if not a single list column is editable (i.e Stations or Graph views), a *padlock* icon is displayed in the title bar.
 +
The selected row is shown in reverse (light text on dark background.) It is possible to bookmark a row by tapping the desired row with the stylus. The bookmarked row is surrounded by solid lines. In views that allow it (see below), tapping the marked row selects it, thus changing the current survey shot.
 +
List columns can be resized by tapping the stylus leftward of the end of the column head to resize and dragging it to the desired width. Tapping on the *\+* button at the bottom, right of the list widens the rightmost visible column. Columns are limited to a minimal and maximal width.
 +
List columns can be selectively shown or hidden with the _Columns_ item of the _List_ menu, leading to the [Columns|] form.
 +
List columns in Survey Shots, Virtuals and Sessions views can be sorted by tapping the stylus in the head of the column to sort. Sorting the same column a second time inverts its sort order. The head of the sorted column is shown in reverse.
 +
*Note:* Modifying a checkbox or color selector may break the sort if the modified column is the sort column. In this case, tapping the head of the column re\-sorts the view without inverting the sort order.
 +
The 2 center *hardware application buttons* scroll the view horizontally.
 +
*Note:* On devices with Palm OS version prior to 3.5, horizontal scroll bars being unusable, Auriga does not show them. Use the hardware application buttons instead.
 +
Lists can be printed with the _Print_ item from the _List_ menu. In the Graph view, consecutive survey shots (with connecting end\-start stations) are printed as blocks separated by a dotted line.
 +
Six views are selectable with the rightmost drop\-down list in the title bar:
 +
# *Survey Shots* displays a list of raw survey shots (as they were input.) The selected row is the current survey shot; it can be changed by selecting another row. Available columns are:
 +
## stations name
 +
## status (incomplete, duplicate, orphan or part of an incomplete or orphan leg)
 +
## input date
 +
## color (editable)^7^
 +
## session number^6^
 +
## attributes (editable list)^1^
 +
## length^2^
 +
## Topofil start and end^2^
 +
## direct azimuth (editable checkbox)^2^
 +
## azimuth^2^ \- shown between () if the survey shot has the _Ignore Azimuth_ attribute
 +
## azimuth backsight^2^ \- shown between () if the survey shot has the _Ignore Backsight Azimuth_ attribute
 +
## direct slope (editable checkbox)^2^ \- shown between () if the survey shot has the _Ignore Slope_ attribute
 +
## slope^2^ \- shown between () if the survey shot has the _Ignore Backsight Slope_ attribute
 +
## slope backsight^2^
 +
## left, right, up and down passage sizes
 +
## note
 +
This view can be filtered with the center drop\-down list in the title bar to only show:
 +
## survey shots pertaining to the current series
 +
## survey shots pertaining to the current session
 +
## survey shot errors (incomplete or orphan survey shots)
 +
## survey shot warnings (duplicate survey shots or with invalid data or survey shots part of an incomplete or orphan leg)
 +
## survey shot errors and warnings
 +
 
 +
# *Virtuals* displays a list of virtual survey shots (pure virtuals and series beginnings). The selected row corresponds to the current survey shot or the series beginning it belongs to; it can be changed by selecting another row. Available columns are:
 +
## stations name
 +
## input date
 +
## color (editable)^7^
 +
## session number^6^
 +
## number of survey shots in the series^3, 5^
 +
## total surveyed length of survey shots in the series^3, 5^
 +
## draw virtual survey shot or survey shots in the series in the map (editable checkbox)
 +
## sum length of survey shots in the series to total cave development^3, 4, 5^
 +
## flip survey shots in the series in the extended profile map view (editable checkbox)^3, 5^
 +
## position
 +
 
 +
# *Sessions* displays a list of survey sessions. The selected row corresponds to the session to which the current shot belongs; selecting another row also selects the first survey shot of that session as the new current survey shot. Available columns are:
 +
## session number (the active session is marked by an asterisk)
 +
## session name
 +
## input date of the first survey shot associated with the session (or session creation date if no survey shot is yet associated with the session)
 +
## color (editable)^7^
 +
## number of survey shots in the session
 +
## total surveyed length of survey shots in the session^4^
 +
## draw survey shots in the session in Map (editable checkbox)
 +
## sum length of survey shots in the session to total cave development
 +
## flip development direction of survey shots in the session in the extended profile map view (editable checkbox)
 +
 
 +
# *Stations* displays a list of stations with computed XYZC coordinates and an uneditable *Attributes* column that can contain a combination of 'E' (Entrance), 'P' (Permanent) and ''' (Lead) characters. All coordinates use the map scale and, for the Z coordinate, the vertical factor defined in the [Computations|] tab of the [Cave Details|] form. The selected rows correspond to the stations of the current survey shot. Selecting another row also selects the first survey shot associated to that station as the new current survey shot and consequently selects the other station of this survey shot.
 +
# *Graph* displays a list of stations with computed XYZC coordinates and links to other stations along with an uneditable *Attributes* column that can contain a combination of 'E' (Entrance), 'P' (Permanent) and ''' (Lead) characters. this is the most useful view to draw the cave map on paper. In this view, scrolling, marking and selection is done by pair of rows. A dotted line separates pairs of stations linked by a survey shot. All these coordinates use the map scale and, for the Z coordinate, the vertical factor defined in the [Computations|] tab of the [Cave Details|] form. All passage sizes use the map scale; up/down sizes also use the vertical factor.
 +
 
 +
*Note:* Left/right passage sizes may be swapped in order to always correspond to a direct survey shot.
 +
# *Caves* (available when handling a network) displays the list of the caves in the network. Available columns are:
 +
## index of cave in network
 +
## cave alias
 +
## color (editable)^7^
 +
## draw cave in Map (editable checkbox)
 +
## number of survey shots in cave
 +
## number of sessions in cave
 +
## number of series in cave
 +
## cave development
 +
## total surveyed length in cave
 +
## cave vertical drop
 +
# The column displays abbreviated survey shot attributes; if no attribute is set, the column displays the _Attribute_ icon; tapping on this column pops up a list of selectable attributes
 +
# Only applies to regular survey shots
 +
# Only applies to series beginnings
 +
# Only if cave coordinates are computed
 +
# Only if series are enabled
 +
# Only if cave has more than one session
 +
# Only if device has color or grayscale
 +
*Note:* The _Stations_ and _Graph_ views require the cave coordinates to be computed. If computations cannot be performed (likely due to a lack of memory), the display of these views is denied. Other views can benefit from computed coordinates by displaying faster or showing computed lengths (_Virtuals_ and _Sessions_ views).
 +
*Note:* The _Stations_ and _Graph_ views can display 3 different types of coordinates, selectable in the title bar:
 +
# *Real* coordinates are expressed in cave length units (meters or feet), as selected in the [Cave|] tab of the [Cave Details|] form
 +
# *To Scale* coordinates where the map scale (selected in the [Computations|] tab of the [Cave Details|] form) is applied. These coordinates are displayed in centimeters or inches, depending on the cave map length unit (selected in the [Cave|] tab of the [Cave Details|] form)
 +
# *Grid* coordinates, where both the map scale (selected in the [Computations|] tab of the [Cave Details|] form) and the paper grid (selected in the [Map|] tab of the [Preferences|] form) are applied. These coordinates are expressed in paper grid units and are identical to those displayed in the [Sketch to Scale|] form when ran in absolute mode
 +
If the _Ignore Origin_ option is selected with the selector, the origin X, Y, Z and C coordinates are substracted from the station coordinates, thus displaying origin\-relative absolute coordinates.
 +
*Note:* Modifying the status of series\-related checkboxes in the Virtuals view has no effect if the *Sessions override Series* checkbox is selected in the [Computations|] tab of the [Cave Details|] form. Conversely, modifying the status of checkboxes in the Sessions view has no effect if the *Sessions override Series* checkbox is unselected.
 +
# Columns that are irrelevant for a given row display as '\-'
 +
# Columns with missing data for a given row do not display
 +
# Columns with yet incomputed data for a given row display a '''
 +
*Note:* Numeric columns are normally right\-justified to maintain number alignment. However, for columns other than station names and session number, if a number does not fit in the column width, it gets automatically left\-justified so as to show its most significant digits (and truncate its decimals).
 +
Select the *Forms* icon  to return to the previous form or select the _Close_ item in the [Cave|] menu to return to [Main|] form. This is disabled by the _Assistant_ (if active). Maintaining this icon depressed displays a list of exit choices (_Survey Shot_, _Map_ or _Close Cave_.)
 +
*Note:* When handling a network, the data displayed in lists can be grouped by cave by selecting this option in the views list.
 +
The *Gofer (running man)* button  launches the [Survey Shot Search|] form.
 +
Menus: [Cave|], [List|] and [Options|].
 +
 
 +
h4.The Columns form
 +
 +
Highlight columns to be shown in main list. Columns whose name is preceeded by a padlock icon are not toggable.
 +
 
 +
h3.The Map form
 +
     
 +
The Map form displays the topographical path (cave skeleton) in top view or various profile views. The Map can be redrawn using the map options list (see below).
 +
Tapping in the screen while the map is being drawn allows to suspend the operation. On devices with a fixed Graffiti area, a confirmation is required.
 +
*Note:* The top of the map corresponds to the North, either geographic (true) or magnetic, depending on whether a magnetic deviation was input or not in individual sessions and/or the [Cave Details|] form.
 +
The map is restored with the previously used zoom ratio and pan factor for this cave.
 +
*Troubleshooting*: An empty map display may be caused by:
 +
# an extreme zoom ratio
 +
# a pan factor that moves survey shots out of the view
 +
# a choice of invisible colors for survey shots
 +
# unselected display options
 +
See the _Display Options_ list.
 +
If the computation process of the cave map detects incomputable survey shots (orphan or incomplete), an alert is displayed and the user can view a log of the offending survey shots. Tapping on one of the survey shots in the results list loads that survey shot into the [Survey Shot|] form.
 +
Conversely, station errors detected while computing the cave map coordinates can be viewed by tapping the _Station Errors_ item in the [Cave|] menu. Survey shots that lead to computing the same station but with differing coordinates (beyond the station error tolerance input in the [Computations|] tab of the [Cave Details|] form) are grouped together.
 +
Tapping on a survey shot name brings it up in the [Survey Shot|] form.
 +
Unlinked or incomputable shots and loop error logs can be exported as memos to the built\-in Memo Pad application for future viewing. it may be advisable to create a memo category to store them.
 +
     
 +
These errors can be visually detected in the map: for every station that is part of a loop, the difference between its theoretical location and its actual location (determined by the survey shot used to compute the station location) is drawn with a dotted line.
 +
*Tip*: With station markers displayed, any survey shot segment that does not reach a station marker at both ends reveals a loop error.
 +
If the *Full Screen Cave Map* option is selected in the [Preferences|] form, controls at the bottom of the screen are only briefly displayed when the form is open to show the current view and stylus mode. These controls can then be shown or hidden by simply tapping a '.' in the numeric sector of the Graffiti area. This allows viewing the entire cave, that then uses the full screen height.
 +
*Note:* On devices with a dynamic Graffiti area, in full screen map mode, when the Graffiti area is closed, tapping the *Menu* icon first displays the Map form controls
 +
A scale is displayed at the bottom of the screen. If option *Show Scale* is not selected in the [Map|] tab of the [Preferences|] form, the scale is only displayed for a second. It briefly reappears every time the map is redrawn. In permanent scale display mode, it can be hidden by tapping on it with the stylus.
 +
Tapping on the leftmost *Attributes* icon pops up a list of display options. Options in this list are specific to the current cave:
 +
# *Redraw Map* redraws the map with a normal zoom ratio and a null pan factor; if the map drawing was interrupted, the map is redrawn with current zoom ratio and pan factor
 +
# *Shot Info* toggles the display of the current shot information at the top of the map
 +
# *Grid* toggles the display of a grid; note that if not grid matching the configured settings can be displayed, no grid is effectively displayed (see the [Map|] tab of the [Preferences|] form); see note below
 +
# *Scale* toggles the display of a scale
 +
# *Stations* pops up a list of the station display options:
 +
## *Markers* toggles the display of triangular markers on stations
 +
## *Landmarks* toggles the display of asterisks on stations with a geographic position
 +
## *Entrances* toggles the display of a letter 'E' next to cave entrances
 +
## *Permanent* toggles the display of a letter 'P' next to permanent stations
 +
## *Leads* toggles the display of a ''' next to leads
 +
## *Names* toggles the display of station names
 +
## *Suffixes* toggles the display of station name suffixes (only available if series are enabled); series are truncated from the station names to lead shorter labels in map
 +
# *Line Plot* toggles the display of the line plot between stations
 +
# *Dimensions* toggles the display of dimension lines (left\-right or up\-down) across stations; see note below; if the map displays a cave network, this option and the following one only have an effect if the _Retain Passage Dimensions_ is selected in the [Network|] tab of the [Network Details|] form
 +
# *Walls* toggles the display of (theoritical) wall lines between dimension lines (visible or not); see note below
 +
# *Fill Passages* toggles the filling of passages with walls color
 +
# *Orphan Legs* toggles the display of orphan shots and all survey shots that depend on orphan shots (dotted line)
 +
# *Loop Errors* toggles the display of loop errors as dotted lines between actual and theoretical shot ends for survey shots that are part of a loop; if the map displays a cave network, this option and the following one only have an effect if the _Retain Closure Errors_ is selected in the [Network|] tab of the [Network Details|] form
 +
# *Map Coloring* pops up a list of map coloring modes:
 +
## *Default* colors used are those selected in the [Map|] tab of the [Preferences|] form
 +
## *By Series* color is selected in the [Survey Shot|] form
 +
## *By Session* color is selected in the [Shots|] tab of the [Session|] form
 +
## *By Survey Shot* color is selected in the [Survey Shot|] form
 +
## *By Selection* colors used are those selected in the [Map|] tab of the [Preferences|] form (if a selection is available in the [Selection|] form)
 +
## *By Cave* (when displaying a network) the cave\-specific color is selected in the [Caves|] tab of the [Network Details|] form
 +
In *Section* view, display options are:
 +
# *Swap Sides* swaps let\-right sides; *the right side is indicated by the map or grid scale position*
 +
# *Other Station* toggles between the start and end stations of the current survey shots
 +
# *Grid* toggles the display of a grid; note that if not grid matching the configured settings can be displayed, no grid is effectively displayed (see the [Map|] tab of the [Preferences|] form); see note below
 +
# *Dimensions* toggles the display of dimension lines
 +
# *Line Ends* toggles the display of small lines perpendicular to dimensions
 +
# *Walls* toggles the display of (theoretical) passage walls between dimensions lines (visible or not)
 +
# *Fill Section* toggles the filling of the section
 +
*Note:* Passage dimensions are computed with the Up, Down, Left and Right survey data. As each survey shot can hold a single set of passage dimensions, the user has to indicate to which of the two stations (of the survey shot) the set of dimensions belongs, i.e. start or end station. Thus, it is possible to end up with more than one set of dimensions for a given station if more than one shot leaves/arrives from/to a given station. For simplicity, Auriga only retains the first set of dimensions for a given station while computing cave coordinates. In some cases, depending on passage morphology, this may lead to an incorrect graphical rendition of actual cave walls.
 +
Also note that Auriga takes passage dimension data as perpendicular to the axis of the survey shot.
 +
*Note:* The map grid is not centered in the screen but aligned on the origin station of the cave. In profile views, if a vertical factor other than 1.0 is set (see the [Computations|] tab of the [Cave Details|] form), the grid may appear rectangular to match the displayed numeric grid value both horizontally and vertically.
 +
The leftmost popup list allows selecting the type of cave view displayed:
 +
# *Top View* is X vs Y
 +
# *W\-E Profile* view is X vs Z
 +
# *S\-N Profile* view is Y vs Z
 +
# *Extended Profile* is a X vs C stretched profile view
 +
# *Projected Profile* is a profile view relative to a user\-selected projection angle (see the next popup list); Auriga offers 2 different projected profile views, each with its distinct projection angle
 +
# *Section* is a section view of the passage at the current station, drawn using its left, right, up and down dimensions and designed to assist sketching
 +
*Note:* Each cave has its default direction for developing survey shots in the extended profile view (set in the [Map|] tab of the [Cave Details|] form). This direction can be toggled by the passage flip attribute (either series or session, depending on the state of the _Sessions over Series_ checkbox in the [Computations|] pane of the [Cave Details|] form). For series, this flip attribute can be set in the [Survey Shot|] form, while for sessions, the flip attribute can be set via the _Sessions_ view of the [List|] form. In addition, this direction can again be toggled by the individual survey shot flip attribute set in the _Survey Shots_ view of the [List|] form. Thus, the survey shot can inverse the development direction set by the passage, that can itself inverse the general cave development direction. This allows the user full control on the display of extended profiles of complex cave systems.
 +
The center popup list allows selecting the stylus mode (*Zoom*, *Pan*, *Info*, *Line*, *Spot*, *Select* or *Projection*.) This mode determines the results of stylus taps or drags in the cave map.
 +
*Note:* In _Section_ view, only the _Zoom_ and _Info_ are permitted.
 +
In *Zoom* mode, tracing the diagonal of a rectangle in the cave map zooms the part of the cave map enclosed in that rectangle (unless the rectangle is too small.) The zoom rectangle may be adjusted when re\-displaying the cave to maintain a uniform zoom ratio, both vertically and horizontally.
 +
In *Pan* mode, dragging the stylus in the cave map shifts the map in the drag direction.
 +
In *Info* mode, the name of the stations of the current shot and its note (if any) are displayed at the top of the screen. The current station is marked with a bullet in the map and displayed in bold at the top of the screen. On color or halftone\-capable devices, both the current station bullet and the current shot segment use the color set in the [Map|] tab of the [Preferences|] form. The current station can be selected with *arrow* pushbuttons (see below) or by tapping directly into the cave map.
 +
In *Line* mode, dragging the pen in the cave map displays the length and angle or slope of the drawn line along with the vertical and horizontal distance (map\-wise.) Length and angle units used are those set in the [Cave Details|] form. Tapping the screen again dismisses the line display.
 +
 +
When viewing a *Top* cave view, the angle of the drawn line is automatically copied into the clipboard to later ease selecting the projected profile angle. In profile cave views, a slope angle is displayed instead.
 +
The *Spot* mode displays the position of the stylus in the cave map. In top cave view, the position format is that selected for the cave in the [Cave Details|] form; geographic locations can only be provided if the cave is geo\-referenced. In profile views, the position is displayed in XZ format, with altitude if the cave has an altitude reference. Tapping the screen again dismisses the spot display.
 +
In *Select* mode, tracing the diagonal of a rectangle in the cave map determines a selection area that can then be used in the [Select|] form to select survey shots or stations.
 +
The *Projection* mode is used to select the angles used by the two projected profile views. In the plan view, angles can be selected graphically, as in the _Line_ mode. The corresponding projected profile is displayed after an angle is selected. The angle unit is that selected in the [Cave|] tab of the [Cave Details|] form [Network|] tab of the [Network Details|] form.
 +
If the current station has survey shots toward other stations, the current shot is the first survey shot (in cave list order) leaving from the current station.
 +
If the current station has no survey shots toward other stations, the current shot is the first survey shot (in cave list order) arriving from the current station.
 +
The current station name is displayed in bold in the information line displayed at the top of the cave map.
 +
The *Up/Down* scroll buttons allow to cycle through the various survey shots associated with the current station. Currently, only survey shots that start from the current station can thus be reached.
 +
Arrow pushbuttons  allow navigation between survey shots. From left to right, they:
 +
# go to previous series beginning of current series *or*
 +
## go to first survey shot in previous series or previous cave leg *or*
 +
## move backward by a user\-chosen number of survey shots
 +
depending on settings configured in the [Stations|] tab of the [Cave Details|] form
 +
# move one survey shot backward
 +
# move one survey shot forward
 +
# go to next series beginning *or*
 +
## go to first survey shot in next series or cave leg *or*
 +
## move forward by a user\-chosen number of survey shots
 +
depending on settings configured in the [Cave Details|] form
 +
The *\+* and *\-* buttons zoom in or out the cave map from the center. The first zoom out action restores the previous zoom ratio, regardless of whether it was manually determined (stylus dragged across the map) or automatic with the *\+* button.
 +
If the *\-* or *\+* buttons are held down, a list of zoom options is displayed:
 +
# *x* or *÷ 1.5*, *2*, *3*, *5*, *10*, *25*, *50* and *100* provoke a zoom\-in (x) or zoom\-out (÷); the number of available options depends on the current zoom ratio, so as to avoid zooming beyond maximum zoom or below minimum zoom
 +
# *Maximum Zoom* provokes a maximum zoom of the map
 +
# *Full Map* displays the entire cave or network map within the size of the screen
 +
# *Full Section* displays the entire passage section within the size of the screen (_Section_ view only)
 +
# *Current Shot* provokes a zoom on the current survey shot
 +
# *Current Shot\+neighbors* provokes a zoom on the current survey shot and its immediate neighbors
 +
# *Locate a Shot* launches the [Survey Shot Search|] form, after which the map is zoomed on the selected survey shot and its immediate neighbors
 +
# *Current Series or Session* provokes a zoom on the series or session of the current survey shot. The choice between series or session is determined by the status of the _Sessions Over Series_ checkbox in the [Computations|] pane of the [Cave Details|] form
 +
# *Current Cave* provokes a zoom of the network map on the cave to which belongs the current survey shot
 +
Select the *Forms* icon  to return to the previous form or select the _Close_ item in the [Cave|] menu to return to [Main|] form. This is disabled by the _Assistant_ (if active). Maintaining this icon depressed displays a list of exit choices (_Survey Shot_, _List_ or _Close Cave_.)
 +
The 4 hardware application buttons have the following effect:
 +
# In *Info* mode, from left to right, they mimic the arrow buttons (previous series beginning/cave leg, previous survey shot, next survey shot and next series beginning/cave leg.) On the Palm Zire, which has only 2 such buttons, they only mimic the previous shot and next shot arrows.
 +
# In *Zoom*, *Pan* or *Line* mode, the leftmost button (Date book) mimics the *\-* (zoom out) button while the rightmost button (Memo Pad) mimics the *\+* (zoom in) button. The second (Address book) and third (To do) buttons and the *Up/Down* scroll buttons pan left, right, up and down.
 +
Graffiti shortcuts:
 +
# '\-' zooms out
 +
# '\+' zooms in
 +
# the 'tab' stroke returns to the [Survey Shot|] form
 +
# dragging the stylus from the Graffiti area to the middle of the screen toggles between top and extended profile views
 +
*Note:* For these shortcuts, tapping the Graffiti 1 punctuation mark (a single tap in the Graffiti area) is not required. Thus, ' ' (space) acts as '\-' (zoom out), 'k' as '\+' (zoom in) and 'f' as a tab (exit.)
 +
Menus: [Cave|] or [Network|], [Map|] and [Options|].
 +
 
 +
h3.The Statistics form
 +
 +
The Statistics form displays cave statistics. It may trigger an automatic XYZC coordinates computation if these are not up to date.
 +
The development is the sum of the horizontal projection of the length of every survey shot that has the *\+* attribute set and that belongs to a series with the *Sum to development* attribute set (if series are used.)
 +
The mapped length is simply the sum of the length of all survey shots.
 +
Statistics can be exported as memos to the built\-in Memo Pad application for future viewing. The same menu also allows printing statistics or beaming them to another device.
 +
Menu: [Log|].
 +
 
 +
h3.The Network Details form
 +
This form displays information on a network, either existing or being created.
 +
This form has 3 tabs, selected with the pushbuttons in the title bar.
 +
 
 +
h4.The Network tab
 +
 +
The *Name* of the network can be any string of 26 characters or less and may include spaces. This corresponds to the name of the Auriga network PDB on the Palm OS device (with a 5\-character suffix to distinguish it between PDB types.) Editing the name of an existing network actually renames it (an alert is issued before proceeding.)
 +
The *Category* selector allows selecting the network category. Categories are edited in the usual Palm OS way by selecting the _Edit categories..._ list item.
 +
Select measurement units to be used for computing coordinates:
 +
# *Lengths* unit (_meters_ or _feet_)
 +
# *Angles* unit (_degrees_ or _grads_) for azimuths and projection angle
 +
# *Slopes* unit (_degrees_, _grads_ or _%_)
 +
# *Slope 0* setting (_up_, _level_ or _down_)
 +
*Note:* Measurements units selected in this form are used throughout Auriga to report coordinates, lengths and angles between stations and statistics.
 +
Select the format to be used to display *Positions* in the network map (_XYZ_, _UTM_, _d°m's"_ or _d°m.m'_.)
 +
If latitude/longitude or UTM geographical positions are to be input, select the proper topographical *Datum* to use for conversions.
 +
Select the *Shot Navigation Mode* with navigation arrows in the [Survey Shot|] and [Map|] forms. Choices are:
 +
# *Go to the next or previous series beginning* (default if the 4.4 format is selected)
 +
# *Go to Next Cave Leg* (determined by a station naming change in the left subpart of the station name if the 4.4 format is selected)
 +
# *Go to Next Session*
 +
# *Move by n shots*, where n is user\-chosen value between 1 and 255
 +
If the network cannot be built due to a lack of memory, unselecting the following checkboxes may perhaps reduce the memory requirements down to a working level, at the expense of lost functionality:
 +
# Unselecting *Retain Closure Errors* drops the closure error data; closure errors can no longer be displayed or listed; the memory gain is 61% for survey shots (16/26 bytes)
 +
*Note:* If the closure error data is not retained, Auriga plots survey shots between the computed position of their start and end stations, regardless of the position resulting from actually computing the survey shot, which may differ in case of a closure error, thus forcing an artificial loop closure.
 +
# Unselecting *Retain Passage Dimensions* drops the passage dimensions data; passage widths or cave walls can no longer be displayed; the memory gain is 31% for survey stations (14/44 bytes)
 +
# Unselecting *Retain Session Statistics* drops the total length statistics for sessions; this data is not currently usable by networks, so dropping it makes no difference and saves 12 bytes/session
 +
Tap the *Note* button to edit the network note. 255 characters are permitted.
 +
 
 +
h4.The Map tab
 +
 +
Select the network map *Grid* value. See the [Map|] tab of the [Preferences|] form for general grid preferences (that apply to all caves/networks).
 +
Select the *Automatic* checkbox so that the map grid gets resized when it cannot be displayed within the user\-defined minimum and maximum number of lines. The grid value is then multiplied or divided by 2 and rounded to the lowest integer. Otherwise, the grid is hidden.
 +
Select the *Wall Color same as Shot* checkbox so walls and dimensions are drawn in the map using the color of their corresponding survey shot. Otherwise, they are drawn using the default color selected in the [Map|] tab of the [Preferences|] form.
 +
Select the *Vertical* factor used in profile maps and coordinate computations to exaggerate the verticality of the network for display purposes. A factor less than 1 (ex. 0.5) actually flattens out a vertical network. This factor is applied to coordinates reported in the [List|] form for drawing, but coordinates reported in the [Map|] form are not affected.
 +
Indicate the coordinates of the network *Origin* (0,0,0 by default), expressed in map units.
 +
 
 +
h4.The Caves tab
 +
 +
This tab allow selecting the caves that are part of the network.
 +
Use the *Add* or *Remove* buttons to select caves; use the *Up* or *Down* arrow buttons to move the selected cave in the list; this order alters the search for linking stations when building the network (see the [Network Cave|] form.)
 +
From left to right, the 5 columns are:
 +
# *Loaded*: cave data could be loaded by the network building process \- this attribute is set by Auriga
 +
# *Linked*: the cave could be linked to the network \- Auriga only attempts to link loaded caves, and only linked caves can be displayed
 +
# *Draw in Map*: the cave is to be drawn in the network map
 +
# *Color*: this color is used when selecting the _Color by Cave_ option in the map settings popup list of the [Map|] form
 +
# *Alias*: prefix used before station names in the _Info_ line of the network [Map|]
 +
The _Draw in Map_, _Flip Extended Profile_ and _Color_ settings can be modified by holding down the stylus on them.
 +
Tapping on the currently selected cave displays the [Network Cave|] form.
 +
Menus: [Edit|] and [Defaults|].
 +
 
 +
h3.The Network Cave form
 +
 +
This form displays information on a networked cave, either already selected or being added to a network.
 +
Select the name of the networked *Cave*, either manually or with the drop\-down list of caves present on the device. Caves already selected for this network do not appear in the list. If there are no caves present on the device or if all caves present on the device are already selected for the network, the list does not show.
 +
The *Alias* is used as a prefix before station names in the _Info_ line of the network [Map|]. A short alias is preferable.
 +
Select the type of link that binds the cave to the network:
 +
# *Automatic*: Auriga sets the first cave on the network origin, and tries to link other caves by common stations with other caves
 +
# *By Geo\-Reference*: after a cave owning a geo\-reference can be linked to the network, other caves owning a geo\-reference can also be linked to the network through their geographic location; note that only UTM geographic locations are recognized at this moment
 +
# *Origin Same as Network*: the cave origin station is set on the network origin
 +
# *XYZ Offset from Network Origin*: the cave origin station is set on an XYZ shift from the network origin
 +
# *Station Linked to Remote Cave*: the cave is linked to another cave through common stations. If the cave is the only one currently selected for the network, the drop\-down list cannot be shown. If the *Station* and *Links to* fields are left empty, Auriga searches for identical stations in one or more caves; otherwise, a pair of different stations can be input. If the *of* field is left empty, Auriga searches for link stations in all other caves already linked; otherwise, the search is limited to a single cave. In any case, XYZ offsets can be input, they get added to the cave coordinates.
 +
# *Use Cave Origin as Offset*: the cave origin station coordinates (set in the [Computations|] tab of the [Cave Details|] form) are used as an offset from the network origin
 +
In _Automatic_ mode, selecting the *Auto Update Link Type* checkbox updates the link type to that actually used by Auriga upon successfully building the network. Otherwise, the *Actual link* button allows knowing the type of link used by Auriga when building the network. This button only appears after the network is built.
 +
Menu: [Edit|]
 +
 
 +
h3.The Selection form
 +
 +
The Selection form allows to select a set of survey shots or stations to act upon in the [Beam|], [Export|] and (later) [Maintenance|] forms.
 +
Use the rightmost popup list in the title bar to select the *Stations* or *Shots* view to indicate the type of items to select.
 +
Use the selector trigger in the middle of the title bar to view *All* or only *Selected* items.
 +
Items can be selected or unselected from the list by tapping on them. In _Selected_ mode, unselecting an item immediately removes it from the list.
 +
A continuous range of items can be selected or unselected by first selecting the *Range* pushbutton and the desired action (*\+* to select, *\-* to unselect), then selecting the bounds of the item range. The start of the range is highlighted by dotted lines. The desired operation is immediately performed when the second range bound is selected. In _Selected_ mode, items can only be unselected, and are immediately removed from the list. The operation can be aborted by unselecting the _Range_ pushbutton.
 +
The *Select* button opens the [Select|] form that offers various ways to select/unselect items.
 +
*Note:* The Selection is flushed from survey shots and stations when a survey shot is added or deleted to/from the cave.
 +
*Tip:* To break up a large cave into smaller more manageable subsets of that cave:
 +
# Display the cave [Map|]
 +
# Use the _Select_ stylus mode to graphically select the desired cave subset
 +
# In the [Select|] form, use the _Select from Map_ operation to add the selected survey shots to the Selection
 +
# If needed, repeat the previous operations to add or remove survey shots to/from the Selection
 +
# Go to the [Export|] form and export the selected survey shots into another (new) cave
 +
# To export the other half of the current cave into another cave return to the Selection form, use the _Invert Selection_ menu item and then repeat the export operation, this time into another (new) cave
 +
Menu: [Selection|].
 +
 
 +
h3.The Select form
 +
 +
The Select form offers various ways to select/unselect items in the Selection.
 +
Use the top pushbuttons to select the survey *Stations* or *Shots* view in which items are to be (de)selected .
 +
Select the *\+* (select), *\-* (unselect) or *Replace* pushbutton to determine the effect of the selection operation.
 +
Select the type of selection to perform:
 +
# _All_ (un)selects all survey shots or stations
 +
# _Select Session_ (un)selects survey shots or stations belonging to the current session or to a range of sessions.
 +
# _Select Series_ (un)selects survey shots or stations belonging to the current series or to a range of series.
 +
# _Select Between Dates_ (un)selects survey shots or stations input during the given date range
 +
# _Select from Map_ uses the selection made in the [Map|] form; this option is not available if no selection were made in the [Map|] form
 +
In _Select Session_ or _Select Series_ operations, if the *Current* checkbox is not selected, input fields are provided to supply a session or series range.
 +
When using a date range, it spans from 00:00:00 on the start date to 23:59:59 on the end date.
 +
Menu: [Edit|]
 +
 
 +
h3.The Pit Sounder form
 +
 +
This form allows estimating the depth of a pit from the fall time of a rock. Computations lay on the numerical resolution of the differential equation that describes the fall of a spherical body in air. The parameters of this equation are the mass and diameter of the rock, Earth's gravitational constant, air density and the Reynolds number of a sphere, that in turn depends on the diameter and instantaeous speed of the rock, as well as air density and viscosity.
 +
A more complete explanation of the maths involved is available in the [profondeurpuits.pdf|http://auriga.neopages.org/profondeurpuits.pdf] document (in French) in the Auriga Web site.
 +
Only the rock diameter is input by the user. The rock mass is computed from this diameter, using the average limestone density of 2520 kg per cubic meter. The gravitational constant used corresponds to a 45° latitude at the surface of the Earth. Air density and viscosity depend on temperature and humidity, but values used correspond to 20° Celsius in a saturated atmosphere (100% humidity.)
 +
The equation solution yields the distance travelled by the rock over time with the help of a constant\-step 4^th^ order Runge\-Kutta method. The computed pit depth takes into account the speed of sound in air.
 +
Find a rock, ideally spherical, and select its *Diameter* with the scroll bar.
 +
At the moment the rock is dropped (with no initial speed), hit the *Rock!* button or one of the 4 hardware application buttons to start the stopwatch.
 +
When the sound of the rock hitting the bottom of the pit is heard, hit the *Boom!* button or one of the 4 hardware application buttons to stop he stopwatch. The estimated depth is displayed after computations that can last a few seconds. The algorithm accepts fall times of up to 15 seconds.
 +
It is possible to manually input a fall time measured outside of Auriga by tapping the stylus on the time field to make it editable and to write that fall time. Hit the *Boom!* button to know the corresponding depth.
 +
For a detailed explanation of the physical model and the underlying mathematical treatment; see the _ProfondeurPuits.pdf_ document (in French) available in the _Support_ page of the [Auriga|http://auriga.neopages.org/%E9%E9www.speleo.qc.ca/Auriga] Web site.
 +
Research and algorithm: Pierre Beauchemin
 +
Menu: none.
 +
 
 +
h3.The Maintenance form
 +
 +
The Maintenance form offers various cave maintenance operations:
 +
*Note:* The first 3 operations should normally never be required and are only present for debug purposes.
 +
Series\-related operations are only available if the cave allows series, that is, if the stations naming scheme is 4.4 (see the [Cave Details|] form)
 +
# *Sort* sorts the cave. Caves are normally kept sorted automatically.
 +
# *Reorganize Cave* reorganizes the cave (number of shots, sessions, etc.)
 +
# *Purge Deleted Records* removes the deleted survey shot and session records from the cave. Such records are normally archived for use by the Auriga conduit, which then deletes them.
 +
*Warning*: Purging deleted records indiscriminately may result in the conduit not properly detecting deleted records.
 +
# \[not implemented\] *Set Session* sets a new session number for all shots between two given dates (that can be the same.) The target session must already exist. This allows correcting shot calibration when one later realizes instruments did not correspond to the active session calibration when shots were taken:
 +
## Create a new session from the active session shots were taken with
 +
## Modify the new session calibration to reflect true instrument calibration when shots were taken
 +
## Link survey shots to this new session
 +
*Note:* Creating a new session every survey day makes the instrument calibration easier: just edit the session.
 +
# *Change Session* renumbers a given session and all associated survey shots to a new session number (ex. session 1 becomes session 2 and all shots taken during session 1 are now associated with session 2 \- session 1 is then deleted.) If the new session number already exists, sessions are merged, with all associated survey shots.
 +
# \[not implemented\] *Change Series* renumbers all survey shots in a given series to another series (ex. all shots in series 4 become part of series 5.) Unselecting the *All Shots* checkbox allows specifying a range of survey shots to renumber \- only this series subset is then renumbered (ex. shots from 3.3 to 3.67.)
 +
# \[not implemented\] *Shift Shots/Series* shifts a series of survey shots by a given offset (ex. all shots in series 4, except the series beginning, are shifted by 3 survey shot numbers.) The resulting shots must not already exist or an error message is issued. Unselecting the *All Shots* checkbox allows specifying a range of survey shots to shift \- only this series subset is then shifted (ex. shots from 3.3 to 3.67.)
 +
Menu: [Edit|].
 +
 
 +
h3.The Font form
 +
 +
The Font form allows choosing various fonts.
 +
The *Notes* font is used to display network, cave, survey shot and session notes. It is also used for error logs.
 +
The *Survey Shot* font is used to display station names in the [Survey Shot|] form. If the cave has long station names containing letters, the standard font may be preferred.
 +
To avoid cluttering the map, prefer a small font for *Map Stations*. It is possible to load fonts other than the usual basic choices by installing *FontBucket* ([www.handshigh.com/fontbucket|http://www.handshigh.com/fontbucket]). FontBucket does not work on Sony Clié devices with high\-resolution screen, but Auriga nonetheless offers an accrued font selection.
 +
Menu: none.
 +
 
 +
h4.The Page Setup form
 +
     
 +
This form pops up when printing and allows configuring the print feature.
 +
Select the print *Font* (Courier, Times or Helvetica) and *Size* (9, 10 or 12 points.) Printing the [List|] form imposes the use of the Courier fixed\-width font for column alignment.
 +
Input the number of *Lines per page* for lists (use 0 for continuous paper.)
 +
Input the cave *Map Zoom Factor* used for map printing. This can be determined by experimenting with the target printer and paper size.
 +
Select whether the *Cave Name* and the *Current Date* must be printed too.
 +
Menu: [Edit|].
 +
 
 +
h2.Auriga menus
 +
 
 +
h3.The Cave menu
 +
#  *Statistics* leads to the [Statistics|] form, that displays statistics for the open or selected cave
 +
# *Details* leads to the [Cave Details|] form that displays details for the open or selected cave
 +
# *Sessions* leads to the [Session|] form. When the [Session|] form is launched via this menu, navigating between sessions does not affect the current shot session setting (unlike when launched with the _Session_ selector in the [Survey Shot|] form)
 +
# *Shot Errors* computes XYZC coordinates and displays a log of erroneous shots (incomplete or orphan), if any (see the [Map|] form)
 +
# *Closure Errors* computes XYZC coordinates and displays a log of loop closure errors, if any, given the maximum loop error setting (see the [Map|] form)
 +
# *Selection* leads to the [Selection|] form
 +
# *Export* leads to the [Export|] form
 +
# *Beam* leads to the [Beam|] form
 +
# *Maintenance* leads to the [Maintenance|] form, allowing various Auriga cave maintenance operations
 +
# *Backup to Card* opens the [Universal File Dialog (UFD)|] to allow selecting the card directory where the cave is going to be saved
 +
# *Restore from Card* opens the [Universal File Dialog (UFD)|] to allow selecting a cave present on the card to be restored into the device main memory (available in [Main|] form only)
 +
# *Close* closes the currently open cave (if any) and returns to the [Main|] form (not available in [Main|] form only)
 +
 
 +
 
 +
 
 +
h3.The Network menu
 +
#  *Statistics* leads to the [Statistics|] form, that displays statistics for the open or selected network
 +
# *Details* leads to the [Network Details|] form that displays details for the open or selected network
 +
# *Beam* beams the network
 +
# *Backup to Card* opens the [Universal File Dialog (UFD)|] to allow selecting the card directory where the network is going to be saved
 +
# *Restore from Card* opens the [Universal File Dialog (UFD)|] to allow selecting the network present on card to be restored into the device main memory (available in [Main|] form only)
 +
# *Close* closes the currently open network (if any) and returns to the [Main|] form (not available in [Main|] form only)
 +
 
 +
 
 +
 
 +
h3.The Edit menu
 +
#  *Undo*
 +
# *Cut*
 +
# *Copy*
 +
# *Paste*
 +
# *Select All*
 +
# *Keyboard*
 +
# *Graffiti Help*
 +
# *Swap Stations* swaps the survey stations in the [Survey Shot|] form (available in [Survey Shot|] form only)
 +
# *Slope Calculator* leads to the [Slope Calculator|] form (available in [Survey Shot|] form only)
 +
 
 +
 
 +
 
 +
h3.The Options menu
 +
#  *Fonts* leads to the [Fonts|] form. The font selected are used in logs, note fields and map display
 +
# *Preferences* leads to the [Preferences|] form
 +
# *Pit Sounder* leads to the [Pit Sounder|] form
 +
# *Power Off* puts the device to sleep, without exiting Auriga
 +
# *Backlight/Contrast* toggles the backlight state (on monochrome devices) or pops up the brightness dialog (on color devices)
 +
# *Battery Status* displays the percentage of battery charge remaining
 +
# *Limits* displays the minimum number of computable survey shots; see the [Limits|] section
 +
# *Help* displays form\-specific help in forms where an *i* button is not present
 +
# *About Auriga* displays the current Auriga version
 +
 
 +
 
 +
 
 +
h3.The Session menu
 +
#  *Select as Active Session* selects the displayed session as the active session
 +
# *Go To Active Session* displays the active session
 +
# *Beam* leads to the [Beam|] form
 +
 
 +
 
 +
 
 +
h3.The Defaults menu
 +
#  *Save Settings as Defaults* saves the current form settings as defaults
 +
# *Load Default Settings* loads the default settings relevant for the current form
 +
 
 +
 
 +
 
 +
h3.The Map menus
 +
#  \[not implemented\] *Close Loops* triggers the loop closure process
 +
# *Re\-compute Coordinates* forces a re\-computation of XYZC coordinates
 +
# *Print* prints the cave map
 +
# \[not implemented\] *Connect/Disconnect GPS* connects/disconnects a GPS for position tracking on the surface
 +
 
 +
 
 +
#  *Rebuild Network* reloads station coordinates of caves in the network and rebuilds links between them
 +
# *Re\-compute Caves* forces a re\-computation of XYZC coordinates of all caves in network
 +
 
 +
 
 +
 
 +
h3.The List menu
 +
#  *Columns* leads to the [Columns|] form
 +
# *Re\-compute Coordinates* forces a re\-computation of XYZC coordinates
 +
# *Print* prints the current list
 +
 
 +
 
 +
 
 +
h3.The Log menu
 +
#  *Export as Memo* exports the log to the built\-in Memo application
 +
# *Beam* beams the log to another device
 +
# *Print* prints the log
 +
 
 +
 
 +
 
 +
h3.The Position menu
 +
This menu is available in the [Auriga custom keypad|] when editing the start station of a virtual survey shot or a series beginning. It allows selecting the type of position given to the start station (if any.)
 +
 +
 
 +
 
 +
h3.The Selection menu
 +
#  *Select All* selects all items in the current view
 +
# *Unselect All* unselects all items in the current view
 +
# *Invert Selection* inverts the current selection in the current view
 +
# *Select Shots from Stations* selects all survey shots for which either one of its stations is already selected
 +
# *Select Stations from Shots* selects all stations referenced by selected survey shots
 +
# *Export* leads to the [Export|] form
 +
# *Beam* leads to the [Beam|] form
 +
 
 +
 
 +
 
 +
h2.Miscellaneous
 +
 
 +
h3.Beaming
 +
Infrared data transmission, known as "beaming" can be launched in Auriga with the _Beam_ item of the _Cave_ menu or the _Beam_ icon in the command bar menu (displayed when writing a slash ("/") Graffiti gesture). When launched from the [Main|] form, the cave currently selected in the list, if any, is beamed entirely. When launched from other forms, the Beam form is displayed:
 +
 +
The Beam form offers a choice of beam options; these options are context\-dependent and thus, not all of them may always be available.
 +
When using a date range, it spans from 00:00:00 on the start date to 23:59:59 on the end date.
 +
*Note:* Whatever the option selected, if the beamed cave already exists on the destination device, beamed data is added to the existing cave, or updates it. Nothing gets overwritten in the existing cave.
 +
Cave details are always beamed to the receiving device so as to make beamed data interpretable. Similarly, all sessions relevant to beamed survey shots accompany these survey shots in the beamed data.
 +
On the receiving device, the reception of beamed data pops up a form:
 +
 +
The Beamed Data Received form allows to change the target cave name; this allows creating caves of subparts of caves or to compensate for cave name differences between two devices. The vertical arrow pops up a list of existing caves on the device.
 +
If the target cave already exists, a merge process is launched:
 +
# Cave Details from the beamed cave are compared with those of the local (existing) cave and the following differences are logged:
 +
## station name format (4.4 or 8 characters) and character sets; if these differ, a user confirmation may be asked to proceed with the merge process as beamed series beginning could become incompatible with the resulting cave and thus require a prior conversion into virtual survey shots. If beamed and local caves differ by station name character sets, the most permissive sets are assigned for the local cave
 +
## XYZ coordinates of the cave origin
 +
## origin station
 +
## geographic reference station
 +
## altitude reference station
 +
# beamed survey shots that do not exist in the local cave (with same start/end stations) are inserted in the local cave
 +
# beamed survey shots that already exist in the local cave are compared:
 +
## local incomplete (missing survey data) survey shots are updated with their complete counterpart from the beamed cave (if available)
 +
## local survey shots without passage dimensions are updated with passage dimensions from beamed identical survey shots (if available)
 +
## local survey shots without a note are updated with notes from identical beamed survey shots (if available)
 +
## beamed survey shots differing from local survey shots with regards to session number, survey data (length, azimuth, slope or passage dimensions) or note are duplicated in the local cave and sorted *before* their corresponding local survey shot
 +
# beamed sessions that do not exist in the local cave (with same session number) are inserted in the local cave.
 +
# beamed sessions that already exist in the local cave are compared:
 +
## local sessions without a note are updated with notes from identical beamed sessions (if available)
 +
## beamed sessions differing from local sessions with regards to instruments calibration, survey shot settings or note are added to the local cave but get renumbered with the first available session number on both sides. Received survey shots associated with these sessions get assigned to the new session numbers.
 +
If the beam merge process modified the local cave, a merge log is generated and written as a memo in the built\-in Memo Pad application. This log indicates:
 +
# differences in cave details
 +
# the list of renumbered sessions
 +
# duplicated or updated survey shots
 +
# renumbered or updated sessions
 +
*Note:* If survey shots or sessions were duplicated by the beam merge process, the user should *immediately clean up* the cave by removing superfluous records, eventually manually merging their data into one. A cave with duplicate survey shots or sessions is bound to create confusion.
 +
*Tip:* If two or more teams survey a cave, upon exiting the cave,
 +
# all teams should first beam their cave to one of the devices
 +
# the cave of this device should be cleaned up from duplicate survey shots and sessions resulting from the merge process
 +
# the existing cave should be removed from other devices
 +
# the merged cave should be beamed to these other devices
 +
At the end of this operation, all devices will contain the entire cave data. Failing to remove the existing cave from the devices (step 3) before receiving the merged cave may again result in duplications and require a subsequent clean\-up on receiving devices.
 +
*Warning:* Beaming Auriga caves with file managers like FileZ does not trigger a beam merge process; instead, the beamed cave simply overwrites the local (existing) cave.
 +
 
 +
h3.Data Export
 +
The export of cave survey data works the same as [Beaming|], except that exported data are stored into a local cave. This allows splitting a cave into subparts (for example, to reduce computation delay) or, on the opposite, to merge into one several parts of a cave mapped separately. Options offered by the Export form:
 +
 +
are the same as those of the [Beam|] form, but in this case, the edited target cave name must be different from the current cave name.
 +
 
 +
h3.Backup/restore on memory card
 +
Auriga can backup or restore its caves or networks to/from a memory card via items in the Cave or Network menu. Restoring a cave/network can only be performed while in [The Main form|]
 +
Requirements are:
 +
# a device with a Secure Digital or Memory Stick slot
 +
# an unlocked card this slot (i.e. not in read\-only mode)
 +
# UFD.prc (Universal File Dialog) loaded on device (downloadable from Auriga's Web site)
 +
 +
In backup mode, the current cave/network DB, or the selected cave/network DB in [The Main form|], is written in the card directory selected with UFD.
 +
In restore mode, the cave DB selected on the card with UFD is restored on the device. A confirmation is required prior to overwriting an existing cave/network.
 +
This backup/restore feature can be used as a faster alternative to beaming caves/networks between devices. However, data merge is not yet implemented; the restored cave/network can only overwrite the (existing) local cave/network.
 +
 
 +
h3.Use of silkscreen icons and hardware buttons on 4\-button devices
 +
|*Form/Key*|*Calendar*|*Contacts*|*To Do*|*Notes*|*Calculator1*|*Page Up2*|*Page Down2*|
 +
|*Survey Shot*|Previous series|Previous survey shot|Next survey shot|Next series|Slope Calculator^3^|Previous field|Next field|
 +
|*Survey Shot with Assistant*|[Sketch to Scale|]|Keypad|Save \+
 +
New shot|[Map|]|Calculator|Previous field|Next field|
 +
|*Map (Zoom)*|Zoom out|Pan left|Pan right|Zoom in|Calculator|Pan up|Pan down|
 +
|*Map (Info)*|Previous series|Previous survey shot|Next survey shot|Next series|Calculator|Previous station|Next station|
 +
|*List*|Maximum scroll left|Scroll left|Scroll left|Maximum scroll right|Calculator|Scroll up|Scroll down|
 +
|*Auriga keypad*|Symbols|Accents|Alphabet^4^|Numbers|Slope Calculator^3^|Previous field|Next field|
 +
|*Sketch*|Exit|Shot Data|Toggle View|Toggle View|Calculator|\-|\-|
 +
|*Others*|Leftward tab|Keypad|\-|Rightward tab|Calculator|Previous field|Next field|
 +
# Upper right button in Graffiti area
 +
# The Palm 5\-way Navigator in up/down directions behaves like these buttons
 +
# If the insertion point is currently in the *Slope* or *Reverse Slope* field; otherwise, pops up the application linked with this button (calculator or other)
 +
# If the keypad layout is already alphabetic, pops up the Palm OS keyboard
 +
 
 +
h3.Use of silkscreen icons and hardware buttons on 2\-button devices (Palm Zire)
 +
|*Form/Key*|*Calendar*|*Contacts*|*Star (HotSync)*|*Page Up1*|*Page Down1*|
 +
|*Survey Shot*|Previous survey shot|Next survey shot|Slope Calculator^2^|Previous field|Next field|
 +
|*Survey Shot with Assistant*|Keypad|Save \+
 +
New shot|Calculator|Previous field|Next field|
 +
|*Map (Zoom)*|Pan left|Pan right|Calculator|Pan up|Pan down|
 +
|*Map (Info)*|Previous survey shot|Next survey shot|Calculator|Previous station|Next station|
 +
|*List*|Scroll left|Scroll right|Calculator|Scroll up|Scroll down|
 +
|*Auriga keypad*|Palm OS keyboard|Rightward layout|Slope Calculator^2^|Previous field|Next field|
 +
|*Sketch*|Shot Data|Toggle View|Calculator|\-|\-|
 +
|*Others*|Keypad|Rightward tab|Calculator|Previous field|Next field|
 +
# The Palm 5\-way Navigator in up/down directions behaves like these buttons
 +
# If the insertion point is currently in the *Slope* or *Reverse Slope* field; otherwise, pops up the calculator
 +
 
 +
h3.Use of Sony JogDial and Palm 5\-way Navigator
 +
|*Form/Action*|*Jog Up*|*Jog Down*|*Jog Push*|*Jog Back*|*Navigator Left*|*Navigator Right*|*Navigator Select*|
 +
|*Main*|Scroll up|Scroll down|Open cave|Exit|\-|\-|\-|
 +
|*Survey Shot*|Previous field|Next field|Menu|Previous form|Previous field|Next field|Connect|
 +
|*Survey Shot with Assistant*|Previous field|Next field|Menu|Exit|Previous field|Next field|Connect|
 +
|*Session*|Previous session|Next session|Menu|Previous form|Previous field|Next field|\-|
 +
|*Map*|Previous station|Next station|Menu|Survey Shot form|Left pan|Right pan|\-|
 +
|*List*|Scroll up|Scroll down|Menu|Exit|Scroll left|Scroll right|\-|
 +
|*Auriga Keypad*|Previous field|Next field|\-|Previous form|Previous field|Next field|\-|
 +
|*Others*|Previous field|Next field|\-|Previous form|Leftward tab|Rightward tab|\-|
 +
 
 +
h3.Limits
 +
# Maximum number of survey shots per cave: 16,382
 +
# Maximum number of survey sessions: 16,383 minus the number of survey shots
 +
# Maximum number of survey shots per survey session: 16 382
 +
# Maximum number of caves on Palm OS device: only limited by memory
 +
# Cave name maximum length: 26 characters
 +
# Precision of survey data:
 +
## 0.01 unit for length data (meter or foot); 1 inch for feet\-inches data
 +
## 0.01 unit for azimuths and slopes (degree or grad); 1 minute for sexagesimal data
 +
## 0.1 second or 0.001 minute for theodolite angles
 +
## 0.1 unit for depths (meter or foot)
 +
## 1 unit for altitudes (meter or foot)
 +
## 1 cm (i.e. 2 decimals) for geodesic grid positions
 +
## 0.01 second for latitude/longitude
 +
# Maximum survey shot length: 655.33 units (meters or feet)
 +
# Maximum passage size at station: 655.33 units (meters or feet)
 +
# Depth range: \-3276.7 to 3276.6 units (meters or feet)
 +
# Altitude range: \-32767 to 32766 units (meters or feet)
 +
The *maximum number* of computable survey shots is limited by available memory (RAM), as well as the amount of this memory the OS allocates for applications use ("heap"); this depends on device model and Palm OS version.
 +
The *minimum number* of computable survey shots can be obtained with the _Limits_ item of the _Options_ menu. This estimate assumes an equal number of survey shots and stations. The maximum number of computable survey shots may be higher than the number reported if the cave has many interconnected passages, thus reducing the stations/shots ratio (and stations require almost twice as much computation memory as survey shots). This estimate does not take into consideration memory used by sessions when computing caves (networks do not require memory for sessions). If your cave has several sessions, the actual number of computable survey shots might be reduced. Moreover, this assumes that you are simply computing a cave and not displaying lists, which also require memory. If you display a list and later are unable to compute a cave, you might want to try exiting and reentering Auriga to then go straight to computing the map. Obviously, these manoeuvres are only necessary if your cave is close to the device memory limit. When computing a network, see the [Network|] tab of the [Network Details|] form for options to reduce the memory required by computations.
 +
|*Device*|*OS*|*RAM
 +
(Mb)*|*CPU
 +
(MHz)*|*Heap memory*|*Min. Cave Shots*|*Min. Network Shots*|*Min. Network
 +
"Light" Shots1*|
 +
|*Palm III*|3.0|1|4|90.9 Kb|871|897|1,525|
 +
|*Palm III*|4.1^2^|1|4|121.3 Kb|1,138|1,172|1,992|
 +
|*Palm IIIe*|3.1|2|16|122.7 Kb|1,322|1,361|2,313|
 +
|*Palm IIIx*|3.1|4|16|122.7 Kb|1,276|1,313|2,233|
 +
|*Palm IIIx*|4.1^2^|4|16|249.3 Kb|2,919|3,004|5,100|
 +
|*Palm IIIxe*|3.5\-4.1|8|16|250.0 Kb|2,957|3,044|5,176|
 +
|*Palm IIIc*|3.5|8|16|250.0 Kb|3,199|3,293|5,598|
 +
|*Palm m105*|3.5|8|16|250.0 Kb|3,016|3,104|5,278|
 +
|*Palm m125*|4.0|8|33|249.3 Kb|2,791|2,873|4,884|
 +
|*Palm m130*|4.1|8^3^|33|249,3 Kb|2,952|3,039|5,167|
 +
|*Palm Zire*|4.1|2|16|121.3 Kb|1,045|1,076|1,829|
 +
|*Palm Zire 31*|5.2|8^3^|33|1,0 Mb|13,773|14,178|24,103|
 +
|*Sony Clié S\-360*|4.1|16^4^|33|249.3 Kb|2,462|2,534|4,309|
 +
|*Sony Clié SJ\-22*|4.1|16^4^|33|1.0 Mb|13,572|13,971|23,752|
 +
|*Palm Tungsten E*|5.2|32^3^|126|2.0 Mb|28,436|29,272|49,763|
 +
|*Palm Tungsten 2*|5.2|32^3^|144|800.0 Kb|9,782|10,070|17,119|
 +
|*Palm Tungsten 3*|5.2|64^3^|400|11.0 Mb|65,545^5^|65,545^5^|65,545^5^|
 +
|*Palm TX*|5.4.9|128^3^|312|6.0 Mb|65,545^5^|65,545^5^|65,545^5^|
 +
 
 +
# Reached by deselecting the memory options in the [Network|] tab of the [Network Details|] form
 +
# After OS upgrade
 +
# Features a Secure Digital card slot
 +
# Features a Memory Stick card slot
 +
# Maximum number of survey shots computable by Auriga regardless of heap size
 +
Owners of devices not listed above are invited to run the _Limits_ item of the _Options_ menu and to report the results obtained.
 +
*Tip:* if a cave is too large to be computed on a given device (Auriga then reports it could not allocate the graph), or if computations take too much time, it is possible to fragment the cave by exporting to another new cave only areas of current interest (as distinguished by specific sessions and/or series). After adding new survey shots to this sub\-cave, it is possible to merge this new data with the original cave by exporting the sub\-cave back into the original cave. All this can obviously be done on the PC, but also in Auriga itself, because although a large cave may not be computable on some older hardware, importing and exporting caves is still possible.
 +
For you information, here is a [study|http://www.laubrass.com/doc/PUB/BATTERY/Battery Test for PDA.pdf] on the battery duration of various devices.
 +
 
 +
h3.Storage
 +
Each Auriga cave is stored in a distinct Palm OS database (PDB.) The cave database consists of general information about the cave, followed by shot and session records, sorted by start and end stations or session number respectively.
 +
# Cave database general information is 380 bytes \+ note (1 byte/character) \+ 78 bytes for Palm OS management
 +
# Survey shot records are 56 bytes \+ note (1 byte/character) \+ 8 bytes for Palm OS management
 +
# Session records are 138 bytes \+ note (1 byte/character) \+ 8 bytes for Palm OS management
 +
Thus, a cave containing 100 survey shots is at least 6 Kbytes in size.
 +
 
 +
h3.Requirements
 +
Minimum: Palm OS 3.0 or higher (runs on any Palm OS device since the Palm III)
 +
Recommended: Palm OS 3.5 or higher
 +
Uses 509 Kb of RAM.
 +
 
 +
h1.Frequently Asked Questions
 +
# [Numbers cannot be entered with a comma/period decimal separator|]
 +
# [Survey shots cannot be saved without inputting passage dimensions|]
 +
# [When saving new survey shots, Auriga keeps asking whether to create a new survey shot or to replace the current (existing) one|]
 +
# [The cave map is empty or incomplete|]
 +
# [Auriga repeatedly starts with a crash|]
 +
# [The screen appears lighter on a Palm IIIxe when running Auriga|]
 +
# [The vertical scroll bar does not work in the List form|]
 +
*Numbers cannot be entered with a comma/period decimal separator*
 +
Auriga uses the decimal separator selected in the Palm OS Prefs program
 +
*Survey shots cannot be saved without inputting passage dimensions*
 +
The _Passage Dimensions_ checkbox in the _Shots_ tab of the _Sessions_ form determines whether passage dimensions are mandatory or optional
 +
*When saving new survey shots, Auriga keeps asking whether to create a new survey shot or to replace the current (existing) one*
 +
The proper way to create new survey shots is to tap the _New_ (square with a star) button in the _Survey Shot_ form; this auto\-increments station names and clears other input fields. On the other hand, editing the input fields to enter a new survey shot "over" an existing one naturally prompts Auriga to ask whether to replace the current survey shot or to create a new one
 +
*The cave map is empty or incomplete*
 +
An empty or incomplete cave map can be due to several causes:
 +
# the current zoom ratio or pan factor puts all survey shots off screen
 +
# no survey shot could be computed (try the _Re\-compute Coordinates_ item in the _Map_ menu to see what happens)
 +
# the state of the _Draw_ checkbox in sessions, series or indivisual survey shots prevents survey shots from being drawn
 +
# the _Line Plot_ item is unselected in the _Map Settings_ popup list (leftmost icon at the bottom of the [Map|] form)
 +
# the cave contains orphan legs while the _Orphan Legs_ item is unselected in the _Map Settings_ popup list (check the _Shot Errors_ item in the _Cave_ menu to display survey shot errors)
 +
# the selected default, session, series or individual survey shot colors (depending on the _Map Coloring_ option in the _Map Settings_ popup list) are invisible against the currently selected background color (black or white)
 +
 
 +
*Auriga repeatedly starts with a crash*
 +
When Auriga is launched, it re\-opens the cave and the form it was left in when last exited. So, if for some reason the last opened cave/network crashes Auriga, re\-starting Auriga will repeatedly crash it. This cycle can be broken by holding down the *PageUp* button while tapping on the Auriga icon; an alert will then ask whether to start Auriga without opening the previous cave/network. Select *OK*. If things still go bad, repeat the operation, but this time select the *Reset* button to reset all Auriga preferences; note that this does not affect cave\-specific settings. After that, you should report the bug to me, along with the faulty \_Cave.PDB file.
 +
*The screen appears lighter on a Palm IIIxe when running Auriga*
 +
Due to a quirk in the graphic controller of some Palm IIIxe devices, when Auriga turns on the 4 bits/pixel mode to enjoy 16 shades of gray in the cave map, blacks tend to become lighter.
 +
*The vertical scroll bar does not work in the [List|] form*
 +
On devices with Palm OS version prior to 3.5, vertical scroll bars did not always work. Use the *PageUp* and *PageDown* buttons instead.
 +
 
 +
Auriga Web site: [www.speleo.qc.ca/Auriga|http://www.speleo.qc.ca/Auriga]
 +
Document last updated 2006\-12\-01

Latest revision as of 06:00, 14 August 2012

Not ready yet.png Το παρόν κεφάλαιο (Auriga) ΔΕΝ έχει ακόμη ολοκληρωθεί και πολύ πιθανόν να περιέχει πληροφορίες και οδηγίες ΠΟΥ ΝΑ ΜΗΝ ΕΙΝΑΙ ΑΚΡΙΒΕΙΣ!.

Εξώφυλλο, οπισθόφυλλο και λοιπά - Πρόλογος - Εισαγωγή - Ατομικός σπηλαιολογικός εξοπλισμός - Ένδυση - υπόδηση - φωτισμός κλπ - Υλικά ανάβασης - κατάβασης - Σκοινί - Γενικής φύσεως - Υλικά Αρματώματος - Kόμποι - ...κι άλλοι κόμποι (πιο εξειδικευμένοι) - Τεχνικές Μονού Σκοινιού - Γενικά - Τεχνικές Μονού Σκοινιού - Κατάβαση - Τεχνικές Μονού Σκοινιού - Ανάβαση - Τεχνικές αυτοδιάσωσης για μικρές ομάδες - Κίνδυνοι κατά την κατάβαση / ανάβαση με Τεχνικές Μονού Σκοινιού - Αρμάτωμα - Βασικές αρχές - Αρμάτωμα - Για προχωρημένους - Ελαφρύ αρμάτωμα (light rigging) Η αναρρίχηση στην σπηλαιολογία - Ελεύθερη αναρρίχηση - Τεχνητή αναρρίχηση - Εξορμήσεις του Σαββατοκύριακου - Μεγάλες αποστολές - Ατυχήματα στην σπηλαιολογία - Πρώτες Βοήθειες - Θερμό σημείο - Σπηλαιοδιάσωση - Χαρτογράφηση - Γεωλογία και Σπηλαιογέννεση - Βιοσπηλαιολογία - Καταστροφές - προστασία των σπηλαίων - Πού μπορώ να κάνω σεμινάρια; - Μερικά σπήλαια για πρακτική - Συκιά - Μονή Αστερίου - Του Προφήτη Ηλία - Σαλίγκαρος - Γερμανικό - Παρεξήγηση - Πύργος Υμητού - Βιβλιογραφία - Τα σπήλαια σε όλες τις γλώσσες - Διεθνές Λεξικό Σπηλαιολογικής Ορολογίας - Nομικό πλαίσιο

Auriga user manual 1.04

  • Table of contents*
  1. [Introduction|]
  2. [Why read this manual'|]
  3. [Installing Auriga|]
  4. [Notes on user interface|]
  5. [Quick start|]
    1. [Viewing existing cave data|]
    2. [Surveying a cave|]
  6. [Auriga key concepts|]
    1. [Customizing Auriga|]
    2. [Series vs Sessions|]
    3. [Coordinates|]
    4. [Data input|]
    5. [The Input Assistant|]
    6. [Launching Auriga|]
    7. [Coordinates computation|]
    8. [Passage dimensions|]
    9. [Cave diving data|]
  7. [Auriga forms|]
    1. [The Main form|]
    2. [The Preferences form|]
      1. [The General tab|]
      2. [The Assistant tab|]
      3. [The Map tab|]
      4. [The Link tab|]
        1. [Connecting a GPS|]
        2. [Connecting a TNT Revolution module|]
        3. [Connecting a Disto|]
    3. [The Cave Details form|]
      1. [The Cave tab|]
      2. [The Stations tab|]
      3. [The Computations tab|]
      4. [The Map tab|]
    4. [The Survey Shot form|]
      1. [Regular survey shots|]
      2. [Virtual survey shots|]
      3. [Series beginnings (cave legs or passages)|]
      4. [The Survey Shot Search form|]
      5. [The Slope Calculator|]
      6. [The Sketch to Scale form|]
    5. [The Session form|]
      1. [The Instruments tab|]
      2. [The Shots tab|]
    6. [The Auriga Keypad|]
    7. [The List form|]
      1. [The Columns form|]
    8. [The Map form|]
    9. [The Statistics form|]
    10. [The Network Details form|]
      1. [The Network tab|]
      2. [The Map tab|]
      3. [The Caves tab|]
    11. [The Network Cave form|]
    12. [The Selection form|]
    13. [The Select form|]
    14. [The Pit sounder form|]
    15. [The Maintenance form|]
    16. [The Fonts form|]
    17. [The Page Setup form|]
  8. [Auriga menus|]
    1. [The Cave menu|]
    2. [The Network menu|]
    3. [The Edit menu|]
    4. [The Options menu|]
    5. [The Session menu|]
    6. [The Defaults menu|]
    7. [The Map menus|]
    8. [The List menu|]
    9. [The Log menu|]
    10. [The Position menu|]
    11. [The Selection menu|]
  9. [Miscellaneous|]
    1. [Beaming|]
    2. [Data export|]
    3. [Database backup/restore on memory card|]
    4. [Use of silkscreen icons and hardware buttons on 4\-button devices|]
    5. [Use of silkscreen icons and hardware buttons on 2\-button devices (Palm Zire)|]
    6. [Limits|]
    7. [Storage|]
    8. [Requirements|]
  10. [Frequently asked questions|]


h2.Introduction Auriga is a cave survey software that runs on Palm OS devices. Auriga stores survey shots as a collection of records in Palm OS databases and performs appropriate computations to convert survey shot data into Cartesian coordinates. Results can be displayed in graphical (line plot) or list form. Each cave is stored in a separate database and is automatically backed up on the PC/Mac by the HotSync Manager. A conduit allows the synchronization of Auriga databases with various cave survey software running under Windows or Mac OS. Auriga was designed with flexibility and ease of use in mind. Several survey teams, each with various sets of instruments using various measurement units, can survey a given cave and merge their data into a single cave, both on Palm devices and PC/Mac.

h2.Why read this manual' Despite all my efforts to make Auriga as user\-friendly and intuitive as possible, it is sometimes hard to make all the information immediately visible on such a small screen. Furthermore, if Auriga is not complicated, it remains nonetheless complex, due to the wealth of available options. A single read of this manual should allow you to:

  1. get an understanding of underlying concepts in Auriga
  2. understand the operation of Auriga
  3. discover unsuspected features
  4. go underground with Auriga with peace of mind (without having to take this manual with you)

h2.Installing Auriga The basic Auriga delivery consists of 7 Palm OS files:

  1. *aurigaen.prc* \- the Auriga English executable
  2. *grids.pdb* \- a collection of geodesic datum
  3. *mathlib.prc* \- a mathematic and trigonometric shared library already used by many calculators and other computational programs (it could already be present on your Palm OS device)
  4. 3 demo caves (optional):
    1. Fairy\_Cave\_Cave.pdb: Fairy Cave is a Toporobot export
    2. Kiamika\_Cave.pdb; Kiamika was mapped with Auriga in September 2003
    3. Voronja\_Cave.PDB : Voronja is a Compass export, but parts of it were surveyed with Auriga in 2005

If you want to be able to toggle operating language on the fly, also load desired resources files:

  1. AurigaFR\_rsrc.prc (French)
  2. AurigaES\_rsrc.prc (Spanish)

Install these files on the Palm OS device via the Palm Desktop and the HotSync Manager. Only Auriga appears on the Palm desktop, although the other files can be seen in the Palm OS *Info* view on the desktop (PRCs only) or with other file managers like FileZ. If the available memory of your device permits, also install the 3 files from the FontBucket.zip archive to enjoy a larger selection of small fonts for the cave map. You may later reclaim the memory used by unwanted fonts by deleting them with the FontBucket program.

  • Note:* FontBucket does not work on high resolution Sony Clié devices.

If using a Palm Tungsten 3 device, also install the compatibility PRCs provided by Palm to support the Dynamic Input (Graffiti) Area (Tungsten3.zip archive). If you want to be able to print on IR\-enabled Postscript or LaserJet printers, also load the 2 files contained in the XPprint.zip archive. To export Auriga survey data into Compass or Visual Topo files, also install the [Auriga conduit|http://chenier.dag.ca/AurigaConduit/AurigaConduitReadMe.html] on your PC (chenier.dag.ca/AurigaConduit/AurigaConduitReadMe.html).

h2.Notes on user interface Online help is available in every Auriga form: in modal dialogs (signaled by a bold border), tap on the *i* icon in the title bar; in other forms, use the _Help_ item from the _Options_ menu. Configuration forms (Preferences, Details and Sessions) feature a *Defaults* menu allowing to save the current configuration as default values, and to recall them later. Data input in forms is usually only validated upon saving the form contents. When invalid data is found, a beep is played and the insertion point is moved to the faulty field; if need be, the current tab is changed to the one containing the faulty field. A few graphic buttons are used in various forms:

  1. Save
  2. New
  3. Delete
  4. Sketch
  5. Map
  6. List
  7. Note (appears in black if a note already exists)
  8. Form (exit)
  9. Attributes

h2.Quick start Starting Auriga for the first time brings up the [Main|] form. After that, starting Auriga restores its previous state. [Preferences|] should be configured before going further ([Options|] menu, _Preferences_ item.) Minimally, set the paper grid size in the *Map* tab.

h3.Surveying a cave

  1. Create and open a [new|] cave ([Main|] form, *New* button)
    1. Enter the cave name
    2. Select length and angle units
    3. Select the target software
    4. Go to the *Stations* tab and select the station naming scheme
    5. Go to the *Computations* tab and set the map scale and the global magnetic deviation (optional)
    6. Go to the *Map* tab and set the grid size
    7. If you want to save these settings so that future caves inherit them by default, drop down the *Defaults* menu and select the *Save Settings as Defaults* item
    8. Save the cave details with the *OK* button
  1. The [Session|] form pops up automatically (sessions are also known as "surveys" in some other cave surveying software)
    1. Enter the session name (optional)
    2. Select length and angle units for instruments set 1
    3. Tap the *Set 2* pushbutton and select length and angle units for instruments set 2
    4. Go to the *Shots* tab and set default dimension, azimuth and slope direction
    5. Set the session\-specific magnetic deviation (optional)
    6. Select the backsight azimuth and slope behavior
    7. If you want to save these settings so that future sessions use them as default, drop down the *Defaults* menu and select the *Save Settings as Defaults* item
    8. Save the session with the *Save* button and exit the form with the *Done* button
  1. Input survey shots with the [Survey Shot|] form
    1. Enter start and end stations
    2. Enter length, azimuth and slope data
    3. If you enabled passage dimensions in the [Session|] form, enter passage dimensions
    4. Enter a note (optional, but convenient to find your way in your survey data)
    5. Tap on the *Save* icon (checkmark)
    6. Tap on the *New* icon (square with a star) to create a new survey shot
    7. Repeat entering survey shot data
    8. Tap on the *Map* icon (network\-like) to view the cave [Map|]
    9. Tap on the *Form* icon (rightmost at the bottom of the screen) to return to the [Survey Shot|] form
    10. Tap on the *Home* icon to return to the [Main|] form

Countless other features are available and are fully described in this manual. This manual is easy to read and the text is accompanied by helpful screen shots. It contains:

  1. valuable information on key surveying concepts used in Auriga
  2. details on how to use the _Assistant_ to enable you to enter data more quickly and more accurately
  3. description of all map features tools (zoom, pan, survey shot information, queries, ...)
  4. use of lists to review or navigate within the data
  5. and much much more!

To be informed about the frequent updates to Auriga, you should definitely subscribe to the Auriga e\-mail list by sending an e\-mail to: [auriga\-topo\-subscribe@yahoogroups.com|mailto:auriga-topo-subscribe@yahoogroups.com], or at least check back with the Auriga Web site regularly: [www.speleo.qc.ca/Auriga|http://www.speleo.qc.ca/Auriga].

h2.Auriga key concepts

  • Stations* are survey locations (virtual or physical, that is, placed anywhere in a cave passage, or located on a cave wall or some other physical feature. Survey shots are taken from one station toward another station.

Auriga supports station names of up to 8 characters, with an optional separator. In the latter case, the station name is input as 2 parts of at most 4 characters each, with the separator in the middle. Example: 12.41 As with any cave survey software, one of the difficulties is to be able to manipulate as a whole a series of survey stations that correspond to a single *cave leg* or *passages* This requires to be able to group survey stations into *Series*. One way to let the cave survey software know which survey stations belong to the same series is to use survey station names that share a common identifiable root. In addition to 8\-character station names, Auriga also offers a station name format called "4.4" where both the series name and the station number in that series can each use between 1 and 4 characters. Auriga can discriminate series in station names in the 4.4 format if either:

  1. An explicit separator (dot or slash) separates between the leg "prefix" (called the "series") and the station number within that series (ex. station LAKE.6B represents station number 6B in series LAKE)
  2. Exclusive character sets are used for the series name and the station number (ex. A\-Z for series name, 0\-9 for station numbers, so station LAKE66 represents station 66 in series LAKE)
  3. A character type change occurs between series name and station number. (ex. LAKE66B represents station 66B in series LAKE). Note that in this case, the series prefix is detected when, starting from the leftmost character in the station name, a character type change occurs (ex. in LAKE66B, characters A\-Z can occur in both the series name and station number, but when letters in LAKE change to a digit (6), the series name is detected).
  • Note:* With or without separator, with the "4.4" station name format, a 4\-character limit applies to the length of both series name and station number. Station names like LAKEHERE, LAKE2.66B or LA.665544 are thus invalid.
  • Survey shots* are links between a pair of stations. Auriga differentiates 3 types of survey shots:
  1. regular survey shots
  2. virtual survey shots
  3. series beginnings
  • Regular survey shots* are physical measurements between a start station and an end station. They consist of:
  1. a length (distance between two stations) or a pair of Topofil readings
  2. a compass azimuth (horizontal angle between two stations relative to North, true or magnetic, or absolute if a theodolite is used)
  3. a slope (vertical inclination between two stations), an altimeter, or a depthmeter reading
  4. optionally, the passage dimensions (height below and above the reference station and width left and right of that station perpendicular to the survey shot; the station where these dimensions are taken, either start or end, is user\-selectable)
  • Note:* The *Topofil* is a length\-measuring device originally used in agriculture and forestry and involving a disposable cotton thread rolling onto a wheel connected to a numeric odometer; the thread is cut after each measurement and can be picked up or left to rot on the ground. The Vulcain Caving Group in Lyon, France, makes a popular [model especially designed for caving|http://groupe.vulcain.free.fr/com/btopo.pdf]. Their compact sturdy box also provides azimuth data by aligning the thread with the embedded compass, and slope data, measured with a protractor glued on the side of the box and placed against the thread while the box is maintained horizontal with the help of an embedded bubble level.
  • Virtual survey shots* are zero\-length survey shots that link two stations together. Virtual survey shots can act as milestones (the start and end stations can be the same.) Virtual shots can be used to mark an entrance or hold a geographic position; they are also convenient for joining cave legs together when junctions are made. Virtual shots can also be used to record passage dimensions at the beginning (or end) of a passage when dimensions are recorded on end (or start) stations.
  • Series beginnings* are virtual survey shots representing the beginning of a series. *Series* are logical groupings of contiguous stations. Their use in Auriga is optional. Stations composing a single passage, or "cave leg", would likely be part of the same series, while another cave branch would be part of another series.

Each series has a unique name; stations pertaining to the same series share this common series prefix. Ex. stations 3.1 and 3.2 are both part of series 3. Survey shots do not have to be continuously numbered (without gaps) to be part of the same series; their start station only needs to share a common series name. Ex. survey shots 3.1\-3.2, 3.2\-3.6 and 3.6\-4.2 constitute a possible series 3. Although series can start at any shot number, a *Series Beginning* shot is necessary to hold settings that apply to a whole series (add to cave development, draw or color in map, etc.) Series beginnings are thus special virtual (zero\-length) survey shots linking a cave passage to the rest of the cave. Using series beginnings imposes 3 minor constraints:

  1. there can only be one series beginning per series
  2. the series beginning station must have the smallest station number within the series (ex. 2.2 cannot be a series beginning station if there also exists a survey station numbered 2.1)
  3. series beginnings survey shots must be entered as: _series beginning station \- connecting station_ (ex. 2.0 \- 1.4 is the beginning shot for series 2) and not the opposite

Series beginnings are often given a station number of '0', '1', 'A' or 'a'. Although not required by Auriga, this may be convenient as it can allow automatic recognition of series beginning shots by the software. These options can be selected in the [Stations|] tab of the [Cave Details|] form. Even if series beginnings are not used by the target cave survey desktop software, they improve Auriga navigation by making it easier to distinguish cave legs and browse survey shots faster. Series become transparent to cave survey desktop software that do not recognize them: the Auriga conduit simply converts them into virtual survey shots when syncing with these desktop software.

  • Geographic positions* given to virtual survey shots or series beginnings are used to compute the geographical position of the current survey shot's stations as well as that of other stations that depend on them. An entrance is usually such a milestone, as well as any other station where a precise position can be determined (likely with a GPS or through radio\-location techniques.)

If the Cartesian coordinates of the stations of a virtual survey shot or a series beginning cannot be computed (because no computed station links to this survey shot), the UTM position of this survey shot, if available, is used to compute the XY coordinates of its stations relative to the cave geo\-reference (if a geo\-reference is available).

  • Warning*: In order to minimize data storage, survey shots can only be *either*:
  1. a regular survey shot
  2. a virtual survey shot (2 stations virtually made equal)
  3. a series beginning

and *not* a simultaneous combination of these. Thus, for example, in order to give a geographic position to the entrance station 1.0 and survey from station 1.0 to station 1.1, the user should input:

  1. a virtual survey shot or a series beginning for stations 1.0\-1.0, holding a geographic position
  2. a regular survey shot 1.0\-1.1

Survey shots can be saved as *Incomplete*. This allows "reserving" their name, while measuring some or all of the actual survey shot data at a more convenient time. These incomplete survey shots are considered neutral during computations. Survey shots computed from such incomplete survey shots are then part of an incomplete leg. These survey shots are reported in the log produced with the _Shots Errors_ item in the [Cave|] menu. Survey shots are said to be *Orphan* when there is no "path" between their stations and other computed stations. In order to be able to compute these survey shots and display the related cave legs in the cave map (albeit at an arbitrary location), the computation algorithm arbitrarily sets their start station to be at position 0,0,0. Survey shots computed from such orphan survey shots are then part of an orphan leg. Such orphan survey shots are reported in the log produced with the _Shots Errors_ item in the [Cave|] menu.

  • Survey sessions* are actual time periods during which survey shots are taken. The time period is up to the user (a day, a caving trip, an expedition or a whole cave survey.) Each survey session has a given instruments calibration and units choice. Each shot belongs to a session. A survey session can cover several series. Not every shot in a given series needs to be associated with the same survey session. Even with same instruments, sessions can be used to differentiate survey teams or periods of different magnetic declination over time.

An Auriga caves must have at least one session. A session numbered 1 is automatically created with default settings and calibration when the first survey shot is input. Using different Auriga sessions for actual different survey sessions is convenient should instrument calibration or team precision differences later be discovered: modifying the instruments calibration for that given session could fix the interpretation of all survey shot data input during that session. Sessions are transparent to the cave survey desktop software used: if the target desktop software does not recognize sessions, or a subset of session settings, the Auriga conduit simply applies the instruments calibration or subset of it to every shot and passes corrected data to the desktop software. (Not fully implemented yet.) The *active session* is the session to which new survey shots are to be added. It is set with the [Session|] menu in the [Session|] form. The *current session* is the session to which belongs the current survey shot. Auriga keeps cave survey data in Palm OS *Databases* ("PDB" in the Palm OS vocabulary). Each cave has its own database, named with the name of the cave (up to 26 character) completed with the "\_Cave" suffix. Each cave is complete in itself, containing its settings, survey shots and sessions. Survey shots are automatically kept sorted in caves in increasing alphanumeric order of start and end stations; this is the order one can observe using the navigation arrows in the [Survey Shot|] and the [Map|] forms.

h3.Customizing Auriga Auriga is extremely customizable; some people would say "too much", but no one would be willing to drop one's preferred options for the sake of reducing their overall number. Nonetheless, much effort takes place to keep things coherent and understandable. Here's a trick to help you find your way among these many options:

  1. If an option is relevant to the whole of Auriga (sound, backlight use, Topofil behavior, keypad preferences, Assistant, general display features or the measuring device connected to the Palm, etc.), it belongs to the Auriga [Preferences|] form
  2. If an option is specific to a cave (display units, target, datum, station names format, geography\-related data, grid, vertical factor, etc.), it belongs to the [Cave Details|] form
  3. If an option is specific to a survey session (choice of instruments, instruments units or calibration, handling of backsights, etc.) it belongs to the [Session|] form

h3.Series vs Sessions As of version 0.16, Auriga offers sessions the same passage\-related setting as with series. Sessions can thus be used to view a given set of survey shots as representing a cave passage and to act selectively upon these passages (map draw color, sum to/exclude from cave development or show/hide in the map). So, why bother with series if sessions can do the same' Because, in my opinion, series were made just for that, while sessions rather correspond to a given time period when a given team of surveyors used a given set of instruments with a given calibration to survey a cave, or part of it, but not necessarily only a single passage. In other words, sessions relate to the survey process (team and instruments), while series relate to the physical arrangement of cave locations (survey stations). Thus, hijacking the concept of sessions to make it correspond to cave passages requires to create or duplicate a session every time surveyors hit a new passage they could later wish to manipulate selectively. It is cumbersome, and also risky: if you later discover you had an instrument problem that day, you would have to find all relevant sessions to fix the instrument calibration for each of them. To sum up, sessions relate to the survey process (team and instruments) while series relate to the physical arrangement of the cave, the object of cave surveying. Hence my recommendation to use both series and sessions, each for its distinct purpose. But the choice remains yours, Auriga clearly lets you do it your way.

h3.Coordinates Survey stations are computed into Cartesian coordinates, where:

  1. X is the horizontal axis (West\-East); positive X values are located East of the origin; negative values West of the origin
  2. Y is the vertical axis (South\-North); positive Y values are located North of the origin; negative values South of the origin
  3. Z is the depth axis; positive Z values are located above the origin; negative values below the origin
  4. C is the cumulative distance (normally drawn along the X\-axis) and is used in combination with the Z\-axis to draw Extended Extended Profiles.

h3.Data input In every form where data can be input, it is possible to pop up the [Auriga custom keypad|] with the *1\-2\-3* or *a\-b\-c* buttons in the Graffiti area (depending on field type.) If a field contains invalid data, upon tapping on the *OK* or *Save* button, the insertion point is moved to the invalid field, its contents, if any, is selected, and a beep sound is played.

h3.The Input Assistant The input _Assistant_ is an operation mode designed to ease data input by automating repetitive tasks involved with inputting survey shots. The _Assistant_ can automatically:

  1. create a new blank survey shot every time a new survey shot is saved, applying proper auto\-incrementation to current station names
  2. pop up the [Auriga custom keypad|]
  3. display the cave map
  4. turn off the device after a new survey shot is saved
  5. handle the device backlight

While the _Assistant_ options can be set in the [Assistant|] tab of the [Preferences|] form, the _Assistant_ mode is started/stopped in the [Survey Shot|] form. Under _Assistant_ control, the behavior of the device hardware buttons is altered (see tables at the end of this manual), again to concentrate on the task of inputting survey shots. To prevent mishaps, leaving the _Assistant_ mode must be explicitly confirmed.

h3.Launching Auriga When Auriga is launched, the 4 hardware buttons on the front of the device (or 2 on the Palm Zire) usually assigned to the built\-in organizer applications are automatically reassigned to Auriga. This prevents accidentally exiting Auriga while letting Auriga use these buttons to ease survey shot navigation, map handling, data input, etc. After the device is turned off, either manually or automatically, hitting any hardware button wakes up Auriga, left in its previous state; the same result is obtained if the power button is depressed. Thus, the proper way to leave Auriga is to hit the *Home* button in the Graffiti silkscreen area. Upon exiting Auriga, hardware buttons are restored to their previous assignment (Agenda, Addresses, etc.) If Auriga is not exited properly (i.e. after a crash or device reset), hardware buttons remain assigned to Auriga. Simply re\-launching and exiting Auriga restores the buttons to their previous assignment. Conversely, when tapping the *Calculator* button in the Graffiti silkscreen area (a *star* button on some Palm devices), this button gets temporarily reassigned to Auriga so as to allow a quick return from the calculator back into Auriga by simply tapping this button again. This button gets reassigned to its previous state when returning to Auriga. When Auriga is launched, it re\-opens the cave and the form it was left in when last exited. If the *PageUp* button is held down while the Auriga icon is tapped, an alert offers to start Auriga without opening the previously open cave, or to reset of all Auriga preferences is also offered; note that this does not affect cave\-specific settings.

h3.Coordinates computation Station coordinates are automatically computed when necessary. The following actions trigger this automatic computation process:

  1. Displaying the [Map|]
  2. Displaying the _Stations_ or _Graph_ views in the [List|] form
  3. Selecting the _Statistics_, _Shot Errors_ or _Closure Errors_ items of the [Cave|] menu

The computation process can also be triggered manually by selecting the _Re\-compute Coordinates_ of the [Map|] or [List|] menus. If coordinates are already computed, saving a survey shot causes its coordinates to be incrementally computed; this is faster than re\-computing the whole cave. Deleting and, in some case, modifying an existing survey shot requires a full re\-computation, this is done automatically if the _Compute Shots on Save_ is selected in the [Map|] tab of the [Preferences|] form. If the new survey shot closes a loop, an alert reports the closure error. If saving a survey shot connects an orphan leg to the rest of the cave, an alert is displayed.

h3.Passage dimensions Auriga interprets passage dimensions (left, right, up and down) as being taken perpendicular to survey shots. Passage dimensions are associated to survey stations, and each station can only have a single set of passage dimensions. When station coordinates are computed, even if several survey shots provide passage dimensions for the same station, only the first set of passage dimensions found while computing survey shots is kept for a given station in the cave graph for map display purposes (but the input data remains untouched).

h3.Cave diving data Survey shots taken while cave diving differ from other survey shots in their use of a depthmeter as the instrument for slopes. When taking cave diving data, the associated session must thus use a depthmeter. If a dive survey shot connects to a non\-dive survey shot, it is assumed that the start station is at depth = 0 (feet or meters). For clarity to humans reading the data, it is suggested (but not required) that a zero\-length shot be used to mark the beginning of a dive leg at depth 0. This zero\-length shot can be a normal shot with length = 0 or, even better, a virtual ("=") shot or a series beginning (when series are used). With virtual shots or series beginning, it is also possible to input an arbitrary depth (other than 0) with a position of type _Depth (diving)_. Note that all underwater shots should have a negative value for depth. If a positive depth is provided, Auriga understands that the station is sitting above the water surface. Positive depths can therefore be used for short sections above water between two sumps (assuming of course that one has the ability to accurately measure the distance above water and that the surface of both sumps is at the same height.)

  • Notes regarding cave diving survey data:*
  1. Depthmeter readings entered as foresight or backsight slopes are always assumed to correspond to the end station of a survey shot, regardless of the state of the _Direct_ checkbox for the slope data in the [Survey Shot|] form.
  2. The backsight slope is not displayed (see the [Shots|] tab of the [Session|] form) if the slope instrument for one set is a depthmeter while the other set is not a depthmeter (but if two depthmeters are used, even with different units, the expected depth for the second instrument can be displayed, taking into account both instrument calibrations). The expected backsight slope is not displayed if both depthmeters are the same (see the _Instrument Set #2=#1_ checkbox in the [Instruments|] tab (set #2) of the [Session|] form) because this would only repeat the entered value.
  3. The projected length of the survey shot is not displayed if the slope instrument for set 1 is a depthmeter.

h2.Auriga forms

h3.The Main form

The Main form is Auriga's default entry point. The view drop\-down list in the title bar allows switching between a view of caves or networks present on the device. The list displays the name of caves/networks present on the device. Read\-only caves or networks (see the [Cave Details|] form) appear with a *padlock* icon next to their name. Tapping a list entry selects it. Tapping again on a selected cave opens the cave and leads to the [Survey shot|] form, showing a survey shot, if any. Tapping again on a selected network opens the network and leads to the [Network Details|].

  • Note:* Auriga memorizes its previous state and automatically skips the _Main_ form to go directly to the active form and current shot when Auriga was last exited. Holding the PageUp hardware key while starting Auriga opens the Main form (forgetting the previously open cave/network and active form).

Icons allow to:

  1. Create a *New* cave/network (leads to the [Cave Details|] or [Network Details|] form)
  2. *Delete* the selected cave/network
  3. Display the [Survey Shot|] form with a survey shot from the selected cave
  4. Display the selected cave/network [Map|]
  5. Display the [List|] form for the selected cave
  6. *View/Edit* the note associated with the selected cave/network
  • Note:* Holding down the Map or List buttons pops up a list of available views prior to opening the corresponding form.

The *EN* selector allows to toggle the language under which Auriga operates (Auriga is available in French, English and Spanish). This option requires to load on the device the proper supplementary *Auriga\_rsrc.prc* resource files (where is the language abbreviation.) Toggling the language restarts Auriga. This setting is retained for subsequent Auriga start\-ups. *Note:* The version of the resource file must match that of Auriga to be usable; otherwise Auriga falls back to the native language of its PRC file.

  • Up/Down* scroll buttons scroll the cave list by one page.

Entering text in the *Lookup* field moves the list selection the first cave/network with its name starting with this text (characters other than alphanumeric are skipped.) The field can be scrolled horizontally using the hardware buttons located on either side of the Up/Down scroll buttons. Menus: [Cave|] or [Network|], [Edit|] and [Options|].

h3.The Preferences form Preferences set in this form are global to Auriga and used throughout all caves. This form has 4 tabs, selected with pushbuttons in the title bar.

h4.The General tab

Select the *Sound* level for Auriga warnings and errors (used when no other visual clue is given to the user.) This sound level overrides the system sound level set in the built\-in Prefs application. Select the *Backlight* checkbox so that Auriga automatically turns on the backlight (if not already on) when launched. Select the desired *type of data save* behavior:

  1. _Manual Shot/Session Save_ requires a manual save of modified survey shot or session data before leaving the window or the current shot/session, otherwise it is lost; this is the least safe option.
  2. _Warn if Data Save Needed_ warns the user when unsaved data is about to be overwritten or abandoned
  3. _Automatic Shot/Session Save_ automatically saves modified survey shot or session data when needed; this is a convenient choice when inputting new cave data.
  4. _Automatic Save\+Overwrite_ automatically saves modified survey shot or session data when needed and automatically updates existing survey shots when modified; this is a convenient choice when reviewing existing cave data.

Select the calculator thats gets launched when tapping the *Calculator* button (or *Star* on some Palm Zire devices) in the Graffiti area while Auriga is active. Tapping this button again while using the calculator returns to Auriga. Select the *Enable Global Find* checkbox so that Auriga searches the cave notes, survey shot names and notes, session names and notes and network notes in all its caves and networks when the Palm OS Global Find is launched outside of Auriga. If the Palm OS Global Find is launched within Auriga while a cave is open, the search only takes place in the current cave or network.

  • Note:* Global Find is always enabled when launched while Auriga is running.

If measuring lengths with a Topofil, select the *Continuous Topofil* checkbox to have Auriga automatically initialize the start Topofil reading of a survey shot with the end Topofil reading of the previous shot. This reading can be overridden for each individual survey shot Select the *Show Projected Length* checkbox to display in the [Survey Shot|] form the net shot length projected over horizontal ground (useful for sketching.) Select the *Notes Keyboard* to use when editing notes. If the Palm OS keyboard is selected, it opens within the [Auriga custom keypad|]. If _None_ is selected, when field navigation reaches a note field, the [Auriga custom keypad|] closes automatically. Select the *Toggle keyboards*, i.e. the Auriga keyboard layouts that stay on for a single character (with a subsequent automatic return to the alphabetic layout.) See the [Auriga custom keypad|]. Select the input order of numeric fields of the survey shot. This determines the order in which fields are navigated with the PageUp/Down buttons or Up/Down arrows in the [Survey Shot|] form or the [Auriga Keypad|].

  1. *Length (including Topofil) \+ Angles (Azimuth and Slope) \+ Dimensions Left, Right, Up, Down*
  2. *Length (including Topofil) \+ Angles (Azimuth and Slope) \+ Dimensions Up, Down, Left, Right*
  3. *Length (including Topofil) \+ Dimensions Left, Right, Up, Down \+ Angles (Azimuth and Slope)*
  4. *Length (including Topofil) \+ Dimensions Up, Down, Left, Right \+ Angles (Azimuth and Slope)*

Select the *Auto Decimal Lengths* checkbox to let Auriga complete length data (including passage dimensions) when the decimal sign is skipped during input (whether in Graffiti or through the [Auriga custom keypad|].) The data is then interpreted in hundredths of length unit: 7 becomes 0.07 70 becomes 0.70 700 becomes 7.00 Select the *Auto LRUD* (Dimensions) checkbox to let Auriga complete missing passage dimensions (Left, Right, Up, Down) upon saving the survey shot when the opposite dimension has been input (e.g. insert 0.00 in Left dimension if a Right dimension is provided, or vice versa, and conversely for Up/Down dimensions.) This can be convenient when survey stations tend to be located on cave walls. Select the appearance of the numeric layout of the top row of the [Auriga custom keypad|] with the *123* or *789* pushbuttons.

h4.The Assistant tab

The _Assistant_ provides an automated input mode while surveying a cave (see the [Assistant|] section and the [Survey Shot|] form.) The Assistant tab is used to configure the behavior of the input _Assistant_. The _Assistant_ itself is started by selecting the *Assistant* pushbutton in the [Survey Shot|] form. Select the *Auto Popup Auriga Keypad* checkbox to automatically display the Auriga custom keypad when inputting a new survey shot. Select the *Use Passage Size Fields* checkbox to make the Auriga keypad navigate into the passage size fields of the [Survey Shot|] form. when writing an up/down Graffiti symbol, scrolling with the *Up/Down* scroll buttons or using *Arrow* buttons. *Note:* If the current session makes passage sizes mandatory (see the [Shots|] tab of the [Session|] form), passage size fields are always navigated into. Select the automatic _Assistant_ behavior *After Saving a Survey Shot*:

  1. *No special action*
  2. *Create New Survey Shot* creates a new empty survey shot with auto\-incrementation applied to the survey stations of the save survey shot
  3. *Create New Shot; Power Off* same as option above, with device powering itself off
  4. *Show Map* computes the new survey shot and displays the Map
  5. *Map; New Shot\->Power off* computes the new survey shot and displays the Map; upon returning, creating a new empty survey shot also powers off the device
  • Note:* A new survey shot is automatically created only if the saved survey shot was itself new. Saving a modified existing survey shot does not automatically create a new survey shot.

Select the *Keep Backlight On* checkbox to automatically activate the backlight while in _Assistant_ mode (only available on monochrome devices.) This option differs from the one in the [General|] tab as it only applies to the _Assistant_.

h4.The Map tab

Select the *Full Screen Cave Map* checkbox to use the full screen height to draw the cave map. Controls at the bottom of the [Map|] form can then be show/hidden by tapping in the Graffiti area as they overlap the cave map. Survey shot coordinates are incrementally computed every time a survey shot is saved, if other survey shots are already computed. This is faster than re\-computing the whole cave, but only works with new survey shots. Modifying or deleting an existing survey shot may require a total computation. Selecting the *Compute Shot on Save* checkbox allows Auriga to perform coordinates computations even if this requires a full re\-computation of the cave. Select the *Grid*, *Default Trace*, *Current Shot* and *Walls* colors. Select the *Black Background* checkbox to display the map against a black background.

  • Note:* Color\-related options are only available on devices with halftones of color.

Indicate the *Paper Grid Size* in the notebook where sketching is to take place (i.e. the actual physical size of printed squares; ex. 1 mm) as well as the number of *Decimals* used to display coordinates in the [Sketch to Scale|] form.

h4.The Link tab

The _Link_ tab allows configuring an electronic measuring device connected to Auriga. Select the *Device* connected to Auriga. If no device is selected, the rest of the form is blank. Auriga currently support any NMEA\-capable GPS (i.e. most GPSes) as well as a [Disto|http://auriga.neopages.org/www.leica-geosystems.com/cpd/], the [Revolution|http://www.tntc.com/Products/revolution.htm] electronic compass/clinometer module from [True North Technology|http://www.tntc.com/] or the Toposcan prototype. Depending on the selected device, some form options may be locked or hidden if irrelevant. If the *Link* type is _RS\-232 (serial)_, select the *Baud* rate to match that of the connected device. In order to connect a serial device via the HotSync cable, a null\-modem adapter is usually required betwwen this cable and the one supplied with the device (2\-3, 3\-2, 5\-5 on a 9\-pin connector.)

  • Note:* All Palm OS USB device connectors, with the Palm Zire and Tungsten E as the only (') exception, feature both USB and serial pins. It is thus possible to buy or assemble a serial cable for a USB device.

After a first connection was established with a Bluetooth device, a *Bluetooth* button allows to know its device id and to clear it to provoque a new device discovery (necessary when using another device of the same type.) Select the *Data Use Mode*:

  1. *Input Survey Data* fills the relevant [Survey Shot|] form input fields with the received data
  2. *Input Survey Data \+ Dimensions* fills the relevant [Survey Shot|] form input fields (including passage dimensions) with the received data. This option only applies to devices allowing the measurement of length data and requires five consecutive data measurements (one for the survey shot length, four for passage dimensions)
  3. *Input GPS Position* fills the relevant [Survey Shot|] form position input fields with the received GPS location
  4. *Display/Track Acquired Data* displays the received data. In the [Survey Shot|] form, survey data or GPS locations are displayed in a popup form.

\[not implemented\] In the [Map|] form, the current GPS location is marked with a cross\-line (\+). The _Input GPS Position_ option can only be selected if the connected device is a GPS. Conversely, options _Input Survey Data_ and _Input Survey Data \+ Dimensions_ can only be selected if the connected device is a TNT Revolution module. With the first three data modes, if the survey shot currently displayed already exists when data is received, an alert asks whether to create a new survey shot or to replace the data of the existing one. If the current survey shot is incompatible with the type of received data (ex. a virtual survey shot vs azimuth data), an alert asks whether to create a new survey shot or to adapt the existing survey shot to the type of data received.

  • Note:* The received survey data can only be copied into relevant input fields of the [Survey Shot|] form if the connect device corresponds to the measurement instrument selected for these fields in the [Session|] form.

In _Display/Track Received Data_ mode, Auriga can operate in a *Cyclical Measurement* mode, fetching data in a *Continuous* manner (as fast as it can) or repeatedly after a user\-selectable time period varying between 5 and 900 seconds (15 minutes). The *Suspend Auto\-Off* checkbox may be selected to suspend the Palm OS auto\-off timer that would otherwise halt data reception. When a device is selected, the *Dimensions* icon (4 arrows) in the center of the [Survey Shot|] form is replaced by an *Connect* pushbutton This pushbutton is used to toggle the data link. The device beeps every time new data is received. Holding down this pushbutton pops up a list of possible actions:

  1. *Continue sequence* measures the next field in the measurement sequence
  2. *Repeat Last Input* repeats the measure of the previous field in the measurement sequence
  3. *Stop Sequence* stops the measurement sequence
  4. *Restart at Current Field* restarts the measurement sequence at the current field (where the cursor is)

If the device needs to be prompted for data (currently only the TNT Revolution module works that way), a *2\-step* process can be selected; this allows to pause between the link connection and the actual data measurement. The pause is interrupted when tapping again on the *Connect* pushbutton. It is also possible to select a *Delay* between the connection and the actual data measurement. In this case, the device beeps one second before the measurement takes place. Select the *Auto Create New Shot* checkbox to automatically create a new survey shot when data is received while an existing survey shot is displayed. Select the *Auto Detect Retries* checkbox to automatically detect that a measurement has been repeated when the measured azimuth is within ±45° of the previous one. In this case, an alert asks whether to replace the data in the _Survey Shot_ form by the new measurement. This option is only available with the Toposcan. Select the *Accept Retries* checkbox to automatically accept the data of a repeated measurement when it is detected (see previous checkbox.) This option is only available with the Disto and the Toposcan. Select the *Auto Detect Sequence* checkbox to automatically detect that passage dimension fields are skipped during the measurement sequence. This can be convenient when survey stations tend to be located against cave walls.

h5.Connecting a GPS Select the *Format* used to display or store the received location. Until geodesic conversions are implemented, only latitude\-longitude formats are supported. Make sure the data communication protocol is set to NMEA on the GPS side (many units default to proprietary protocols). The NMEA protocol standardizes the baud rate at 4800. Select the *Link* type used to connect to the GPS, either _Serial_ (RS\-232), _Bluetooth_ or _Internal_ if Auriga is running on a Garmin iQue Palm OS PDA (featuring an internal GPS.) The current time on a device running Palm OS 4.0 or better can be synchronized with the GPS time by selecting the *Sync Device with GPS Time*. This operation is performed only once after the connection is established. This option is not offered with the Garmin iQue, where the device already performs this operation automatically. The altitude unit is set by the current session; the GPS always transmits in meters, possibly causing an automatic conversion in Auriga. When using GPS data to fill survey shots, select the *Use GPS Altitude* checkbox to fill the altitude field with the altitude data reported by the GPS (if available).

h5.Connecting a TNT Revolution module When received azimuth/slope data from the TNT Revolution module, the azimuth and slope units in the current session may be selected among degrees, grads or %; the module must be set to report degrees (default selection), possibly causing an automatic conversion in Auriga.

h5.Connecting a Disto If the _Input Survey Data \+ Dimensions_ mode is selected, an input order where passage dimensions immediately follow the length data should be selected in the [General|] tab, so as to perform all Disto measurements in a row, followed by angular measurements. It is advisable to let Auriga automatically move from field to field every time new data is received. Otherwise (i.e. if the _Manual Sequence_ checkbox is selected), it is necessary to manually move the insertion point from field to field (ex. with the PageDown button.) In manual sequence mode, if a measurement is repeated for a non\-empty field, if the _Accept Retries_ checkbox is selected, the previous data is silently overwritten, otherwise an alert pops up. Note that even in automatic sequence mode, it is always possible to move the insertion point backwards to repeat a measurement, or forward to skip a measurement (e.g. when the survey station is against a wall, this zero\-length measurement can be skipped \- it it then advisable to have the _Auto LRUD_ checkbox selected in the [General|] tab so as to let Auriga automatically fill the skipped field with 0.00). When the *2nd* button is hit on the Disto A6, 8 buttons can now transmit an arrow character:

  1. the 4 *corner* arrows write an 'X' (unknown) in the current passage dimension field of the [Survey Shot|] form
  2. the *Up* arrow moves the cursor to the previous length or passage dimension field of the [Survey Shot|] form
  3. the *Down* arrow moves the cursor to the next passage dimension field of the [Survey Shot|] form. If the skipped field is a passage dimension field, 0.0 is written

h3.The Cave Details form This form displays information on a cave, either existing or being created. This form has 4 tabs, selected with the pushbuttons in the title bar.

h4.The Cave tab

The *Name* of the cave can be any string of 26 characters or less and may include spaces. This corresponds to the name of the Auriga cave PDB on the Palm OS device (with a 5\-character suffix to distinguish it between PDB types.) Editing the name of an existing cave actually renames it (an alert is issued before proceeding.) The *Category* selector allows selecting the cave category. Categories are edited in the usual Palm OS way by selecting the _Edit categories..._ list item. If you do not intend to modify the cave data and wish to prevent accidental modifications, select the *Read\-only* checkbox (implicitly prevents adding survey shots.) A new cave cannot be set as read\-only.

  • Note:* In read\-only mode, survey data (survey shots or sessions) or details that could affect computations cannot be modified. Nonetheless, details that determine the cave map presentation can still be modified.

Select the *Public* checkbox to store the synchronized cave in the public Palm Desktop directory on the desktop computer (as opposed to the user directory.) Select measurement units to be used for computing coordinates:

  1. *Lengths* unit (_meters_ or _feet_)
  2. *Angles* unit (_degrees_ or _grads_) for azimuths and projection angle
  3. *Slopes* unit (_degrees_, _grads_ or _%_)
  4. *Slope 0* setting (_up_, _level_ or _down_)
  • Note:* Measurements units selected in this form are used throughout Auriga to report coordinates, lengths and angles between stations and statistics.

Select the *Target* desktop software this cave is going to be synchronized with and indicate the *version* number. This information is used to suggest usage in survey management or to enforce rules dictated by the target desktop software constraints. If no desktop software syncing is to take place (other than a backup with the HotSync Manager), select *None* to ensure proper internal handling of deleted records. Select the format to be used to display *Positions* in the cave map (_XYZ_ (relative to the origin station), _UTM_, _d°m's"_ or _d°m.m'_.) If latitude/longitude or UTM geographical positions are to be input, select the proper topographical *Datum* to use for conversions. Tap the *Note* button to edit the cave note. 255 characters are permitted.

h4.The Stations tab

Select the appropriate name format pushbutton: *4.4* or *8* characters. In 4.4 format, the separator (usually a dot) does not count as a character. In 8\-character free format, all characters are counted.

  • Note:* Series support is possible in the 8\-character by actually choosing the 4.4 format with a null separator. It is then necessary to select distinct non\-overlapping character sets for the root (series) and shot number subparts (e.g. "HM12") so that Auriga can discriminate series prefixes. Overlapping character sets require the *Auto Split Series in Name* option below.

Select the character set allowed for the left and right subparts of station names and the separator used between station name subparts (if 4.4 format is selected.) Select whether punctuation characters are allowed for the right subpart of station names. Supported characters are:

  • .,;:\-\+/=!@$%'&\*()<>\[\]\{\}\|\~'\*

Select the *Auto Split Series in Name* to automatically split 4.4 station names into series and station number upon the first leftmost change in character type (digit\->letter or vice\-versa). Each resulting subpart remains limited to 4 characters in length. Select *Use Alpha Keypad* checkbox to launch the alphabetic layout of the Auriga keypad to edit station names.

  • Note:* Alphabetic characters can also be input with Graffiti strokes.

Select the *Enforced Series Beginnings* checkbox to indicate that series beginnings can only use the allowed start station number among "0", "1", "A" or "a". Otherwise, series beginnings can be any first survey shot of the series. Select the *Shot Navigation Mode* with navigation arrows in the [Survey Shot|] and [Map|] forms. Choices are:

  1. *Go to the next or previous series beginning* (default if the 4.4 format is selected)
  2. *Go to Next Series* (determined by a station naming change in the left subpart of the station name if the 4.4 format is selected)
  3. *Go to Next Session*
  4. *Move by n shots*, where n is user\-chosen value between 1 and 255
  • Note:* If series are not allowed, that is, the naming scheme is not 4.4, the only available behavior is to *Move by n shots*

Select the *Auto\-incrementation* mode for station names when creating new survey shots. Options are:

  1. *None* (station fields are left blank)
  2. *Repeat Shot* stations (and let user edit them manually)
  3. *Add one* to previous start station (start station is set as the end station of the previous shot and the end station is incremented by 1; this works with both numbers and letters)
  4. *Leap Frog*; if the previous shot is "forward" (start station < end station), then the new start station is set to the previous end station \+ 1 and the new end station is set to the previous end station. If the previous shot is "backward", then the new start station is the same as the previous shot's start station, and the end station is the start station \+ 1.

Example: 1.2\->1.1, 1.2\->1.3, 1.4\->1.3, 1.4\->1.5, 1.6\->1.5, 1.6\->1.7

  • Note :* Auto\-incrementation can be performed equally on digits or letters, but if the rightmost character is a digit, only digits get incremented, or vice\-versa with letters (where case is sensitive). Eventually, characters may be added by the auto\-incrementation process. If series are enabled, only the station number within the series is incremented.

Examples:

ANA99y increments to ABA99z, which increments to ANA99aa ANA999 increments to ANA1000, but ANA99999 fails (8\-character limit) ANA.999 increments to ANA.1000, but ANA.9999 fails (series limit reached)

h4.The Computations tab

Select the *Sessions override Series* checkbox so that _Draw in Map_ and _Sum to cave length_ session attributes override those of series. Input the cave map *Scale* used to compute coordinates reported in the [Sketch to Scale|] form; for example:

1 cm = 1 m corresponds to a scale of 1:100 1 inch = 20 feet corresponds to a scale of 1:240 (there are 12 inches in a foot)

  • Note:* This scale does not affect coordinates reported in the [List|] or [Map|] forms.

Input the *Maximum Loop Error* that triggers the station XYZ position error detection algorithm. Select the *Save XYZC Computations* checkbox to retain computed coordinates when closing the cave, thus making map display faster when re\-opening the cave (at the price of accrued storage requirements.) \[not implemented\] Select the *Loop Close* mode (_Never_, _On demand_ or _Always_) to determine when the loop closure is to be applied. Selecting _Always_ applies the loop closure algorithm every time coordinates are computed. If this feature is never going to be used, select _None_ to quicken coordinates computations. Input the *Magnetic Deviation* that is going to be applied to survey shots that belong to session that does not hold a magnetic deviation. A westward magnetic deviation must be set as negative; an eastward deviation as positive. Select the *Geo\-Reference* station of the cave, that is the station whose geographic location is to be used to compute other locations. If this field is left blank, or if the selected station does not have a geographic location, the coordinates computation algorithm uses the start station of the first series beginning with a geographic location as the geographic reference station. Select the *Origin* station of the cave as well as its XYZ coordinates (0,0,0 by default), expressed in map units. If this field is left blank, the coordinates computation algorithm uses the first station of the cave as the origin station, and assumes a 0,0,0 initial position.

h4.The Map tab

Select the cave\-specific map *Grid* value. See the [Map|] tab of the [Preferences|] form for general grid preferences (that apply to all caves). Select the *Automatic Grid Resize* checkbox so that the map grid gets resized when it cannot be displayed within the user\-defined minimum and maximum number of lines. The grid value is then multiplied or divided by 2 and rounded to the lowest integer. Otherwise, the grid is hidden. Select the *Wall Color same as Shot* checkbox so walls and dimensions are drawn in the map using the color of their corresponding survey shot. Otherwise, they are drawn using the default color selected in the [Map|] tab of the [Preferences|] form. Select the default direction to *Develop* survey shots in the extended profile view with the *Left* or *Right* pushbuttons. Select the *Vertical* factor used in profile maps and coordinate computations to exaggerate the verticality of the cave for display purposes. A factor less than 1 (ex. 0.5) actually flattens out a vertical cave. This factor is applied to coordinates reported in the [List|] form for drawing, but coordinates reported in the [Map|] form are not affected. Menus: [Edit|] and [Defaults|].

h3.The Survey Shot form This form is used to input and display survey shot data. It can be used in a manual mode or automated input with the help of an _Assistant_. The _Assistant_ makes input easier and faster by automatically and optionally:

  1. popping up a smart keypad allowing to input digits without the help of the stylus
  2. creating a new empty shot when the current one is saved
  3. performing a smart incrementation of station numbers
  4. preventing accidental escapes from the input mode

The _Assistant_ can be toggled on/off with the *Assistant* pushbutton in the form title bar (upper right corner.) 3 types of survey shots can be input with this form, which self\-adapts by hiding or showing different user interface controls (checkboxes, pushbuttons or drop\-down lists) depending on that type:

  1. [Regular survey shots|], with actual survey data (length, azimuth and slope) between two stations
  2. [Series beginnings|], linked onto themselves (cave entrance) or to other series, and usually determining the start of a cave leg. Series beginnings have no proper survey data (length, azimuth and slope) but can hold a geographic (UTM or latitude/longitude) or absolute position (XYZ)
  3. +Virtual shots+, where two survey stations are virtually made the same (convenient to close loops)
  • Form features common to all survey shot types*

The *Station IDs* are displayed as "series.number". The topmost station ID is the start station while the bottommost station ID is the end station. The direction that determines the start and end of survey shots is the direction of the surveying process, regardless of whether survey shots use direct or reverse azimuths. Depending on settings configured in the [Station|] tab of the [Cave Details|] form, any first survey shot of a series or only those survey shots with a start station numbered "0", "1", "a" or "A" (ex. 6.0) may be automatically set as series beginnings.

  • Passage sizes* (above, below, left and right of the survey station) can be associated with either the *Start* or the *End* station of the survey shot using the corresponding pushbutton in front of them.
  • Note :* Auriga supports the input of letter 'X' to signal an unknown or undetermined passage dimension, for example when crossing another passage. This is similar to inputting a 'P' (Passage) in Compass.

Select the *Gray halftone* or *Color* this survey shot or survey shots in this series (depending on case) will take in the map (offered only if device permits.) Tapping the *Attributes* icon displays a list of attributes:

  1. *Entrance on Start/End Station (Es/Ee)*: the start/end station is a cave entrance; the [Map|] form can display a 'E' next to these stations
  2. *Permanent Start/End Station (Ps/Pe)*: the start/end station is marked permanently (cairn o other); the [Map|] form can display a 'P' next to these stations
  3. *Lead on Start/End Station (Ls/Le)*: the start/end station has a possible lead; the [Map|] form can display a next to these stations
  4. *Surface Survey Shot (S)*
  5. *Dead Survey Shot (D)*: this survey shot is ignored by computations and map display (similar to 'X' shots of Compass)
  6. *Hide in Map (H)*: hides this individual survey shot from the map
  7. *Flip Development Direction (F)* flips the development direction of this survey shot in the Developed Profile view
  8. *Exclude from development (X)* excludes the length of this survey shot from the total developement of the cave
  9. *Ignore Azimuth (Ia)*: the foresight azimuth of this survey shot is ignored by computations \- selecting this attribute displays the azimuth field with a small font
  10. *Ignore Backsight Azimuth (Ia\-)*: the backsight azimuth of this survey shot is ignored by computations \- selecting this attribute displays the backsight azimuth field with a small font
  11. *Ignore Slope (Is)*: the foresight slope of this survey shot is ignored by computations \- selecting this attribute displays the slope field with a small font
  12. *Ignore Backsight Slope (Is\-)*: the backsight slope of this survey shot is ignored by computations \- selecting this attribute displays the backsight slope field with a small font

Abbreviations in parenthesis are those used in the list of attributs in the _Survey Shots_ view of the [List|] form. The *Attributes* icon is highlighted when at least one setting is set. Parallel or duplicate survey shots that would otherwise exaggerate total cave length can be ignored when computing this length. This can be done at the survey shot level by selecting the _Exclude from Development_ attribute.

  • Note:* If the *Sum Series to Cave Length* checkbox is unselected in the series parameters, the _Exclude from Development_ attribute is ignored for all shots within this series.

Tapping the *Alarm clock* icon displays the date the survey shot was saved. This date should only be modified with caution. The type of survey shot is determined by the following pushbuttons; these determine which form controls must be hidden or shown:

  1. the *Link* pushbutton creates a regular survey shot
  2. the pushbutton creates a virtual shot (station equal to another one)
  3. the *Series* pushbutton creates a series beginning
  • Note:* If series are disabled (i.e. the station names format selected in the [Stations|] tab of the [Cave Details|] form is 8\-character), the *Series* pushbutton does not appear in the form.

Arrow pushbuttons allow to navigate between survey shots within the cave. From left to right, they load:

  1. the first survey shot in the cave
  2. the previous series beginning/beginning of current series *or*
    1. first shot in previous series or cave leg *or*
    2. move backward by a user\-chosen number of shots

depending on settings configured in the [Stations|] tab of the [Cave Details|] form

  1. the previous shot
  2. the next shot
  3. the next series beginning *or*
    1. first shot in next series or cave leg *or*
    2. move forward by a user\-chosen number of shots

depending on settings configured in the [Stations|] tab of the [Cave Details|] form

  1. the last survey shot in the cave

The *Gofer (running man)* button left of these arrows launches the [Survey Shot Search|] form. The *Session Number* selector leads to the [Session|] form, which allows selecting and configuring the current session. The *4 hardware application buttons* mimic navigation arrows (previous series/cave leg, previous shot, next shot and next series/cave leg.) On the Palm Zire, which has only 2 such hardware application buttons, these only mimic the previous shot and next shot arrows. While in _Assistant_ mode:

  1. the second leftmost hardware application button (Address Book, or Date Book on a Palm Zire) pops up the built\-in keyboard or the [Auriga custom keypad|], depending on the field into which the insertion point is blinking
  2. the second rightmost hardware application button (To Do, or Address Book on a Palm Zire) saves the current shot and creates a new shot

The *Up/Down* scroll buttons scroll the insertion point between fields in the form and scroll the note field when the insertion point is in the note field. Icons at the bottom of the form allow (from left to right) to:

  1. save the current shot (this button is only available when the survey shot data has been modified)

If the input data is erroneous, the field in error is highlighted and the save operation is hampered. It is however possible to save an incomplete survey shot by inputting at least the start and end station and leaving one or more field empty. The survey shot is then marked as incomplete and ignored during coordinates computation. This survey shot can be modified later with the complete survey data. This can prove useful when a survey shot is planned but currently impossible to take (required climb, water too high, etc.)

  1. create a new shot

By default, stations of the new survey shot are generated by applying to the last displayed survey shot the auto\-incrementation mode selected in the [Stations|] tab of the [Cave Details|] form. However, holding the stylus on the _New_ button displays a list of auto\-incrementation options:

    1. *Default Auto\-incrementation*
    2. *Radiant shot (from center)* creates a survey shot that keeps the previous start station, but increments the end station; this incrementation mode is useful when surveying a room by taking several survey shots from the center to the walls
    3. *Convergent shot (to center)* creates a survey shot that keeps the previous end station, but increments the start station; this incrementation mode is useful when surveying a room by taking several survey shots from the walls to the center
  • Note:* The survey shot auto\-incrementation can be applied until it is saved.
  1. delete the current shot
  2. load the [Sketch to Scale|] form
  3. display the cave [Map|]

If the cave is already computed and the *Map* icon is held down, a list of zoom options is displayed:

    1. *Previous Zoom* displays the map with the previous zoom ratio and pan factor
    2. *Full Map* displays the entire cave or network map within the size of the screen
    3. *Current Shot* displays the map zoomed on the current survey shot
    4. *Current Shot\+neighbors* displays the map zoomed on the current survey shot and its immediate neighbors
    5. *Current Series or Session* displays the map zoomed on the series or session of the current survey shot. The choice between series or session is determined by the status of the _Sessions Over Series_ checkbox in the [Computations|] pane of the [Cave Details|] form
    6. *Current Cave* displays the network map zoomed on the cave to which belongs the current survey shot
  2. display the [List|] form

If the *List* icon is held down, a list of List views is displayed before displaying the [List|] form

  1. close the cave and return to the [Main|] form
  2. display the note associated with the survey shot (in a full\-screen edit form)
  • Note:* If the _Assistant_ is active, any operation that would close the current cave or load another survey shot is disabled.
  • Note:* When handling a network, the _Assistant_ pushbutton is replaced by an arrow that pops up a list of caves in the network for quick navigation.

h4.Regular survey shots

Enter the survey shot *length*, *azimuth* and *slope*. Select the *Direct* checkboxes if direct azimuth and/or slope are taken (from start station toward end station, as opposed to reverse.) If the option is selected in the [General|] tab of the [Preferences|] form, the projected length is displayed in bold on the right of the length field. This field is updated when the length or slope changes.

  • Note:* When taking Topofil data, selecting the *Length* icon displays the net survey shot length, taking into account Topofil calibration.

Depending on session settings, *backsight azimuth and slope* are ignored, displayed in bold for purpose of self\-validation and/or stored. If option *Show and Store* was selected in the [Shots|] tab of the [Session|] form, the backsight azimuth and slope displayed for self\-validation purposes can be overwritten with actual survey data. The backsight measurement is stored for averaging if it was edited, otherwise it is ignored. When, due to physical constraints, the slope cannot be measured as an angle but as a height above the horizontal baseline that joins start and end stations, you may enter this height (in dimension units, i.e. the measurement unit set for passage dimensions in the [Instruments|] tab (set #2) of the [Session|] form) into the slope field and then hit the *Calculator* silkscreen button to call the [Slope Calculator|] to compute the resulting angular slope. Hitting the *OK* button or the *Calculator* silkscreen button again pastes the computed slope into the slope input field.

h4.Virtual survey shots

If a geographic position is available for this virtual shot, it can be given to that station. First select a position type with the position popup list. UTM positions require an easting, a northing, a gore (1\-60) and a zone (A\-Z) while DMS (degrees, minutes, seconds: ddd°mm'ss.ss") or DM (degrees minutes: ddd°mm.mmm') positions require a latitude and a longitude. These must be entered with a blank or appropriate symbol as separator between degrees, minutes and seconds values. Every position type other than XYZ may be accompanied by an *Altitude* reading ( ).

h4.Series beginnings (cave legs or passages)

Series beginnings act as milestones and are thus not related to a real survey shot. Rather, these are kept in the Auriga cave to store settings that apply to all shots belonging to that series. Toggle the *Details/Position* list to display either series details or start station geographic position. If a position is already input, the _Position_ selector is highlighted. Select whether shots pertaining to this series will be displayed, or not, in the cave map with the *Show Series in Map* checkbox. Indicate with the *Flip Extended Profile* checkbox whether survey shots in this series must be extended in a direction opposite to the cave default in the extended profile view. Select the *Add Series to Cave Length* checkbox to sum the length of survey shots in this series to total cave development (convenient to exclude surface survey data from cave development.) If a geographic position is available for the series beginning, it can be given to that station. First select a position type with the position popup list. UTM positions require an easting, a northing, a gore (1\-60) and a zone (A\-Z) while DMS (degrees, minutes, seconds: ddd°mm'ss.ss") or DM (degrees minutes: ddd°mm.mmm') positions require a latitude and a longitude. These must be entered with a blank or appropriate symbol as separator between degrees, minutes and seconds values. Every position type other than XYZ may be accompanied by an *Altitude* reading ( ). Menus: [Cave|], [Edit|] and [Options|].

h4.The Survey Shot Search form This form is used to find survey shots related to a station.

Edit the station ID field and tap the *OK* button to find related survey shots. Tapping on one of the found shots in the results list of related survey shots loads that survey shot. The *Wildcards* checkbox allows performing a search using wildcards:

  1. *\** substitutes any character string of 0, 1 or more characters
  2. *'* substitutes exactly one character

The *Ignorer Case* checkbox allows performing a search while ignoring lowercase/uppercase or accented letters. Tapping on the button pastes the other station (start or end) of the current survey shot into the station field.

h4.The Slope Calculator

When, due to physical constraints, the slope cannot be measured as an angle but as the height of the triangle which hypotenuse joins start and end stations, you may enter this height (in dimension units, i.e. the measurement unit set for passage dimensions in the [Instruments|] tab (set #2) of the [Session|] form) into the slope field of the [Survey shot|] form or the [Auriga custom keypad|] and then hit the *Calculator* silkscreen button to call this Slope Calculator to compute the resulting angular slope. The *Up* and *Down* pushbuttons can be used to indicate whether the slope heads upwards or downwards. Hitting the *OK* button or the *Calculator* silkscreen button again pastes the computed slope into the slope input field of the calling form. The same works for the secondary slope.

h4.The Sketch to Scale form

The Sketch to Scale form displays the coordinates necessary to report, on paper, the current survey shot and its passage dimensions. The selector at the bottom of the form allow to toggle between *Relative* and *Absolute* coordinates. In relative mode, the form displays:

  1. X, Y, Z and C (extended profile) offset of the survey shot
  2. X, Y segments of left and right passage dimensions relative to the reference station of these dimensions
  3. Z segments of up and down passage dimensions relative to the reference station of these dimensions
  • Note: *An arrow appears next to the reference station for passage dimensions.

In absolute mode, the form displays:

  1. absolute X, Y, Z and C coordinates of the stations of the survey shot (if the cave coordinates are computed, otherwise, are shown)
  2. the length of left, right, up and down passage dimensions segments
  • Note:* Left/right passage sizes may be swapped in order to always correspond to a direct survey shot.
  • Note:* In absolute mode, if the _Ignore Origin_ option is selected with the selector, the origin X, Y, Z and C coordinates are substracted from the station coordinates, thus displaying origin\-relative absolute coordinates.
  • Note:* All numeric data shown takes into account the map scale indicated in the [Computations|] tab of the [Cave Details|] form, as well as the size of the notebook grid indicated in the [Map|] tab of the [Preferences|] form. An overly large map scale or paper grid may lead to very large offsets, overflowing the available display width.

The *Shot* button allows to quickly show raw data of the current survey shot without having to return to the [Survey Shot|] form.

  • Usage*

Sketching to scale in the notebook first requires to position the start and end stations on paper before sketching walls and other features. Prior to Auriga, this was done with a ruler and a protractor:

  1. position the start station; location can be arbitrary
  2. apply the center of the protractor against the start station and mark the edge of the protractor at the angle corresponding to the azimuth of the survey shot (when sketching in top view)
  3. place the start of the ruler on the start station and align it on the azimuth mark
  4. with the ruler, measure the projected length over ground of the survey shot from the start station and position the end station, correctly reducing this length as the slope increases (using a cosine table or a special protractor)
  5. repeat the process with the slope angle to sketch a profile

With the _Sketch to Scale_ form in Auriga, the X and Y offsets represent the number of paper grid squares to count horizontaly and verticaly, respectively, from the start station to position the end station. Positive offsets grow up and right, negative offsets grow down and left. For sketching a profile, use the Z offset for the vertical axis. For sketching a West\-East profile, use the X offset for the horizontal axis. For sketching a South\-North profile, use the Y offset for the horizontal axis. For sketching an extended profile, use the C offset for the horizontal axis. Relative coordinates correspond to the type of work performed with a ruler and protractor. Absolute positionning is best suited when using very large gridded paper or to avoid cumulative sketching mistakes when one station gets misplaced. Note that the _Sketch to Scale_ form opens in the last used mode (Relative or Absolute.)

h3.The Session form

This form is used to manage survey sessions and to select the current session. This form has three tabs, selected with pushbuttons in the title bar. Existing survey session numbers can be cycled through with the *Up/Down arrow* pushbuttons. A session numbered 1, initialized with default instrument calibration and units, is automatically added when creating a new cave. If the displayed session is the active session, an *Asterisk* is displayed on the left of the session number. A 31\-character name can be given to the session. The *Date* shown is that of the creation of the session. It is optionally updated when the first survey shot is taken during this session. Tapping on the date selector allows to change it. The *Done* button exits the _Session_ form. If the _Session_ form was launched with the _Session number_ selector in the [Survey Shot|] form, changing the session associated to the current survey shot must be confirmed. Calling the [Session|] form with the _Sessions_ item in the [Cave|] menu does not affect the session number to which the current survey shot (if any) is associated. The *Save* button saves the current session. The *New* button creates a new session, initialized with default data and numbered with the next available session number. It is possible to create a session from an existing session by merely editing the session number and saving this new session (provided the new session does not already exist.) The *Note* button allows linking a note to the session (name of surveyors, details of instruments used, etc..) 255 characters are permitted.

  • Note:* All tabs are then refreshed or saved as defaults.

Several session calibrations may be edited sequentially by saving modifications before selecting another session number.

h4.The Instruments tabs

These tabs allow to select instruments and set their calibration values. Select instruments used for surveying (*Tape* vs *Topofil*, *Compass* vs *Theodolite*, *Clinometer* vs *Theodolite*, *Altimeter* or *Depthmeter*.) The handling of angular instruments other than compass and clinometer is not implemented yet. When selecting a Topofil, also select the *number of digits* on its counter. Repeatedly tapping on the selector next to the _Topofil_ instrument cycles though possible choices (3 to 6, default is 5). Select *Lengths*, *Azimuths* and *Slopes* units.

  • Note:* Auriga supports the following angular units and universal notations:
  1. *d°m's"*: degrees in base 360 written in sexagesimal format with seconds (ex. 20°30'17" means 20 degrees, 30 minutes and 17 seconds)
  2. *d°m.m'*: degrees in base 360 written in sexagesimal format without seconds (ex. 20°30.4' means 20 degrees, 30 minutes and 4 tenths of minuto)
  3. *degrees*: degrees in base 360 written in decimal format (ex. 20.8 means 20 degrees and 8 tenths of degree)
  4. *grads*: grads in base 400 writtent in decimal format (ex. 370.4 means 370 grads and 4 tenths of grad, in base 400)

For convenience, with unit *d°m's"* and *d°m.m'*, Auriga allows to input a space instead of of the °, ' o " symbols. Furthermore, it is posible to input a decimal value even if the selected unit format is sexagesimal (ex. 20.5, equivalent to 20°30'). However, when showing the input value, Auriga uses the selected unit format, and the appropriate symbols, if any. Select the proper orientation for *Slope angle 0* (_Up_, _Down_ or _Level_.) Select the *Shift* or *Precision* pushbuttons to toggle between shift and precision input. *Length*, *Azimuth* and *Slope shifts* will be added to surveyed values to obtain the correct value.

  • Note:* In case of a Topofil, the shift is taken as a multiplying factor applied to the measurement to obtain exact data.

\[not implemented\] *Length*, *Azimuth* and *Slope precisions* are used to redistribute errors when performing loop closure. Azimuths taken with a *Compass* are relative to the North (magnetic or geographic, depending on whether a magnetic deviation was input.) \[not implemented\] Azimuths taken with a *Theodolite* are absolute angles relative to the previous survey shot. Auriga simultaneously supports 2 instrument set calibrations, numbered 1 and 2. Instrument set 1 is used for primary shots (regardless of their direction), while set 2 is used for backsights. Respective calibrations can be reached by selecting either the *Set 1* or the *Set 2* tab pushbutton. If only one instrument set is actually used for both direct and backsight azimuths or slopes, as is often the case, select the appropriate *Instrument Set #1 = #2* checkbox in the secondary instrument set calibration. By default, only one instrument set is assumed. Length measurements are associated with instruments set 1, while passage dimensions are associated with instruments set 2.

  • Note:* When a Topofil is used for lengths in instruments set 1, Auriga assumes dimensions (instruments set 2) are input with a tape. For any other length instrument selected in instruments set 1, a tape is assumed for dimensions only if the *Instrument Set #2 = #1* checkbox is not set for dimensions.

h4.The Shots tab

The *Number of Shots* associated with this session is displayed at the top of the form. Select the *Gray halftone* or *Color* this session will take in the map (offered only if device permits.) Select whether shots pertaining to this session will be displayed, or not, in the cave map with the *Draw* checkbox. Indicate with the *Flip* checkbox whether survey shots in this session must be extended in a direction opposite to the cave default in the extended profile view. Select whether shots pertaining to this session will be summed to the total cave development *\+ (Sum)* pushbutton. Select the *Passage sizes* checkbox to indicate passage sizes are mandatory. Select either the *Start* or the *End* pushbutton to indicate which side of the survey shot is to be associated, by default, with size measurements. This association can be overridden in each individual survey shot. Select the *Direct* checkbox if passage sizes are "seen" from the start station. Input the *Magnetic Deviation* to be added to compass (magnetic) azimuths to obtain geographic (true) azimuths. This setting can be different for each individual survey session as it can vary over time and space. A westward magnetic deviation must be set as negative; an eastward deviation as positive. Select the behavior for *Reverse Azimuths* and *Reverse Slopes*:

  1. *Ignore*: backsight azimuths/slopes are ignored (neither shown nor input)
  2. *Show*: backsight azimuths/slopes are automatically computed while the direct measurement is input and displayed for self\-validation purposes
  3. *Store*: backsight azimuths/slopes are to be input by the user and stored in the shot data
  4. *Show and Store*: backsight azimuths/slopes are automatically computed and displayed while the direct measurement is input but may be overwritten by the user with the actual measured backsight data and then gets stored in the shot data
  • Note:* With options _Show_ and _Show and Store_, Auriga shows what the expected backsight (azimuth or slope) should be, taking into account the calibration of both instruments sets. For instance, if the foresight azimuth is 35°, assuming neutral calibrations, the expected backsight azimuth should be 215° (35° \+ 180°).
  • Note:* Some compasses offer two reading scales, one direct and one corrected (i.e. reverse). The Auriga user may find more natural to compare the foresight azimuth with a corrected backsight (ex. 35° vs 36° rather than 35° vs 216°); in this case, option _Show_ becomes irrelevant. Auriga accepts either a true backsight azimuth or a corrected backsight azimuth. When computing the survey shot (and averaging azimuths, if both exist), if its foresight and backsight azimuths do not fall within 90°, Auriga assumes the backsight azimuth is not corrected. The backsight is always considered normal (not corrected) if the foresight azimuth is missing or if the survey shot has the _Ignore Azimuth_ attribute.

Select the *Direct* checkboxes in the *Azimuths* and *Slopes* groups to indicate direct azimuths and slope measurements by default. These options can be overridden for each individual survey shot in the [Survey Shot|] form. Select *Altitude* units.

  • Warning:* Modifying existing sessions modifies the interpretation of input data for the shots associated with the modified sessions.

Menus: [Session|], [Edit|] and [Defaults|] The latter can be used to store or retrieve default values.

h3.The Auriga Keypad

The Auriga keypad overrides the built\-in Palm OS alphabetic and numeric keypads in every Auriga form where text data can be input. It pops up when the *1\-2\-3* or *a\-b\-c* keyboard button is tapped in the silkscreen area. This custom keypad self\-adjusts to the type of field being edited; thus some buttons (like "*\-*", "*.*", "*North*", "*Direct*" or "*Series*") may not always be present. Buttons are big enough to make a stylus unnecessary when surveying. The name of the currently edited field along with its measurement unit, if any, is displayed in the Keypad form title. When editing sexagesimal coordinates (d°m's"), tap the *West*, *East*, *North* or *South* selector to invert the coordinate. The symbol key at the bottom self\-adjusts into *°*, *'* and *"* to allow separation of degrees, minutes and seconds. Use the *OK* button to leave the keypad; saving the input field is automatic. Tap the *left arrow* (backspace) button to erase one character, or hold it to erase the input field. Press the *Up/Down arrow* buttons to save the input field and move to the previous/next field. When editing a survey shot, holding the stylus on the *i* button (upper right corner) displays the contents of the [Survey Shot|] form input fields. When editing a survey shot, holding the stylus on the *Up* or *Down* buttons displays a list of the [Survey Shot|] form input fields to speed up navigation. If the edited field is the azimuth or slope field, a *Direct* pushbutton is displayed left of the input field. Conversely, if the edited field is the start station and the automatic detection of series beginnings is not selected (see the [Stations|] tab of the [Cave Details|] form), a *Regular/Virtual/Series* pushbutton is displayed to allow selecting the type of survey shot. Depending on the type of data input, alphabetic, symbolic or international keyboard layouts may be offered. When editing a series beginning or a virtual survey shot, the type of position, if any, can be selected with the [Position|] menu while editing the start station. Menus: [Edit|] and [Position|] when relevant.

h3.The List form

The List form displays surveyed and computed cave data in list views. Displayed data is in read\-only mode except for the attributes list, checkboxes and color selectors that can be modified by maintaining the stylus on them for a short delay; modifications take effect immediately. If the cave is open in read\-only mode or if not a single list column is editable (i.e Stations or Graph views), a *padlock* icon is displayed in the title bar. The selected row is shown in reverse (light text on dark background.) It is possible to bookmark a row by tapping the desired row with the stylus. The bookmarked row is surrounded by solid lines. In views that allow it (see below), tapping the marked row selects it, thus changing the current survey shot. List columns can be resized by tapping the stylus leftward of the end of the column head to resize and dragging it to the desired width. Tapping on the *\+* button at the bottom, right of the list widens the rightmost visible column. Columns are limited to a minimal and maximal width. List columns can be selectively shown or hidden with the _Columns_ item of the _List_ menu, leading to the [Columns|] form. List columns in Survey Shots, Virtuals and Sessions views can be sorted by tapping the stylus in the head of the column to sort. Sorting the same column a second time inverts its sort order. The head of the sorted column is shown in reverse.

  • Note:* Modifying a checkbox or color selector may break the sort if the modified column is the sort column. In this case, tapping the head of the column re\-sorts the view without inverting the sort order.

The 2 center *hardware application buttons* scroll the view horizontally.

  • Note:* On devices with Palm OS version prior to 3.5, horizontal scroll bars being unusable, Auriga does not show them. Use the hardware application buttons instead.

Lists can be printed with the _Print_ item from the _List_ menu. In the Graph view, consecutive survey shots (with connecting end\-start stations) are printed as blocks separated by a dotted line. Six views are selectable with the rightmost drop\-down list in the title bar:

  1. *Survey Shots* displays a list of raw survey shots (as they were input.) The selected row is the current survey shot; it can be changed by selecting another row. Available columns are:
    1. stations name
    2. status (incomplete, duplicate, orphan or part of an incomplete or orphan leg)
    3. input date
    4. color (editable)^7^
    5. session number^6^
    6. attributes (editable list)^1^
    7. length^2^
    8. Topofil start and end^2^
    9. direct azimuth (editable checkbox)^2^
    10. azimuth^2^ \- shown between () if the survey shot has the _Ignore Azimuth_ attribute
    11. azimuth backsight^2^ \- shown between () if the survey shot has the _Ignore Backsight Azimuth_ attribute
    12. direct slope (editable checkbox)^2^ \- shown between () if the survey shot has the _Ignore Slope_ attribute
    13. slope^2^ \- shown between () if the survey shot has the _Ignore Backsight Slope_ attribute
    14. slope backsight^2^
    15. left, right, up and down passage sizes
    16. note

This view can be filtered with the center drop\-down list in the title bar to only show:

    1. survey shots pertaining to the current series
    2. survey shots pertaining to the current session
    3. survey shot errors (incomplete or orphan survey shots)
    4. survey shot warnings (duplicate survey shots or with invalid data or survey shots part of an incomplete or orphan leg)
    5. survey shot errors and warnings
  1. *Virtuals* displays a list of virtual survey shots (pure virtuals and series beginnings). The selected row corresponds to the current survey shot or the series beginning it belongs to; it can be changed by selecting another row. Available columns are:
    1. stations name
    2. input date
    3. color (editable)^7^
    4. session number^6^
    5. number of survey shots in the series^3, 5^
    6. total surveyed length of survey shots in the series^3, 5^
    7. draw virtual survey shot or survey shots in the series in the map (editable checkbox)
    8. sum length of survey shots in the series to total cave development^3, 4, 5^
    9. flip survey shots in the series in the extended profile map view (editable checkbox)^3, 5^
    10. position
  1. *Sessions* displays a list of survey sessions. The selected row corresponds to the session to which the current shot belongs; selecting another row also selects the first survey shot of that session as the new current survey shot. Available columns are:
    1. session number (the active session is marked by an asterisk)
    2. session name
    3. input date of the first survey shot associated with the session (or session creation date if no survey shot is yet associated with the session)
    4. color (editable)^7^
    5. number of survey shots in the session
    6. total surveyed length of survey shots in the session^4^
    7. draw survey shots in the session in Map (editable checkbox)
    8. sum length of survey shots in the session to total cave development
    9. flip development direction of survey shots in the session in the extended profile map view (editable checkbox)
  1. *Stations* displays a list of stations with computed XYZC coordinates and an uneditable *Attributes* column that can contain a combination of 'E' (Entrance), 'P' (Permanent) and (Lead) characters. All coordinates use the map scale and, for the Z coordinate, the vertical factor defined in the [Computations|] tab of the [Cave Details|] form. The selected rows correspond to the stations of the current survey shot. Selecting another row also selects the first survey shot associated to that station as the new current survey shot and consequently selects the other station of this survey shot.
  2. *Graph* displays a list of stations with computed XYZC coordinates and links to other stations along with an uneditable *Attributes* column that can contain a combination of 'E' (Entrance), 'P' (Permanent) and (Lead) characters. this is the most useful view to draw the cave map on paper. In this view, scrolling, marking and selection is done by pair of rows. A dotted line separates pairs of stations linked by a survey shot. All these coordinates use the map scale and, for the Z coordinate, the vertical factor defined in the [Computations|] tab of the [Cave Details|] form. All passage sizes use the map scale; up/down sizes also use the vertical factor.
  • Note:* Left/right passage sizes may be swapped in order to always correspond to a direct survey shot.
  1. *Caves* (available when handling a network) displays the list of the caves in the network. Available columns are:
    1. index of cave in network
    2. cave alias
    3. color (editable)^7^
    4. draw cave in Map (editable checkbox)
    5. number of survey shots in cave
    6. number of sessions in cave
    7. number of series in cave
    8. cave development
    9. total surveyed length in cave
    10. cave vertical drop
  2. The column displays abbreviated survey shot attributes; if no attribute is set, the column displays the _Attribute_ icon; tapping on this column pops up a list of selectable attributes
  3. Only applies to regular survey shots
  4. Only applies to series beginnings
  5. Only if cave coordinates are computed
  6. Only if series are enabled
  7. Only if cave has more than one session
  8. Only if device has color or grayscale
  • Note:* The _Stations_ and _Graph_ views require the cave coordinates to be computed. If computations cannot be performed (likely due to a lack of memory), the display of these views is denied. Other views can benefit from computed coordinates by displaying faster or showing computed lengths (_Virtuals_ and _Sessions_ views).
  • Note:* The _Stations_ and _Graph_ views can display 3 different types of coordinates, selectable in the title bar:
  1. *Real* coordinates are expressed in cave length units (meters or feet), as selected in the [Cave|] tab of the [Cave Details|] form
  2. *To Scale* coordinates where the map scale (selected in the [Computations|] tab of the [Cave Details|] form) is applied. These coordinates are displayed in centimeters or inches, depending on the cave map length unit (selected in the [Cave|] tab of the [Cave Details|] form)
  3. *Grid* coordinates, where both the map scale (selected in the [Computations|] tab of the [Cave Details|] form) and the paper grid (selected in the [Map|] tab of the [Preferences|] form) are applied. These coordinates are expressed in paper grid units and are identical to those displayed in the [Sketch to Scale|] form when ran in absolute mode

If the _Ignore Origin_ option is selected with the selector, the origin X, Y, Z and C coordinates are substracted from the station coordinates, thus displaying origin\-relative absolute coordinates.

  • Note:* Modifying the status of series\-related checkboxes in the Virtuals view has no effect if the *Sessions override Series* checkbox is selected in the [Computations|] tab of the [Cave Details|] form. Conversely, modifying the status of checkboxes in the Sessions view has no effect if the *Sessions override Series* checkbox is unselected.
  1. Columns that are irrelevant for a given row display as '\-'
  2. Columns with missing data for a given row do not display
  3. Columns with yet incomputed data for a given row display a
  • Note:* Numeric columns are normally right\-justified to maintain number alignment. However, for columns other than station names and session number, if a number does not fit in the column width, it gets automatically left\-justified so as to show its most significant digits (and truncate its decimals).

Select the *Forms* icon to return to the previous form or select the _Close_ item in the [Cave|] menu to return to [Main|] form. This is disabled by the _Assistant_ (if active). Maintaining this icon depressed displays a list of exit choices (_Survey Shot_, _Map_ or _Close Cave_.)

  • Note:* When handling a network, the data displayed in lists can be grouped by cave by selecting this option in the views list.

The *Gofer (running man)* button launches the [Survey Shot Search|] form. Menus: [Cave|], [List|] and [Options|].

h4.The Columns form

Highlight columns to be shown in main list. Columns whose name is preceeded by a padlock icon are not toggable.

h3.The Map form

The Map form displays the topographical path (cave skeleton) in top view or various profile views. The Map can be redrawn using the map options list (see below). Tapping in the screen while the map is being drawn allows to suspend the operation. On devices with a fixed Graffiti area, a confirmation is required.

  • Note:* The top of the map corresponds to the North, either geographic (true) or magnetic, depending on whether a magnetic deviation was input or not in individual sessions and/or the [Cave Details|] form.

The map is restored with the previously used zoom ratio and pan factor for this cave.

  • Troubleshooting*: An empty map display may be caused by:
  1. an extreme zoom ratio
  2. a pan factor that moves survey shots out of the view
  3. a choice of invisible colors for survey shots
  4. unselected display options

See the _Display Options_ list. If the computation process of the cave map detects incomputable survey shots (orphan or incomplete), an alert is displayed and the user can view a log of the offending survey shots. Tapping on one of the survey shots in the results list loads that survey shot into the [Survey Shot|] form. Conversely, station errors detected while computing the cave map coordinates can be viewed by tapping the _Station Errors_ item in the [Cave|] menu. Survey shots that lead to computing the same station but with differing coordinates (beyond the station error tolerance input in the [Computations|] tab of the [Cave Details|] form) are grouped together. Tapping on a survey shot name brings it up in the [Survey Shot|] form. Unlinked or incomputable shots and loop error logs can be exported as memos to the built\-in Memo Pad application for future viewing. it may be advisable to create a memo category to store them.

These errors can be visually detected in the map: for every station that is part of a loop, the difference between its theoretical location and its actual location (determined by the survey shot used to compute the station location) is drawn with a dotted line.

  • Tip*: With station markers displayed, any survey shot segment that does not reach a station marker at both ends reveals a loop error.

If the *Full Screen Cave Map* option is selected in the [Preferences|] form, controls at the bottom of the screen are only briefly displayed when the form is open to show the current view and stylus mode. These controls can then be shown or hidden by simply tapping a '.' in the numeric sector of the Graffiti area. This allows viewing the entire cave, that then uses the full screen height.

  • Note:* On devices with a dynamic Graffiti area, in full screen map mode, when the Graffiti area is closed, tapping the *Menu* icon first displays the Map form controls

A scale is displayed at the bottom of the screen. If option *Show Scale* is not selected in the [Map|] tab of the [Preferences|] form, the scale is only displayed for a second. It briefly reappears every time the map is redrawn. In permanent scale display mode, it can be hidden by tapping on it with the stylus. Tapping on the leftmost *Attributes* icon pops up a list of display options. Options in this list are specific to the current cave:

  1. *Redraw Map* redraws the map with a normal zoom ratio and a null pan factor; if the map drawing was interrupted, the map is redrawn with current zoom ratio and pan factor
  2. *Shot Info* toggles the display of the current shot information at the top of the map
  3. *Grid* toggles the display of a grid; note that if not grid matching the configured settings can be displayed, no grid is effectively displayed (see the [Map|] tab of the [Preferences|] form); see note below
  4. *Scale* toggles the display of a scale
  5. *Stations* pops up a list of the station display options:
    1. *Markers* toggles the display of triangular markers on stations
    2. *Landmarks* toggles the display of asterisks on stations with a geographic position
    3. *Entrances* toggles the display of a letter 'E' next to cave entrances
    4. *Permanent* toggles the display of a letter 'P' next to permanent stations
    5. *Leads* toggles the display of a next to leads
    6. *Names* toggles the display of station names
    7. *Suffixes* toggles the display of station name suffixes (only available if series are enabled); series are truncated from the station names to lead shorter labels in map
  6. *Line Plot* toggles the display of the line plot between stations
  7. *Dimensions* toggles the display of dimension lines (left\-right or up\-down) across stations; see note below; if the map displays a cave network, this option and the following one only have an effect if the _Retain Passage Dimensions_ is selected in the [Network|] tab of the [Network Details|] form
  8. *Walls* toggles the display of (theoritical) wall lines between dimension lines (visible or not); see note below
  9. *Fill Passages* toggles the filling of passages with walls color
  10. *Orphan Legs* toggles the display of orphan shots and all survey shots that depend on orphan shots (dotted line)
  11. *Loop Errors* toggles the display of loop errors as dotted lines between actual and theoretical shot ends for survey shots that are part of a loop; if the map displays a cave network, this option and the following one only have an effect if the _Retain Closure Errors_ is selected in the [Network|] tab of the [Network Details|] form
  12. *Map Coloring* pops up a list of map coloring modes:
    1. *Default* colors used are those selected in the [Map|] tab of the [Preferences|] form
    2. *By Series* color is selected in the [Survey Shot|] form
    3. *By Session* color is selected in the [Shots|] tab of the [Session|] form
    4. *By Survey Shot* color is selected in the [Survey Shot|] form
    5. *By Selection* colors used are those selected in the [Map|] tab of the [Preferences|] form (if a selection is available in the [Selection|] form)
    6. *By Cave* (when displaying a network) the cave\-specific color is selected in the [Caves|] tab of the [Network Details|] form

In *Section* view, display options are:

  1. *Swap Sides* swaps let\-right sides; *the right side is indicated by the map or grid scale position*
  2. *Other Station* toggles between the start and end stations of the current survey shots
  3. *Grid* toggles the display of a grid; note that if not grid matching the configured settings can be displayed, no grid is effectively displayed (see the [Map|] tab of the [Preferences|] form); see note below
  4. *Dimensions* toggles the display of dimension lines
  5. *Line Ends* toggles the display of small lines perpendicular to dimensions
  6. *Walls* toggles the display of (theoretical) passage walls between dimensions lines (visible or not)
  7. *Fill Section* toggles the filling of the section
  • Note:* Passage dimensions are computed with the Up, Down, Left and Right survey data. As each survey shot can hold a single set of passage dimensions, the user has to indicate to which of the two stations (of the survey shot) the set of dimensions belongs, i.e. start or end station. Thus, it is possible to end up with more than one set of dimensions for a given station if more than one shot leaves/arrives from/to a given station. For simplicity, Auriga only retains the first set of dimensions for a given station while computing cave coordinates. In some cases, depending on passage morphology, this may lead to an incorrect graphical rendition of actual cave walls.

Also note that Auriga takes passage dimension data as perpendicular to the axis of the survey shot.

  • Note:* The map grid is not centered in the screen but aligned on the origin station of the cave. In profile views, if a vertical factor other than 1.0 is set (see the [Computations|] tab of the [Cave Details|] form), the grid may appear rectangular to match the displayed numeric grid value both horizontally and vertically.

The leftmost popup list allows selecting the type of cave view displayed:

  1. *Top View* is X vs Y
  2. *W\-E Profile* view is X vs Z
  3. *S\-N Profile* view is Y vs Z
  4. *Extended Profile* is a X vs C stretched profile view
  5. *Projected Profile* is a profile view relative to a user\-selected projection angle (see the next popup list); Auriga offers 2 different projected profile views, each with its distinct projection angle
  6. *Section* is a section view of the passage at the current station, drawn using its left, right, up and down dimensions and designed to assist sketching
  • Note:* Each cave has its default direction for developing survey shots in the extended profile view (set in the [Map|] tab of the [Cave Details|] form). This direction can be toggled by the passage flip attribute (either series or session, depending on the state of the _Sessions over Series_ checkbox in the [Computations|] pane of the [Cave Details|] form). For series, this flip attribute can be set in the [Survey Shot|] form, while for sessions, the flip attribute can be set via the _Sessions_ view of the [List|] form. In addition, this direction can again be toggled by the individual survey shot flip attribute set in the _Survey Shots_ view of the [List|] form. Thus, the survey shot can inverse the development direction set by the passage, that can itself inverse the general cave development direction. This allows the user full control on the display of extended profiles of complex cave systems.

The center popup list allows selecting the stylus mode (*Zoom*, *Pan*, *Info*, *Line*, *Spot*, *Select* or *Projection*.) This mode determines the results of stylus taps or drags in the cave map.

  • Note:* In _Section_ view, only the _Zoom_ and _Info_ are permitted.

In *Zoom* mode, tracing the diagonal of a rectangle in the cave map zooms the part of the cave map enclosed in that rectangle (unless the rectangle is too small.) The zoom rectangle may be adjusted when re\-displaying the cave to maintain a uniform zoom ratio, both vertically and horizontally. In *Pan* mode, dragging the stylus in the cave map shifts the map in the drag direction. In *Info* mode, the name of the stations of the current shot and its note (if any) are displayed at the top of the screen. The current station is marked with a bullet in the map and displayed in bold at the top of the screen. On color or halftone\-capable devices, both the current station bullet and the current shot segment use the color set in the [Map|] tab of the [Preferences|] form. The current station can be selected with *arrow* pushbuttons (see below) or by tapping directly into the cave map. In *Line* mode, dragging the pen in the cave map displays the length and angle or slope of the drawn line along with the vertical and horizontal distance (map\-wise.) Length and angle units used are those set in the [Cave Details|] form. Tapping the screen again dismisses the line display.

When viewing a *Top* cave view, the angle of the drawn line is automatically copied into the clipboard to later ease selecting the projected profile angle. In profile cave views, a slope angle is displayed instead. The *Spot* mode displays the position of the stylus in the cave map. In top cave view, the position format is that selected for the cave in the [Cave Details|] form; geographic locations can only be provided if the cave is geo\-referenced. In profile views, the position is displayed in XZ format, with altitude if the cave has an altitude reference. Tapping the screen again dismisses the spot display. In *Select* mode, tracing the diagonal of a rectangle in the cave map determines a selection area that can then be used in the [Select|] form to select survey shots or stations. The *Projection* mode is used to select the angles used by the two projected profile views. In the plan view, angles can be selected graphically, as in the _Line_ mode. The corresponding projected profile is displayed after an angle is selected. The angle unit is that selected in the [Cave|] tab of the [Cave Details|] form [Network|] tab of the [Network Details|] form. If the current station has survey shots toward other stations, the current shot is the first survey shot (in cave list order) leaving from the current station. If the current station has no survey shots toward other stations, the current shot is the first survey shot (in cave list order) arriving from the current station. The current station name is displayed in bold in the information line displayed at the top of the cave map. The *Up/Down* scroll buttons allow to cycle through the various survey shots associated with the current station. Currently, only survey shots that start from the current station can thus be reached. Arrow pushbuttons allow navigation between survey shots. From left to right, they:

  1. go to previous series beginning of current series *or*
    1. go to first survey shot in previous series or previous cave leg *or*
    2. move backward by a user\-chosen number of survey shots

depending on settings configured in the [Stations|] tab of the [Cave Details|] form

  1. move one survey shot backward
  2. move one survey shot forward
  3. go to next series beginning *or*
    1. go to first survey shot in next series or cave leg *or*
    2. move forward by a user\-chosen number of survey shots

depending on settings configured in the [Cave Details|] form The *\+* and *\-* buttons zoom in or out the cave map from the center. The first zoom out action restores the previous zoom ratio, regardless of whether it was manually determined (stylus dragged across the map) or automatic with the *\+* button. If the *\-* or *\+* buttons are held down, a list of zoom options is displayed:

  1. *x* or *÷ 1.5*, *2*, *3*, *5*, *10*, *25*, *50* and *100* provoke a zoom\-in (x) or zoom\-out (÷); the number of available options depends on the current zoom ratio, so as to avoid zooming beyond maximum zoom or below minimum zoom
  2. *Maximum Zoom* provokes a maximum zoom of the map
  3. *Full Map* displays the entire cave or network map within the size of the screen
  4. *Full Section* displays the entire passage section within the size of the screen (_Section_ view only)
  5. *Current Shot* provokes a zoom on the current survey shot
  6. *Current Shot\+neighbors* provokes a zoom on the current survey shot and its immediate neighbors
  7. *Locate a Shot* launches the [Survey Shot Search|] form, after which the map is zoomed on the selected survey shot and its immediate neighbors
  8. *Current Series or Session* provokes a zoom on the series or session of the current survey shot. The choice between series or session is determined by the status of the _Sessions Over Series_ checkbox in the [Computations|] pane of the [Cave Details|] form
  9. *Current Cave* provokes a zoom of the network map on the cave to which belongs the current survey shot

Select the *Forms* icon to return to the previous form or select the _Close_ item in the [Cave|] menu to return to [Main|] form. This is disabled by the _Assistant_ (if active). Maintaining this icon depressed displays a list of exit choices (_Survey Shot_, _List_ or _Close Cave_.) The 4 hardware application buttons have the following effect:

  1. In *Info* mode, from left to right, they mimic the arrow buttons (previous series beginning/cave leg, previous survey shot, next survey shot and next series beginning/cave leg.) On the Palm Zire, which has only 2 such buttons, they only mimic the previous shot and next shot arrows.
  2. In *Zoom*, *Pan* or *Line* mode, the leftmost button (Date book) mimics the *\-* (zoom out) button while the rightmost button (Memo Pad) mimics the *\+* (zoom in) button. The second (Address book) and third (To do) buttons and the *Up/Down* scroll buttons pan left, right, up and down.

Graffiti shortcuts:

  1. '\-' zooms out
  2. '\+' zooms in
  3. the 'tab' stroke returns to the [Survey Shot|] form
  4. dragging the stylus from the Graffiti area to the middle of the screen toggles between top and extended profile views
  • Note:* For these shortcuts, tapping the Graffiti 1 punctuation mark (a single tap in the Graffiti area) is not required. Thus, ' ' (space) acts as '\-' (zoom out), 'k' as '\+' (zoom in) and 'f' as a tab (exit.)

Menus: [Cave|] or [Network|], [Map|] and [Options|].

h3.The Statistics form

The Statistics form displays cave statistics. It may trigger an automatic XYZC coordinates computation if these are not up to date. The development is the sum of the horizontal projection of the length of every survey shot that has the *\+* attribute set and that belongs to a series with the *Sum to development* attribute set (if series are used.) The mapped length is simply the sum of the length of all survey shots. Statistics can be exported as memos to the built\-in Memo Pad application for future viewing. The same menu also allows printing statistics or beaming them to another device. Menu: [Log|].

h3.The Network Details form This form displays information on a network, either existing or being created. This form has 3 tabs, selected with the pushbuttons in the title bar.

h4.The Network tab

The *Name* of the network can be any string of 26 characters or less and may include spaces. This corresponds to the name of the Auriga network PDB on the Palm OS device (with a 5\-character suffix to distinguish it between PDB types.) Editing the name of an existing network actually renames it (an alert is issued before proceeding.) The *Category* selector allows selecting the network category. Categories are edited in the usual Palm OS way by selecting the _Edit categories..._ list item. Select measurement units to be used for computing coordinates:

  1. *Lengths* unit (_meters_ or _feet_)
  2. *Angles* unit (_degrees_ or _grads_) for azimuths and projection angle
  3. *Slopes* unit (_degrees_, _grads_ or _%_)
  4. *Slope 0* setting (_up_, _level_ or _down_)
  • Note:* Measurements units selected in this form are used throughout Auriga to report coordinates, lengths and angles between stations and statistics.

Select the format to be used to display *Positions* in the network map (_XYZ_, _UTM_, _d°m's"_ or _d°m.m'_.) If latitude/longitude or UTM geographical positions are to be input, select the proper topographical *Datum* to use for conversions. Select the *Shot Navigation Mode* with navigation arrows in the [Survey Shot|] and [Map|] forms. Choices are:

  1. *Go to the next or previous series beginning* (default if the 4.4 format is selected)
  2. *Go to Next Cave Leg* (determined by a station naming change in the left subpart of the station name if the 4.4 format is selected)
  3. *Go to Next Session*
  4. *Move by n shots*, where n is user\-chosen value between 1 and 255

If the network cannot be built due to a lack of memory, unselecting the following checkboxes may perhaps reduce the memory requirements down to a working level, at the expense of lost functionality:

  1. Unselecting *Retain Closure Errors* drops the closure error data; closure errors can no longer be displayed or listed; the memory gain is 61% for survey shots (16/26 bytes)
  • Note:* If the closure error data is not retained, Auriga plots survey shots between the computed position of their start and end stations, regardless of the position resulting from actually computing the survey shot, which may differ in case of a closure error, thus forcing an artificial loop closure.
  1. Unselecting *Retain Passage Dimensions* drops the passage dimensions data; passage widths or cave walls can no longer be displayed; the memory gain is 31% for survey stations (14/44 bytes)
  2. Unselecting *Retain Session Statistics* drops the total length statistics for sessions; this data is not currently usable by networks, so dropping it makes no difference and saves 12 bytes/session

Tap the *Note* button to edit the network note. 255 characters are permitted.

h4.The Map tab

Select the network map *Grid* value. See the [Map|] tab of the [Preferences|] form for general grid preferences (that apply to all caves/networks). Select the *Automatic* checkbox so that the map grid gets resized when it cannot be displayed within the user\-defined minimum and maximum number of lines. The grid value is then multiplied or divided by 2 and rounded to the lowest integer. Otherwise, the grid is hidden. Select the *Wall Color same as Shot* checkbox so walls and dimensions are drawn in the map using the color of their corresponding survey shot. Otherwise, they are drawn using the default color selected in the [Map|] tab of the [Preferences|] form. Select the *Vertical* factor used in profile maps and coordinate computations to exaggerate the verticality of the network for display purposes. A factor less than 1 (ex. 0.5) actually flattens out a vertical network. This factor is applied to coordinates reported in the [List|] form for drawing, but coordinates reported in the [Map|] form are not affected. Indicate the coordinates of the network *Origin* (0,0,0 by default), expressed in map units.

h4.The Caves tab

This tab allow selecting the caves that are part of the network. Use the *Add* or *Remove* buttons to select caves; use the *Up* or *Down* arrow buttons to move the selected cave in the list; this order alters the search for linking stations when building the network (see the [Network Cave|] form.) From left to right, the 5 columns are:

  1. *Loaded*: cave data could be loaded by the network building process \- this attribute is set by Auriga
  2. *Linked*: the cave could be linked to the network \- Auriga only attempts to link loaded caves, and only linked caves can be displayed
  3. *Draw in Map*: the cave is to be drawn in the network map
  4. *Color*: this color is used when selecting the _Color by Cave_ option in the map settings popup list of the [Map|] form
  5. *Alias*: prefix used before station names in the _Info_ line of the network [Map|]

The _Draw in Map_, _Flip Extended Profile_ and _Color_ settings can be modified by holding down the stylus on them. Tapping on the currently selected cave displays the [Network Cave|] form. Menus: [Edit|] and [Defaults|].

h3.The Network Cave form

This form displays information on a networked cave, either already selected or being added to a network. Select the name of the networked *Cave*, either manually or with the drop\-down list of caves present on the device. Caves already selected for this network do not appear in the list. If there are no caves present on the device or if all caves present on the device are already selected for the network, the list does not show. The *Alias* is used as a prefix before station names in the _Info_ line of the network [Map|]. A short alias is preferable. Select the type of link that binds the cave to the network:

  1. *Automatic*: Auriga sets the first cave on the network origin, and tries to link other caves by common stations with other caves
  2. *By Geo\-Reference*: after a cave owning a geo\-reference can be linked to the network, other caves owning a geo\-reference can also be linked to the network through their geographic location; note that only UTM geographic locations are recognized at this moment
  3. *Origin Same as Network*: the cave origin station is set on the network origin
  4. *XYZ Offset from Network Origin*: the cave origin station is set on an XYZ shift from the network origin
  5. *Station Linked to Remote Cave*: the cave is linked to another cave through common stations. If the cave is the only one currently selected for the network, the drop\-down list cannot be shown. If the *Station* and *Links to* fields are left empty, Auriga searches for identical stations in one or more caves; otherwise, a pair of different stations can be input. If the *of* field is left empty, Auriga searches for link stations in all other caves already linked; otherwise, the search is limited to a single cave. In any case, XYZ offsets can be input, they get added to the cave coordinates.
  6. *Use Cave Origin as Offset*: the cave origin station coordinates (set in the [Computations|] tab of the [Cave Details|] form) are used as an offset from the network origin

In _Automatic_ mode, selecting the *Auto Update Link Type* checkbox updates the link type to that actually used by Auriga upon successfully building the network. Otherwise, the *Actual link* button allows knowing the type of link used by Auriga when building the network. This button only appears after the network is built. Menu: [Edit|]

h3.The Selection form

The Selection form allows to select a set of survey shots or stations to act upon in the [Beam|], [Export|] and (later) [Maintenance|] forms. Use the rightmost popup list in the title bar to select the *Stations* or *Shots* view to indicate the type of items to select. Use the selector trigger in the middle of the title bar to view *All* or only *Selected* items. Items can be selected or unselected from the list by tapping on them. In _Selected_ mode, unselecting an item immediately removes it from the list. A continuous range of items can be selected or unselected by first selecting the *Range* pushbutton and the desired action (*\+* to select, *\-* to unselect), then selecting the bounds of the item range. The start of the range is highlighted by dotted lines. The desired operation is immediately performed when the second range bound is selected. In _Selected_ mode, items can only be unselected, and are immediately removed from the list. The operation can be aborted by unselecting the _Range_ pushbutton. The *Select* button opens the [Select|] form that offers various ways to select/unselect items.

  • Note:* The Selection is flushed from survey shots and stations when a survey shot is added or deleted to/from the cave.
  • Tip:* To break up a large cave into smaller more manageable subsets of that cave:
  1. Display the cave [Map|]
  2. Use the _Select_ stylus mode to graphically select the desired cave subset
  3. In the [Select|] form, use the _Select from Map_ operation to add the selected survey shots to the Selection
  4. If needed, repeat the previous operations to add or remove survey shots to/from the Selection
  5. Go to the [Export|] form and export the selected survey shots into another (new) cave
  6. To export the other half of the current cave into another cave return to the Selection form, use the _Invert Selection_ menu item and then repeat the export operation, this time into another (new) cave

Menu: [Selection|].

h3.The Select form

The Select form offers various ways to select/unselect items in the Selection. Use the top pushbuttons to select the survey *Stations* or *Shots* view in which items are to be (de)selected . Select the *\+* (select), *\-* (unselect) or *Replace* pushbutton to determine the effect of the selection operation. Select the type of selection to perform:

  1. _All_ (un)selects all survey shots or stations
  2. _Select Session_ (un)selects survey shots or stations belonging to the current session or to a range of sessions.
  3. _Select Series_ (un)selects survey shots or stations belonging to the current series or to a range of series.
  4. _Select Between Dates_ (un)selects survey shots or stations input during the given date range
  5. _Select from Map_ uses the selection made in the [Map|] form; this option is not available if no selection were made in the [Map|] form

In _Select Session_ or _Select Series_ operations, if the *Current* checkbox is not selected, input fields are provided to supply a session or series range. When using a date range, it spans from 00:00:00 on the start date to 23:59:59 on the end date. Menu: [Edit|]

h3.The Pit Sounder form

This form allows estimating the depth of a pit from the fall time of a rock. Computations lay on the numerical resolution of the differential equation that describes the fall of a spherical body in air. The parameters of this equation are the mass and diameter of the rock, Earth's gravitational constant, air density and the Reynolds number of a sphere, that in turn depends on the diameter and instantaeous speed of the rock, as well as air density and viscosity. A more complete explanation of the maths involved is available in the [profondeurpuits.pdf|http://auriga.neopages.org/profondeurpuits.pdf] document (in French) in the Auriga Web site. Only the rock diameter is input by the user. The rock mass is computed from this diameter, using the average limestone density of 2520 kg per cubic meter. The gravitational constant used corresponds to a 45° latitude at the surface of the Earth. Air density and viscosity depend on temperature and humidity, but values used correspond to 20° Celsius in a saturated atmosphere (100% humidity.) The equation solution yields the distance travelled by the rock over time with the help of a constant\-step 4^th^ order Runge\-Kutta method. The computed pit depth takes into account the speed of sound in air. Find a rock, ideally spherical, and select its *Diameter* with the scroll bar. At the moment the rock is dropped (with no initial speed), hit the *Rock!* button or one of the 4 hardware application buttons to start the stopwatch. When the sound of the rock hitting the bottom of the pit is heard, hit the *Boom!* button or one of the 4 hardware application buttons to stop he stopwatch. The estimated depth is displayed after computations that can last a few seconds. The algorithm accepts fall times of up to 15 seconds. It is possible to manually input a fall time measured outside of Auriga by tapping the stylus on the time field to make it editable and to write that fall time. Hit the *Boom!* button to know the corresponding depth. For a detailed explanation of the physical model and the underlying mathematical treatment; see the _ProfondeurPuits.pdf_ document (in French) available in the _Support_ page of the [Auriga|http://auriga.neopages.org/%E9%E9www.speleo.qc.ca/Auriga] Web site. Research and algorithm: Pierre Beauchemin Menu: none.

h3.The Maintenance form

The Maintenance form offers various cave maintenance operations:

  • Note:* The first 3 operations should normally never be required and are only present for debug purposes.

Series\-related operations are only available if the cave allows series, that is, if the stations naming scheme is 4.4 (see the [Cave Details|] form)

  1. *Sort* sorts the cave. Caves are normally kept sorted automatically.
  2. *Reorganize Cave* reorganizes the cave (number of shots, sessions, etc.)
  3. *Purge Deleted Records* removes the deleted survey shot and session records from the cave. Such records are normally archived for use by the Auriga conduit, which then deletes them.
  • Warning*: Purging deleted records indiscriminately may result in the conduit not properly detecting deleted records.
  1. \[not implemented\] *Set Session* sets a new session number for all shots between two given dates (that can be the same.) The target session must already exist. This allows correcting shot calibration when one later realizes instruments did not correspond to the active session calibration when shots were taken:
    1. Create a new session from the active session shots were taken with
    2. Modify the new session calibration to reflect true instrument calibration when shots were taken
    3. Link survey shots to this new session
  • Note:* Creating a new session every survey day makes the instrument calibration easier: just edit the session.
  1. *Change Session* renumbers a given session and all associated survey shots to a new session number (ex. session 1 becomes session 2 and all shots taken during session 1 are now associated with session 2 \- session 1 is then deleted.) If the new session number already exists, sessions are merged, with all associated survey shots.
  2. \[not implemented\] *Change Series* renumbers all survey shots in a given series to another series (ex. all shots in series 4 become part of series 5.) Unselecting the *All Shots* checkbox allows specifying a range of survey shots to renumber \- only this series subset is then renumbered (ex. shots from 3.3 to 3.67.)
  3. \[not implemented\] *Shift Shots/Series* shifts a series of survey shots by a given offset (ex. all shots in series 4, except the series beginning, are shifted by 3 survey shot numbers.) The resulting shots must not already exist or an error message is issued. Unselecting the *All Shots* checkbox allows specifying a range of survey shots to shift \- only this series subset is then shifted (ex. shots from 3.3 to 3.67.)

Menu: [Edit|].

h3.The Font form

The Font form allows choosing various fonts. The *Notes* font is used to display network, cave, survey shot and session notes. It is also used for error logs. The *Survey Shot* font is used to display station names in the [Survey Shot|] form. If the cave has long station names containing letters, the standard font may be preferred. To avoid cluttering the map, prefer a small font for *Map Stations*. It is possible to load fonts other than the usual basic choices by installing *FontBucket* ([www.handshigh.com/fontbucket|http://www.handshigh.com/fontbucket]). FontBucket does not work on Sony Clié devices with high\-resolution screen, but Auriga nonetheless offers an accrued font selection. Menu: none.

h4.The Page Setup form

This form pops up when printing and allows configuring the print feature. Select the print *Font* (Courier, Times or Helvetica) and *Size* (9, 10 or 12 points.) Printing the [List|] form imposes the use of the Courier fixed\-width font for column alignment. Input the number of *Lines per page* for lists (use 0 for continuous paper.) Input the cave *Map Zoom Factor* used for map printing. This can be determined by experimenting with the target printer and paper size. Select whether the *Cave Name* and the *Current Date* must be printed too. Menu: [Edit|].

h2.Auriga menus

h3.The Cave menu

  1. *Statistics* leads to the [Statistics|] form, that displays statistics for the open or selected cave
  2. *Details* leads to the [Cave Details|] form that displays details for the open or selected cave
  3. *Sessions* leads to the [Session|] form. When the [Session|] form is launched via this menu, navigating between sessions does not affect the current shot session setting (unlike when launched with the _Session_ selector in the [Survey Shot|] form)
  4. *Shot Errors* computes XYZC coordinates and displays a log of erroneous shots (incomplete or orphan), if any (see the [Map|] form)
  5. *Closure Errors* computes XYZC coordinates and displays a log of loop closure errors, if any, given the maximum loop error setting (see the [Map|] form)
  6. *Selection* leads to the [Selection|] form
  7. *Export* leads to the [Export|] form
  8. *Beam* leads to the [Beam|] form
  9. *Maintenance* leads to the [Maintenance|] form, allowing various Auriga cave maintenance operations
  10. *Backup to Card* opens the [Universal File Dialog (UFD)|] to allow selecting the card directory where the cave is going to be saved
  11. *Restore from Card* opens the [Universal File Dialog (UFD)|] to allow selecting a cave present on the card to be restored into the device main memory (available in [Main|] form only)
  12. *Close* closes the currently open cave (if any) and returns to the [Main|] form (not available in [Main|] form only)


h3.The Network menu

  1. *Statistics* leads to the [Statistics|] form, that displays statistics for the open or selected network
  2. *Details* leads to the [Network Details|] form that displays details for the open or selected network
  3. *Beam* beams the network
  4. *Backup to Card* opens the [Universal File Dialog (UFD)|] to allow selecting the card directory where the network is going to be saved
  5. *Restore from Card* opens the [Universal File Dialog (UFD)|] to allow selecting the network present on card to be restored into the device main memory (available in [Main|] form only)
  6. *Close* closes the currently open network (if any) and returns to the [Main|] form (not available in [Main|] form only)


h3.The Edit menu

  1. *Undo*
  2. *Cut*
  3. *Copy*
  4. *Paste*
  5. *Select All*
  6. *Keyboard*
  7. *Graffiti Help*
  8. *Swap Stations* swaps the survey stations in the [Survey Shot|] form (available in [Survey Shot|] form only)
  9. *Slope Calculator* leads to the [Slope Calculator|] form (available in [Survey Shot|] form only)


h3.The Options menu

  1. *Fonts* leads to the [Fonts|] form. The font selected are used in logs, note fields and map display
  2. *Preferences* leads to the [Preferences|] form
  3. *Pit Sounder* leads to the [Pit Sounder|] form
  4. *Power Off* puts the device to sleep, without exiting Auriga
  5. *Backlight/Contrast* toggles the backlight state (on monochrome devices) or pops up the brightness dialog (on color devices)
  6. *Battery Status* displays the percentage of battery charge remaining
  7. *Limits* displays the minimum number of computable survey shots; see the [Limits|] section
  8. *Help* displays form\-specific help in forms where an *i* button is not present
  9. *About Auriga* displays the current Auriga version


h3.The Session menu

  1. *Select as Active Session* selects the displayed session as the active session
  2. *Go To Active Session* displays the active session
  3. *Beam* leads to the [Beam|] form


h3.The Defaults menu

  1. *Save Settings as Defaults* saves the current form settings as defaults
  2. *Load Default Settings* loads the default settings relevant for the current form


h3.The Map menus

  1. \[not implemented\] *Close Loops* triggers the loop closure process
  2. *Re\-compute Coordinates* forces a re\-computation of XYZC coordinates
  3. *Print* prints the cave map
  4. \[not implemented\] *Connect/Disconnect GPS* connects/disconnects a GPS for position tracking on the surface


  1. *Rebuild Network* reloads station coordinates of caves in the network and rebuilds links between them
  2. *Re\-compute Caves* forces a re\-computation of XYZC coordinates of all caves in network


h3.The List menu

  1. *Columns* leads to the [Columns|] form
  2. *Re\-compute Coordinates* forces a re\-computation of XYZC coordinates
  3. *Print* prints the current list


h3.The Log menu

  1. *Export as Memo* exports the log to the built\-in Memo application
  2. *Beam* beams the log to another device
  3. *Print* prints the log


h3.The Position menu This menu is available in the [Auriga custom keypad|] when editing the start station of a virtual survey shot or a series beginning. It allows selecting the type of position given to the start station (if any.)


h3.The Selection menu

  1. *Select All* selects all items in the current view
  2. *Unselect All* unselects all items in the current view
  3. *Invert Selection* inverts the current selection in the current view
  4. *Select Shots from Stations* selects all survey shots for which either one of its stations is already selected
  5. *Select Stations from Shots* selects all stations referenced by selected survey shots
  6. *Export* leads to the [Export|] form
  7. *Beam* leads to the [Beam|] form


h2.Miscellaneous

h3.Beaming Infrared data transmission, known as "beaming" can be launched in Auriga with the _Beam_ item of the _Cave_ menu or the _Beam_ icon in the command bar menu (displayed when writing a slash ("/") Graffiti gesture). When launched from the [Main|] form, the cave currently selected in the list, if any, is beamed entirely. When launched from other forms, the Beam form is displayed:

The Beam form offers a choice of beam options; these options are context\-dependent and thus, not all of them may always be available. When using a date range, it spans from 00:00:00 on the start date to 23:59:59 on the end date.

  • Note:* Whatever the option selected, if the beamed cave already exists on the destination device, beamed data is added to the existing cave, or updates it. Nothing gets overwritten in the existing cave.

Cave details are always beamed to the receiving device so as to make beamed data interpretable. Similarly, all sessions relevant to beamed survey shots accompany these survey shots in the beamed data. On the receiving device, the reception of beamed data pops up a form:

The Beamed Data Received form allows to change the target cave name; this allows creating caves of subparts of caves or to compensate for cave name differences between two devices. The vertical arrow pops up a list of existing caves on the device. If the target cave already exists, a merge process is launched:

  1. Cave Details from the beamed cave are compared with those of the local (existing) cave and the following differences are logged:
    1. station name format (4.4 or 8 characters) and character sets; if these differ, a user confirmation may be asked to proceed with the merge process as beamed series beginning could become incompatible with the resulting cave and thus require a prior conversion into virtual survey shots. If beamed and local caves differ by station name character sets, the most permissive sets are assigned for the local cave
    2. XYZ coordinates of the cave origin
    3. origin station
    4. geographic reference station
    5. altitude reference station
  2. beamed survey shots that do not exist in the local cave (with same start/end stations) are inserted in the local cave
  3. beamed survey shots that already exist in the local cave are compared:
    1. local incomplete (missing survey data) survey shots are updated with their complete counterpart from the beamed cave (if available)
    2. local survey shots without passage dimensions are updated with passage dimensions from beamed identical survey shots (if available)
    3. local survey shots without a note are updated with notes from identical beamed survey shots (if available)
    4. beamed survey shots differing from local survey shots with regards to session number, survey data (length, azimuth, slope or passage dimensions) or note are duplicated in the local cave and sorted *before* their corresponding local survey shot
  4. beamed sessions that do not exist in the local cave (with same session number) are inserted in the local cave.
  5. beamed sessions that already exist in the local cave are compared:
    1. local sessions without a note are updated with notes from identical beamed sessions (if available)
    2. beamed sessions differing from local sessions with regards to instruments calibration, survey shot settings or note are added to the local cave but get renumbered with the first available session number on both sides. Received survey shots associated with these sessions get assigned to the new session numbers.

If the beam merge process modified the local cave, a merge log is generated and written as a memo in the built\-in Memo Pad application. This log indicates:

  1. differences in cave details
  2. the list of renumbered sessions
  3. duplicated or updated survey shots
  4. renumbered or updated sessions
  • Note:* If survey shots or sessions were duplicated by the beam merge process, the user should *immediately clean up* the cave by removing superfluous records, eventually manually merging their data into one. A cave with duplicate survey shots or sessions is bound to create confusion.
  • Tip:* If two or more teams survey a cave, upon exiting the cave,
  1. all teams should first beam their cave to one of the devices
  2. the cave of this device should be cleaned up from duplicate survey shots and sessions resulting from the merge process
  3. the existing cave should be removed from other devices
  4. the merged cave should be beamed to these other devices

At the end of this operation, all devices will contain the entire cave data. Failing to remove the existing cave from the devices (step 3) before receiving the merged cave may again result in duplications and require a subsequent clean\-up on receiving devices.

  • Warning:* Beaming Auriga caves with file managers like FileZ does not trigger a beam merge process; instead, the beamed cave simply overwrites the local (existing) cave.

h3.Data Export The export of cave survey data works the same as [Beaming|], except that exported data are stored into a local cave. This allows splitting a cave into subparts (for example, to reduce computation delay) or, on the opposite, to merge into one several parts of a cave mapped separately. Options offered by the Export form:

are the same as those of the [Beam|] form, but in this case, the edited target cave name must be different from the current cave name.

h3.Backup/restore on memory card Auriga can backup or restore its caves or networks to/from a memory card via items in the Cave or Network menu. Restoring a cave/network can only be performed while in [The Main form|] Requirements are:

  1. a device with a Secure Digital or Memory Stick slot
  2. an unlocked card this slot (i.e. not in read\-only mode)
  3. UFD.prc (Universal File Dialog) loaded on device (downloadable from Auriga's Web site)

In backup mode, the current cave/network DB, or the selected cave/network DB in [The Main form|], is written in the card directory selected with UFD. In restore mode, the cave DB selected on the card with UFD is restored on the device. A confirmation is required prior to overwriting an existing cave/network. This backup/restore feature can be used as a faster alternative to beaming caves/networks between devices. However, data merge is not yet implemented; the restored cave/network can only overwrite the (existing) local cave/network.

h3.Use of silkscreen icons and hardware buttons on 4\-button devices |*Form/Key*|*Calendar*|*Contacts*|*To Do*|*Notes*|*Calculator1*|*Page Up2*|*Page Down2*| |*Survey Shot*|Previous series|Previous survey shot|Next survey shot|Next series|Slope Calculator^3^|Previous field|Next field| |*Survey Shot with Assistant*|[Sketch to Scale|]|Keypad|Save \+ New shot|[Map|]|Calculator|Previous field|Next field| |*Map (Zoom)*|Zoom out|Pan left|Pan right|Zoom in|Calculator|Pan up|Pan down| |*Map (Info)*|Previous series|Previous survey shot|Next survey shot|Next series|Calculator|Previous station|Next station| |*List*|Maximum scroll left|Scroll left|Scroll left|Maximum scroll right|Calculator|Scroll up|Scroll down| |*Auriga keypad*|Symbols|Accents|Alphabet^4^|Numbers|Slope Calculator^3^|Previous field|Next field| |*Sketch*|Exit|Shot Data|Toggle View|Toggle View|Calculator|\-|\-| |*Others*|Leftward tab|Keypad|\-|Rightward tab|Calculator|Previous field|Next field|

  1. Upper right button in Graffiti area
  2. The Palm 5\-way Navigator in up/down directions behaves like these buttons
  3. If the insertion point is currently in the *Slope* or *Reverse Slope* field; otherwise, pops up the application linked with this button (calculator or other)
  4. If the keypad layout is already alphabetic, pops up the Palm OS keyboard

h3.Use of silkscreen icons and hardware buttons on 2\-button devices (Palm Zire) |*Form/Key*|*Calendar*|*Contacts*|*Star (HotSync)*|*Page Up1*|*Page Down1*| |*Survey Shot*|Previous survey shot|Next survey shot|Slope Calculator^2^|Previous field|Next field| |*Survey Shot with Assistant*|Keypad|Save \+ New shot|Calculator|Previous field|Next field| |*Map (Zoom)*|Pan left|Pan right|Calculator|Pan up|Pan down| |*Map (Info)*|Previous survey shot|Next survey shot|Calculator|Previous station|Next station| |*List*|Scroll left|Scroll right|Calculator|Scroll up|Scroll down| |*Auriga keypad*|Palm OS keyboard|Rightward layout|Slope Calculator^2^|Previous field|Next field| |*Sketch*|Shot Data|Toggle View|Calculator|\-|\-| |*Others*|Keypad|Rightward tab|Calculator|Previous field|Next field|

  1. The Palm 5\-way Navigator in up/down directions behaves like these buttons
  2. If the insertion point is currently in the *Slope* or *Reverse Slope* field; otherwise, pops up the calculator

h3.Use of Sony JogDial and Palm 5\-way Navigator |*Form/Action*|*Jog Up*|*Jog Down*|*Jog Push*|*Jog Back*|*Navigator Left*|*Navigator Right*|*Navigator Select*| |*Main*|Scroll up|Scroll down|Open cave|Exit|\-|\-|\-| |*Survey Shot*|Previous field|Next field|Menu|Previous form|Previous field|Next field|Connect| |*Survey Shot with Assistant*|Previous field|Next field|Menu|Exit|Previous field|Next field|Connect| |*Session*|Previous session|Next session|Menu|Previous form|Previous field|Next field|\-| |*Map*|Previous station|Next station|Menu|Survey Shot form|Left pan|Right pan|\-| |*List*|Scroll up|Scroll down|Menu|Exit|Scroll left|Scroll right|\-| |*Auriga Keypad*|Previous field|Next field|\-|Previous form|Previous field|Next field|\-| |*Others*|Previous field|Next field|\-|Previous form|Leftward tab|Rightward tab|\-|

h3.Limits

  1. Maximum number of survey shots per cave: 16,382
  2. Maximum number of survey sessions: 16,383 minus the number of survey shots
  3. Maximum number of survey shots per survey session: 16 382
  4. Maximum number of caves on Palm OS device: only limited by memory
  5. Cave name maximum length: 26 characters
  6. Precision of survey data:
    1. 0.01 unit for length data (meter or foot); 1 inch for feet\-inches data
    2. 0.01 unit for azimuths and slopes (degree or grad); 1 minute for sexagesimal data
    3. 0.1 second or 0.001 minute for theodolite angles
    4. 0.1 unit for depths (meter or foot)
    5. 1 unit for altitudes (meter or foot)
    6. 1 cm (i.e. 2 decimals) for geodesic grid positions
    7. 0.01 second for latitude/longitude
  7. Maximum survey shot length: 655.33 units (meters or feet)
  8. Maximum passage size at station: 655.33 units (meters or feet)
  9. Depth range: \-3276.7 to 3276.6 units (meters or feet)
  10. Altitude range: \-32767 to 32766 units (meters or feet)

The *maximum number* of computable survey shots is limited by available memory (RAM), as well as the amount of this memory the OS allocates for applications use ("heap"); this depends on device model and Palm OS version. The *minimum number* of computable survey shots can be obtained with the _Limits_ item of the _Options_ menu. This estimate assumes an equal number of survey shots and stations. The maximum number of computable survey shots may be higher than the number reported if the cave has many interconnected passages, thus reducing the stations/shots ratio (and stations require almost twice as much computation memory as survey shots). This estimate does not take into consideration memory used by sessions when computing caves (networks do not require memory for sessions). If your cave has several sessions, the actual number of computable survey shots might be reduced. Moreover, this assumes that you are simply computing a cave and not displaying lists, which also require memory. If you display a list and later are unable to compute a cave, you might want to try exiting and reentering Auriga to then go straight to computing the map. Obviously, these manoeuvres are only necessary if your cave is close to the device memory limit. When computing a network, see the [Network|] tab of the [Network Details|] form for options to reduce the memory required by computations. |*Device*|*OS*|*RAM (Mb)*|*CPU (MHz)*|*Heap memory*|*Min. Cave Shots*|*Min. Network Shots*|*Min. Network "Light" Shots1*| |*Palm III*|3.0|1|4|90.9 Kb|871|897|1,525| |*Palm III*|4.1^2^|1|4|121.3 Kb|1,138|1,172|1,992| |*Palm IIIe*|3.1|2|16|122.7 Kb|1,322|1,361|2,313| |*Palm IIIx*|3.1|4|16|122.7 Kb|1,276|1,313|2,233| |*Palm IIIx*|4.1^2^|4|16|249.3 Kb|2,919|3,004|5,100| |*Palm IIIxe*|3.5\-4.1|8|16|250.0 Kb|2,957|3,044|5,176| |*Palm IIIc*|3.5|8|16|250.0 Kb|3,199|3,293|5,598| |*Palm m105*|3.5|8|16|250.0 Kb|3,016|3,104|5,278| |*Palm m125*|4.0|8|33|249.3 Kb|2,791|2,873|4,884| |*Palm m130*|4.1|8^3^|33|249,3 Kb|2,952|3,039|5,167| |*Palm Zire*|4.1|2|16|121.3 Kb|1,045|1,076|1,829| |*Palm Zire 31*|5.2|8^3^|33|1,0 Mb|13,773|14,178|24,103| |*Sony Clié S\-360*|4.1|16^4^|33|249.3 Kb|2,462|2,534|4,309| |*Sony Clié SJ\-22*|4.1|16^4^|33|1.0 Mb|13,572|13,971|23,752| |*Palm Tungsten E*|5.2|32^3^|126|2.0 Mb|28,436|29,272|49,763| |*Palm Tungsten 2*|5.2|32^3^|144|800.0 Kb|9,782|10,070|17,119| |*Palm Tungsten 3*|5.2|64^3^|400|11.0 Mb|65,545^5^|65,545^5^|65,545^5^| |*Palm TX*|5.4.9|128^3^|312|6.0 Mb|65,545^5^|65,545^5^|65,545^5^|

  1. Reached by deselecting the memory options in the [Network|] tab of the [Network Details|] form
  2. After OS upgrade
  3. Features a Secure Digital card slot
  4. Features a Memory Stick card slot
  5. Maximum number of survey shots computable by Auriga regardless of heap size

Owners of devices not listed above are invited to run the _Limits_ item of the _Options_ menu and to report the results obtained.

  • Tip:* if a cave is too large to be computed on a given device (Auriga then reports it could not allocate the graph), or if computations take too much time, it is possible to fragment the cave by exporting to another new cave only areas of current interest (as distinguished by specific sessions and/or series). After adding new survey shots to this sub\-cave, it is possible to merge this new data with the original cave by exporting the sub\-cave back into the original cave. All this can obviously be done on the PC, but also in Auriga itself, because although a large cave may not be computable on some older hardware, importing and exporting caves is still possible.

For you information, here is a [study|http://www.laubrass.com/doc/PUB/BATTERY/Battery Test for PDA.pdf] on the battery duration of various devices.

h3.Storage Each Auriga cave is stored in a distinct Palm OS database (PDB.) The cave database consists of general information about the cave, followed by shot and session records, sorted by start and end stations or session number respectively.

  1. Cave database general information is 380 bytes \+ note (1 byte/character) \+ 78 bytes for Palm OS management
  2. Survey shot records are 56 bytes \+ note (1 byte/character) \+ 8 bytes for Palm OS management
  3. Session records are 138 bytes \+ note (1 byte/character) \+ 8 bytes for Palm OS management

Thus, a cave containing 100 survey shots is at least 6 Kbytes in size.

h3.Requirements Minimum: Palm OS 3.0 or higher (runs on any Palm OS device since the Palm III) Recommended: Palm OS 3.5 or higher Uses 509 Kb of RAM.

h1.Frequently Asked Questions

  1. [Numbers cannot be entered with a comma/period decimal separator|]
  2. [Survey shots cannot be saved without inputting passage dimensions|]
  3. [When saving new survey shots, Auriga keeps asking whether to create a new survey shot or to replace the current (existing) one|]
  4. [The cave map is empty or incomplete|]
  5. [Auriga repeatedly starts with a crash|]
  6. [The screen appears lighter on a Palm IIIxe when running Auriga|]
  7. [The vertical scroll bar does not work in the List form|]
  • Numbers cannot be entered with a comma/period decimal separator*

Auriga uses the decimal separator selected in the Palm OS Prefs program

  • Survey shots cannot be saved without inputting passage dimensions*

The _Passage Dimensions_ checkbox in the _Shots_ tab of the _Sessions_ form determines whether passage dimensions are mandatory or optional

  • When saving new survey shots, Auriga keeps asking whether to create a new survey shot or to replace the current (existing) one*

The proper way to create new survey shots is to tap the _New_ (square with a star) button in the _Survey Shot_ form; this auto\-increments station names and clears other input fields. On the other hand, editing the input fields to enter a new survey shot "over" an existing one naturally prompts Auriga to ask whether to replace the current survey shot or to create a new one

  • The cave map is empty or incomplete*

An empty or incomplete cave map can be due to several causes:

  1. the current zoom ratio or pan factor puts all survey shots off screen
  2. no survey shot could be computed (try the _Re\-compute Coordinates_ item in the _Map_ menu to see what happens)
  3. the state of the _Draw_ checkbox in sessions, series or indivisual survey shots prevents survey shots from being drawn
  4. the _Line Plot_ item is unselected in the _Map Settings_ popup list (leftmost icon at the bottom of the [Map|] form)
  5. the cave contains orphan legs while the _Orphan Legs_ item is unselected in the _Map Settings_ popup list (check the _Shot Errors_ item in the _Cave_ menu to display survey shot errors)
  6. the selected default, session, series or individual survey shot colors (depending on the _Map Coloring_ option in the _Map Settings_ popup list) are invisible against the currently selected background color (black or white)
  • Auriga repeatedly starts with a crash*

When Auriga is launched, it re\-opens the cave and the form it was left in when last exited. So, if for some reason the last opened cave/network crashes Auriga, re\-starting Auriga will repeatedly crash it. This cycle can be broken by holding down the *PageUp* button while tapping on the Auriga icon; an alert will then ask whether to start Auriga without opening the previous cave/network. Select *OK*. If things still go bad, repeat the operation, but this time select the *Reset* button to reset all Auriga preferences; note that this does not affect cave\-specific settings. After that, you should report the bug to me, along with the faulty \_Cave.PDB file.

  • The screen appears lighter on a Palm IIIxe when running Auriga*

Due to a quirk in the graphic controller of some Palm IIIxe devices, when Auriga turns on the 4 bits/pixel mode to enjoy 16 shades of gray in the cave map, blacks tend to become lighter.

  • The vertical scroll bar does not work in the [List|] form*

On devices with Palm OS version prior to 3.5, vertical scroll bars did not always work. Use the *PageUp* and *PageDown* buttons instead.

Auriga Web site: [www.speleo.qc.ca/Auriga|http://www.speleo.qc.ca/Auriga]

Document last updated 2006\-12\-01
Retrieved from "http://grcavingmanual.org/el/index.php?title=Auriga&oldid=7965"