electricsheepafrica/africa-northeast-nigeria-displacement-for-borno-adamawa-and-yobe-states-bay-state

---
annotations_creators:
- no-annotation
language_creators:
- found
language:
- en
license: cc-by-4.0
multilinguality:
- monolingual
size_categories:
- 1K<n<10K
source_datasets:
- original
task_categories:
- tabular-classification
- tabular-regression
task_ids: []
tags:
- africa
- humanitarian
- hdx
- electric-sheep-africa
- affected-population
- displacement
- hxl
- internally-displaced-persons-idp
- populated-places-settlements
- returnees
- nga
pretty_name: "Northeast Nigeria - Displacement for Borno, Adamawa, and Yobe States (BAY State)"
dataset_info:
splits:
- name: train
num_examples: 1380
- name: test
num_examples: 345
---

# Northeast Nigeria - Displacement for Borno, Adamawa, and Yobe States (BAY State)

**Publisher:** OCHA Nigeria · **Source:** [HDX](https://data.humdata.org/dataset/northeast-nigeria-displacement-for-borno-adamawa-and-yobe-states-bay-state) · **License:** `cc-by-igo` · **Updated:** 2025-02-04

---

## Abstract

Northeast Nigeria displacement datasets by rounds of assessment from the in country IOM/DTM.

Each row in this dataset represents subnational administrative unit observations. Data was last updated on HDX on 2025-02-04. Geographic scope: **NGA**.

*Curated into ML-ready Parquet format by [Electric Sheep Africa](https://huggingface.co/electricsheepafrica).*

---

## Dataset Characteristics

| | |
|---|---|
| **Domain** | Forced displacement and migration |
| **Unit of observation** | Subnational administrative unit observations |
| **Rows (total)** | 1,726 |
| **Columns** | 10 (2 numeric, 8 categorical, 0 datetime) |
| **Train split** | 1,380 rows |
| **Test split** | 345 rows |
| **Geographic scope** | NGA |
| **Publisher** | OCHA Nigeria |
| **HDX last updated** | 2025-02-04 |

---

## Variables

**Geographic** — `state_name` (BORNO, ADAMAWA, YOBE), `state_pcode` (NG008, NG002, NG036), `lga_name` (MAIDUGURI, JERE, CHIBOK), `lga_pcode` (NG008021, NG008013, NG008006), `ward_name` (MAISANDARI, DUSUMAN, OLD MAIDUGURI) and 1 others.

**Demographic** — `households` (range 1.0–21124.0), `individuals` (range 8.0–73012.0).

**Identifier / Metadata** — `esa_source` (HDX), `esa_processed` (2026-04-17).

---

## Quick Start

```python
from datasets import load_dataset

ds = load_dataset("electricsheepafrica/africa-northeast-nigeria-displacement-for-borno-adamawa-and-yobe-states-bay-state")
train = ds["train"].to_pandas()
test = ds["test"].to_pandas()

print(train.shape)
train.head()
```

---

## Schema

| Column | Type | Null % | Range / Sample Values |
|---|---|---|---|
| `state_name` | object | 0.0% | BORNO, ADAMAWA, YOBE |
| `state_pcode` | object | 0.0% | NG008, NG002, NG036 |
| `lga_name` | object | 0.0% | MAIDUGURI, JERE, CHIBOK |
| `lga_pcode` | object | 0.0% | NG008021, NG008013, NG008006 |
| `ward_name` | object | 0.0% | MAISANDARI, DUSUMAN, OLD MAIDUGURI |
| `ward_pcode` | object | 0.0% | NG008021013, NG008013004, NG008013011 |
| `households` | float64 | 0.1% | 1.0 – 21124.0 (mean 271.869) |
| `individuals` | float64 | 0.1% | 8.0 – 73012.0 (mean 1308.5942) |
| `esa_source` | object | 0.0% | HDX |
| `esa_processed` | object | 0.0% | 2026-04-17 |

---

## Numeric Summary

| Column | Min | Max | Mean | Median |
|---|---|---|---|---|
| `households` | 1.0 | 21124.0 | 271.869 | 65.0 |
| `individuals` | 8.0 | 73012.0 | 1308.5942 | 355.0 |

---

## Curation

Raw data was downloaded from HDX via the CKAN API and converted to Parquet. Column names were lowercased and standardised to snake_case. Common missing-value markers (`N/A`, `null`, `none`, `-`, `unknown`, `no data`, `#N/A`) were unified to `NaN`. 12 exact duplicate rows were removed. 2 column(s) were cast from string to numeric or datetime based on parse-success rate (>85% threshold). The dataset was split 80/20 into train and test partitions using a fixed random seed (42) and saved as Snappy-compressed Parquet.

---

## Limitations

- Data originates from OCHA Nigeria and has not been independently validated by ESA.
- Automated cleaning cannot correct for misreported values, definitional inconsistencies, or sampling bias in the original collection.
- Refer to the [original HDX dataset page](https://data.humdata.org/dataset/northeast-nigeria-displacement-for-borno-adamawa-and-yobe-states-bay-state) for the publisher's own methodology notes and caveats.

---

## Citation

```bibtex
@dataset{hdx_africa_northeast_nigeria_displacement_for_borno_adamawa_and_yobe_states_bay_state,
title = {Northeast Nigeria - Displacement for Borno, Adamawa, and Yobe States (BAY State)},
author = {OCHA Nigeria},
year = {2025},
url = {https://data.humdata.org/dataset/northeast-nigeria-displacement-for-borno-adamawa-and-yobe-states-bay-state},
note = {Repackaged for machine learning by Electric Sheep Africa (https://huggingface.co/electricsheepafrica)}
}
```

---

*[Electric Sheep Africa](https://huggingface.co/electricsheepafrica) — Africa's ML dataset infrastructure. Lagos, Nigeria.*