togo 0.1.1__cp310-cp310-musllinux_1_2_x86_64.whl

togo-0.1.1.dist-info/METADATA

@@ -0,0 +1,148 @@
+Metadata-Version: 2.4
+Name: togo
+Version: 0.1.1
+Summary: Lightweight Python bindings for the TG geometry library
+Author-email: Giorgio Salluzzo <giorgio.salluzzo@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/mindflayer/togo
+Project-URL: Source, https://github.com/mindflayer/togo
+Project-URL: Tracker, https://github.com/mindflayer/togo/issues
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: C
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Scientific/Engineering :: GIS
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license
+Dynamic: license-file
+
+# ToGo
+Python bindings for [TG](https://github.com/tidwall/tg)
+(Geometry library for C - Fast point-in-polygon)
+
+ToGo is a high-performance Python library for computational geometry, providing a Cython wrapper around the above-mentioned C library.
+
+The main goal is to offer a Pythonic, object-oriented, fast and memory-efficient library for geometric operations, including spatial predicates, format conversions, and spatial indexing.
+
+While ToGo's API interfaces are still a work in progress, the underling C library is stable and well-tested.
+
+## Installation
+
+```bash
+pip install togo
+```
+
+## Features
+
+- Fast and efficient geometric operations
+- Support for standard geometry types: Point, Line, Ring, Polygon, and their multi-variants
+- Geometric predicates: contains, intersects, covers, touches, etc.
+- Format conversion between WKT, GeoJSON, WKB, and HEX
+- Spatial indexing for accelerated queries
+- Memory-efficient C implementation with Python-friendly interface
+
+## Basic Usage
+
+```python
+from togo import Geometry, Point, Ring, Poly
+
+# Create a geometry from GeoJSON
+geom = Geometry('{"type":"Point","coordinates":[1.0,2.0]}')
+
+# Create a point
+point = Point(1.0, 2.0)
+
+# Create a polygon
+ring = Ring([(0,0), (10,0), (10,10), (0,10), (0,0)])
+polygon = Poly(ring)
+
+# Convert to various formats
+wkt = polygon.as_geometry().to_wkt()
+geojson = polygon.as_geometry().to_geojson()
+
+# Perform spatial predicates
+point_geom = point.as_geometry()
+contains = polygon.as_geometry().contains(point_geom)
+```
+
+## Core Classes
+
+### Geometry
+
+The base class that wraps tg_geom structures and provides core operations:
+
+```python
+# Create from various formats
+g1 = Geometry('POINT(1 2)', fmt='wkt')
+g2 = Geometry('{"type":"Point","coordinates":[1,2]}', fmt='geojson')
+
+# Geometric predicates
+g1.intersects(g2)
+g1.contains(g2)
+g1.within(g2)
+
+# Format conversion
+g1.to_wkt()
+g1.to_geojson()
+```
+
+### Point, Line, Ring, Poly
+
+Building blocks for constructing geometries:
+
+```python
+# Create a point
+p = Point(1.0, 2.0)
+
+# Create a line
+line = Line([(0,0), (1,1), (2,2)])
+
+# Create a ring (closed line)
+ring = Ring([(0,0), (10,0), (10,10), (0,10), (0,0)])
+
+# Create a polygon with holes
+exterior = Ring([(0,0), (10,0), (10,10), (0,10), (0,0)])
+hole = Ring([(2,2), (8,2), (8,8), (2,8), (2,2)])
+poly = Poly(exterior, [hole])
+```
+
+### MultiGeometries
+
+Creating collections of geometries:
+
+```python
+# Create a MultiPoint
+multi_point = Geometry.from_multipoint([(0,0), (1,1), Point(2,2)])
+
+# Create a MultiLineString
+multi_line = Geometry.from_multilinestring([
+    [(0,0), (1,1)],
+    Line([(2,2), (3,3)])
+])
+
+# Create a MultiPolygon
+poly1 = Poly(Ring([(0,0), (1,0), (1,1), (0,1), (0,0)]))
+poly2 = Poly(Ring([(2,2), (3,2), (3,3), (2,3), (2,2)]))
+multi_poly = Geometry.from_multipolygon([poly1, poly2])
+```
+
+## Polygon Indexing
+
+Togo supports different polygon indexing strategies for optimized spatial operations:
+
+```python
+from togo import TGIndex, set_polygon_indexing_mode
+
+# Set the indexing mode
+set_polygon_indexing_mode(TGIndex.NATURAL)  # or NONE, YSTRIPES
+```
+
+## Performance Considerations
+
+- Togo is optimized for speed and memory efficiency
+- For large datasets, proper indexing can significantly improve performance
+- Creating geometries with the appropriate format avoids unnecessary conversions
+
+Soon there will be a full API documentation, for now please refer to the test suite for more usage examples.

togo-0.1.1.dist-info/RECORD

@@ -0,0 +1,6 @@
+togo.cpython-310-x86_64-linux-gnu.so,sha256=gCLm0X6-QiyQ-Gh1MHjMG88C-7P7-sAuKuIsLS9Tkik,2368856
+togo-0.1.1.dist-info/METADATA,sha256=smJ-qt2aCBBDfYMWWUQHrO8gjVvXQk3KB4RXAG3wQOE,4128
+togo-0.1.1.dist-info/WHEEL,sha256=YJPq7zroHSsdctrb_KymZ4ss41PkmaA9SD9TZzqKSX8,112
+togo-0.1.1.dist-info/top_level.txt,sha256=bldd6tssR8THqoSDFauQQdh_pg79DMHBDhiNKgS4ttM,5
+togo-0.1.1.dist-info/RECORD,,
+togo-0.1.1.dist-info/licenses/LICENSE,sha256=OfTFHFMDSt9X89g-BWUVis-GuTPWAdjplg2z9d2dBCw,1073

togo-0.1.1.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.9.0)
+Root-Is-Purelib: false
+Tag: cp310-cp310-musllinux_1_2_x86_64
+

togo-0.1.1.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Giorgio Salluzzo
+
+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:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+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.

togo-0.1.1.dist-info/top_level.txt

@@ -0,0 +1 @@
+togo