Paquet Python

Chaque table en DataFrame, hors ligne : les unités, les deux recensements, les établissements et les logements.

Installer

shell
pip install "morocco-communes[pandas]"

Le paquet sur PyPI

Utiliser

Python
import morocco_communes as mc

communes = mc.communes()                    # 1 503 lignes
communes[communes["region_code"] == "01"]   # les 146 de Tanger-Tétouan-Al Hoceima

people = mc.indicators("people")            # le recensement de 2024, par unité, zone et sexe
economy = mc.economy()                      # les établissements, par unité
housing = mc.housing()                      # les logements urbains, par unité

Chaque table revient en DataFrame pandas. Avec as_frame=False, c’est une liste de dictionnaires, et le paquet n’a alors besoin que de la bibliothèque standard.

Tables

AppelLignes
regions(), provinces(), cercles(), communes(), arrondissements()une par unité
indicators(subject, census)une par unité et zone, et par sexe pour les habitants
economy()une par unité, du pays jusqu’à la commune
housing()une par unité dotée d’une partie urbaine, 784 en tout
crosswalk()une par commune renumérotée en 2015

indicators prend "people" ou "households", et census "2024" ou "2014". Le recensement de 2024 pose 73 des questions de 2014 de la même façon : ces colonnes se soustraient.

Ce que mesure chaque colonne

  • fields() donne la colonne, un libellé en anglais, l’intitulé du HCP et l’unité, et pour 2024 le concept sous lequel le HCP la définit, avec sa formulation. Il prend "indicators", "indicators2014", "economy" ou "housing".
  • sources() donne l’URL de chaque classeur, son SHA-256 et la date de lecture.
  • version est la version du jeu de données, qui est aussi celle du paquet.

Codes

Une unité est identifiée par son code HCP, et le code porte la hiérarchie : 01.511.01.0 est une commune de la province 01.511, dans la région 01. Les codes restent des chaînes : code_digits garde les zéros de tête qui lui donnent ses 9 chiffres.

Ce qu’il laisse de côté

Les limites, et la superficie et la densité qui en découlent, sont sous ODbL : elles restent dans les téléchargements et l’API. La recherche, les centres urbains et la commune en un point sont dans l’API aussi.

Licence

Le code est sous MIT. Les données viennent du Haut-Commissariat au Plan (RGPH 2024 et 2014) ; créditez-le quand vous les publiez.