About
Why Sudan Atlas exists
The same place in Sudan is written a dozen ways across reports and spreadsheets: El Fasher, Al Fashir, Elfasher, الفاشر. Joining datasets, or simply putting them on a map, means cleaning those names by hand every time.
Sudan Atlas does that cleaning once, openly, for everyone. It matches names to the official P-codes used across the humanitarian system, gives the names in Arabic and English, and draws the boundaries, so analysts, journalists, researchers and developers can spend their time on the data instead.
Private by design
The map-maker runs entirely in your browser. The files you open are never uploaded, stored or seen by anyone. The site counts page visits and how often each feature is used (files matched, maps made and downloaded, by file type only), never what is in them. No cookies are used.
The one exception is the MCP server for AI assistants: it runs on our server, so the names an assistant sends are processed there to answer the request. They are not stored or logged.
Open
Everything is free and open: the code under the MIT licence, the data under Creative Commons. The packages are on PyPI and npm, and the source is on GitHub.
Help improve it
Found a spelling the matcher misses, or a name that should match differently? Open an issue on GitHub with the name as written and the place it refers to. Every new spelling is reviewed before it is added.
How to cite
Shennan, A. (2026). Sudan Atlas: official names, P-codes and boundaries for Sudan's states and localities. Zenodo. https://doi.org/10.5281/zenodo.24191932
Please also credit the boundary source: "OCHA (COD-AB Sudan), via HDX".
Who made it
Sudan Atlas is made by Amin Shennan.
عن الأطلس
لماذا أطلس السودان؟
يُكتب اسم المكان الواحد في السودان بطرق كثيرة تختلف من تقرير إلى آخر ومن جدول إلى آخر: الفاشر، El Fasher، Al Fashir، Elfasher. ولذلك يجد كل من يريد دمج البيانات، أو حتى عرضها على خريطة، نفسه مضطرًا إلى تصحيح هذه الأسماء يدويًا في كل مرة.
جاء أطلس السودان ليُنجز هذا العمل مرة واحدة، ويتيح نتيجته للجميع مجانًا. فهو يربط الأسماء بالرموز المكانية (P‑codes) الرسمية المعتمدة في العمل الإنساني، ويقدّم الأسماء بالعربية والإنجليزية، ويرسم الحدود الإدارية، حتى يصرف المحللون والصحفيون والباحثون والمطوّرون وقتهم في فهم البيانات لا في تنظيفها.
خصوصيتك محفوظة
يعمل صانع الخرائط داخل متصفحك بالكامل، فلا تُرسل ملفاتك إلى أي خادم، ولا تُحفظ، ولا يطّلع عليها أحد. وكل ما يحصيه الموقع هو عدد الزيارات وعدد مرات استخدام كل ميزة (مطابقة الملفات وصنع الخرائط وتنزيلها، حسب نوع الملف فقط)، دون أي اطلاع على محتواها، ودون أي ملفات تعريف ارتباط.
والاستثناء الوحيد هو خادم MCP المخصّص لمساعدي الذكاء الاصطناعي: فهو يعمل على خادمنا، ولذلك تُعالَج هناك الأسماء التي يرسلها المساعد للإجابة عن الطلب، ولا تُحفظ ولا تُسجَّل.
مفتوح للجميع
كل ما في الأطلس مجاني ومفتوح المصدر: البرمجيات برخصة MIT، والبيانات برخص المشاع الإبداعي. تجد الحزم على PyPI وnpm، والشيفرة المصدرية على GitHub.
شارك في تحسينه
هل صادفت اسم مكان مكتوبًا بطريقة لم تتعرّف عليها أداة المطابقة، أو اسمًا رُبط بمكان غير صحيح؟ أبلغنا عبر GitHub، واذكر الاسم كما ورد عندك والمكان المقصود به. نراجع كل صيغة جديدة قبل إضافتها.
كيف تستشهد بالأطلس
إذا استخدمت أطلس السودان في تقرير أو بحث، فاستشهد به هكذا:
Shennan, A. (2026). Sudan Atlas: official names, P‑codes and boundaries for Sudan's states and localities. Zenodo. https://doi.org/10.5281/zenodo.24191932
واذكر كذلك مصدر الحدود: OCHA (COD-AB Sudan), via HDX.
من وراء الأطلس
أعدّ أطلس السودان Amin Shennan.