حزمة Python
كل جدول في شكل DataFrame، بدون اتصال: الوحدات، والإحصاءان، والمؤسسات، والمساكن.
التثبيت
pip install "morocco-communes[pandas]"الاستعمال
import morocco_communes as mc
communes = mc.communes() # عدد الصفوف: 1.503
communes[communes["region_code"] == "01"] # جماعات طنجة-تطوان-الحسيمة الـ146
people = mc.indicators("people") # إحصاء 2024، حسب الوحدة والوسط والجنس
economy = mc.economy() # المؤسسات، حسب الوحدة
housing = mc.housing() # المساكن الحضرية، حسب الوحدةكل جدول يرجع في شكل DataFrame من pandas. مع as_frame=False يرجع قائمة من القواميس، وعندها تكتفي الحزمة بالمكتبة القياسية.
الجداول
| الاستدعاء | الصفوف |
|---|---|
| regions(), provinces(), cercles(), communes(), arrondissements() | صف لكل وحدة |
| indicators(subject, census) | صف لكل وحدة ووسط، ولكل جنس في جدول السكان |
| economy() | صف لكل وحدة، من المستوى الوطني إلى الجماعة |
| housing() | صف لكل وحدة لها وسط حضري، وعددها 784 |
| crosswalk() | صف لكل جماعة تغير رمزها في 2015 |
indicators تقبل "people" أو "households"، وcensus يقبل "2024" أو "2014". إحصاء 2024 يسأل 72 سؤالا من أسئلة 2014 بالطريقة نفسها، فيمكن حساب الفرق بين أعمدتها.
معنى كل عمود
fields()تعطي العمود، وتسمية بالإنجليزية، وتسمية المندوبية السامية للتخطيط، ووحدة القياس، وبالنسبة لإحصاء 2024 المفهوم الذي تعرّفه به المندوبية مع نصه. وتقبل"indicators"أو"indicators2014"أو"economy"أو"housing".sources()تعطي عنوان URL لكل ملف من ملفات المندوبية، وقيمة SHA-256 الخاصة به، وتاريخ قراءته.versionهو إصدار مجموعة البيانات، وهو إصدار الحزمة أيضا.
الرموز
تعرف كل وحدة برمز المندوبية السامية للتخطيط، والرمز يعكس التقسيم الإداري: 01.511.01.0 جماعة في العمالة 01.511، ضمن الجهة 01. تبقى الرموز سلاسل نصية، فيحتفظ code_digits بالأصفار الأولى التي تجعله من 9 أرقام.
ما لا تتضمنه الحزمة
الحدود، والمساحة والكثافة المحسوبتان منها، تحت رخصة ODbL، فتبقى في التنزيلات وفي API. البحث والمراكز الحضرية والجماعة التي تضم نقطة موجودة في API كذلك.
الرخصة
الكود تحت رخصة MIT. البيانات مصدرها المندوبية السامية للتخطيط (الإحصاء العام للسكان والسكنى 2024 و2014)؛ اذكر المصدر عند نشرها.