Changelog#

v0.21.0 - May 22,2023#

  • Add initial support for EIA V2 API

  • Date ranges can be provided as either separate start/end arguments or a tuple to date.

# both do the same thing
iso.get_load(start="Jan 1, 2023", end="March 1, 2023")
iso.get_load(date=("Jan 1, 2023", "March 1, 2023"))

CAISO#

  • Add support for querying larger set of CAISO Oasis Datasets with caiso.get_oasis_dateset

  • add CAISO.get_curtailed_non_operational_generator_report to parse this daily report

  • Support hourly start/end time for CAISO LMPs

SPP#

  • Update SPP fuel mix source. Add helper function to parse historical fuel mix data back to 2011.

  • Add SPP.get_ver_curtailments to return curtailment data for SPP

  • Support self scheduled vs market breakdown in SPP.get_fuel_mix using detailed=True parameter

ISONE#

  • Add ISONE BTM solar

>>> iso = gridstatus.ISONE()
>>> iso.get_btm_solar("today")
                         Time            Interval Start              Interval End  BTM Solar
0   2023-04-14 00:00:00-04:00 2023-04-14 00:00:00-04:00 2023-04-14 00:05:00-04:00      0.000
1   2023-04-14 00:05:00-04:00 2023-04-14 00:05:00-04:00 2023-04-14 00:10:00-04:00      0.000
2   2023-04-14 00:10:00-04:00 2023-04-14 00:10:00-04:00 2023-04-14 00:15:00-04:00      0.000
3   2023-04-14 00:15:00-04:00 2023-04-14 00:15:00-04:00 2023-04-14 00:20:00-04:00      0.000
4   2023-04-14 00:20:00-04:00 2023-04-14 00:20:00-04:00 2023-04-14 00:25:00-04:00      0.000
..                        ...                       ...                       ...        ...
164 2023-04-14 13:40:00-04:00 2023-04-14 13:40:00-04:00 2023-04-14 13:45:00-04:00   4356.833
165 2023-04-14 13:45:00-04:00 2023-04-14 13:45:00-04:00 2023-04-14 13:50:00-04:00   4328.750
166 2023-04-14 13:50:00-04:00 2023-04-14 13:50:00-04:00 2023-04-14 13:55:00-04:00   4300.667
167 2023-04-14 13:55:00-04:00 2023-04-14 13:55:00-04:00 2023-04-14 14:00:00-04:00   4272.583
168 2023-04-14 14:00:00-04:00 2023-04-14 14:00:00-04:00 2023-04-14 14:05:00-04:00   4244.500

[169 rows x 4 columns]

ERCOT#

  • Ercot.get_fuel_mix("latest") now returns last two days of data.

v0.20.0 - March 24, 2023#

  • Add Interval Start and Interval End time stamps to every applicable time series to avoid ambiguity. The Time column will be dropped in favor of just these two columns in next release

Breaking Changes#

  • Removed FuelMix class. iso.get_fuel_mix(date="latest") now returns a DataFrame with a single row to make API consistent with other ways of calling the method.

v0.19.0 - Feb 19, 2023#

  • Updated ISONE Interconnection Queue to contain completed and withdrawn projects

  • Add all areas to PJM get_load

  • Add load over time visualization

v0.18.0 - Jan 27, 2023#

  • Update CAISO LMP markets to support real time five minute

  • Fix bug affecting NYISO interconnection queues

Breaking Changes#

The following changes were made to CAISO Market:

  • REAL_TIME_HOURLY removed since this market incorrectly mapped to the HASP market

  • REAL_TIME_5_MIN added and maps to the RTD market

  • REAL_TIME_15_MIN and DAY_AHEAD_HOURLY unchanged

v0.17.0 - Dec 30, 2022#

  • Add CAISO LMP Heat Map Example Notebook

  • Add Settlement Point Prices for ERCOT

  • SPP: Add today/latest LMP for Real Time 5 minute and Day Ahead Hourly (DAM)

  • ERCOT load data is now returned with 5 minute frequency

  • Add a guide on contributing to gridstatus

