RubyGems - shp - Versions diffs - 0.0.1 - Mend

shp 0.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (78) hide show

checksums.yaml +15 -0
data/.gitignore +34 -0
data/.travis.yml +4 -0
data/Gemfile +3 -0
data/LICENSE +28 -0
data/README.md +30 -0
data/Rakefile +23 -0
data/ext/shp/base.hpp +113 -0
data/ext/shp/dbf.cpp +381 -0
data/ext/shp/dbf.hpp +44 -0
data/ext/shp/extconf.rb +13 -0
data/ext/shp/shape_object.cpp +58 -0
data/ext/shp/shape_object.hpp +27 -0
data/ext/shp/shapefile.cpp +299 -0
data/ext/shp/shapefile.hpp +35 -0
data/ext/shp/shapelib/.cvsignore +15 -0
data/ext/shp/shapelib/ChangeLog +450 -0
data/ext/shp/shapelib/HOWTO-RELEASE +16 -0
data/ext/shp/shapelib/LICENSE.LGPL +483 -0
data/ext/shp/shapelib/Makefile +113 -0
data/ext/shp/shapelib/README +41 -0
data/ext/shp/shapelib/README.tree +172 -0
data/ext/shp/shapelib/contrib/.cvsignore +12 -0
data/ext/shp/shapelib/contrib/Makefile +66 -0
data/ext/shp/shapelib/contrib/ShapeFileII.pas +234 -0
data/ext/shp/shapelib/contrib/Shape_PointInPoly.cpp +238 -0
data/ext/shp/shapelib/contrib/Shape_PointInPoly_README.txt +59 -0
data/ext/shp/shapelib/contrib/csv2shp.c +558 -0
data/ext/shp/shapelib/contrib/dbfcat.c +166 -0
data/ext/shp/shapelib/contrib/dbfinfo.c +106 -0
data/ext/shp/shapelib/contrib/makefile.vc +34 -0
data/ext/shp/shapelib/contrib/my_nan.h +46 -0
data/ext/shp/shapelib/contrib/shpcat.c +100 -0
data/ext/shp/shapelib/contrib/shpcentrd.c +159 -0
data/ext/shp/shapelib/contrib/shpdata.c +129 -0
data/ext/shp/shapelib/contrib/shpdxf.c +340 -0
data/ext/shp/shapelib/contrib/shpfix.c +110 -0
data/ext/shp/shapelib/contrib/shpgeo.c +1595 -0
data/ext/shp/shapelib/contrib/shpgeo.h +154 -0
data/ext/shp/shapelib/contrib/shpinfo.c +113 -0
data/ext/shp/shapelib/contrib/shpproj.c +260 -0
data/ext/shp/shapelib/contrib/shpsort.c +605 -0
data/ext/shp/shapelib/contrib/shpsort.txt +44 -0
data/ext/shp/shapelib/contrib/shpwkb.c +123 -0
data/ext/shp/shapelib/contrib/tests/shpproj.sh +38 -0
data/ext/shp/shapelib/dbfopen.c +2221 -0
data/ext/shp/shapelib/makefile.vc +86 -0
data/ext/shp/shapelib/makeshape.sh +21 -0
data/ext/shp/shapelib/mkdist.sh +37 -0
data/ext/shp/shapelib/mkinstalldirs +38 -0
data/ext/shp/shapelib/mkrelease.sh +55 -0
data/ext/shp/shapelib/safileio.c +286 -0
data/ext/shp/shapelib/shapefil.h +647 -0
data/ext/shp/shapelib/shapelib.def +46 -0
data/ext/shp/shapelib/shpopen.c +2388 -0
data/ext/shp/shapelib/shptree.c +1187 -0
data/ext/shp/shapelib/shputils.c +1072 -0
data/ext/shp/shapelib/stream1.out +1465 -0
data/ext/shp/shapelib/stream1.sh +28 -0
data/ext/shp/shapelib/stream2.out +530 -0
data/ext/shp/shapelib/stream2.sh +11 -0
data/ext/shp/shapelib/stream3.out +37 -0
data/ext/shp/shapelib/web/.cvsignore +2 -0
data/ext/shp/shapelib/web/codepage.html +403 -0
data/ext/shp/shapelib/web/dbf_api.html +436 -0
data/ext/shp/shapelib/web/index.html +235 -0
data/ext/shp/shapelib/web/license.html +78 -0
data/ext/shp/shapelib/web/manifest.html +87 -0
data/ext/shp/shapelib/web/release.html +80 -0
data/ext/shp/shapelib/web/shapelib-tools.html +352 -0
data/ext/shp/shapelib/web/shp_api.html +376 -0
data/ext/shp/shp.cpp +19 -0
data/ext/shp/shp.hpp +47 -0
data/lib/shp.rb +35 -0
data/lib/shp/version.rb +3 -0
data/shp.gemspec +23 -0
data/spec/shp_spec.rb +127 -0
metadata +176 -0

