Nigeria Emission Factor Database (NEFDB) is an open, versioned collection of emission factors built specifically for Nigerian grid electricity, fuel combustion, transport, and waste operations.
# NEFDB - Nigeria Emission Factor Database
NEFDB publishes versioned Scope 1 and Scope 2 emission factors for Nigerian operations.
## What is NEFDB?
The Nigeria Emission Factor Database (NEFDB) is an open, versioned collection of emission factors built specifically for Nigerian grid electricity, fuel combustion, transport, and waste operations. Each factor is traceable to source data and calculation notes so the figures can be audited and reproduced.
It is designed for:
- Researchers studying Nigerian greenhouse gas emissions
- Regulators and auditors reviewing corporate carbon disclosures
- Sustainability teams preparing reports for NGX, FRC, and SEC Nigeria
- Developers building carbon accounting tools for Nigerian companies
## Public datasets
All NEFDB source datasets, documents, and derived calculation outputs are published through the public R2 Worker:
**`
nefdb-r2-publisher.ugbodaga…`**
Published domains:
| Domain | Worker route |
|--------------------|------------------------------------------------------|
| Grid electricity | `/grid_electricity/` |
| Fuel combustion | `/fuel_combustion/` |
| Transport aviation | `/transport_aviation/` |
| Waste water | `/waste_water/` |
Each domain contains `main`, `additional`, and `derived` folders for datasets and documentation.
## Installation
Add the package with Bun, npm, pnpm, or Yarn:
```bash
bun add @palmgrove/nefdb
```
```bash
npm install @palmgrove/nefdb
```
## Usage
Import the database API from the package:
```typescript
import { nefdb } from "@palmgrove/nefdb";
// List every factor in the current version
const all = nefdb.list();
// Include source records
const withSources = nefdb.list({ withSource: true });
// Include full factor records
const full = nefdb.list({ full: tru …