Metadata-Version: 2.4
Name: energyatlas
Version: 0.0.1
Summary: The unified Python interface for North American energy data
Project-URL: Homepage, https://sondio.io/energy-atlas
Project-URL: Documentation, https://sondio.io/energy-atlas/docs
Project-URL: Repository, https://github.com/sondio-io/energyatlas
Project-URL: Issues, https://github.com/sondio-io/energyatlas/issues
Author-email: Sondio <dev@sondio.io>
License-Expression: MIT
License-File: LICENSE
Keywords: electricity,energy,gas,geospatial,grid,mining,oil,pandas,power,production,solar,wells,wind
Classifier: Development Status :: 1 - Planning
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Scientific/Engineering
Classifier: Topic :: Scientific/Engineering :: GIS
Classifier: Topic :: Scientific/Engineering :: Information Analysis
Requires-Python: >=3.10
Requires-Dist: pandas>=2.0
Requires-Dist: requests>=2.28
Provides-Extra: all
Requires-Dist: click>=8.0; extra == 'all'
Requires-Dist: geopandas>=0.14; extra == 'all'
Requires-Dist: rich>=13.0; extra == 'all'
Provides-Extra: cli
Requires-Dist: click>=8.0; extra == 'cli'
Requires-Dist: rich>=13.0; extra == 'cli'
Provides-Extra: geo
Requires-Dist: geopandas>=0.14; extra == 'geo'
Description-Content-Type: text/markdown

# Energy Atlas

**The unified Python interface for North American energy data.**

Energy Atlas gives you pandas DataFrames for oil & gas wells, wind turbines, solar farms, power plants, transmission lines, coal mines, EV charging stations, wholesale electricity prices, and more — all from one package.

> **Status: Coming soon.** This package is under active development. Star the repo or follow [@sondio](https://sondio.io) for launch updates.

## What it will look like

```python
import energyatlas as ea

# Oil & gas
wells = ea.wells(state="TX", basin="permian")
production = ea.production("42-461-40000", months=24)

# Wind & solar
turbines = ea.wind.turbines(state="IA", manufacturer="Vestas")
solar = ea.solar.farms(state="CA", min_capacity_mw=50)

# Power plants & grid
plants = ea.power_plants(fuel="nuclear")
lines = ea.transmission_lines(voltage_min=345)

# Electricity markets
lmp = ea.markets.lmp(iso="ERCOT", node="HB_HOUSTON")

# Mining
mines = ea.mines(commodity="coal", state="WY")

# EV charging
chargers = ea.ev_stations(state="TX", connector="DCFC")

# Everything returns pandas DataFrames
wells.to_csv("permian_wells.csv")
```

## Data coverage (planned)

| Category | Source | Records |
|----------|--------|---------|
| Oil & gas wells | State agencies (11 states + GOM) | 3M+ |
| Wind turbines | USGS USWTDB | 75,000+ |
| Solar farms | USGS USPVDB | 5,000+ |
| Power plants | EIA Form 860 | 30,000+ generators |
| Transmission lines | HIFLD | 165,000 segments |
| Substations | HIFLD | 70,000 |
| Mines | MSHA | 85,000 |
| EV charging | DOE AFDC | 70,000+ stations |
| Dams | USACE NID | 92,000 |
| Wholesale prices | 7 ISOs | Billions of records |

## Built by Sondio

Energy Atlas is the developer SDK for [Sondio](https://sondio.io) — the energy data platform. One API key works across the SDK, REST API, and web platform.

## License

MIT
