geompp 0.1.1

Python bindings for geompp — a C++ 2D/3D geometry library

← back

geompp

Python bindings for geompp — a C++ 2D/3D geometry library.

Install

    pip install geompp

Pre-built wheels are available for:

Platform	Python versions
Linux x86_64	3.8 · 3.9 · 3.10 · 3.11 · 3.12
Windows x64	3.8 · 3.9 · 3.10 · 3.11 · 3.12

If your platform or Python version is not in the table above, pip will compile from source — you will need CMake ≥ 3.15 and a C++20-capable compiler.

Quick start

    import geompp

    # Points & vectors
    p = geompp.Point2D(1.0, 2.0)
    v = geompp.Vector2D(3.0, 0.0)
    q = p + v                       # Point2D(4, 2)
    diff = q - p                    # Vector2D(3, 0)

    # Lines and intersection
    l1 = geompp.Line2D.make(geompp.Point2D(0,0), geompp.Point2D(1,0))
    l2 = geompp.Line2D.make(geompp.Point2D(0.5,-1), geompp.Point2D(0.5,1))
    hit = l1.intersection(l2)       # Point2D(0.5, 0) or None

    # 3D
    p3 = geompp.Point3D(1, 2, 3)
    plane = geompp.Plane.xy()
    proj = plane.project_onto(p3)   # Point3D(1, 2, 0)

    # Precision
    geompp.set_decimal_precision(geompp.DP_SIX)

    # File parser
    parser = geompp.LVSParser.open("geometry.lsv")
    while parser.has_next():
        item = parser.next()
        if item is not None:
            print(geompp.LVSParser.to_wkt(item))

Classes

2D	3D
Point2D	Point3D
Vector2D	Vector3D
Line2D	Line3D
Ray2D	Ray3D
LineSegment2D	LineSegment3D
Polyline2D	Polyline3D
Triangle2D	Triangle3D
Polygon2D	Polygon3D
BBox2D	BBox3D
	Plane

Build the python bindings from source

Linux

Build

    mkdir build && cd build
    cmake .. [-DCMAKE_BUILD_TYPE=Release] [-DBUILD_PYTHON=ON]
    make -j6

The -DBUILD_PYTHON=ON will build locally the python bindings and run the smoke tests immediately.

To try out the library after building it use this

    # from the main directory geompp
    pip3 install --break-system-packages ./geompp_python
    python3 -c "import geompp as g; print(g.Point3D(1,2,3).to_wkt())"
    # should print POINT (1 2 3)

Windows

Build the library

    mkdir build_win
    cd build_win
    cmake -S .. -G "Visual Studio 18 2026" -A x64
    cmake --build . --target geompp [--config Release] [-DBUILD_PYTHON=ON]

The -DBUILD_PYTHON=ON will build locally the python bindings and run the smoke tests immediately.