تخطَّ إلى المحتوى

سكريبتات برمجية

أداة تصدير بيانات النزوح للباحثين (Displacement Data Exporter)

سكريبت سطر أوامر يستخدم أداة `export_data` لتصدير سجلات النزوح المُطبّعة بصيغ CSV/JSON/GeoJSON مع بيان استخراج (manifest) وكودبوك اختياري جاهز لملحق بيانات في ورقة بحثية.

إعداد: الفريق التقني للعمل الإنساني

export_datarefugee_populationcompare_countries

سكريبت سطر أوامر يستخدم أداة `export_data` لتصدير سجلات النزوح المُطبّعة بصيغ CSV/JSON/GeoJSON مع بيان استخراج (manifest) وكودبوك اختياري جاهز لملحق بيانات في ورقة بحثية.

القيمة

يوفّر على الباحثين ساعات التنظيف اليدوي: بيانات نظيفة قابلة للاستشهاد فورياً، مع بيان يعيد إنتاج نفس الاستخراج بالضبط (نفس الوسائط، الطابع الزمني، إصدار الخادم، والاقتباس).

كيف تعمل؟

سكريبت Python يستدعي `export_data(dataset, format, …)` ويكتب الملف مع بيان الاستخراج المضمّن. مناسب للجدولة الدورية (Cron) لتحديث لقطات بيانات لبوابات مفتوحة أو مستودعات أبحاث. صيغة GeoJSON تعمل مع group_by لربط الصفوف بالبلدان.

مثال تقني

res = await session.call_tool("export_data", {
    "dataset": "population",
    "format": "csv",
    "country": "Sudan",
    "role": "origin",
    "year_from": 2020,
    "include_manifest": True
})
with open("sudan_displacement.csv", "w", encoding="utf-8") as f:
    f.write(res["data"])
print("صفوف:", res["row_count"], "| المصدر:", res["manifest"]["source"])