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)

shapelib                                          OCTOBER 2004                                       SHAPELIB(1)