carbon-aware-sdk icon indicating copy to clipboard operation
carbon-aware-sdk copied to clipboard

Documentation: WattTime provides marginal while Electricity Map provides average signal

Open Ravichou opened this issue 1 year ago • 1 comments

Contact Details

[email protected]

Overview of Change

Hello,

The documentation of the Web API states that it provides "the marginal carbon intensity for a given location and time period".

However, looking at the implementation of the Electricity Map API, here , there, and there, it seems like the SDK retrieves the average signal from the Electricity Map, not the marginal one.

Furthermore this difference with the WattTime API could also be explicited in the selecting a datasource tutorial, as I believe this a significant feature difference between both APIs.

From the SCI standpoint, this is fine, as it accepts both marginal and average signals. However I think this should be explicited in the doc: remove the 'marginal' in the Web API doc, and explicit the different behavior in the data source doc.

Thanks and best regards, Robin

Code of Conduct

  • [X] I agree to follow this project's Code of Conduct

Ravichou avatar Oct 04 '24 13:10 Ravichou