data/ext/shp/shapelib/web/license.html ADDED Viewed

@@ -0,0 +1,78 @@
+<html>
+<head>
+<title>Shapelib License</title>
+<link href="http://www.maptools.org/maptools.css" rel="stylesheet" type="text/css">
+</head>
+<body>
+<h1>License</h1>
+The source for the Shapefile C Library is (c) 1998 Frank Warmerdam,
+and released under the following conditions.  The intent is that anyone
+can do anything with the code, but that I do not assume any liability, nor
+express any warranty for this code.  <p>
+As of Shapelib 1.2.6 the core portions of the library are made available
+under two possible licenses.  The licensee can choose to use the code
+under either the Library GNU Public License (LGPL) described in
+LICENSE.LGPL or under the following MIT style license.  Any files in
+the Shapelib distribution without explicit copyright license terms
+(such as this documentation, the Makefile and so forth) should be
+considered to have the following licensing terms.  Some auxilary portions
+of Shapelib, notably some of the components in the contrib directory
+come under slightly different license restrictions.  Check the source
+files that you are actually using for conditions.<p>
+<h3>Default License Terms</h3>
+<quote>
+Copyright (c) 1999, Frank Warmerdam<p>
+This software is available under the following "MIT Style" license,
+or at the option of the licensee under the LGPL (see LICENSE.LGPL).  This
+option is discussed in more detail in shapelib.html.<p>
+Permission is hereby granted, free of charge, to any person obtaining a
+copy of this software and associated documentation files (the "Software"),
+to deal in the Software without restriction, including without limitation
+the rights to use, copy, modify, merge, publish, distribute, sublicense,
+and/or sell copies of the Software, and to permit persons to whom the
+Software is furnished to do so, subject to the following conditions:<p>
+The above copyright notice and this permission notice shall be included
+in all copies or substantial portions of the Software.<p>
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
+OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
+THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
+DEALINGS IN THE SOFTWARE.<p>
+</quote>
+<h3>Shapelib Modifications</h3>
+I am pleased to receive bug fixes, and improvements for Shapelib.  Unless
+the submissions indicate otherwise I will assume that changes submitted to
+me remain under the the above "dual license" terms.  If changes are made
+to the library with the intention that those changes should be protected by
+the LGPL then I should be informed upon submission.  Note that I will not
+generally incorporate changes into the core of Shapelib that are protected
+under the LGPL as this would effectively limit the whole file and
+distribution to LGPL terms.<p>
+<h3>Opting for LGPL</h3>
+For licensee's opting to use Shapelib under LGPL as opposed to the MIT
+Style license above, and wishing to redistribute the software based on
+Shapelib, I would ask that all "dual license" modules be updated to
+indicate that only the LGPL (and not the MIT Style license) applies.  This
+action represents opting for the LGPL, and thereafter LGPL terms apply to
+any redistribution and modification of the affected modules.<p>
+</body>
+</html>

