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

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd">
<HTML
><HEAD
><TITLE
>extend</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
REL="HOME"
TITLE="Survex 1.2.30 Manual"
HREF="index.htm"><LINK
REL="UP"
TITLE="Command Reference"
HREF="cmdline.htm#AEN322"><LINK
REL="PREVIOUS"
TITLE="diffpos"
HREF="diffpos.htm"><LINK
REL="NEXT"
TITLE="sorterr"
HREF="sorterr.htm"></HEAD
><BODY
CLASS="REFENTRY"
><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.30 Manual</TH
></TR
><TR
><TD
WIDTH="10%"
ALIGN="left"
VALIGN="bottom"
><A
HREF="diffpos.htm"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
></TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="sorterr.htm"
ACCESSKEY="N"
>Next</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><H1
><A
NAME="EXTEND"
></A
>extend</H1
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN570"
></A
><H2
>Name</H2
>extend&nbsp;--&nbsp;produce an extended elevation from a <TT
CLASS="FILENAME"
>.3d</TT
> file</DIV
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN574"
></A
><H2
>Synopsis</H2
><P
><B
CLASS="COMMAND"
>extend</B
>  [--survey=SURVEY] [--specfile=ESPEC_FILE] [--show-breaks] {INPUT_3D_FILE} [OUTPUT_3D_FILE]</P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN582"
></A
><H2
>Description</H2
><DIV
CLASS="NOTE"
><P
></P
><TABLE
CLASS="NOTE"
WIDTH="100%"
BORDER="0"
><TR
><TD
WIDTH="25"
ALIGN="CENTER"
VALIGN="TOP"
><IMG
SRC="note.png"
HSPACE="5"
ALT="Note"></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
><P
>The <B
CLASS="COMMAND"
>extend</B
> program can also work on
<SPAN
CLASS="APPLICATION"
>Compass</SPAN
> <TT
CLASS="FILENAME"
>.plt</TT
> (as can
<B
CLASS="COMMAND"
>aven</B
> and any other <SPAN
CLASS="APPLICATION"
>Survex</SPAN
> program which reads <TT
CLASS="FILENAME"
>.3d</TT
>
files).</P
></TD
></TR
></TABLE
></DIV
><P
>If no specfile is given, extend starts with the highest station marked
as an entrance which has at least one underground survey leg attached
to it.  If there are no such stations, the highest deadend station in
the survey (or the highest station if there are no deadends) is used.
Extend puts the first station on the left, then folds each leg out
individually to the right, breaking loops arbitrarily (usually at
junctions).</P
><P
>If the output filename is not specified, extend bases the output
filename on the input filename, but ending "_extend.3d".  For example,
<B
CLASS="COMMAND"
>extend deep_pit.3d</B
> produces an extended elevation
called <TT
CLASS="FILENAME"
>deep_pit_extend.3d</TT
>.</P
><P
>If you pass <CODE
CLASS="OPTION"
>--show-breaks</CODE
> then a leg flagged as
"surface survey" will be added between each point at which a loop has
been broken - this can be very useful for visualising the result in
aven.</P
><P
>This approach suffices for simple caves or sections of cave, but for more
complicated situations human intervention is required.  More complex
sections of cave can be handled with a specfile giving directions to
switch the direction of extension between left and right, to
explicitly specify the start station, or to break the extension at
particular stations or legs. </P
><P
>The specfile is in a format similar to cavern's data format:</P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>;This is a comment

; start the elevation at station entrance.a
*start entrance.a  ;this is a comment after a command

; start extending leftwards from station half-way-down.5
*eleft half-way-down.5

; change direction of extension at further-down.8
*eswap further-down.8

; extend right from further-down.junction, but only for
; the leg joining it to very-deep.1, other legs continuing
; as before
*eright further-down.junction  very-deep.1

; break the survey at station side-loop.4
*break side-loop.4

; break survey at station side-loop.junction but only
; for leg going to complex-loop.2
*break side-loop.junction complex-loop.2 </PRE
></TD
></TR
></TABLE
><P
>This approach requires some trial and error, but gives useful results
for many caves.  The most complex systems would benefit from an
interactive interface to select and view the breaks and switches of
direction.</P
></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="diffpos.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="sorterr.htm"
ACCESSKEY="N"
>Next</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>diffpos</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="cmdline.htm#AEN322"
ACCESSKEY="U"
>Up</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>sorterr</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>
survex 1.2.30-1 / usr / share / doc / survex / manual / extend.htm
