Skip to content

IRI.Maptor.Sta.ShapefileFormat Home

Hossein Narimani Rad edited this page Sep 28, 2025 · 4 revisions

IRI.Maptor.Sta.ShapefileFormat Wiki

Welcome to the comprehensive documentation for the IRI.Maptor.Sta.ShapefileFormat library - a powerful .NET library for reading, writing, and converting ESRI Shapefile formats.

πŸ“š Quick Navigation

Topic Description
🏠 Home This overview page
πŸ“– Usage Guide Comprehensive usage documentation
πŸ—ΊοΈ Coordinate Systems Projections and transformations
πŸ’‘ Examples Code examples and tutorials
❓ Troubleshooting FAQ and common issues

🎯 What is IRI.Maptor.Sta.ShapefileFormat?

The IRI.Maptor.Sta.ShapefileFormat library is a comprehensive .NET Standard 2.1 library that provides:

  • Complete ESRI Shapefile Support: Read and write all standard shapefile components (SHP, DBF, SHX, PRJ, CPG)
  • Advanced Geometry Support: All ESRI geometry types including Point, Polyline, Polygon, and Multipoint variants
  • International Character Support: Robust encoding support for global character sets
  • Coordinate System Transformations: Full projection and coordinate system support
  • High Performance: Memory-efficient streaming APIs for large datasets
  • Type Safety: Strongly-typed attribute data handling

Prerequisites

  • .NET Standard 2.1 or higher
  • Visual Studio 2019 or later (for development)
  • Windows, macOS, or Linux (cross-platform support)

Package Manager Installation

NuGet Package Manager

Install-Package IRI.Maptor.Sta.ShapefileFormat

.NET CLI

dotnet add package IRI.Maptor.Sta.ShapefileFormat

PackageReference

<PackageReference Include="IRI.Maptor.Sta.ShapefileFormat" Version="1.0.0" />

πŸš€ Quick Start

Basic Usage

using IRI.Maptor.Sta.ShapefileFormat;

// Read a shapefile
var shapes = await Shapefile.ReadShapesAsync("data.shp");

// Process geometries
foreach (var shape in shapes)
{
    Console.WriteLine($"Geometry: {shape.AsSqlServerWkt()}");
}

✨ Key Features

πŸ“ File Format Support

  • SHP - Geometry storage with full ESRI specification compliance
  • DBF - Attribute data with advanced encoding support
  • SHX - Shape index for fast spatial queries
  • PRJ - Projection and coordinate system information
  • CPG - Code page detection for character encoding

πŸ”· Geometry Types

Point Types Polyline Types Polygon Types Multipoint Types
Point Polyline Polygon Multipoint
PointM PolylineM PolygonM MultipointM
PointZ PolylineZ PolygonZ MultipointZ

🌍 Advanced Capabilities

  • Format Conversion: WKT, WKB, and GeoJSON support
  • Internationalization: Multi-language character encoding
  • Performance: Streaming APIs for large files
  • Type Safety: Custom object mapping
  • Coordinate Systems: Full projection support
  • Spatial Indexing: Fast spatial queries

🎯 Use Cases

GIS Applications

  • Desktop GIS software
  • Web mapping applications
  • Spatial data analysis tools
  • Cartographic applications

Data Processing

  • ETL (Extract, Transform, Load) operations
  • Data format conversion
  • Batch processing of spatial data
  • Data quality assessment

Enterprise Solutions

  • Enterprise GIS systems
  • Business intelligence with spatial data
  • Location-based services
  • Asset management systems

πŸ”— Related Libraries

The IRI.Maptor.Sta.ShapefileFormat library is part of the larger IRI.Maptor ecosystem:

  • IRI.Maptor.Sta.Common - Core primitives and utilities
  • IRI.Maptor.Sta.Ogc - OGC standard implementations
  • IRI.Maptor.Sta.Spatial - Spatial data structures

πŸ“Š Performance Characteristics

  • Memory Efficient: Streaming readers for large files
  • Fast Spatial Queries: Built-in spatial indexing
  • Async Support: Non-blocking I/O operations
  • Cross-Platform: .NET Standard 2.1 compatibility

🀝 Contributing

We welcome contributions! Please see our Contributing Guidelines for details.

πŸ“„ License

This project is licensed under the MIT License - see the LICENSE file for details.

πŸ“ž Support

  • GitHub Issues: Create an issue
  • Documentation: Browse this wiki
  • Examples: Check the sample projects in the repository

Last updated: December 2024

Maptor Wiki

🏠 Home

πŸ“š Library Groups

πŸ“¦ IRI.Maptor.Sta

πŸ“ IRI.Maptor.Sta.ShapefileFormat

πŸ”§ IRI.Maptor.Ket

Coming Soon

πŸ–₯️ IRI.Maptor.Jab

Coming Soon

πŸš€ Getting Started

πŸ”— External Resources


Maptor Spatial Library Ecosystem

Clone this wiki locally