Man Linux: Main Page and Category List

NAME

       shpadd - append a shape to an ESRI shapefile

SYNOPSIS

       shpadd file [[x y] [+]]*

DESCRIPTION

       Appends  a  shape to the shapefile determined from file.  The geometric
       data of the new shape consists of lists of X/Y points  on  the  command
       line  grouped into parts, with points in different parts separated by a
       plus (+) sign.  If no points or parts are given then a  shape  of  type
       NullShape  is  appended to the shapefile, and otherwise the type of the
       new shape is determined by the shapefile’s header.  See shpdump(1)  for
       a  description  of  shape  types  and  how geometric data for parts are
       interpreted for a specific type.  No geometric restrictions set by  the
       shapefile specification are enforced by shpadd(1).

       Shapefiles  actually  consist  of  two files with the same basename and
       extensions .shp and .shx (or .SHP and .SHX) containing the  shape  data
       and  shape  index  respectively.   The  files to open are determined by
       first stripping any filename extension from file and attempting to open
       the  files  file.shp  or  file.SHP,  and  file.shx  or file.SHX for the
       respective data and index files.

EXIT STATUS

       0      Successful program execution.

       1      Missing file argument, the shapefile can’t  be  opened,  or  the
              program ran out of memory.

DIAGNOSTICS

       The following diagnostics may be issued on stdout:

       Unable to open:file

       Out of memory

AUTHORS

       Frank Warmerdam (warmerdam@pobox.com) is the maintainer of the shapelib
       shapefile library.  Joonas Pihlaja (jpihlaja@cc.helsinki.fi) wrote this
       man page.

BUGS

       Coordinate  values  that  can’t be be parsed by sscanf(3) get undefined
       values.  There’s no way to give measure or Z  data  to  vertices  in  a
       shape,  but  those are always set to zero if the shapefile’s shape type
       requires those values.  MultiPatch shape types aren’t supported.

SEE ALSO

       dbfadd(1),   dbfcreate(1),   dbfdump(1),   dbf_dump(1),   shpcreate(1),
       shpdump(1), shprewind(1)