shpadd

Langue: en

Version: OCTOBER 2004 (debian - 07/07/09)

Section: 1 (Commandes utilisateur)

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)