data/ext/shp/shapelib/web/manifest.html ADDED Viewed

@@ -0,0 +1,87 @@
+<html>
+<head>
+<title>Shapefile C Library V1.2</title>
+<link href="http://www.maptools.org/maptools.css" rel="stylesheet" type="text/css">
+</head>
+<body>
+<h1>Shapelib Manifest</h1>
+<ul>
+<li> <b>web/index.html</b>: This file - general documentation on the
+Shapefile C Library.<p>
+<li> <b><a href="shp_api.html">web/shp_api.html</a></b>: Documentation
+for the API for accessing the .shp/.shx files. <p>
+<li> <b><a href="dbf_api.html">web/dbf_api.html</a></b>: Documentation
+for the API for accessing the .dbf attribute files. <p>
+<li> <b>shpopen.c</b>: C code for access to .shp/.shx vertex files.<p>
+<li> <b>dbfopen.c</b>: C code for access to .dbf attribute file.<p>
+<li> <b>shapefil.h</b>:  Include file defining all the services of dbfopen.c
+and shpopen.c.<p>
+<li> <b>contrib/</b>: A directory of "in progress" contributed programs
+from Carl Anderson.<p>
+<li> <b>dbfcreate.c</b>: Simple example program for creating a new .dbf file.
+     <p>
+<li> <b>dbfadd.c</b>:
+	Simple example program for adding a record to a .dbf file.<p>
+<li> <b>dbfdump.c</b>: Simple example program for displaying the contents of
+		  a .dbf file.<p>
+<li> <b>shpcreate.c</b>: Simple example program for creating a new .shp and
+.shx file.<p>
+<li> <b>shpadd.c</b>: Simple example program for adding a shape to an existing
+		  shape file.<p>
+<li> <b>shpdump.c</b>: Simple program for dumping all the vertices in a
+		shapefile with an indicating of the parts.<p>
+<li> <b>shputils.c</b>: Complex contributed program capable of clipping and
+		  appending
+                  shapefiles as well as a few other things.  Type shputils
+                  after building to get a full usage message.<p>
+<li> <b>Makefile</b>: A simple makefile to compile the library and example
+		  programs.<p>
+<li> <b>makeshape.sh</b>: A simple script for running some of the example
+programs.<p>
+<li> <b>shptest.c</b>: A simple test harnass to generate each of the supported
+		  types of shapefiles. <p>
+<li> <b>shptree.c</b>: Implements a simple quadtree algorithm for fast
+spatial searches of shapefiles.<p>
+<li> <b>shptreedump.c</b>: A simple mainly showing information on quad
+trees build using the quad tree api.<p>
+<li> <b>stream1.sh</b> - A test script, which should produce stream1.out.
+Note this will only work if you have the example data downloaded.<p>
+<li> <b>stream1.out</b>: Expected output of stream1.sh test script.<p>
+<li> <b>stream2.sh</b>: A test script, which should produce stream2.out.<p>
+<li> <b>stream2.out</b>: Expected output of stream2.sh test script.<p>
+<li> <b>pyshapelib-0.1</b>: Prototype contributed Python bindings.<p>
+</ul>
+</body>
+</html>

data/ext/shp/shapelib/web/release.html ADDED Viewed

