Plot the carbon intensity time series

[andreww]

Just a proof of concept for now, but plots the CI forecast time series alongside our planned run times.

Currently looks like this:

I think the optimal and now plots (green and red, respectively) are 30 mins out. Or background data is 30 mins out. Anyhow, this is a start.

[codecov]

Codecov Report

Attention: Patch coverage is 15.55556% with 38 lines in your changes missing coverage. Please review.

Project coverage is 82.69%. Comparing base (0eb9ffc) to head (aadbf72).

Files with missing lines	Patch %	Lines
cats/plotting.py	12.19%	36 Missing ⚠️
cats/__init__.py	50.00%	2 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##             main     #112      +/-   ##
==========================================
- Coverage   87.48%   82.69%   -4.79%     
==========================================
  Files          13       14       +1     
  Lines         631      676      +45     
==========================================
+ Hits          552      559       +7     
- Misses         79      117      +38     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

[abhidg]

@andreww one way to handle matplotlib is by putting in as an optional dependency, in a plots group as an example. Then if users want the plotting functionality they can use pip install 'climate-aware-task-scheduler[plots]'

[andreww]

@andreww one way to handle matplotlib is by putting in as an optional dependency, in a plots group as an example. Then if users want the plotting functionality they can use pip install 'climate-aware-task-scheduler[plots]'

Thanks - I did this. It ended up being a little fiddly because of the type testing but it seems to be working. Ready to merge?

[abhidg]

@andreww I don't see any interpolation here, running with cats -d 60 --loc OX1 --plot, I get this output:

The.____ ..... __ .... ________ . ______...
.. /  __)...../  \....(__    __).)  ____)....
..|  /......./    \......|  |...(  (___........
..| |limate./  ()  \ware.|  |ask.\___  \cheduler
..|  \__...|   __   |....|  |....____)  )....
...\    )..|  (..)  |....|  |...(      (..

WARNING:root:config file not found
WARNING:root:Unspecified carbon intensity forecast service, using carbonintensity.org.uk

Best job start time                       = 2025-06-08 10:40:44
Carbon intensity if job started now       = 76.08 gCO2eq/kWh
Carbon intensity at optimal time          = 63.87 gCO2eq/kWh

Zooming in on the plots figure, I see a 30 min window highlighted, rather than 60 minutes (starting now, red):

and the optimal time (green)

[andreww]

Ugh, yes, I see. I need to add the start and end times and interpolated values on the start and end of the series of points plotted in green and red. We must have this calculated somewhere - it'll be a case of getting it into the plotting function. Good spot.