GEOS - Geometry Engine, Open Source

GEOS (Geometry Engine - Open Source) is a C++ port of the ​Java Topology Suite (JTS). As such, it aims to contain the complete functionality of JTS in C++. This includes all the ​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 ​GNU Lesser General Public License (LGPL), and is a project of ​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

• 2015/08/16 ​geos-3.5.0.tar.bz2 (Changes)
• 2013/08/25 ​geos-3.4.2.tar.bz2 (Changes)
• 2013/09/04 ​geos-3.3.9.tar.bz2 (Changes)
• 2011/09/21 ​geos-3.2.3.tar.bz2 (Changes)
• ​Older versions...
• Nightly snapshot: ​http://geos.osgeo.org/snapshots/
• Live development: code repository

Build and Install

Build status	Debbie Debian 8.2 GNU/Linux 64bit	Winnie Windows	Travis Ubuntu 12.04 GNU/Linux 32bit,64bit GCC 4.6.3, Clang 3.4 cmake,automake	gitlab-ci Debian 8.2 GNU/Linux 64bit gcc automake	AppVeyor Windows Server 2012 R2 64bit VS2015 CMake	drone.io GNU/Linux 64bit GCC 4.6 automake	drone.osgeo Alpine Linux
trunk		N/A
3.5					N/A	N/A	N/A
3.4		N/A			N/A	N/A	N/A
3.3		N/A			N/A	N/A	N/A
3.2		N/A			N/A	N/A	N/A

Source

• Building on Unix with Autotools
• Building on Unix with CMake
• Building on MINGW64 with CMake
• Building on Windows with NMake
• Building on Windows with CMake

Binaries

• Windows binaries:
  • As part of ​OSGeo4W as part of the ​geos package.
• Linux distributions provide packages with GEOS: ​Debian, ​Ubuntu, ​Fedora, ​Gentoo, ​openSUSE and other
• ​PostgreSQL RPM Repository has up2date GeOS (and other GIS related components) packages.
• Binaries /Packages with GEOS for other Unix systems:
  • ​GEOS Framework for ​Mac OS X 10.5+ provided by William Kyngesburye. Big thanks to William!
  • ​Fink for Mac OS X
  • ​MacPorts for Mac OS X
  • ​Homebrew package manager for Mac OS X
  • ​GEOS ports for ​FreeBSD
  • ​GEOS pkgsrc packages for NetBSD and other UNIX-like systems including ​including Solaris, OpenBSD, FreeBSD, OpenBSD, Linux, Darwin and others.

Development

Bug Reporting

You will need an ​OSGeo user account to submit bugs here. A "New Ticket" button will appear once you have logged in.

When submitting bugs caused by particular geometries (TopologyExceptions, for example), you must submit the geometries that cause the failure, preferably in hex-encoded WKB, so that we can re-produce the failure cases.

Mailing Lists

• [geos-devel] ​Subscribe/Unsubscribe | ​List Archive
• [geos-commits] ​Subscribe/Unsubscribe | ​List Archive

Code Repository

• See CodeRepository

Features

• Prepared Geometries
• Geometry Cleaning (Discussion Page)
• Boundary node rule (Discussion Page)

Governance

The GEOS project is run by a Project Steering Committee made up of developers and contributors to the project and is a project of ​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.

• RFC-1 - Project Steering Committee
• RFC-2 - Committer Guidelines
• RFC-3 - Thread Safe CAPI

Documentation and Other Information

• ​GEOS API -- Doxygen-generate API documentation
• Buildbot -- Farm used to run regular builds and tests
• ​SVN Change Log -- Changes and comments from SVN
• Microsoft Visual Studio visualizers
• Applications -- Applications using GEOS
• GSoC -- Google Summer of Code Ideas (GSOC)

Wiki / Trac Information

• TracGuide -- Built-in Documentation
• ​The Trac project -- Trac Open Source Project
• ​Trac FAQ -- Frequently Asked Questions
• TracSupport -- Trac Support
• For a complete list of local wiki pages, see TitleIndex.