@@ -0,0 +1,80 @@
+<html>
+<head>
+<title>Shapelib Release Notes</title>
+<link href="http://www.maptools.org/maptools.css" rel="stylesheet" type="text/css">
+</head>
+<body>
+<h1>Shapelib Release Notes</h1>
+To get notification of new releases of Shapelib <i>subscribe</i> to
+the project at www.freshmeat.net.  This is currently the only reliable
+way of finding out about new releases since there is no shapelib specific
+mailing list.<p>
+<b>Release 1.3.0</b>:
+<ul>
+<li> Major rework to us application provided hooks for file io, and error reporting (SAHooks).
+<li> Added contrib/Shape_PointInPoly.cpp from Marko Podgorsek.
+<li> Added shapelib tools documentation from Eduardo Patto Kanegae.
+<li> Added dbf deletion support.
+<li> Added DBFAddNativeFieldType().
+<li> Added DBFDeleteField(), DBFReorderFields() and DBFAlterFields() to
+rework DBF schema.
+<li> likely a variety of other changes - it has been eight years since 1.2.10!
+</ul>
+<b>Release 1.2.10</b>: Added SHPRewindObject() function, and shprewind utility
+program.  Added FTLogical, DBFReadLogicalAttribute() and
+DBFWriteLogicalAttribute() (thanks to Olek Neyman). <p>
+<b>Release 1.2.9</b>: Good support for reading and writing NULL fields
+in .dbf files, good support for NULL shapes and addition of the
+DBFGetFieldIndex() functions (all contributed by Jim Matthews).<p>
+An upgraded shputils.c has been contributed by Bill Miller.  Daniel
+Morissette contributed DBFGetNativeFieldType().  Better error checking
+for disk errors in dbfopen.c.  Various other bug fixes and safety improvements.
+<p>
+<b>Release 1.2.8</b>: Added hacked libtool support (supplied by Jan)
+and "rpm ready" install logic.<p>
+<b>Release 1.2.7</b>: Fix record size (was 4 bytes too long).  Modify
+SHPReadObject() to handle null shapes properly.  Use atof() instead of
+sscanf().  Support .DBF as well as .dbf.<p>
+<b>Release 1.2.6</b>: Now available under old MIT style license, or at the
+users option, LGPL.  Added the contrib directory of stuff from Carl Anderson
+and the shptree.c API for quadtree based spatial searches.<p>
+<b>Release 1.2.5</b>: SHPOpen() now forcably uses "rb" or "r+b" access string
+to avoid common mistakes on Windows.  Also fixed a serious bug with .dbf
+files with a 'F' field type.<p>
+<b>Release 1.2.4</b>: DBFOpen() will now automatically translate a .shp
+extension to .dbf for convenience.  SHPOpen() will try datasets with lower
+and uppercase extension.  DBFAddField() now returns the field number,
+not TRUE/FALSE.<p>
+<b>Release 1.2.3</b>: Disable writing measures to multi-patches as ArcView
+seems to puke on them (as reported by Monika Sester).  Add white space
+trimming, and string/numeric attribute interchangability in DBF API
+as suggested by Steve Lime.  Dbfdump was updated to include several
+reporting options.<p>
+<b>Release 1.2.2</b>: Added proper support for multipatch (reading and
+writing) - this release just for testing purposes.<p>
+<b>Release 1.2</b> is mostly a rewrite of the .shp/.shx access API to account
+for ArcView 3.x 3D shapes, and to encapsulate the shapes in a structure.
+Existing code using the shapefile library will require substantial changes
+to use release 1.2.<p>
+<b>Release V1.1</b> has been built on a number of platforms, and used by a
+number of people successfully.  V1.1 is the first release with the xBase API
+documentation.<p>
+</body>
+</html>

data/ext/shp/shapelib/web/shapelib-tools.html ADDED Viewed

