= GEOS - Geometry Engine, Open Source =


{{{
#!html

}}} 

{{{
#!div style="background-color: #fdd; font-size: 120%; padding: 1em; text-align: center; font-weight: bold"

The official GEOS web site is now https://libgeos.org
[[BR]] This site is now read-only and new issues should be filed at [https://github.com/libgeos/geos/issues GitHub].

}}}

== License ==

GEOS is available under the terms of [http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html GNU Lesser General Public License] (LGPL).

== Capabilities  ==

=== Spatial Model and  Functions ===

 * 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.

=== API Features ===

 * C++ API (will likely change across versions)
 * C API (provides long-term ABI stability)
 * Thread safe (using the reentrant API)

== Download ==

See https://libgeos.org/usage/download/

{{{
#!comment
 * 2021/11/02 [https://download.osgeo.org/geos/geos-3.10.1.tar.bz2 geos-3.10.1.tar.bz2] 
 * 2021/11/01 [https://download.osgeo.org/geos/geos-3.9.2.tar.bz2 geos-3.9.2.tar.bz2] 
 * 2021/04/10 [https://download.osgeo.org/geos/geos-3.8.2.tar.bz2 geos-3.8.2.tar.bz2] 
 * 2019/10/04 [https://download.osgeo.org/geos/geos-3.7.3.tar.bz2 geos-3.7.3.tar.bz2] 
 * 2020/12/11 [https://download.osgeo.org/geos/geos-3.6.5.tar.bz2 geos-3.6.5.tar.bz2] 
 * 2019/10/04 [https://download.osgeo.org/geos/geos-3.5.2.tar.bz2 geos-3.5.2.tar.bz2] 
 * [http://download.osgeo.org/geos/ Older versions...]
 * Nightly snapshot: http://geos.osgeo.org/snapshots/
 * Live development: [CodeRepository code repository]
 * '''PHP bindings''': http://git.osgeo.org/gitea/geos/php-geos
 * 2021/02/10 [http://download.osgeo.org/geos/geos-3.9.1.tar.bz2 geos-3.9.1.tar.bz2] 
 * 2016/10/27 [http://download.osgeo.org/geos/geos-3.4.3.tar.bz2 geos-3.4.3.tar.bz2] 
 * 2013/09/04 [http://download.osgeo.org/geos/geos-3.3.9.tar.bz2 geos-3.3.9.tar.bz2] 
 * 2011/09/21 [http://download.osgeo.org/geos/geos-3.2.3.tar.bz2 geos-3.2.3.tar.bz2] 
 * 2009/03/17 [http://download.osgeo.org/geos/geos-3.1.0.tar.bz2 geos-3.1.0.tar.bz2]
 * 2009/06/15 [http://download.osgeo.org/geos/geos-3.0.4.tar.bz2 geos-3.0.4.tar.bz2]
 * 2006/07/08 [http://download.osgeo.org/geos/geos-2.2.3.tar.bz2 geos-2.2.3.tar.bz2]
 * 2005/08/23 [http://download.osgeo.org/geos/geos-2.1.4.tar.bz2 geos-2.1.4.tar.bz2]
 * 2004/10/04 [http://download.osgeo.org/geos/geos-2.0.1.tar.bz2 geos-2.0.1.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 ==

=== CI Status ===

See https://libgeos.org/development/ci_status/

=== Source ===

 * [wiki:BuildingOnUnixWithCMake Building on Unix with CMake]
 * [wiki:BuildingOnMINGW64CMake Building on MINGW64 with CMake]
 * [wiki:BuildingOnWindowsWithCMake Building on Windows with CMake] [https://git.osgeo.org/gitea/geos/geos Latest instructions for VS 2019 in repo] 

** No longer supported **

 * [wiki:BuildingOnUnixWithAutotools Building on Unix with Autotools] 
 * [wiki:BuildingOnWindowsWithNMake Building on Windows with NMake] 

{{{
#!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.
   * As part of [https://ms4w.com/ MS4W]
 * Linux distributions provide packages with GEOS: [http://packages.debian.org/search?keywords=geos&searchon=sourcenames&suite=all&section=all Debian], [http://packages.ubuntu.com/search?keywords=geos&searchon=sourcenames&suite=all&section=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://ports.macports.org/port/geos/summary 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].
 * [https://www.conan.io/search?q=geos GEOS binaries from Conan.io] - a C/C++ Package Manager

=== Tools ===
  
 * [wiki:ToolsTesting Testing]

== Development ==

=== Bug Reporting ===

Report bugs using [https://github.com/libgeos/geos/issues GitHub issues].

When submitting bugs caused by particular geometries, you must submit the geometries that cause the failure, preferably in [HexEncodedWkb hex-encoded WKB], so that we can re-produce the failure cases.

=== Community ===

See https://libgeos.org/development/

=== Features ===

 * [wiki:PreparedGeometry Prepared Geometries]
 * [wiki:GeometryCleaning Geometry Cleaning] (Discussion Page)
 * [wiki:BundaryNodeRule Boundary node rule] (Discussion Page)

=== Governance ===

See https://libgeos.org/development/psc/

=== Documentation and Other Information === 

 * [http://libgeos.org/doxygen/ GEOS API] -- Doxygen-generate API documentation
 * [wiki:MSVSAutoexp Microsoft Visual Studio visualizers]
 * [wiki:Applications] -- Applications using GEOS
 * [wiki:CodingPatterns] Coding Patterns
 * [wiki:GSoC] -- Google Summer of Code Ideas (GSOC)

== 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.