= GEOS - Geometry Engine, Open Source =
{{{
#!comment
--#!html
}}}
GEOS (Geometry Engine - Open Source) is a C++ port of the [http://itshumour.blogspot.com/2011/08/funny-statuses-quotes-for-facebook.html Java Topology Suite] (JTS). As such, it aims to contain the complete functionality of JTS in C++. This includes all the [http://www.opengeospatial.org/standards/sfs OpenGIS Simple Features for SQL] spatial predicate functions and spatial operators, as well as specific JTS enhanced topology functions.
GEOS is available under the terms of [http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html GNU Lesser General Public License] (LGPL), and is a project of [http://www.osgeo.org/ OSGeo].
== Capabilities Include ==
* Geometries: Point, !LineString, Polygon, !MultiPoint, !MultiLineString, !MultiPolygon, !GeometryCollection
* Predicates: Intersects, Touches, Disjoint, Crosses, Within, Contains, Overlaps, Equals, Covers
* Operations: Union, Distance, Intersection, Symmetric Difference, Convex Hull, Envelope, Buffer, Simplify, Polygon Assembly, Valid, Area, Length,
* Prepared geometries (pre-spatially indexed)
* STR spatial index
* OGC Well Known Text (WKT) and Well Known Binary (WKB) encoders and decoders.
* C and C++ API (C API gives long term ABI stability)
* Thread safe (using the reentrant API)
== Download ==
* 2012/06/25 [http://download.osgeo.org/geos/geos-3.3.5.tar.bz2 geos-3.3.5.tar.bz2] ([http://trac.osgeo.org/geos/browser/tags/3.3.5/NEWS Changes])
* 2011/09/21 [http://download.osgeo.org/geos/geos-3.2.3.tar.bz2 geos-3.2.3.tar.bz2] ([http://trac.osgeo.org/geos/browser/tags/3.2.3/NEWS Changes])
* 2009/06/15 [http://download.osgeo.org/geos/geos-3.1.1.tar.bz2 geos-3.1.1.tar.bz2] ([http://trac.osgeo.org/geos/browser/tags/3.1.1/NEWS Changes])
* [http://download.osgeo.org/geos/ Older versions...]
* Nightly snapshot: http://geos.osgeo.org/snapshots/
{{{
#!comment
* 2012/05/31 [http://download.osgeo.org/geos/geos-3.3.4.tar.bz2 geos-3.3.4.tar.bz2] ([http://trac.osgeo.org/geos/browser/tags/3.3.4/NEWS Changes])
* 2012/01/05 [http://download.osgeo.org/geos/geos-3.3.2.tar.bz2 geos-3.3.2.tar.bz2]
* 2011/09/27 [http://download.osgeo.org/geos/geos-3.3.1.tar.bz2 geos-3.3.1.tar.bz2]
* 2011/05/30 [http://download.osgeo.org/geos/geos-3.3.0.tar.bz2 geos-3.3.0.tar.bz2]
* 2011/05/11 [http://download.osgeo.org/geos/geos-3.3.0rc1.tar.bz2 geos-3.3.0rc1.tar.bz2]
* 2010/03/30 [http://download.osgeo.org/geos/geos-3.2.1.tar.bz2 geos-3.2.1.tar.bz2]
* 2009/12/08 [http://download.osgeo.org/geos/geos-3.2.0.tar.bz2 geos-3.2.0.tar.bz2]
* 2009/06/15 [http://download.osgeo.org/geos/geos-3.0.4.tar.bz2 geos-3.0.4.tar.bz2]
* 2008/11/18 [http://download.osgeo.org/geos/geos-3.0.3.tar.bz2 geos-3.0.3.tar.bz2]
* 2009/03/17 [http://download.osgeo.org/geos/geos-3.1.0.tar.bz2 geos-3.1.0.tar.bz2]
* 2009/02/02 [http://download.osgeo.org/geos/geos-3.1.0rc2.tar.bz2 geos-3.1.0rc2.tar.bz2]
* 2008/10/27 [http://download.osgeo.org/geos/geos-3.0.3rc1.tar.bz2 geos-3.0.3rc1.tar.bz2]
* 2008/10/15 [http://download.osgeo.org/geos/geos-3.0.2.tar.bz2 geos-3.0.2.tar.bz2]
* 2008/10/15 [http://download.osgeo.org/geos/geos-3.0.1.tar.bz2 geos-3.0.1.tar.bz2]
* 2007/12/21 [http://download.osgeo.org/geos/geos-3.0.0.tar.bz2 geos-3.0.0.tar.bz2]
* 2007/12/12 [http://download.osgeo.org/geos/geos-3.0.0rc5.tar.bz2 geos-3.0.0rc5.tar.bz2]
* 2007/02/02 [http://download.osgeo.org/geos/geos-3.0.0rc4.tar.bz2 geos-3.0.0rc4.tar.bz2]
* 2006/12/14 [http://download.osgeo.org/geos/geos-3.0.0rc3.tar.bz2 geos-3.0.0rc3.tar.bz2]
* 2006/11/05 [http://download.osgeo.org/geos/geos-3.0.0rc2.tar.bz2 geos-3.0.0rc2.tar.bz2]
* 2006/09/09 [http://download.osgeo.org/geos/geos-3.0.0rc1.tar.bz2 geos-3.0.0rc1.tar.bz2]
* 2006/07/08 [http://download.osgeo.org/geos/geos-2.2.3.tar.bz2 geos-2.2.3.tar.bz2]
* 2006/05/16 [http://download.osgeo.org/geos/geos-2.2.2.tar.bz2 geos-2.2.2.tar.bz2]
* 2005/12/11 [http://download.osgeo.org/geos/geos-2.2.1.tar.bz2 geos-2.2.1.tar.bz2]
* 2005/12/01 [http://download.osgeo.org/geos/geos-2.2.0.tar.bz2 geos-2.2.0.tar.bz2]
* 2005/08/23 [http://download.osgeo.org/geos/geos-2.1.4.tar.bz2 geos-2.1.4.tar.bz2]
* 2005/07/04 [http://download.osgeo.org/geos/geos-2.1.3.tar.bz2 geos-2.1.3.tar.bz2]
* 2005/06/08 [http://download.osgeo.org/geos/geos-2.1.2.tar.bz2 geos-2.1.2.tar.bz2]
* 2004/12/16 [http://download.osgeo.org/geos/geos-2.1.1.tar.bz2 geos-2.1.1.tar.bz2]
* 2004/11/13 [http://download.osgeo.org/geos/geos-2.1.0.tar.bz2 geos-2.1.0.tar.bz2]
* 2004/10/04 [http://download.osgeo.org/geos/geos-2.0.1.tar.bz2 geos-2.0.1.tar.bz2]
* 2004/08/19 [http://download.osgeo.org/geos/geos-2.0.0.tar.bz2 geos-2.0.0.tar.bz2]
* 2003/11/06 [http://download.osgeo.org/geos/geos-1.0.0.tar.bz2 geos-1.0.0.tar.bz2]
}}}
== Build and Install ==
{{{
#!html
funny jokes
funny jokes for kids
funny hilarious quotes
funny love quotes
big bang theory quotes
cute love quotes
cool funny sayings
}}}
=== Source ===
* [wiki:BuildingOnUnixWithAutotools Building on Unix with Autotools]
* [wiki:BuildingOnUnixWithCMake Building on Unix with CMake]
* [wiki:BuildingOnWindowsWithNMake Building on Windows with NMake]
* [wiki:BuildingOnWindowsWithCMake Building on Windows with CMake]
{{{
#!comment
* [wiki:BuildingOnWindowsWithVisualStudioIDE Building on Windows with Visual Studio IDE]
}}}
=== Binaries ===
* Windows binaries:
* As part of [http://osgeo4w.osgeo.org/ OSGeo4W] as part of the [http://trac.osgeo.org/osgeo4w/wiki/pkg-geos geos] package.
* Linux distributions provide packages with GEOS: [http://packages.debian.org/search?keywords=geos&searchon=sourcenames&suite=all§ion=all Debian], [http://packages.ubuntu.com/search?keywords=geos&searchon=sourcenames&suite=all§ion=all Ubuntu], [https://admin.fedoraproject.org/pkgdb/packages/name/geos Fedora], [http://packages.gentoo.org/package/geos Gentoo], [http://download.opensuse.org/repositories/Application:/Geo/ openSUSE] and other
* [http://yum.postgresql.org PostgreSQL RPM Repository] has up2date GeOS (and other GIS related components) packages.
* Binaries /Packages with GEOS for other Unix systems:
* [http://www.kyngchaos.com/software:frameworks GEOS Framework] for [http://www.apple.com/macosx/ Mac OS X] 10.5+ provided by William Kyngesburye. Big thanks to William!
* [http://pdb.finkproject.org/pdb/browse.php?summary=libgeos Fink] for Mac OS X
* [https://trac.macports.org/browser/trunk/dports/science/geos/Portfile MacPorts] for Mac OS X
* [http://github.com/mxcl/homebrew/blob/master/Library/Formula/geos.rb Homebrew package manager] for Mac OS X
* [http://www.freebsd.org/cgi/cvsweb.cgi/ports/graphics/geos/ GEOS ports] for [http://www.freebsd.org FreeBSD]
* [http://pkgsrc.se/geography/geos GEOS pkgsrc packages] for NetBSD and other UNIX-like systems including [http://pkgsrc.se/info.php including Solaris, OpenBSD, FreeBSD, OpenBSD, Linux, Darwin and others].
== Development ==
=== Bug Reporting ===
You will need an [http://www.osgeo.org/osgeo_userid/ OSGeo user account] to submit bugs here. A "New Ticket" button will appear once you have [http://trac.osgeo.org/geos/login logged in].
When [http://trac.osgeo.org/geos/newticket submitting bugs] caused by particular geometries (TopologyExceptions, for example), you must submit the geometries that cause the failure, preferably in [HexEncodedWkb hex-encoded WKB], so that we can re-produce the failure cases.
=== Mailing Lists ===
* [geos-devel] [http://lists.osgeo.org/mailman/listinfo/geos-devel Subscribe/Unsubscribe] | [http://lists.osgeo.org/pipermail/geos-devel/ List Archive]
* [geos-commits] [http://lists.osgeo.org/mailman/listinfo/geos-commits Subscribe/Unsubscribe] | [http://lists.osgeo.org/pipermail/geos-commits/ List Archive]
=== Code Repository ===
* SVN Repository address: http://svn.osgeo.org/geos/
* Checkout with: `svn checkout http://svn.osgeo.org/geos/trunk geos-svn`
* Nightly snapshot: http://geos.osgeo.org/snapshots/
* GIT mirror (with svn metadata): http://github.com/libgeos/libgeos
* Clone with: `git clone git://github.com/libgeos/libgeos.git`
=== Features ===
* [wiki:PreparedGeometry Prepared Geometries]
* [wiki:GeometryCleaning Geometry Cleaning] (Discussion Page)
* [wiki:BundaryNodeRule Boundary node rule] (Discussion Page)
=== Governance ===
The GEOS project is run by a [wiki:PSC Project Steering Committee] made up of developers and contributors to the project and is a project of [http://www.osgeo.org/ OSGeo]. Major project decisions are made via a Request for Comments process, where proposals are first documented and then voted on by the steering committee.
* [wiki:RFC1 RFC-1] - Project Steering Committee
* [wiki:RFC2 RFC-2] - Committer Guidelines
* [wiki:RFC3 RFC-3] - Thread Safe CAPI
=== Documentation and Other Information ===
* [http://geos.osgeo.org/doxygen/ GEOS API] -- Doxygen-generate API documentation
* [wiki:Buildbot] -- Farm used to run regular builds and tests
* [http://geos.osgeo.org/SVN.txt SVN Change Log] -- Changes and comments from SVN
* [wiki:MSVSAutoexp Microsoft Visual Studio visualizers]
* [wiki:Applications] -- Applications using GEOS
== Wiki / Trac Information ==
* TracGuide -- Built-in Documentation
* [http://trac.edgewall.org/ The Trac project] -- Trac Open Source Project
* [http://trac.edgewall.org/wiki/TracFaq Trac FAQ] -- Frequently Asked Questions
* TracSupport -- Trac Support
* For a complete list of local wiki pages, see TitleIndex.