@@ -0,0 +1,352 @@
+<html>
+<head>
+<title>ShapeLib Tools - User Guide</title>
+<link href="http://www.maptools.org/maptools.css" rel="stylesheet" type="text/css">
+</head>
+<body>
+<h1>ShapeLib Tools - User Guide</h1>
+ShapeLib is maintained by Frank Warmerdam<br>
+This guide was created by <a href="http://www.consultoria.eti.br" target="_show">Eduardo Patto Kanegae</a> &lt;&nbsp;eduardo<i>~at~</i>consultoria<i>~dot~</i>eti<i>~dot~</i>br&nbsp;&gt;
+<ul>
+	<li><a href="#dbfcreate">dbfcreate</a></li>
+	<li><a href="#dbfadd">dbfadd</a></li>
+	<li><a href="#dbfdump">dbfdump</a></li>
+	<li><a href="#shpcreate">shpcreate</a></li>
+	<li><a href="#shpadd">shpadd</a></li>
+	<li><a href="#shpdump">shpdump</a></li>
+	<li><a href="#shprewind">shprewind</a></li>
+	<li><i>Tools from ShapeLib 'contrib' directory</i>
+		<ul>
+			<li><a href="#dbfinfo">dbfinfo</a></li>
+			<li><a href="#dbfcat">dbfcat</a></li>
+			<li><a href="#shpinfo">shpinfo</a></li>
+			<li><a href="#shpcat">shpcat</a></li>
+			<li><a href="#shpcentrd">shpcentrd</a></li>
+			<li><a href="#shpdxf">shpdxf</a></li>
+			<li><a href="#shpfix">shpfix</a></li>
+			<li><a href="#shpproj">shpproj</a></li>
+		</ul>
+	</li>
+</ul>
+<h2><a name="dbfcreate">dbfcreate</a></h2>
+<b>Purpose</b>: creates a new and empty .dbf file.
+<br>
+<b>Usage</b>: <font face="courier">dbfcreate xbase_file [[-s field_name width],[-n field_name width decimals]]...</font>
+<br>
+<ul>
+	<li><b>xbase_file</b>: the name of xBase file to be created. Doesn't need the extension.</li>
+	<li><b>-s field_name width</b>: creates a string field with name <u>field_name</u> and size <u>width</u>.</li>
+	<li><b>-n field_name width decimals</b>: creates a numeric field with name <u>field_name</u>, width of <u>width</u> and with decimals places sized by <u>decimals</u>.</li>
+</ul>
+<b>Example</b>
+<br>
+<font face="courier">$ dbfcreate testbase -s NAME 20, -n AREA 9 3, -n VALUE 9 2</font>
+<br># this will create a file named testbase.dbf with 3 fields: NAME ( string (20)),
+AREA ( float (9,3)) and VALUE ( float (9,2))
+<br>
+<hr>
+<h2><a name="dbfadd">dbfadd</a></h2>
+<b>Purpose</b>: adds a record into an existing .dbf file.
+<br>
+<b>Usage</b>: <font face="courier">dbfadd xbase_file field_values</font>
+<br>
+<ul>
+	<li><b>xbase_file</b>: the name of an existing xBase file.</li>
+	<li><b>field_values</b>: list of values to be inserted into the xBase file.
+	You must specify a number of values equal to the number of fields the xBase file has.
+	The order of values must also reflect the order of fields inside xBase file.</li>
+</ul>
+<b>Example</b>
+<br>
+<font face="courier">$ dbfadd testbase.dbf REGION1 25.656 150.22</font>
+<br># assuming that testbase.dbf has 3 fields( NAME, AREA and VALUE), this command line
+will insert a new record into testbase.dbf with the value "REGION1" for NAME,
+'25.656' for AREA and '150.22' for VALUE field.
+<br>
+<hr>
+<h2><a name="dbfdump">dbfdump</a></h2>
+<b>Purpose</b>: dumps the content of a xBase file to the terminal.
+<br>
+<b>Usage</b>: <font face="courier">dbfdump [-h] [-r] [-m] xbase_file</font>
+<br>
+<ul>
+	<li><b>-h</b>: output header info( field descriptions).</li>
+	<li><b>-r</b>: output raw field info, numeric values not reformatted.</li>
+	<li><b>-m</b>: output one line per field.</li>
+	<li><b>xbase_file</b>: the name of an existing xBase file.</li>
+</ul>
+<b>Example</b>
+<br>
+<font face="courier">$ dbfdump -h testbase.dbf</font>
+<br># assuming that testbase.dbf has 1 record( inserted by previous example using 'dbfadd'),
+this command line will produce the following output:<br>
+<font face="courier">
+Field 0: Type=String, Title=`NAME', Width=20, Decimals=0<br>
+Field 1: Type=Double, Title=`AREA', Width=9, Decimals=3<br>
+Field 2: Type=Double, Title=`VALUE', Width=9, Decimals=2<br>
+NAME                      AREA     VALUE<br>
+REGION1                 25.656    150.22
+</font>
+<br>
+<hr>
+<h2><a name="shpcreate">shpcreate</a></h2>
+<b>Purpose</b>: creates a new and empty shapefile.
+<br>
+<b>Usage</b>: <font face="courier">shpcreate shp_file [point|arc|polygon|multipoint]</font>
+<br>
+<ul>
+	<li><b>shp_file</b>: the name of shapefile to be created. Doesn't need the extension.</li>
+	<li><b>point/arc/polygon/multipoint</b>: the type of shapefile that you wish to create. You must specify a valid option.</li>
+</ul>
+<b>Example</b>
+<br>
+<font face="courier">$ shpcreate testpolygon polygon</font>
+<br># this will create a point shapefile named testpolygon( in fact testpolygon.shp and testpolygon.shx will be created).
+<br>
+<hr>
+<h2><a name="shpadd">shpadd</a></h2>
+<b>Purpose</b>: adds a shape into an existing shapefile.
+<br>
+<b>Usage</b>: <font face="courier">shpadd shp_file [[x y] [+]]*</font>
+<br>
+<ul>
+	<li><b>shp_file</b>: the name of an existing shapefile.</li>
+	<li><b>x<sub><i>1</i></sub> y<sub><i>1</i></sub> x<sub><i>2</i></sub> y<sub><i>2</i></sub> ... x<sub><i>n</i></sub> y<sub><i>n</i></sub></b>: 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).</li>
+</ul>
+<b>Example</b>
+<br>
+<font face="courier">$ shpadd testpolygon 100000 7000000 250000 6500000 200000 6000000 100000 7000000</font>
+<br># assuming that testpolygon is a polygon shapefile, this command line will insert a new shape( a triangle) into testpolygon with the following XY coordinates:<br>
+vertice 0: 100000 7000000 ( this will also be the vertice where the shape starts and ends)<br>
+vertice 1: 250000 6500000<br>
+vertice 2: 200000 6000000<br>
+vertice 3: 100000 7000000<br>
+<hr>
+<h2><a name="shpdump">shpdump</a></h2>
+<b>Purpose</b>: dumps content of shapefile showing information like shape type, file extents, total of objects and vertices coordinates.
+<br>
+<b>Usage</b>: <font face="courier">shpdump [-validate] shp_file</font>
+<br>
+<ul>
+	<li><b>-validate</b>: count the number of objects that has invalid ring orderings.</li>
+	<li><b>shp_file</b>: the name of an existing shapefile.</li>
+</ul>
+<b>Example</b>
+<br>
+<font face="courier">$ shpdump testpolygon</font>
+<br># assuming that testpolygon is an existing shapefile previously created, this command line will output the following result:
+<pre>Shapefile Type: Polygon   # of Shapes: 1
+File Bounds: (  100000.000, 6000000.000,0,0)
+         to  (  250000.000, 7000000.000,0,0)
+Shape:0 (Polygon)  nVertices=4, nParts=1
+  Bounds:(  100000.000, 6000000.000, 0, 0)
+      to (  250000.000, 7000000.000, 0, 0)
+     (  100000.000, 7000000.000, 0, 0) Ring
+     (  250000.000, 6500000.000, 0, 0)
+     (  200000.000, 6000000.000, 0, 0)
+     (  100000.000, 7000000.000, 0, 0)</pre>
+<hr>
+<h2><a name="shprewind">shprewind</a></h2>
+<b>Purpose</b>: validates and resets the winding order of rings in polygon geometries to match the ordering required by shapefile specification. This is usefull for shapefiles having troubles when checked with a 'shpdump -validate'.
+<br>
+<b>Usage</b>: <font face="courier">shprewind in_shp_file out_shp_file</font>
+<br>
+<ul>
+	<li><b>in_shp_file</b>: the name of an existing shapefile.</li>
+	<li><b>out_shp_file</b>: the name of the new fixed shapefile that will be created.</li>
+</ul>
+<b>Example</b>
+<br>
+<font face="courier">$ shprewind badshapefile newshapefile</font>
+<br>
+<hr>
+<h2><a name="dbfinfo">dbfinfo</a></h2>
+<b>Purpose</b>: displays basic information for a given xBase file, like number of columns, number of records and type of each column.
+<br>
+<b>Usage</b>: <font face="courier">dbfinfo xbase_file</font>
+<br>
+<ul>
+	<li><b>xbase_file</b>: the name of an existing xBase file.</li>
+</ul>
+<b>Example</b>
+<br>
+<font face="courier">$ dbfinfo testbase</font>
+<br>
+<pre>Info for testbase.dbf
+3 Columns,  1 Records in file
+           NAME          string  (20,0)
+           AREA           float  (9,3)
+          VALUE           float  (9,2)
+</pre>
+<br>
+<hr>
+<h2><a name="dbfcat">dbfcat</a></h2>
+<b>Purpose</b>: appends the records of a source xBase file into a destiny xBase file. Both files must have the same number of fields.
+<br>
+<b>Usage</b>: <font face="courier">dbfcat [-v] [-f] from_DBFfile to_DBFfile</font>
+<br>
+<ul>
+	<li><b>-v</b>: verbose mode.</li>
+	<li><b>-f</b>: forces data convertion if data field types is not the same at both files or if is there any null value into <u>from_DBFfile</u>.</li>
+	<li><b>from_DBFfile</b>: source xBase file.</li>
+	<li><b>to_DBFfile</b>: destiny xBase file.</li>
+</ul>
+<b>Example</b>
+<br>
+<font face="courier">$ dbfcat -v testbase1 testbase2</font>
+<br>
+<hr>
+<h2><a name="shpinfo">shpinfo</a></h2>
+<b>Purpose</b>: displays basic information for a given shapefile, like shapefile type, number of objects and its extents.
+<br>
+<b>Usage</b>: <font face="courier">shpinfo shp_file</font>
+<br>
+<ul>
+	<li><b>shp_file</b>: the name of an existing shapefile.</li>
+</ul>
+<b>Example</b>
+<br>
+<font face="courier">$ shpinfo testpolygon</font>
+<br>
+<pre>Info for testpolygon
+Polygon(5), 1 Records in file
+File Bounds: (         100000,        6000000)
+        (         250000,        7000000)</pre>
+<hr>
+<h2><a name="shpcat">shpcat</a></h2>
+<b>Purpose</b>: appends the content of a source shapefile into a destiny shapefile. Both files must be the same shapefile type.
+<br>
+<b>Usage</b>: <font face="courier">shpcat from_shpfile to_shpfile</font>
+<br>
+<ul>
+	<li><b>from_shpfile</b>: source shapefile</li>
+	<li><b>to_shpfile</b>: destiny shapefile</li>
+</ul>
+<b>Example</b>
+<br>
+<font face="courier">$ shpcat shapefile1 shapefile2</font>
+<br>
+<hr>
+<h2><a name="shpcentrd">shpcentrd</a></h2>
+<b>Purpose</b>: computes XY centroid for polygon shapefiles.
+<br>
+<b>Usage</b>: <font face="courier">shpcentrd shp_file new_shp_file</font>
+<br>
+<ul>
+	<li><b>shp_file</b>: the name of an existing polygon shapefile.</li>
+	<li><b>new_shp_file</b>: the name of the point shapefile that will created.</li>
+</ul>
+<b>Example</b>
+<br>
+<font face="courier">$ shpcentrd apolygonfile pointcentrd</font>
+<br>
+<hr>
+<h2><a name="shpdxf">shpdxf</a></h2>
+<b>Purpose</b>: creates a DXF file from an existing shapefile.
+<br>
+<b>Usage</b>: <font face="courier">shpdxf shapefile {idfield}</font>
+<br>
+<ul>
+	<li><b>shapefile</b>: the name of an existing shapefile.</li>
+	<li><b>idfield</b>: explain</li>
+</ul>
+<b>Example</b>
+<br>
+<font face="courier">$ shpdxf testshapefile IDFIELD</font>
+<br># explain the command
+<br>
+<hr>
+<h2><a name="shpfix">shpfix</a></h2>
+<b>Purpose</b>: Utility program to fix nulls and inconsistencies in Shapefiles
+as happens from time to time.
+<br>
+<b>Usage</b>: <font face="courier">shpfix shpfile new_file &lt;Record# to Blank&gt;</font>
+<br>
+<ul>
+	<li><b>shpfile</b>: input file</li>
+	<li><b>new_file</b>: output file</li>
+</ul>
+<b>Example</b>
+<br>
+<font face="courier">$ shpfix broken fixed</font>
+<br>
+<hr>
+<h2><a name="shpproj">shpproj</a></h2>
+<b>Purpose</b>: Reproject Shapefiles using PROJ.4
+<br>
+<b>Usage</b>: <font face="courier">shpproj shp_file new_shp ( -i=in_proj_file | -i="in_params" | -i=geographic ) ( -o=out_info_file | -o="out_params" | -o=geographic ) </font>
+<br>
+<ul>
+	<li><b>param1</b>: explain</li>
+	<li><b>param2</b>: explain</li>
+</ul>
+<p>
+<b>INPUT</b><br>
+  Input can come from one of three sources.  A projection parameter file,
+  directly through parameters or geographic. If the shapefile has an associated
+  prj file, name the same as the shapefile but ending in ".prj" it will be used
+  by default ignoring all other parameters.  If input is omitted it defaults to
+  geographic, unless the default prj file exists.<p>
+<b>OUTPUT</b><br>
+  Output can come from one of three sources.  A projection parameter file,
+  directly through parameters or geographic.  If output is omitted it defaults
+  to geographic.<p>
+<b>PROJECTION PARAMETER FILE</b><br>
+  This file MUST end with the extension ".prj".  It has the form of one
+  projection parameter per line.  Parameters can be in any order.  The
+  projection parameters are those used to define a PROJ.4 projection.<p>
+<b>PROJECTION PARAMETERS</b><br>
+  Are the same as used by proj and invproj.<p>
+<pre>
+  use      proj -lP   to see available projections
+	   proj -lu   to see available units
+	   proj -le   to see available ellipsoid
+</pre>
+Or visit the PROJ.4 web page at <a href="http://www.remotesensing.org/proj">http://www.remotesensing.org/proj</a> for more details.<p>
+<p>
+<b>Example</b></br>
+the following example projects file rowtest to row3, moving data from Stateplane NAD83  zone 1002 to utm zone 16 in meters<p>
+<pre>
+shpproj rowtest row -i="init=nad83:1002 units=us-ft" -o="proj=utm zone=16 units=m"
+shpproj rowtest row3 -o="proj=utm zone=18 units=m" -i="zone=16 proj=utm units=us-ft"
+shpproj rowtest row3 -o="proj=utm zone=18 units=m"
+shpproj rowtest row3 -i=myfile.prj -o=geographic
+shpproj rowtest row3 -is=myfile.prj
+</pre>
+<hr>
+</body>
+</html>