ANNOUNCE: v.in.dxf3d

[Evaristo QUIROGA]

Hello GRASS Users:

As I promised to Gareth 2 weeks ago, I have sended today to
the "moon incoming" the first version of the command "v.in.dxf3d"
and the shell "v.in.dxf3d.sh".

The program imports the Z coordinate values of the POLYLINEs
(contour and isolines types) of DXF files to the dig_att file. 
It must be executed in conjunction with "v.in.dxf" an "v.support",
for this reason I writed a script that runs all these programs.

I adjoint the man pages of the programs at the bottom of the mail.

This programs have been tested in AIX and Linux platform, and run
perfectly.

Please send me any comments or bugs.

                Enjoy,


                                Evaristo.

------------------------------------------------------------------------
       __                                                      __
      / /          Evaristo QUIROGA RAIMUNDEZ                 / /
  ___/ /                                                  ___/ /
 /    /                                                  /    /
/    /          UNIVERSIDAD AUTONOMA DE BARCELONA       /    /
\__/\\    Gabinete de Analisis Territorial y Ambiental  \__/\\
     \\__ Unidad de Geodinamica Externa y Hidrogeologia      \\__
     /  /\                 Edificio CS                       /  /\
     \ / /\       08193 - Bellaterra (BARCELONA)             \ / /\
      \ /  \               SPAIN                              \ /  \
       \___/        email: evaristo at cataw.uab.es               \___/
------------------------------------------------------------------------


=================================================================

v.in.dxf3d <contrib>  GRASS Reference Manual <contrib> v.in.dxf3d



NAME
     Iv.in.dxf3dR - Converts the Z values of DXF files to
     attribute GRASS vector file format.
     (GRASS Vector Program)

SYNOPSIS
     Bv.in.dxf3dR
     Bv.in.dxf3d helpR
     v.in.dxf3d dxf=name [lines=name[,name,...]]

DESCRIPTION
     The v.in.dxf3d data conversion program generates GRASS
     dig_att files from a DXF file with Z values.

     This program, in conjunction with v.in.dxf, is ideal for
     automaticaly importing, to GRASS vector file, layers with Z
     values (isolines and level contours) from DXF format files.

     Firts should be run the v.in.dxf program for import the DXF
     polylines to binary GRASS vector file format (dig). Later,
     the DXF Z values of the isolines layers with v.in.dxf3d
     (dig_att) must be imported, and finally run v.support to
     attach at this layers their elevations.  The v.in.dxf3d.sh
     script can be used to make all this automaticaly, for a
     maximun of two isolines layers (normally contours and master
     contours) from one DXF file.

     The v.in.dxf program only recognizes, by now, the Z values
     from polylines entities in the DXF format.


COMMAND LINE OPTIONS
     Parameters

     dxf  Name of the DXF input design file from where will be
          extracted the Z values.

     lines
          Name(s) of layer(s) in DXF input file containing
          isoline data with Z values, and the name(s) to be
          assigned to the GRASS vector data (dig_att) files
          output.


BUGS
     The program only recognizes the Z values if they are in the
     "30" field of the POLYLINE entity section.

     If the input DXF file is in MS-DOS text format, with CR/LF
     instead of Unix LF, the program doesn't run. To avoid this
     problem, import to Unix your DXF-MSDOS format files with FTP
     in ascii mode or with a command able to convert this files



GRASS 4.1                 U.S. Army CERL                        1






v.in.dxf3d <contrib>  GRASS Reference Manual <contrib> v.in.dxf3d



     (DOS-COPY, mcopy, etc).


SEE ALSO
     v.in.dxf, v.support, v.digit, v.in.dxf3d.sh


AUTHOR
     The original program dxf3d2gras.bas written in GWBASIC (MS-
     DOS) by Evaristo Quiroga, Hidrologic and Extern Geodinamic
     Unity of the University Autonoma of Barcelona (6/93).

     The program was rewritted in C for Grass-Unix environment by
     Evaristo Quiroga, Environmental and Territorial Analisis
     Center, UAB (12/95).

NOTICE
     This program is part of the contrib section of the GRASS
     distribution.  As such, it is externally contributed code
     that has not been examined or tested by the Office of GRASS
     Integration.

GRASS 4.1                 U.S. Army CERL                        2

===============================================================


v.in.dxf3d.sh <scriptsGRASS Reference Manu<scripts> v.in.dxf3d.sh



NAME
     Iv.in.dxf3d.sh R - Imports contour levels and master contour
     levels in DXF file format to GRASS vector file format.
     (GRASS Vector Program)

SYNOPSIS
     v.in.dxf3d.sh dxf=name lines=name,name

DESCRIPTION
     The v.in.dxf3d.sh data conversion program generates GRASS
     vector files from a DXF file with contour levels and master
     contour levels layers with Z values.

     This shell run successively the programs v.in.dxf,
     v.in.dxf3d and v.support for both specified layers.



COMMAND LINE OPTIONS
     Parameters

     dxf  Name of the DXF input design file to be converted to
          GRASS vector format.

     lines
          Name(s) of layer(s) in DXF input file containing  the
          contour levels and master contour levels with Z values,
          and the mane(s) to be assigned to the GRASS vector
          files output.


SEE ALSO
     v.in.dxf, v.in.dxf3d, v.support, v.digit


AUTHOR
     The shell was writted by Evaristo Quiroga, Environmental and
     Territorial Analisis Center, UAB (12/95).


GRASS 4.1                 U.S. Army CERL                        1