energyquantified 0.8

Energy Quantified Time series API client.

Energy Quantified Python Client

Documentation | Python package | GitHub repository

The Python library for Energy Quantified's Time Series API. It allows you to access thousands of data series directly from Energy Quantified's time series database. It integrates with the popular pandas library for high-performance data analysis and manipulation.

Developed for Python 3.7+.

from datetime import date, timedelta
from energyquantified import EnergyQuantified

# Initialize client
eq = EnergyQuantified(api_key='<insert api key here>')

# Freetext search (filtering on attributes is also supported)
curves = eq.metadata.curves(q='de wind production actual')

# Load time series data
curve = curves[0]
timeseries = eq.timeseries.load(
    curve,
    begin=date.today() - timedelta(days=10),
    end=date.today()
)

# Convert to Pandas data frame
df = timeseries.to_dataframe()

Full documentation available at Read the Docs.

Features

• Simple authentication
• Metadata caching
• Rate-limiting and automatic retries on network errors
• Full-text search and keyword search for curves and powerplants
• Forecasts- and time series data
• Period-based data
• OHLC data
• SRMC calculations on OHLC data
• (TODO!) Shows your subscription for each series
• Support for time-zones, resolutions and aggregations
• Easy-to-use filters for issue dates and forecast types
• Integrates with pandas

Note: A user account with an API key is required to use this library. Create an account on Energy Quantified's home page. Trial users get access to 30 days of history.

Installation

Install with pip:

# Install
pip install energyquantified

# Upgrade
pip install --upgrade energyquantified

Documentation

Find the documentation at Read the Docs.

License

The Energy Quantified Python client is licensed under the Apache License version 2.0.