/usr/share/doc/survex/manual/getstart.htm

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd">
<HTML
><HEAD
><TITLE
>Getting Started</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
REL="HOME"
TITLE="Survex 1.2.11 Manual"
HREF="index.htm"><LINK
REL="PREVIOUS"
TITLE="Survex 1.2.11 Manual"
HREF="index.htm"><LINK
REL="NEXT"
TITLE="Survex Programs"
HREF="cmdline.htm"></HEAD
><BODY
CLASS="SECT1"
><DIV
CLASS="NAVHEADER"
><TABLE
SUMMARY="Header navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TH
COLSPAN="3"
ALIGN="center"
><SPAN
CLASS="APPLICATION"
>Survex</SPAN
> 1.2.11 Manual</TH
></TR
><TR
><TD
WIDTH="10%"
ALIGN="left"
VALIGN="bottom"
><A
HREF="index.htm"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
></TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="cmdline.htm"
ACCESSKEY="N"
>Next</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><DIV
CLASS="SECT1"
><H1
CLASS="SECT1"
><A
NAME="AEN81"
>Getting Started</A
></H1
><P
>This section covers how to obtain the software, and how to unpack and
install it, and how to configure it.</P
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="AEN84"
>Obtaining <SPAN
CLASS="APPLICATION"
>Survex</SPAN
></A
></H2
><P
>The latest version is available from the <SPAN
CLASS="APPLICATION"
>Survex</SPAN
> website:
<A
HREF="http://survex.com/"
TARGET="_top"
>http://survex.com/</A
>. If you do not
have internet access or would prefer to get a copy by post, we are
also happy to send out up-to-date copies on a floppy on receipt of
a stamped, self-addressed envelope. See the end of this
document for addresses.</P
><P
>There's also a CD containing versions of <SPAN
CLASS="APPLICATION"
>Survex</SPAN
> for every supported
platform.  You can download an image for this from the website, or we'll
send you a copy on a CD-R if you send us money to cover the costs.</P
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="AEN92"
>Installing <SPAN
CLASS="APPLICATION"
>Survex</SPAN
></A
></H2
><P
>The details of installation depend greatly on what platform you
are using, so there is a separate section below for each platform.</P
><DIV
CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="AEN96"
>Linux</A
></H3
><P
>We supply pre-compiled versions for x86 Linux machines in RPM format
(suitable for Redhat, Mandrake, and some other distributions).
Survex Debian packages are available from Debian mirror sites in
the usual way.</P
><P
>You'll need root access to install these prebuilt packages.
If you don't have root access you will need to build from source
(see the next section).</P
></DIV
><DIV
CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="AEN100"
>Other versions of UNIX</A
></H3
><P
>For other UNIX versions you'll need to get the source code
and compile it on your system.  Unpack the sources and read
the file called INSTALL in the top level for details about building
from source.</P
></DIV
><DIV
CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="AEN103"
>Microsoft Windows 95/NT and successors</A
></H3
><P
>This version comes packaged with an installation wizard.  Just
run the downloaded package and it will lead you through the
installation process.  If installing on MS Windows NT, 2000, XP, or newer
we recommend you run the installer as administrator (or as a
user with administrator rights) so that the file associations
can be set up for all users.</P
><P
>The survey viewer that's part of <SPAN
CLASS="APPLICATION"
>Survex</SPAN
> is called aven, and uses OpenGL
for 3d rendering.
OpenGL comes as standard as of Windows 98, and was included in the
OSR2 update to Windows 95.  It's also possible that you've installed
OpenGL with another application already (especially a 3D game like Quake).
If you can view a survey in aven, all is well.  Otherwise you can
<A
HREF="http://support.microsoft.com/default.aspx?scid=kb;EN-US;q154877 "
TARGET="_top"
>download OpenGL drivers from Microsoft's website</A
> (or here's
a <A
HREF="http://download.microsoft.com/download/win95upg/info/1/W95/EN-US/Opengl95.exe"
TARGET="_top"
>direct link to the file you actually need</A
>).</P
><P
>If you find that 3D rendering is sometimes very slow (e.g. one user reported
very slow performance when running full screen, while running in a window
was fine) then try installing the OpenGL driver supplied by the manufacturer
of your graphics card rather than the driver Microsoft supply.</P
><P
>The installer creates a Survex group in the Programs sub-menu of the
Start menu containing the following items:</P
><P
></P
><UL
><LI
><P
>Aven</P
></LI
><LI
><P
>Documentation</P
></LI
><LI
><P
>Uninstall Survex</P
></LI
></UL
><P
>Icons are installed for <TT
CLASS="FILENAME"
>.svx</TT
>, <TT
CLASS="FILENAME"
>.3d</TT
>, <TT
CLASS="FILENAME"
>.err</TT
>, and <TT
CLASS="FILENAME"
>.pos</TT
> files, and also for
Compass Plot files (<TT
CLASS="FILENAME"
>.plt</TT
> and <TT
CLASS="FILENAME"
>.plf</TT
>)
(which Survex can read). 
Double-clicking on a <TT
CLASS="FILENAME"
>.svx</TT
> file loads it for editing.  To process it to
produce a <TT
CLASS="FILENAME"
>.3d</TT
> file, right click and choose "Process" from the menu.
Double-clicking the resultant <TT
CLASS="FILENAME"
>.3d</TT
> file views it in aven.
All the <SPAN
CLASS="APPLICATION"
>Survex</SPAN
> file types can be right clicked on to give a menu of
possible actions.  </P
><P
></P
><DIV
CLASS="VARIABLELIST"
><DL
><DT
><TT
CLASS="FILENAME"
>.svx</TT
></DT
><DD
><P
></P
><DIV
CLASS="VARIABLELIST"
><DL
><DT
>Open</DT
><DD
><P
>  Load file into SvxEdit
  </P