v0.16.0 - Dec 15, 2022#

  • Ercot Fuel Mix Endpoint URL updated to include more fuel sources

  • Ercot get_load supports more historical data

v0.15.0 - Dec 2, 2022#

  • Add ability to get renewable curtailment data for CAISO

  • Add Ancillary Service Methods for CAISO

  • Add Ancillary Service Prices for ERCOT

  • Add Ability to save intermediate results to disk when fetching data across multiple requests using save_to parameter

v0.14.0 - Nov 8, 2022#

  • Add get_capacity_prices to NYISO

  • Fix ISONE Daylight Savings Time handling

v0.13.0 - Nov 2, 2022#

  • Add interconnection queue to data for SPP, NYISO, ERCOT, ISONE, PJM, MISO, and CAISO

  • Add get_generators and get_loads to NYISO

v0.12.0 - Oct 28, 2022#

  • Can now use "today" are value for end when querying date range

    nyiso.get_fuel_mix(start="Jan 1, 2022", end="today")

Breaking Changes#

  • Simplify method naming. This applies to all method. See below for example

New API#

nyiso.get_fuel_mix("latest")
nyiso.get_fuel_mix("today")
nyiso.get_fuel_mix("jan 1, 2022")

Old API#

nyiso = gridstatus.NYISO()
nyiso.get_latest_fuel_mix()
nyiso.get_fuel_mix_today()
nyiso.get_historical_fuel_mix("jan 1, 2022")

v0.11.0 - Oct 26, 2022#

  • Renamed library to gridstatus

  • New Documentation!

  • Add Examples Notebooks

  • Renamed all demand methods to load

v0.10.0 - Oct 24, 2022#

  • Support both Generator and Zone for NYISO LMPs

  • Optimize NYISO Date Range Queries over Historical Data

v0.9.0 - Oct 21, 2022#

  • Support querying by date range for CAISO, PJM, NYISO, and ISONE get_historical_* Methods

  • Add gas prices to CAISO

  • Add GHG allowance price to CAISO

v0.8.0 - Oct 13, 2022#

  • PJM: add lmp prices for 3 markets: real time 5 minutes, real time hourly, day ahead hourly

  • Add notes to Ercot status

  • Add .status_homepage url to ISOs that report a status

  • Add Ercot Historical RTM Settlement Point Prices (SPPs)

  • Refactor storage API to support non-battery storage types

v0.7.0 - Aug 23, 2022#

  • Added load forecasting to NYISO, PJM, CAISO, ISONE, Ercot, SPP, MISO

  • Add battery charging and discharging to CAISO

  • Removed yesterday methods. Use get_historical_*() instead

  • Add get latest status to SPP

v0.6.0 - Aug 17, 2022#

  • ISONE: add system status

  • NYISO: add system status

  • Improve LMP return format

  • Bug fixes

v0.5.0 - Aug 12, 2022#

  • CAISO: added LMP prices for 3 market: real time 15 minute (FMM), real time hours (HASP), day ahead hourly (DAM)

  • NYISO: added LMP prices for 2 markets: real time 5 minute and day ahead 5 minute

  • MISO: added LMP prices for 2 market: real time 5 minute and day head hourly

  • ISONE: add lmp prices for 3 markets: real time 5 minutes, real time hourly, day ahead hourly

  • Bug fixes

v0.4.0 - Aug 4, 2022#

  • NYISO: added all demand, fuel mix, and supply methods

  • PJM: add all demand methods for

  • SPP: today and latest demand

  • MISO: added get demand today and latest supply

  • ISONE: now has complete coverage after adding all fuel mix and supply methods

  • Ercot: added today and latest supply

v0.3.0 - Aug 3, 2022#

  • complete coverage of all methods for CAISO

  • partial coverage for ERCOT, ISONE, PJM

  • initial coverage for NYISO, MISO, SPP

v0.2.0 - July 29, 2022#

  • Added isodata.list_isos and isodata.get_iso

v0.1.0 - July 28, 2022#

  • Added get_fuel_mix() to all 7 isos

  • Library structure