Paquet Python
Chaque table en DataFrame, hors ligne : les unités, les deux recensements, les établissements et les logements.
Installer
pip install "morocco-communes[pandas]"Utiliser
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
| Appel | Lignes |
|---|---|
| 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.versionest 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.