🗺️ 🇮🇹 Italy-geopop

• 🗺️ 🇮🇹 Italy-geopop
  • 🧐 What is it?
  • 🚀 Main features
  • 🏪 Where to get it
  • 🔌 Example of use
  • 📖 License
  • 🔎 Full docs reference
  • 👩‍💻 Contributes
  • 🐛 Bugs and issues

🧐 What is it?

Italy-geopop is a python library that provides instant access to italian geospatial and population data.

🚀 Main features

• Easy access to italian geospatial and population data
• Easy geospatial plot made possible by the usage of geopandas
• Multiple years of population and geospatial data available (2022, 2023)
• Population data available by age and sex with customable age ranges
• Easy linkage of italy-geopop data with your data made possible by using pandas and the registration of italy-geopop as pandas accessor

You only need a list of municipalities (or municipality ISTAT codes), provinces (or province ISTAT codes or province abbreviations (e.g. Torino -> TO)) and regions (or region ISTAT codes). ISTAT codes can be found here or here.

🏪 Where to get it

PyPi

pip install italy-geopop, as simple as that.

GitHub - specific version (e.g. 0.1.1)

pip install git+https://github.com/zenodallavalle/italy-geopop.git@v0.1.1

GitHub - latest (main branch)

pip install git+https://github.com/zenodallavalle/italy-geopop.git@main

GitHub - development branch

pip install git+https://github.com/zenodallavalle/italy-geopop.git@dev

🔌 Example of use

>>> from italy_geopop.pandas_extension import pandas_activate
>>> pandas_activate(include_geometry=False, data_year=2022)

>>> pd.Series(["Torino", "Agliè", "Airasca"]).italy_geopop.from_municipality(population_limits='total')

>>> pd.Series(["Torino", "Milano", "Venezia"]).italy_geopop.from_province(population_limits=[50], population_labels=['below_50', 'above_equal_50'])

> > > pd.Series(["Piemonte", "Lombardia", "Veneto"]).italy_geopop.from_region()

> > > pd.Series(["Regione Lombardia", "Regione del Veneto", "Veneto o Lombardia", 15]).italy_geopop.smart_from_region()

📖 License

Italy-geopop is distributed under Creative Commons license (CC-BY-4.0). Full license can be read at LICENSE.

Italy-geopop includes data from:

• openpolis/geojson-italy, at the dime of writing distributed under Creative Commons license (CC-BY-4.0)
• ISTAT data, at the time of writing distributed under Creative Commons license (CC-BY-3.0), more info here

🔎 Full docs reference

You can find full docs on italy-geopop.readthedocs.io.

👩‍💻 Contributes

• Zeno Dalla Valle - creator and mantainer

🐛 Bugs and issues

If you experience an issue using this library first check the FAQ, you may find an immediate solution to your problem.

If your problem is not listed or the proposed solution did not worked for you, please report bugs via GitHub issues here providing also a minimum reproducible example.