Jayyp1234/pyflare

Open Python toolkit for satellite-based gas flaring analytics across African oil-producing nations. # pyflare > Open Python toolkit for satellite-based gas flaring analytics across African oil-producing nations. --- ## Why this exists Africa accounts for a significant share of global gas flaring — the deliberate burning of natural gas at oil and gas facilities. Flaring releases CO₂, unburned methane, and a long tail of local air pollutants into communities that, in many cases, live within walking distance of the flare stack. Satellite-based monitoring of flares has existed for over a decade, principally through **VIIRS Nightfire (VNF)** — produced by the Earth Observation Group (EOG) at the Payne Institute, Colorado School of Mines, using data from the VIIRS instrument aboard Suomi NPP and JPSS-1 — and the World Bank's annual flaring estimates from the **Global Flaring and Methane Reduction Partnership (GFMR**, formerly the Global Gas Flaring Reduction Partnership / GGFR**)**. The science is solid. What has been missing is an open Python interface to make the data usable for African researchers, journalists, regulators, and engineers without paywalls or proprietary GIS software. > **Important — pyflare does not bundle, redistribute, or rehost VIIRS Nightfire data.** The library is a thin client; each user must obtain their own VNF Academic Data Use License directly from EOG (`eog@mines.edu`) and supply their own credentials. See `LICENSING_NOTES.md`. `pyflare` is that interface. > **Maintainer note:** the paragraphs above are placeholder framing. Replace this section with your own origin story — why you built this, what you saw, what you want it to change. Reviewers and users respond to specific, personal voice. The rest of this README is reference material that benefits from being mostly factual. --- ## What it does - **Fetches** VIIRS Nightfire daily detections (using user-supplied EOG credentials — pyflare does not redistribute VNF) and GFMR annual flared volumes. - **Filters** to the African continent or any of 17 African oil/gas-producing coun …