esri_shapefile 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 1eea7f296a0ef93cc09b8fe87fa30a3c01c67e61
+  data.tar.gz: 5f2f82a3facd9330fde2125598c443c529103551
+SHA512:
+  metadata.gz: a5e5a80ef2d2665e3f608229da92f49ae671d29dc74f2e9b222fb9eacb48f93eddcfd5b4edda8c4e9ff3328d013590fee16bc2bd2a09cf6b4dc0b5e8db308108
+  data.tar.gz: 53354693c75d1f5f68c040462b343456d598eae0bbcd603373a1a0f20c3c6b2c29b89a9a8a8f1cfb29a4bbd1bbdb4823730cbd25c4cb413e393cc39a5d3a3848

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2016 Joe Karayusuf
+
+MIT License
+
+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.

data/README.md

@@ -0,0 +1,51 @@
+# EsriShapefile
+
+Ruby library to read an [ESRI Shapefile](https://www.esri.com/library/whitepapers/pdfs/shapefile.pdf)
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'esri_shapefile'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install esri_shapefile
+
+## Usage
+
+### Read the header of a shapefile
+
+```ruby
+require 'esri_shapefile'
+reader = EsriShapefile::Reader.new("/path/to/shapefile")
+reader.main_file_header # => Instance of EsriShapefile::MainFileHeader
+```
+
+### Read all of the records in a shapefile
+
+Supported shapes can be found [here](lib/esri_shapefile/models/shapes)
+
+```ruby
+require 'esri_shapefile'
+reader = EsriShapefile::Reader.new("path/to/shapefile")
+reader.each_record do |header, shape|
+  # Iterate over each record with access to the header and shape.
+  # The header will be an instance of the EsriShapefile::RecordHeader class.
+  # The shape will be one of the shape models found in the models/shapes directory. Example: EsriShapefile::Shapes::Polygon
+end
+```
+
+## Contributing
+
+1. Fork it ( https://github.com/karayusuf/esri_shapefile/fork )
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create a new Pull Request

data/Rakefile

@@ -0,0 +1,2 @@
+require "bundler/gem_tasks"
+

data/lib/esri_shapefile/byte_model/field.rb

@@ -0,0 +1,48 @@
+module EsriShapefile
+  module ByteModel
+    class Field
+      attr_reader :name, :position, :type, :byte_order, :number
+
+      TYPES = {
+        integer: { bytesize: 4,  unpack: { big: 'l>', little: 'l<' } },
+        double:  { bytesize: 8,  unpack: { big: 'G',  little: 'E'  } },
+        point:   { bytesize: 16, unpack: { big: 'G',  little: 'E', multiplier: 2 } },
+      }
+
+      def initialize(name, position:, type:, byte_order:, number: nil)
+        @name = name
+        @position = position
+        @type = type
+        @number = number
+        @byte_order = byte_order
+      end
+
+      def list?
+        !@number.nil?
+      end
+
+      def number
+        @number.nil? ? 1 : @number
+      end
+
+      def number_depends_on_field?
+        @number.is_a?(Symbol)
+      end
+
+      def unused?
+        name == :unused
+      end
+
+      def bytesize
+        TYPES[@type][:bytesize]
+      end
+
+      def unpack_format(values = {})
+        number_of_consecutive_values = number_depends_on_field? ? values[number] : number
+        multiplier = TYPES[@type][:unpack][:multiplier] || 1
+        unpack_format = TYPES[@type][:unpack][@byte_order]
+        "#{unpack_format}#{number_of_consecutive_values * multiplier}"
+      end
+    end
+  end
+end

data/lib/esri_shapefile/byte_model.rb

@@ -0,0 +1,43 @@
+module EsriShapefile
+  module ByteModel
+
+    def field(name, number: nil, position:, type:, byte_order:)
+      attr_accessor name unless name == :unused
+      fields << Field.new(name, position: position, type: type, byte_order: byte_order, number: number)
+    end
+
+    def fields
+      @fields ||= []
+    end
+
+    def from_bytes(bytes)
+      field_values = {}
+      fields.reduce(0) do |offset, field|
+        if !field.unused?
+          unpack_format = field.unpack_format(field_values)
+          field_value = bytes.unpack("@#{offset}#{unpack_format}")
+
+          if field.type == :point
+            field_value = field_value.each_slice(2).map do |x, y|
+              point = Shapes::Point.new
+              point.x = x
+              point.y = y
+              point
+            end
+          end
+
+          field_values[field.name] = field.list? ? field_value : field_value.first
+        end
+
+        offset += field.bytesize
+        (offset < bytes.size) ? offset : break
+      end
+
+      field_values.reduce(self.new) do |model, (field, value)|
+        model.send("#{field}=", value)
+        model
+      end
+    end
+
+  end
+end

data/lib/esri_shapefile/models/main_file_header.rb

@@ -0,0 +1,47 @@
+require 'esri_shapefile/byte_model'
+
+module EsriShapefile
+  #
+  # The main file header is 100 bytes long. The fields in the file header are
+  # listed below with their byte position, type, and byte order. Position is
+  # with respect to the start of the file.
+  #
+  class MainFileHeader
+    extend EsriShapefile::ByteModel
+
+    field :file_code,   position:  0, type: :integer, byte_order: :big
+    field :unused,      position:  4, type: :integer, byte_order: :big
+    field :unused,      position:  8, type: :integer, byte_order: :big
+    field :unused,      position: 12, type: :integer, byte_order: :big
+    field :unused,      position: 16, type: :integer, byte_order: :big
+    field :unused,      position: 20, type: :integer, byte_order: :big
+
+    field :file_length, position: 24, type: :integer, byte_order: :big
+    field :version,     position: 28, type: :integer, byte_order: :little
+    field :shape_type,  position: 32, type: :integer, byte_order: :little
+
+    field :x_min,       position: 36, type: :double,  byte_order: :little
+    field :y_min,       position: 44, type: :double,  byte_order: :little
+    field :x_max,       position: 52, type: :double,  byte_order: :little
+    field :y_max,       position: 60, type: :double,  byte_order: :little
+
+    field :z_min,       position: 68, type: :double,  byte_order: :little
+    field :z_max,       position: 76, type: :double,  byte_order: :little
+    field :m_min,       position: 84, type: :double,  byte_order: :little
+    field :m_max,       position: 92, type: :double,  byte_order: :little
+
+    # The value for file length is the total length of the file in 16-bit words
+    # (including the fifty 16-bit words that make up the header). This means
+    # that we need to multiply the value by 2 in order to know the size of the
+    # file in bytes
+    def file_length_bytes
+      file_length * 2
+    end
+
+    def shape
+      Shapes.from_type(shape_type)
+    end
+
+  end
+end
+

data/lib/esri_shapefile/models/record_header.rb

@@ -0,0 +1,28 @@
+require 'esri_shapefile/byte_model'
+
+module EsriShapefile
+  #
+  # The header for each record stores the record number and content length for
+  # the record. Record headers have a fixed length of 8 bytes. The list of
+  # fields shows the fields in the record header with their byte position, type,
+  # and byte order. The field position is with respect to the start of the
+  # record.
+  #
+  class RecordHeader
+    extend EsriShapefile::ByteModel
+
+    # Record numbers begin at 1.
+    field :record_number,  position: 0, type: :integer, byte_order: :big
+
+    # The content length for a record is the length of the record contents
+    # section measured in 16-bit words. Each record, therefore, contributes (4 +
+    # content_length) 16-bit words toward the total length of the file, as
+    # stored as Byte 24 in the file header.
+    field :content_length, position: 4, type: :integer, byte_order: :big
+
+    def content_length_bytes
+      content_length * 2
+    end
+  end
+end
+

data/lib/esri_shapefile/models/shapes/multi_patch.rb

@@ -0,0 +1,33 @@
+require 'esri_shapefile/byte_model'
+
+module EsriShapefile
+  module Shapes
+    #
+    #
+    #
+    class MultiPatch
+      extend EsriShapefile::ByteModel
+
+      field :shape_type, position: 0,  type: :integer, byte_order: :little
+      field :x_min,      position: 4,  type: :double,  byte_order: :little
+      field :y_min,      position: 12, type: :double,  byte_order: :little
+      field :x_max,      position: 20, type: :double,  byte_order: :little
+      field :y_max,      position: 28, type: :double,  byte_order: :little
+
+      field :num_parts,  position: 36, type: :integer, byte_order: :little
+      field :num_points, position: 40, type: :integer, byte_order: :little
+      field :parts,      position: 44, type: :integer, byte_order: :little, number: :num_parts
+      field :part_types, position: :w, type: :integer, byte_order: :little, number: :num_parts
+      field :points,     position: :x, type: :point,   byte_order: :little, number: :num_points
+
+      field :z_min,      position: :x,         type: :double, byte_order: :little
+      field :z_max,      position: :x_plus_8,  type: :double, byte_order: :little
+      field :z_array,    position: :x_plus_16, type: :double, byte_order: :little, number: :num_points
+
+      field :m_min,      position: :y,         type: :double, byte_order: :little
+      field :m_max,      position: :y_plus_8,  type: :double, byte_order: :little
+      field :m_array,    position: :y_plus_16, type: :double, byte_order: :little, number: :num_points
+    end
+  end
+end
+

data/lib/esri_shapefile/models/shapes/multi_point.rb

@@ -0,0 +1,21 @@
+require 'esri_shapefile/byte_model'
+
+module EsriShapefile
+  module Shapes
+    #
+    # A MultiPoint represents a set of points.
+    #
+    class MultiPoint
+      extend EsriShapefile::ByteModel
+
+      field :shape_type, position: 0,  type: :integer, byte_order: :little
+      field :x_min,      position: 4,  type: :double,  byte_order: :little
+      field :y_min,      position: 12, type: :double,  byte_order: :little
+      field :x_max,      position: 20, type: :double,  byte_order: :little
+      field :y_max,      position: 28, type: :double,  byte_order: :little
+      field :num_points, position: 36, type: :integer, byte_order: :little
+      field :points,     position: 40, type: :point,   byte_order: :little, number: :num_points
+    end
+  end
+end
+

data/lib/esri_shapefile/models/shapes/multi_point_m.rb

@@ -0,0 +1,25 @@
+require 'esri_shapefile/byte_model'
+
+module EsriShapefile
+  module Shapes
+    #
+    # A MultiPoint represents a set of points.
+    #
+    class MultiPointM
+      extend EsriShapefile::ByteModel
+
+      field :shape_type, position: 0,  type: :integer, byte_order: :little
+      field :x_min,      position: 4,  type: :double,  byte_order: :little
+      field :y_min,      position: 12, type: :double,  byte_order: :little
+      field :x_max,      position: 20, type: :double,  byte_order: :little
+      field :y_max,      position: 28, type: :double,  byte_order: :little
+      field :num_points, position: 36, type: :integer, byte_order: :little
+      field :points,     position: 40, type: :point,   byte_order: :little, number: :num_points
+
+      field :m_min,      position: :x,         type: :double, byte_order: :little
+      field :m_max,      position: :x_plus_8,  type: :double, byte_order: :little
+      field :m_array,    position: :x_plus_16, type: :double, byte_order: :little, number: :num_points
+    end
+  end
+end
+

data/lib/esri_shapefile/models/shapes/multi_point_z.rb

@@ -0,0 +1,29 @@
+require 'esri_shapefile/byte_model'
+
+module EsriShapefile
+  module Shapes
+    #
+    # A MultiPoint represents a set of points.
+    #
+    class MultiPointZ
+      extend EsriShapefile::ByteModel
+
+      field :shape_type, position: 0,  type: :integer, byte_order: :little
+      field :x_min,      position: 4,  type: :double,  byte_order: :little
+      field :y_min,      position: 12, type: :double,  byte_order: :little
+      field :x_max,      position: 20, type: :double,  byte_order: :little
+      field :y_max,      position: 28, type: :double,  byte_order: :little
+      field :num_points, position: 36, type: :integer, byte_order: :little
+      field :points,     position: 40, type: :point,   byte_order: :little, number: :num_points
+
+      field :z_min,      position: :x,         type: :double, byte_order: :little
+      field :z_max,      position: :x_plus_8,  type: :double, byte_order: :little
+      field :z_array,    position: :x_plus_16, type: :double, byte_order: :little, number: :num_points
+
+      field :m_min,      position: :y,         type: :double, byte_order: :little
+      field :m_max,      position: :y_plus_8,  type: :double, byte_order: :little
+      field :m_array,    position: :y_plus_16, type: :double, byte_order: :little, number: :num_points
+    end
+  end
+end
+

data/lib/esri_shapefile/models/shapes/null.rb

@@ -0,0 +1,19 @@
+require 'esri_shapefile/byte_model'
+
+module EsriShapefile
+  module Shapes
+    #
+    # A shape type of 0 indicates a null shape, with no geometric data for the
+    # shape. Each feature type (point, lie, polygon, etc.) supports nulls - it
+    # is valid to have points and null points in the same shapefile. Often null
+    # shapes are place holders; they are used during shapefile creation and are
+    # populated with geometric data soon after they are created.
+    #
+    class Null
+      extend EsriShapefile::ByteModel
+
+      field :shape_type, position: 0, type: :integer, byte_order: :little
+    end
+  end
+end
+

data/lib/esri_shapefile/models/shapes/point.rb

@@ -0,0 +1,19 @@
+require 'esri_shapefile/byte_model'
+
+module EsriShapefile
+  module Shapes
+    #
+    # A point consists of a pair of double-precision coordinates
+    # in the order X,Y.
+    #
+    class Point
+      extend EsriShapefile::ByteModel
+
+      field :shape_type, position: 0,  type: :integer, byte_order: :little
+      field :x,          position: 4,  type: :double,  byte_order: :little
+      field :y,          position: 12, type: :double,  byte_order: :little
+
+    end
+  end
+end
+

data/lib/esri_shapefile/models/shapes/point_m.rb

@@ -0,0 +1,20 @@
+require 'esri_shapefile/byte_model'
+
+module EsriShapefile
+  module Shapes
+    #
+    # A point consists of a pair of double-precision coordinates
+    # in the order X,Y,Z plus a measure.
+    #
+    class PointM
+      extend EsriShapefile::ByteModel
+
+      field :shape_type, position: 0,  type: :integer, byte_order: :little
+      field :x,          position: 4,  type: :double,  byte_order: :little
+      field :y,          position: 12, type: :double,  byte_order: :little
+      field :measure,    position: 28, type: :double,  byte_order: :little
+
+    end
+  end
+end
+

data/lib/esri_shapefile/models/shapes/point_z.rb

@@ -0,0 +1,21 @@
+require 'esri_shapefile/byte_model'
+
+module EsriShapefile
+  module Shapes
+    #
+    # A point consists of a pair of double-precision coordinates
+    # in the order X,Y,Z plus a measure.
+    #
+    class PointZ
+      extend EsriShapefile::ByteModel
+
+      field :shape_type, position: 0,  type: :integer, byte_order: :little
+      field :x,          position: 4,  type: :double,  byte_order: :little
+      field :y,          position: 12, type: :double,  byte_order: :little
+      field :z,          position: 20, type: :double,  byte_order: :little
+      field :measure,    position: 28, type: :double,  byte_order: :little
+
+    end
+  end
+end
+

data/lib/esri_shapefile/models/shapes/poly_line.rb

@@ -0,0 +1,43 @@
+require 'esri_shapefile/byte_model'
+
+module EsriShapefile
+  module Shapes
+    #
+    # A PolyLine is an ordered set of vertices that consists of one or more
+    # parts. A part is a connected sequence of two or more points. Parts may or
+    # may not be connected to one another. Parts may or may not intersect one
+    # another.
+    #
+    # Because this specification does not forbid consecutive points with
+    # identical coordinates, shapefile readers must handle such cases. On the
+    # other hand, the degenerate, zero length parts that might result are not
+    # allowed.
+    #
+    class PolyLine
+      extend EsriShapefile::ByteModel
+
+      field :shape_type, position: 0,  type: :integer, byte_order: :little
+      field :x_min,      position: 4,  type: :double,  byte_order: :little
+      field :y_min,      position: 12, type: :double,  byte_order: :little
+      field :x_max,      position: 20, type: :double,  byte_order: :little
+      field :y_max,      position: 28, type: :double,  byte_order: :little
+
+      # The number of parts in the PolyLine
+      field :num_parts,  position: 36, type: :integer, byte_order: :little
+
+      # The total number of points for all parts.
+      field :num_points, position: 40, type: :integer, byte_order: :little
+
+      # An array of length num_parts. Stores, for each PolyLine, the index of
+      # its first point in the points array. Array indexes are with respect to 0.
+      field :parts,      position: 44, type: :integer, byte_order: :little, number: :num_parts
+
+      # An array of length NumPoints. The points for each part in the PolyLine
+      # are stored end to end. The points for Part 2 follow the points for
+      # Part 1, and so on. The parts array holds the array index of the starting
+      # point for each part. There is no delimiter in the points array between parts.
+      field :points,     position: :x, type: :point,   byte_order: :little, number: :num_points
+    end
+  end
+end
+

data/lib/esri_shapefile/models/shapes/poly_line_m.rb

@@ -0,0 +1,50 @@
+require 'esri_shapefile/byte_model'
+
+module EsriShapefile
+  module Shapes
+    #
+    # A PolyLineM consists of one or more parts. A part is a connected sequence
+    # of two or more points. Parts may or may not be connected to one another.
+    # Parts may or may not intersect one another.
+    #
+    class PolyLineM
+      extend EsriShapefile::ByteModel
+
+      field :shape_type, position: 0,  type: :integer, byte_order: :little
+      field :x_min,      position: 4,  type: :double,  byte_order: :little
+      field :y_min,      position: 12, type: :double,  byte_order: :little
+      field :x_max,      position: 20, type: :double,  byte_order: :little
+      field :y_max,      position: 28, type: :double,  byte_order: :little
+
+      # The number of parts in the PolyLine
+      field :num_parts,  position: 36, type: :integer, byte_order: :little
+
+      # The total number of points for all parts.
+      field :num_points, position: 40, type: :integer, byte_order: :little
+
+      # An array of length num_parts. Stores, for each PolyLine, the index of
+      # its first point in the points array. Array indexes are with respect to 0.
+      field :parts,      position: 44, type: :integer, byte_order: :little, number: :num_parts
+
+      # An array of length NumPoints. The points for each part in the PolyLine
+      # are stored end to end. The points for Part 2 follow the points for
+      # Part 1, and so on. The parts array holds the array index of the starting
+      # point for each part. There is no delimiter in the points array between parts.
+      field :points,     position: :x, type: :point,   byte_order: :little, number: :num_points
+
+      # The minimum measure for the PolyLineZ
+      field :m_min,      position: :z,         type: :double,  byte_order: :little
+
+      # The maximum measure for the PolyLineZ
+      field :m_max,      position: :z_plus_8,  type: :double,  byte_order: :little
+
+      # An array of length num_points. The measures for each part in the
+      # PolyLineZ are stored end to end. The measures for Part 2 follow the
+      # measures for Part 1, and so on. The parts array holds the array index of
+      # the starting measure for each part. There is no delimited in the measure
+      # array between parts.
+      field :m_array,    position: :z_plus_16, type: :double,  byte_order: :little,  number: :num_points
+    end
+  end
+end
+

data/lib/esri_shapefile/models/shapes/poly_line_z.rb

@@ -0,0 +1,63 @@
+require 'esri_shapefile/byte_model'
+
+module EsriShapefile
+  module Shapes
+    #
+    # A PolyLineZ consists of one or more parts. A part is a connected sequence
+    # of two or more points. Parts may or may not be connected to one another.
+    # Parts may or may not intersect one another.
+    #
+    class PolyLineZ
+      extend EsriShapefile::ByteModel
+
+      field :shape_type, position: 0,  type: :integer, byte_order: :little
+      field :x_min,      position: 4,  type: :double,  byte_order: :little
+      field :y_min,      position: 12, type: :double,  byte_order: :little
+      field :x_max,      position: 20, type: :double,  byte_order: :little
+      field :y_max,      position: 28, type: :double,  byte_order: :little
+
+      # The number of parts in the PolyLine
+      field :num_parts,  position: 36, type: :integer, byte_order: :little
+
+      # The total number of points for all parts.
+      field :num_points, position: 40, type: :integer, byte_order: :little
+
+      # An array of length num_parts. Stores, for each PolyLine, the index of
+      # its first point in the points array. Array indexes are with respect to 0.
+      field :parts,      position: 44, type: :integer, byte_order: :little, number: :num_parts
+
+      # An array of length NumPoints. The points for each part in the PolyLine
+      # are stored end to end. The points for Part 2 follow the points for
+      # Part 1, and so on. The parts array holds the array index of the starting
+      # point for each part. There is no delimiter in the points array between parts.
+      field :points,     position: :x, type: :point,   byte_order: :little, number: :num_points
+
+      # The minimum Z value for the PolyLineZ
+      field :z_min,      position: :y,         type: :double,  byte_order: :little
+
+      # The maximum Z value for the PoliyLineZ
+      field :z_max,      position: :y_plus_8,  type: :double,  byte_order: :little
+
+      # An array of length num_points. the Z values for each part in the
+      # PolyLineZ are stored end to end. The Z values for Part 2 follow the Z
+      # values for Part 1, and so on. The parts array holds the array index of
+      # the starting point for each part. There is no delimited in the Z array
+      # between parts.
+      field :z_array,    position: :y_plus_16, type: :double,  byte_order: :little,  number: :num_points
+
+      # The minimum measure for the PolyLineZ
+      field :m_min,      position: :z,         type: :double,  byte_order: :little
+
+      # The maximum measure for the PolyLineZ
+      field :m_max,      position: :z_plus_8,  type: :double,  byte_order: :little
+
+      # An array of length num_points. The measures for each part in the
+      # PolyLineZ are stored end to end. The measures for Part 2 follow the
+      # measures for Part 1, and so on. The parts array holds the array index of
+      # the starting measure for each part. There is no delimited in the measure
+      # array between parts.
+      field :m_array,    position: :z_plus_16, type: :double,  byte_order: :little,  number: :num_points
+    end
+  end
+end
+

data/lib/esri_shapefile/models/shapes/polygon.rb

@@ -0,0 +1,38 @@
+require 'esri_shapefile/byte_model'
+
+module EsriShapefile
+  module Shapes
+    #
+    # A polygon consists of one or more rings. A ring is a connected sequence of
+    # four or more points that form a closed, non-self-intersecting loop. A
+    # polygon may contain multiple outer rings. The order of vertices or
+    # orientation for a ring indicates which side of the ring is the interior of
+    # the polygon. The neighborhood to the right of an observer walking along
+    # the ring in vertex order is the neighborhood inside the polygon. Vertices
+    # of rings defining holes in polygons are in counterclockwise direction.
+    # Vertices for a single, ringed polygon are, therefore, always in clockwise
+    # order. The rings of a polygon are referred to as its parts.
+    #
+    # Because this specification does not forbid consecutive points with
+    # identical coordinates, shapefile readers must handle such cases. On the
+    # other hand, the degenerate, zero length or zero area parts that might
+    # result are not allowed.
+    #
+    # The Polygon structure is identical to the PolyLine structure.
+    #
+    class Polygon
+      extend EsriShapefile::ByteModel
+
+      field :shape_type, position: 0, type: :integer, byte_order: :little
+      field :x_min,      position: 4,  type: :double,  byte_order: :little
+      field :y_min,      position: 12, type: :double,  byte_order: :little
+      field :x_max,      position: 20, type: :double,  byte_order: :little
+      field :y_max,      position: 28, type: :double,  byte_order: :little
+      field :num_parts,  position: 36, type: :integer, byte_order: :little
+      field :num_points, position: 40, type: :integer, byte_order: :little
+      field :parts,      position: 44, type: :integer, byte_order: :little, number: :num_parts
+      field :points,     position: :x, type: :point,   byte_order: :little, number: :num_points
+    end
+  end
+end
+