NAME

       shpadd - append a shape to an ESRI shapefile

       ##SYNOPSIS shpadd shp_file [[x y] [+]]*

       ##DESCRIPTION  Appends  a  shape  to the shapefile determined from shp_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 shp_file.shp or shp_file.SHP, and shp_file.shx or shp_file.SHX for the
       respective data and index files.

       ##OPTIONS

       shp_file
              the name of an existing shapefile.

       x1 y1 x2 y2 ... xn yn
              the set of x,y coordinates that describes the shape that you wish to add. Note that
              you  must  specify  the correct number of parameters for a given type of shapefile.
              e.g.: for point shapefiles you have to pass 1 pair of  XY  coordinates  and  for  a
              polygon  shapefile  you  should  pass at least 4 pairs of XY coordinates (where the
              first and the last point must have the same coordinates).

       ##EXAMPLE shpadd testpolygon 100000 7000000 250000 6500000 200000 6000000 100000 7000000

       assuming that testpolygon is a polygon shapefile, this command  line  will  insert  a  new
       shape (a triangle) into testpolygon with the following XY coordinates:

           vertice 0: 100000 7000000 (this will also be the vertice where the shape starts and ends)
           vertice 1: 250000 6500000
           vertice 2: 200000 6000000
           vertice 3: 100000 7000000

       ##EXIT STATUS

       0      Successful program execution.

       1      Missing shp_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:shp_file

       Out of memory

       ##AUTHOR shpadd is part of shapelib, maintained by Frank Warmerdam. This guide was created
       by Eduardo Patoo Kanegae and converted to manpage by Johan Van de Wauw.

       ##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),  dbfcat(1),  dbfcreate(1),  dbfdump(1),   dbfinfo(1),   shpcat(1),
       shpcentrd(1),  shpcreate(1),  shpdump(1),  shpdxf(1),  shpfix(1),  shpinfo(1), shpproj(1),
       shprewind(1), shptest(1)

                                           August 2024                                  SHPADD(1)