></DD
><DT
>Process</DT
><DD
><P
>  Process file with cavern to produce <TT
CLASS="FILENAME"
>.3d</TT
> file (and <TT
CLASS="FILENAME"
>.err</TT
> file)
  </P
></DD
></DL
></DIV
></DD
><DT
><TT
CLASS="FILENAME"
>.3d</TT
></DT
><DD
><P
></P
><DIV
CLASS="VARIABLELIST"
><DL
><DT
>Open</DT
><DD
><P
>  Load file into Aven
  </P
></DD
><DT
>Print</DT
><DD
><P
>  Send to the printer
  </P
></DD
><DT
>Extend</DT
><DD
><P
>  Produce extended elevation
  </P
></DD
><DT
>Convert to DXF</DT
><DD
><P
>  Convert to a DXF file (suitable for importing into many CAD packages)
  </P
></DD
><DT
>Convert for hand plotting</DT
><DD
><P
>  Produce a <TT
CLASS="FILENAME"
>.pos</TT
> file listing all the stations and their coordinates
  </P
></DD
></DL
></DIV
></DD
><DT
><TT
CLASS="FILENAME"
>.err</TT
></DT
><DD
><P
></P
><DIV
CLASS="VARIABLELIST"
><DL
><DT
>Open</DT
><DD
><P
>  Load file into Notepad
  </P
></DD
><DT
>Sort by Error</DT
><DD
><P
>  Sort <TT
CLASS="FILENAME"
>.err</TT
> file by the error in each traverse
  </P
></DD
><DT
>Sort by Horizontal Error</DT
><DD
><P
>  Sort <TT
CLASS="FILENAME"
>.err</TT
> file by the horizontal error in each traverse
  </P
></DD
><DT
>Sort by Vertical Error</DT
><DD
><P
>  Sort <TT
CLASS="FILENAME"
>.err</TT
> file by the vertical error in each traverse
  </P
></DD
><DT
>Sort by Percentage Error</DT
><DD
><P
>  Sort <TT
CLASS="FILENAME"
>.err</TT
> file by the percentage error in each traverse
  </P
></DD
><DT
>Sort by Error per Leg</DT
><DD
><P
>  Sort <TT
CLASS="FILENAME"
>.err</TT
> file by the error per leg in each traverse
  </P
