logo
  • Home
  • About
  • Getting started
  • Documentation
  • Community

Documentation

  • User Guide
    • Data Structures
    • Reading and Writing Files
    • Indexing and Selecting Data
    • Making Maps and plots
    • Interactive mapping
    • Managing Projections
    • Geometric Manipulations
    • Set Operations with overlay
    • Aggregation with dissolve
    • Merging Data
    • Geocoding
  • Advanced Guide
    • Missing and empty geometries
    • Re-projecting using GDAL with Rasterio and Fiona
  • API reference
    • GeoSeries
      • geopandas.GeoSeries
      • geopandas.GeoSeries.area
      • geopandas.GeoSeries.boundary
      • geopandas.GeoSeries.bounds
      • geopandas.GeoSeries.total_bounds
      • geopandas.GeoSeries.length
      • geopandas.GeoSeries.geom_type
      • geopandas.GeoSeries.distance
      • geopandas.GeoSeries.representative_point
      • geopandas.GeoSeries.exterior
      • geopandas.GeoSeries.interiors
      • geopandas.GeoSeries.x
      • geopandas.GeoSeries.y
      • geopandas.GeoSeries.z
      • geopandas.GeoSeries.is_empty
      • geopandas.GeoSeries.is_ring
      • geopandas.GeoSeries.is_simple
      • geopandas.GeoSeries.is_valid
      • geopandas.GeoSeries.has_z
      • geopandas.GeoSeries.contains
      • geopandas.GeoSeries.crosses
      • geopandas.GeoSeries.disjoint
      • geopandas.GeoSeries.geom_equals
      • geopandas.GeoSeries.geom_almost_equals
      • geopandas.GeoSeries.geom_equals_exact
      • geopandas.GeoSeries.intersects
      • geopandas.GeoSeries.overlaps
      • geopandas.GeoSeries.touches
      • geopandas.GeoSeries.within
      • geopandas.GeoSeries.covers
      • geopandas.GeoSeries.covered_by
      • geopandas.GeoSeries.difference
      • geopandas.GeoSeries.intersection
      • geopandas.GeoSeries.symmetric_difference
      • geopandas.GeoSeries.union
      • geopandas.GeoSeries.buffer
      • geopandas.GeoSeries.boundary
      • geopandas.GeoSeries.centroid
      • geopandas.GeoSeries.convex_hull
      • geopandas.GeoSeries.envelope
      • geopandas.GeoSeries.simplify
      • geopandas.GeoSeries.affine_transform
      • geopandas.GeoSeries.rotate
      • geopandas.GeoSeries.scale
      • geopandas.GeoSeries.skew
      • geopandas.GeoSeries.translate
      • geopandas.GeoSeries.unary_union
      • geopandas.GeoSeries.explode
      • geopandas.GeoSeries.from_file
      • geopandas.GeoSeries.from_wkb
      • geopandas.GeoSeries.from_wkt
      • geopandas.GeoSeries.from_xy
      • geopandas.GeoSeries.to_file
      • geopandas.GeoSeries.to_json
      • geopandas.GeoSeries.to_wkb
      • geopandas.GeoSeries.to_wkt
      • geopandas.GeoSeries.crs
      • geopandas.GeoSeries.set_crs
      • geopandas.GeoSeries.to_crs
      • geopandas.GeoSeries.estimate_utm_crs
      • geopandas.GeoSeries.fillna
      • geopandas.GeoSeries.isna
      • geopandas.GeoSeries.notna
      • geopandas.GeoSeries.clip
      • geopandas.GeoSeries.plot
      • geopandas.GeoSeries.explore
      • geopandas.GeoSeries.sindex
      • geopandas.GeoSeries.has_sindex
      • geopandas.GeoSeries.cx
      • geopandas.GeoSeries.__geo_interface__
    • GeoDataFrame
      • geopandas.GeoDataFrame
      • geopandas.GeoDataFrame.from_file
      • geopandas.GeoDataFrame.from_features
      • geopandas.GeoDataFrame.from_postgis
      • geopandas.GeoDataFrame.to_file
      • geopandas.GeoDataFrame.to_json
      • geopandas.GeoDataFrame.to_parquet
      • geopandas.GeoDataFrame.to_feather
      • geopandas.GeoDataFrame.to_postgis
      • geopandas.GeoDataFrame.to_wkb
      • geopandas.GeoDataFrame.to_wkt
      • geopandas.GeoDataFrame.crs
      • geopandas.GeoDataFrame.set_crs
      • geopandas.GeoDataFrame.to_crs
      • geopandas.GeoDataFrame.estimate_utm_crs
      • geopandas.GeoDataFrame.rename_geometry
      • geopandas.GeoDataFrame.set_geometry
      • geopandas.GeoDataFrame.dissolve
      • geopandas.GeoDataFrame.explode
      • geopandas.GeoDataFrame.sjoin
      • geopandas.GeoDataFrame.sjoin_nearest
      • geopandas.GeoDataFrame.clip
      • geopandas.GeoDataFrame.overlay
      • geopandas.GeoDataFrame.explore
      • geopandas.GeoDataFrame.plot
      • geopandas.GeoDataFrame.sindex
      • geopandas.GeoDataFrame.has_sindex
      • geopandas.GeoDataFrame.cx
      • geopandas.GeoDataFrame.__geo_interface__
      • geopandas.GeoDataFrame.iterfeatures
    • Input/output
      • geopandas.read_file
      • geopandas.GeoDataFrame.to_file
      • geopandas.read_postgis
      • geopandas.GeoDataFrame.to_postgis
      • geopandas.read_feather
      • geopandas.GeoDataFrame.to_feather
      • geopandas.read_parquet
      • geopandas.GeoDataFrame.to_parquet
    • Tools
      • geopandas.sjoin
      • geopandas.sjoin_nearest
      • geopandas.overlay
      • geopandas.clip
      • geopandas.tools.geocode
      • geopandas.tools.reverse_geocode
      • geopandas.tools.collect
      • geopandas.points_from_xy
      • geopandas.datasets.available
      • geopandas.datasets.get_path
    • Spatial index
      • geopandas.GeoSeries.sindex
      • geopandas.sindex.SpatialIndex.intersection
      • geopandas.sindex.SpatialIndex.is_empty
      • geopandas.sindex.SpatialIndex.nearest
      • geopandas.sindex.SpatialIndex.query
      • geopandas.sindex.SpatialIndex.query_bulk
      • geopandas.sindex.SpatialIndex.size
      • geopandas.sindex.SpatialIndex.valid_query_predicates
    • Testing
      • geopandas.testing.assert_geoseries_equal
      • geopandas.testing.assert_geodataframe_equal
  • Changelog

