wesamoyo-geotools 1.1.0

Professional geospatial engine for surveying, civil engineering, and high-precision UTM transformations with Combined Scale Factor (CSF)

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.