></DD
></DL
></DIV
></DD
></DL
></DIV
></DIV
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="AEN206"
>Configuration</A
></H2
><DIV
CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="AEN208"
>Selecting Your Preferred Language</A
></H3
><P
>Survex has extensive internationalisation capabilities.  The
language used for messages from Survex and most of the library calls
it uses can be changed.  By default this is picked up from the
language the operating system is set to use (from "Regional Settings"
in Control Panel on Microsoft Windows, from the
<SPAN
CLASS="SYSTEMITEM"
>LANG</SPAN
> environment variable on UNIX
If no setting
is found, or <SPAN
CLASS="APPLICATION"
>Survex</SPAN
> hasn't been translated into the
requested language, UK English is used.</P
><P
>However you may want to override the language manually -
for example if Survex isn't available in your native language
you'll want to choose the supported language you understand best.</P
><P
>To do this, you set the
<SPAN
CLASS="SYSTEMITEM"
>SURVEXLANG</SPAN
> environment variable.  Here's a list
of the codes currently supported:</P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><A
NAME="AEN216"
></A
><TABLE
BORDER="1"
FRAME="border"
CLASS="CALSTABLE"
><COL><COL><THEAD
><TR
><TH
>Code</TH
><TH
>Language</TH
></TR
></THEAD
><TBODY
><TR
><TD
>en</TD
><TD
>International English</TD
></TR
><TR
><TD
>en_US</TD
><TD
>US English</TD
></TR
><TR
><TD
>ca</TD
><TD
>Catalan</TD
></TR
><TR
><TD
>de</TD
><TD
>German</TD
></TR
><TR
><TD
>de_CH</TD
><TD
>Swiss German</TD
></TR
><TR
><TD
>de_DE</TD
><TD
>German German</TD
></TR
><TR
><TD
>es</TD
><TD
>Spanish</TD
></TR
><TR
><TD
>fr</TD
><TD
>French</TD
></TR
><TR
><TD
>it</TD
><TD
>Italian</TD
></TR
><TR
><TD
>pt</TD
><TD
>Portuguese</TD
></TR
><TR
><TD
>pt_BR</TD
><TD
>Brazillian Portuguese</TD
></TR
><TR
><TD
>sk</TD
><TD
>Slovak</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
><P
>Here are examples of how to set this environment variable to give
messages in French (language code fr):</P
><P
></P
><DIV
CLASS="VARIABLELIST"
><DL
><DT
>Microsoft Windows</DT
><DD
><P
>For MS Windows 95 and 98 (and probably ME), you'll need to add a line
containing <B
CLASS="COMMAND"
>SET SURVEXLANG=fr</B
> to your
<TT
CLASS="FILENAME"
>AUTOEXEC.BAT</TT
> script.  You need to
reboot for the change to take effect.</P
><P
>For MS Windows NT4, 2000, and XP, you should proceed as follows
(this description is written from MS Windows 2000 - it should be similar on
NT4 and XP): Open the Start Menu, navigate to the Settings sub-menu, and
open Control Panel.  Open System (picture of a computer) and click on the
Advanced tab.  Choose `Environmental Variables', and create a new one: name
<SPAN
CLASS="SYSTEMITEM"
>SURVEXLANG</SPAN
>, value <SPAN
CLASS="SYSTEMITEM"
>fr</SPAN
>.
Click OK and the new value should be effective immediately.
   </P
></DD
><DT
>UNIX - csh/tcsh</DT
><DD
><P
><KBD
CLASS="USERINPUT"
>setenv SURVEXLANG fr</KBD
></P
></DD
><DT
>UNIX - sh/bash</DT
><DD
><P
><KBD
CLASS="USERINPUT"
>SURVEXLANG=fr ; export SURVEXLANG</KBD
></P
></DD
></DL
></DIV
><P
>If <SPAN
CLASS="APPLICATION"
>Survex</SPAN
> isn't available in your language, you could
help out by providing a translation.  The initial translation is
likely to be about a day's work; after that translations for
new or changed messages are occasionally required.  Contact us for details
if you're interested.</P
></DIV
><DIV
CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="AEN282"
>Configuring the Printer Drivers</A
></H3
><DIV
CLASS="TOC"
><DL
><DT
><B
>Table of Contents</B
></DT
><DT
><A
HREF="print.ini.htm"
>print.ini</A
>&nbsp;--&nbsp;survex printer settings</DT
></DL
></DIV
><P
>Printing is now built into aven.
The print.ini configuration file still exists, but is only
useful if you want to configure the colours used if you
have a colour printer.</P
></DIV
></DIV
></DIV
><DIV
CLASS="NAVFOOTER"
><HR
ALIGN="LEFT"
WIDTH="100%"><TABLE
SUMMARY="Footer navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
><A
HREF="index.htm"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="index.htm"
ACCESSKEY="H"
>Home</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
><A
HREF="cmdline.htm"
ACCESSKEY="N"
>Next</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
><SPAN
CLASS="APPLICATION"
>Survex</SPAN
> 1.2.11 Manual</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
>&nbsp;</TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>Survex Programs</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>
survex 1.2.11-1 / usr / share / doc / survex / manual / getstart.htm
