https://github.com/12rambau/pygadm

Easy access to administrative boundary defined by GADM from Python scripts
https://github.com/12rambau/pygadm

administration gadm geography geopandas gis mapping python remote-sensing vector

Last synced: 2 months ago
JSON representation

Easy access to administrative boundary defined by GADM from Python scripts

• Host: GitHub
• URL: https://github.com/12rambau/pygadm
• Owner: 12rambau
• License: mit
• Created: 2022-12-14T16:47:34.000Z (about 2 years ago)
• Default Branch: main
• Last Pushed: 2024-07-22T14:53:36.000Z (6 months ago)
• Last Synced: 2024-10-14T07:26:52.733Z (3 months ago)
• Topics: administration, gadm, geography, geopandas, gis, mapping, python, remote-sensing, vector
• Language: Python
• Homepage: https://pygadm.readthedocs.io
• Size: 22.4 MB
• Stars: 7
• Watchers: 3
• Forks: 1
• Open Issues: 6
• Metadata Files:
  • Readme: README.rst
  • Contributing: CONTRIBUTING.rst
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.rst
  • Citation: CITATION.cff
  • Authors: AUTHORS.rst

Awesome Lists containing this project

README

        
PyGADM

======

.. image:: https://img.shields.io/badge/License-MIT-yellow?logo=opensourceinitiative&logoColor=white

    :target: LICENSE

    :alt: License: MIT

.. image:: https://img.shields.io/badge/Conventional%20Commits-1.0.0-yellow?logo=git&logoColor=white

   :target: https://conventionalcommits.org

   :alt: conventional commit

.. image:: https://img.shields.io/badge/code%20style-black-000000?logo=ford&logoColor=white

   :target: https://github.com/psf/black

   :alt: Black badge

.. image:: https://img.shields.io/badge/code_style-prettier-ff69b4?logo=prettier&logoColor=white

   :target: https://github.com/prettier/prettier

   :alt: prettier badge

.. image:: https://img.shields.io/badge/pre--commit-active-yellow?logo=pre-commit&logoColor=white

    :target: https://pre-commit.com/

    :alt: pre-commit

.. image:: https://img.shields.io/pypi/v/pygadm?color=blue&logo=python&logoColor=white

    :target: https://pypi.org/project/pygadm/

    :alt: PyPI version

.. image:: https://img.shields.io/conda/vn/conda-forge/pygadm?color=blue&logo=anaconda&logoColor=white

    :target: https://anaconda.org/conda-forge/pygadm

    :alt: Conda Version

.. image:: https://img.shields.io/github/actions/workflow/status/12rambau/pygadm/unit.yaml?logo=github&logoColor=white

    :target: https://github.com/12rambau/pygadm/actions/workflows/unit.yaml

    :alt: build

.. image:: https://img.shields.io/codecov/c/github/12rambau/pygadm?logo=codecov&logoColor=white

    :target: https://codecov.io/gh/12rambau/pygadm

    :alt: Test Coverage

.. image:: https://img.shields.io/readthedocs/pygadm?logo=readthedocs&logoColor=white

    :target: https://pygadm.readthedocs.io/en/latest/

    :alt: Documentation Status

Overview

--------

.. image:: docs/_static/logo.svg

    :width: 20%

    :align: right

Easy access to administrative boundary defined by GADM from a Python scripts.

This lib provides access to GADM datasets from a Python script without downloading the file from their server. We provide access to The current version (4.1.) which delimits 400,276 administrative areas.

The data are freely available for academic use and other non-commercial use. Redistribution, or commercial use is not allowed without prior permission. See the `license `__ of the GADM project for more details.

.. note::

   the dataset are generated in the GADM (Global Administrative Areas) project from Berkeley University. Any request relative to the geometries should be redirected to them.

install it using either ``pip`` or ``conda``:

.. code-block:: console

   pip install pygadm

and then request area of interest from their name or GADM Id:

.. code-block:: python

   import pygadm

   gdf = pygadm.AdmItems(name="Singapore", content_level=1)

Credits

-------

This package was created with `Copier `__ and the `@12rambau/pypackage `__ 0.1.11 project template.