Added Documentation on Estimation of Equivalent Usage Emissions

[IamLRBA]

As per issue #733
cc
@benoit-cty
I Added a new section in the methodology.rst.txt file explaining equivalent usage emissions.

[benoit-cty]

Thanks, I'm always happy to see new contributor !

I suggest some changes and can you add the US citizen impact ?

[IamLRBA]

Thanks for the corrections @benoit-cty

[IamLRBA]

@benoit-cty these are the changes as per your review. If there are any more corrections you'd need just let me know.
Thanks!

[benoit-cty]

Thanks, can you add the calculus for the US Citizen ?

We based our calculus on an average annual emission of 13.3 Tons of CO2.eq for a US citizen. And we divide it per 52 weeks per year.

[IamLRBA]

Thanks, can you add the calculus for the US Citizen ?

We based our calculus on an average annual emission of 13.3 Tons of CO2.eq for a US citizen. And we divide it per 52 weeks per year.

Thank you for the feedback @benoit-cty !

PR Update: Added Calculations for US Citizen Weekly Emissions

I've made the following updates to address your request:

1. Added Calculations for US Citizen Weekly Emissions:

   • Based on the average annual emissions of 13.3 tons CO₂ equivalent for a US citizen,
   • I calculated weekly emissions as:
     [
     \text{Weekly Emissions} = \frac{13.3}{52} \approx 0.256 , \text{tons CO₂ equivalent per week.}
     ]
   • I incorporated this into the documentation, providing the formula and examples for clarity.

2. I updated Documentation Structure:

   • Added a new section titled "US Citizen Weekly Emissions" to present the information.
   • I then clarified how total emissions can be compared to this benchmark.

The revised documentation now includes:

• A breakdown of equivalent usage comparisons for cars, TVs, and US Citizen emissions.
• Clear formulas and examples for each comparison.

Please let me know if there's anything else you'd like me to adjust! 🚀

[IamLRBA]

@benoit-cty in this new commit i'm aiming to solve issue #751

[benoit-cty]

I really appreciate your contribution, but please do a separate PR for RAM. Because we can't change something like that in a minor version as it will impact people making comparison between run over time. Changing RAM value must be in a V3 of CodeCarbon.

[IamLRBA]

I really appreciate your contribution, but please do a separate PR for RAM. Because we can't change something like that in a minor version as it will impact people making comparison between run over time. Changing RAM value must be in a V3 of CodeCarbon.

THanks for your reply @benoit-cty. I will do that.

[benoit-cty]

Hello,
You change _sources/methodology.rst.txt, but for Sphinx it is the docs/edit/methodology.rst that need to be change and Sphinx create the txt and then the html.

You can generate the doc locally with hatch run docs:build (See https://github.com/mlco2/codecarbon/blob/master/CONTRIBUTING.md#installation ) if you want to check that everything is fine by opening index.html.