User Guide¶

The User Guide covers different parts of basic usage of GeoPandas. Each page focuses on a single topic and outlines how it is implemented in GeoPandas, with reproducible examples.

If you don’t know anything about GeoPandas, start with the Introduction to GeoPandas.

Advanced topics can be found in the Advanced Guide and further specification in the API Reference.

  • Data Structures
    • GeoSeries
    • GeoDataFrame
    • Display options
  • Reading and Writing Files
    • Reading Spatial Data
    • Writing Spatial Data
    • Spatial databases
    • Apache Parquet and Feather file formats
  • Indexing and Selecting Data
  • Making Maps and plots
    • Choropleth Maps
    • Maps with Layers
    • Pandas Plots
    • Other Resources
  • Interactive mapping
  • Managing Projections
    • Coordinate Reference Systems
    • What is the best format to store the CRS information?
    • Setting a Projection
    • Re-Projecting
    • Projection for multiple geometry columns
    • Upgrading to GeoPandas 0.7 with pyproj > 2.2 and PROJ > 6
  • Geometric Manipulations
    • Constructive Methods
    • Affine transformations
  • Set Operations with overlay
    • The different Overlay operations
    • Overlay Countries Example
    • keep_geom_type keyword
    • More Examples
  • Aggregation with dissolve
    • dissolve() Example
    • Dissolve Arguments
  • Merging Data
    • Appending
    • Attribute Joins
    • Spatial Joins
  • Geocoding
Documentation Data Structures

© Copyright 2013–2021, GeoPandas developers.

Created using Sphinx 4.2.0.