.\" generated with Ronn-NG/v0.9.1
.\" http://github.com/apjanke/ronn-ng/tree/0.9.1
.TH "SHPCREATE" "1" "December 2023" "" "shplib"
.SH "NAME"
\fBshpcreate\fR \- create an empty ESRI shapefile
.SH "SYNOPSIS"
\fBshpcreate\fR \fIshp_file\fR [\fBpoint\fR|\fBarc\fR|\fBpolygon\fR|\fBmultipoint\fR]
.SH "DESCRIPTION"
Creates an empty shapefile supporting shapes of the given type\. Shapefiles actually consist of two files with the same basename and extensions \fB\.shp\fR and \fB\.shx\fR (or \fB\.SHP\fR and \fB\.SHX\fR) containing the shape data and shape index respectively\. The files to create are determined by first stripping any filename extension from \fIshp_file\fR and attempting to create the files \fIshp_file\fR\fB\.shp\fR or \fIshp_file\fR\fB\.SHP\fR, and \fIshp_file\fR\fB\.shx\fR or \fIshp_file\fR\fB\.SHX\fR for the respective data and index files\. The supported values for the \fIshapetype\fR argument are: \fBpoint\fR, \fBarc\fR, \fBpolygon\fR, and \fBmultipoint\fR\.
.SH "OPTIONS"
.TP
\fIshp_file\fR
the name of the shapefile to be created\. Doesn't need the extension
.TP
\fBpoint\fR|\fBarc\fR|\fBpolygon\fR|\fBmultipoint\fR
the type of shapefile that you wish to create\. Must specify a valid option\.
.SH "EXAMPLE"
\fBshpcreate\fR \fItestpolygon\fR \fBpolygon\fR
.P
this will create a polygon shapefile named testpolygon (in fact \fItestpolygon\fR\fB\.shp\fR and \fItestpolygon\fR\fB\.shx\fR will be created)\.
.SH "EXIT STATUS"
.TP
\fB0\fR
Successful program execution\.
.TP
\fB1\fR
Missing \fIshp_file\fR or \fIshapetype\fR argument\.
.TP
\fB2\fR
Unknown shapetype\.
.TP
\fB3\fR
Unable to create the shapefile\.
.SH "DIAGNOSTICS"
The following diagnostics may be issued on stdout:
.P
Shape Type `\fIshapetype\fR' not recognised\.
.P
Unable to create:\fIshp_file\fR
.SH "AUTHOR"
\fBdbfdump\fR 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\. It was further enhanced with the man page written by Joonas Pihlaja (jpihlaja@cc\.helsinki\.fi)\.
.SH "SEE ALSO"
\fBdbfadd\fR(1), \fBdbfcat\fR(1), \fBdbfcreate\fR(1), \fBdbfdump\fR(1), \fBdbfinfo\fR(1), \fBshpadd\fR(1), \fBshpcat\fR(1), \fBshpcentrd\fR(1), \fBshpdump\fR(1), \fBshpdxf\fR(1), \fBshpfix\fR(1), \fBshpinfo\fR(1), \fBshpproj\fR(1), \fBshprewind\fR(1), \fBshptest\fR(1)