NAME

       aven - sophisticated cave viewer

SYNOPSIS

          aven [--survey=SURVEY] [--print] SURVEY_FILE

DESCRIPTION

       Aven displays processed cave surveys in a window and allows you to manipulate the view.

       If  SURVEY_FILE  is an unprocessed survey data format which cavern can process, then aven will run cavern
       on it, and if successful, display the processed data.  If there are any warnings and errors, it will show
       a log window with the output with clickable links to open the affected file at the problematic line.

       SURVEY_FILE  can  also  be  processed survey data - a Survex .3d file, a Compass .plt file or a CMAP .sht
       file.  It can also be a Survex .pos file or a CMP .una or .adj file, but  for  these  only  stations  are
       shown,  not  any  legs (for .pos this is because the format only records station positions).  (All Survex
       programs which read .3d files can also transparently handle these formats.)

   On-Screen Indicators
       There is an auto-resizing scale bar along the bottom of the screen which varies in length as you zoom  in
       or  out.   You can left-button drag on this to zoom, and right click gives a menu to select units or hide
       the scale bar (to get it back go to the Control->Indicators menu from the menu bar).

       In the lower right corner is a compass indicator showing which way is North.  You can drag this to rotate
       the  view;  if  while  dragging  you  move the mouse outside the compass the view snaps to 45° positions:
       N/NE/E/SE/S/SW/W/NW.  Right click gives menu to change the view to N/S/E/W, select  units,  or  hide  the
       compass (to get it back go to the Control->Indicators menu from the menu bar).

       Just  to the left of the compass is clino indicator showing the angle of tilt.  You can drag this to tilt
       the view; if while dragging you move the mouse outside  the  clino  the  view  snaps  to  90°  positions:
       plan/elevation/inverted plan.  Right click gives menu to change the view to plan/elevation, select units,
       or hide the clino (to get it back go to the Control->Indicators menu from the menu bar).

       In the upper right is a colour key showing the correspondence between colour and depth (by default -  you
       can  also colour by other criteria).  Right click gives a menu to choose what to colour by, select units,
       or hide the colour key (to get it back go to the Control->Indicators menu from the menu bar).

   Mouse Control
       Using the mouse to move the cave will probably feel most natural.  We suggest you try each of  these  out
       after reading this section to get a feel for how they work.

       If  you hold down the right button then the view is panned when you move the mouse - it effectively feels
       like you are dragging the cave around.

       If you hold down the left button, then the view is rotated as you move left or right, and zoomed  as  you
       move  up  and  down.  If you hold down Ctrl while dragging with the left mouse button, then moving up and
       down instead tilts the view.  Tilt goes 180 degrees from plan view through elevation view to a view  from
       directly  below  (upside  down  plan)  -  aven deliberately doesn't allow going beyond horizontal into an
       inverted view.

       If your mouse has a middle button then holding it down and moving the mouse up and down tilts  the  cave.
       Moving the mouse left and right has no effect.

       And if you have a scrollwheel, this can be used to zoom in/out.

       By  default  the  mouse  moves  the cave, but if you press Ctrl-R, then the mouse will move the viewpoint
       instead (i.e. everything will go in the opposite direction).  Apparently this feels more natural to  some
       people.

   Keyboard Control
       As with mouse controls, a little experimentation should give a better understanding of how these work.

       All  keyboard  shortcuts  have  a corresponding menu items which should show the keyboard shortcut - this
       provides a way within the application to see the keyboard shortcut for a particular action.

       Delete is useful if you get lost!  It resets the scale, position, and rotation speed, so  that  the  cave
       returns to the centre of the screen.  There are also keyboard controls to use

       P  and  L select Plan and eLevation respectively.  Changing between plan to elevation is animated to help
       you see where you are and how things relate.  This animation is automatically disabled on  slow  machines
       to  avoid user frustration.  You can force skipping the animation by pressing the key again during it, so
       a double press will always take you there quickly.

       Space toggles on and off automatic rotation about a vertical axis through the current centre point (which
       is  moved  by  panning  the  view  or  by  selecting  a  station  or survey).  R toggles the direction of
       auto-rotation.  The speed of auto-rotation can be controlled by Z and X.

       Crosses and/or labels can be displayed at survey stations.  Ctrl-X toggles  crosses  and  Ctrl-N  station
       names.  Ctrl-L toggles the display of survey legs and Ctrl-F of surface survey legs.

       Ctrl-G toggles display of an auto-sizing grid.

       Ctrl-B toggles display of a bounding box.

       O  toggles  display  of  non-overlapping/all names.  For a large survey turning on overlapping names will
       make update rather slow.

       Holding down Shift accelerates all the following movement keys:

       The cursor keys pan the survey view (like dragging with the right mouse button).

       Ctrl plus cursor keys rotate and tilt (like the mouse left button with Ctrl held down).  C/V do the  same
       as Ctrl plus cursor left/right, while Apostrophe ', and Slash / do the same as Ctrl plus cursor up/down.

       [ and ] zoom out and in respectively.

OPTIONS

       -p, --print
              Load the specified file, open the print dialog to allow printing, then exit.

       -s, --survey=SURVEY
              Only load the sub-survey SURVEY.

       --help display short help and exit

       --version
              output version information and exit

SEE ALSO

       cavern(1), diffpos(1), dump3d(1), extend(1), sorterr(1), survexport(1)

COPYRIGHT

       1998-2024

                                                  Aug 14, 2024                                           AVEN(1)