Metadata-Version: 2.4
Name: wesamoyo-geotools
Version: 1.1.0
Summary: Professional geospatial engine for surveying, civil engineering, and high-precision UTM transformations with Combined Scale Factor (CSF)
Home-page: https://houndtid.com
Author: Houndtid Labs
Author-email: houndtidai@gmail.com
Project-URL: Company, https://houndtid.com
Project-URL: Source Code, https://github.com/houndtidlabs/wesamoyo-geotools
Project-URL: Bug Tracker, https://github.com/houndtidlabs/wesamoyo-geotools/issues
Project-URL: Documentation, https://github.com/houndtidlabs/wesamoyo-geotools/wiki
Project-URL: Support, https://houndtid.com/support
Keywords: surveying,geospatial,GIS,COGO,UTM,Houndtid Labs,civil engineering,CSF,Uganda,East Africa,coordinate conversion,traverse adjustment,wesamoyo
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Science/Research
Classifier: Intended Audience :: Developers
Classifier: Topic :: Scientific/Engineering :: GIS
Classifier: Topic :: Scientific/Engineering
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Operating System :: OS Independent
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Provides-Extra: dev
Requires-Dist: pytest>=7.0.0; extra == "dev"
Requires-Dist: twine>=4.0.0; extra == "dev"
Requires-Dist: wheel>=0.38.0; extra == "dev"
Requires-Dist: build>=0.9.0; extra == "dev"
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: keywords
Dynamic: project-url
Dynamic: provides-extra
Dynamic: requires-python
Dynamic: summary

Wesamoyo GeoToolsHigh-Precision Geospatial Engine by Houndtid LabsWesamoyo GeoTools is a professional-grade Python library built for Surveyors, Civil Engineers, and GIS Professionals. Developed by Houndtid Labs, this engine specializes in high-accuracy coordinate transformations, engineering scale factor corrections, and multi-format CAD/Web exports.Unlike standard converters, Wesamoyo GeoTools accounts for Earth curvature and elevation distortion, ensuring that your data is ready for real-world construction and legal land surveying.🚀 Professional Engineering Features1. High-Precision Coordinate TransformationGeographic ↔ UTM: Convert between WGS84 Latitude/Longitude and UTM Easting/Northing.3D Awareness: Full support for Ellipsoidal Height (Elevation).Automatic Zone Detection: Automatically identifies UTM Zones (including the 35N/36N split in East Africa).Equator Logic: Correctly handles the $10,000,000$m False Northing for Southern Hemisphere projects (e.g., Mbarara, Masaka).2. Engineering Scale Factor Suite (Critical for Construction)Don't just move points—correct them. This library calculates:Grid Scale Factor (k): Corrects for UTM projection distortion.Elevation Factor (EF): Accounts for height above the ellipsoid (Sea Level).Combined Scale Factor (CSF): The "Golden Number" for surveyors to convert Map Distance to Ground Distance.3. Professional Survey IO (Multi-Format Export)Take one CSV and instantly generate deliverables for every department:AutoCAD (DXF): Generates 3D DXF files. Points appear at their true elevation in Civil 3D/AutoCAD.Web/Mobile (GeoJSON): Exports 3D GeoJSON for instant mapping in Google Maps, Leaflet, or mobile apps.Clean Survey CSV: Outputs sanitized CSVs with Easting, Northing, Zone, and CSF metadata included.📦 InstallationBashpip install wesamoyo-geotools
🎯 Quick Start ExamplesBulk Process a Survey CSVPerfect for processing thousands of site points in seconds.Pythonfrom wesamoyo_geotools.io import SurveyIO
from wesamoyo_geotools.coordinates import CoordinateConverter

# Process raw GPS CSV to Professional Survey CSV
# Automatically detects 'lat', 'lon', 'alt' or 'lng' headers
SurveyIO.process_csv("field_data.csv", "final_report.csv", CoordinateConverter.latlong_to_utm)
Engineering Math Test (3D)Verify the Combined Scale Factor for a high-altitude project.Pythonfrom wesamoyo_geotools.coordinates import CoordinateConverter

conv = CoordinateConverter()
# Lat: 1.0, Lon: 34.0, Alt: 2000m
res = conv.latlong_to_utm(1.0, 34.0, 2000.0)

print(f"Easting: {res.easting:.3f}")
print(f"Northing: {res.northing:.3f}")
print(f"Combined Scale Factor: {res.combined_scale_factor:.8f}")
Export for AutoCADPythonfrom wesamoyo_geotools.io import SurveyIO

points = [(611263.8, 110547.1, 2000.0), (611300.5, 110600.2, 2005.0)]
SurveyIO.export_to_dxf(points, "site_plan.dxf")
📊 Industry Use CasesRoad & Bridge Construction: Use the CSF to ensure ground-measured distances match the engineering design.Cadastral Surveying: Process land parcel boundaries with high-precision WGS84 math.Topographic Mapping: Generate 3D DXF points for contouring in AutoCAD.Real Estate Tech: Convert GPS coordinates for web-based property portals using GeoJSON.🛠 Advanced CapabilitiesSmart Header Detection: No need to format your CSV perfectly; the engine finds latitude, lat, y, etc., automatically.Robust Error Handling: Skips messy data rows without crashing the entire batch process.3D Geometry: All exports maintain $Z$ (Elevation) values for full BIM/CAD integration.📄 License & CreditsEngineered by Houndtid LabsLicensed under the MIT License.For professional support or custom geospatial integrations, contact Houndtid Labs.
