updated

.vscode/settings.json

@@ -0,0 +1,3 @@
+{
+    "window.title": "${dirty}${activeEditorShort}${separator}${rootName}${separator}${profileName}${separator}${appName}${separator}[Branch: main]"
+}

README.md

@@ -1 +1 @@
-# Emissions-Monetisation-Calculator
+#  

data-dictionary.md

@@ -0,0 +1,66 @@
+## Comments
+Any additional remarks or notes about the proposal.
+
+## Climate Model Used
+The climate model(s) used in deriving the SCC (e.g., DICE, FUND, PAGE).
+
+## Currency
+The currency in which the SCC value is denominated (e.g., USD, GBP).
+
+## Damage Categories Included
+A list of damage categories factored into the calculation (e.g., health impacts, agricultural losses, property damages).
+
+## Discount Rate
+The discount rate(s) used in the calculation of the SCC (e.g., 3%, 2%, 1%).
+
+## Economic Model Used
+The economic model(s) or framework applied in calculating costs.
+
+## Equity Weighting
+Whether equity weighting was applied to account for distributional impacts across regions or populations.
+
+## Geographic Scope
+The geographic region or scope for which the SCC applies (e.g., global, national, state-level).
+
+## Inflation Adjustment Year
+The base year for inflation adjustment if values are adjusted for inflation.
+
+## Methodology
+A brief description of the methodology used to calculate the SCC (e.g., integrated assessment model, empirically derived estimate).
+
+## Policy Context
+The policy application or context for which the SCC was intended (e.g., regulatory impact analysis, carbon tax setting).
+
+## Proposal Name
+Name or identifier of the social cost of carbon proposal.
+
+## Proposal Year
+The year the SCC estimate was proposed or published.
+
+## Range High
+If applicable, the upper bound of a range provided for the SCC estimate.
+
+## Range Low
+If applicable, the lower bound of a range provided for the SCC estimate.
+
+## Range Average
+
+If the social cost of carbon is stated as a range, then the mathematical average is also provided. 
+
+## Source Document
+The name of the report or publication where the estimate is documented.
+
+## Source Organization
+The organization or entity responsible for producing the SCC estimate (e.g., EPA, Interagency Working Group, New York DEC).
+
+## Time Horizon
+The time period over which the damages are calculated (e.g., 100 years, indefinite).
+
+## Uncertainty Notes
+Notes on uncertainties associated with the estimate (e.g., climate sensitivity, economic assumptions).
+
+## Value
+The numerical value of the SCC estimate.
+
+## Value Units
+The units in which the SCC is expressed (e.g., $/ton CO2, £/ton C).

glossary.md

@@ -0,0 +1,94 @@
+# Acronym Glossary For Social Cost Of Carbon Proposals
+
+### Glossary for Social Cost of Carbon Reporting (Alphabetical Order)
+
+This glossary provides key terms, acronyms, and formulas commonly used in the context of social cost of carbon (SCC) reporting and climate economics.
+
+---
+
+#### **Carbon Dioxide (CO₂)**
+- **Definition**: A greenhouse gas that is a primary driver of global warming. It is emitted through activities such as burning fossil fuels, deforestation, and industrial processes.
+- **Units**: Measured in tonnes (metric tons).
+
+---
+
+#### **Carbon Dioxide Equivalent (CO₂e)**
+- **Definition**: A standard unit for measuring the global warming potential (GWP) of greenhouse gases relative to CO₂. It allows for comparison across different gases by converting them into an equivalent amount of CO₂ based on their GWP.
+- **Formula**:
+  $$
+  CO₂e = \text{Mass of Gas} \times \text{GWP of Gas}
+  $$
+- **Units**: Measured in tonnes or millions of tonnes (MtCO₂e).
+
+---
+
+#### **Discount Rate**
+- **Definition**: A percentage used to calculate the present value of future costs and benefits. In SCC calculations, it reflects how much weight is placed on future climate damages compared to immediate costs.
+- **Formula**:
+  $$
+  PV = \frac{FV}{(1 + r)^t}
+  $$
+  Where:
+  - $$ PV $$: Present value
+  - $$ FV $$: Future value
+  - $$ r $$: Discount rate
+  - $$ t $$: Time in years
+
+---
+
+#### **Global Warming Potential (GWP)**
+- **Definition**: A measure of how much heat a greenhouse gas traps in the atmosphere over a specific time period (usually 100 years), relative to CO₂. For example, methane (CH₄) has a GWP of about 25, meaning it is 25 times more potent than CO₂ over the same period.
+
+---
+
+#### **Greenhouse Gases (GHGs)**
+- **Definition**: Gases that trap heat in the Earth's atmosphere and contribute to global warming. Common GHGs include:
+  - Carbon dioxide (CO₂)
+  - Methane (CH₄)
+  - Nitrous oxide (N₂O)
+  - Fluorinated gases (e.g., HFCs, PFCs)
+
+---
+
+#### **Marginal Abatement Cost (MAC)**
+- **Definition**: The cost of reducing one additional unit of greenhouse gas emissions. It is often used in cost-benefit analyses to compare mitigation strategies.
+
+---
+
+#### **Millions of Tonnes of Carbon Dioxide Equivalent (MtCO₂e)**
+- **Definition**: A unit representing one million metric tons of CO₂ or its equivalent. It is commonly used for large-scale emissions reporting.
+
+---
+
+#### **Net Present Value (NPV)**
+- **Definition**: The difference between the present value of benefits and costs over time. In SCC reporting, NPV helps evaluate the economic efficiency of climate policies.
+- **Formula**:
+  $$
+  NPV = \sum_{t=0}^{T} \frac{B_t - C_t}{(1 + r)^t}
+  $$
+  Where:
+  - $$ B_t $$: Benefits in year $$ t $$
+  - $$ C_t $$: Costs in year $$ t $$
+  - $$ r $$: Discount rate
+  - $$ T $$: Time horizon
+
+---
+
+#### **Social Cost of Carbon (SCC)**
+- **Definition**: The monetary estimate of the economic damages associated with emitting one additional tonne of CO₂ or its equivalent into the atmosphere. It accounts for impacts such as reduced agricultural productivity, health effects, and property damage from extreme weather.
+- **Formula**:
+  $$
+  SCC = \frac{\partial W}{\partial C} \cdot \Delta E
+  $$
+  Where:
+  - $$ W $$: Economic welfare
+  - $$ C $$: Consumption
+  - $$ \Delta E $$: Incremental emissions
+- **Units**: Typically expressed as dollars per tonne (\$/tCO₂).
+
+---
+
+#### **Tonnes of Carbon Dioxide Equivalent (tCO₂e)**
+- **Definition**: A unit measuring the emissions or reductions of greenhouse gases expressed as an equivalent amount of CO₂ based on their global warming potential.
+
+ 

proposals.csv

@@ -0,0 +1,2 @@
+proposal_name,proposal_year,value,ghg_unit,ghg_unit_description,reporting_unit,unit_spec,currency_unit,currency_iso,geographical_scope,methodology,source_organization,source_document,climate_model_used,damage_categories_included,policy_context,range_low,range_high,comments
+IFVI Rate,2024,236,tco2e,tonnes of carbon dioxide equivalents,tonnes,carbon dioxide equivalents,,,,,,,,,,,,

units-glossary.md

@@ -0,0 +1,65 @@
+### Glossary of Units for Carbon Dioxide Emissions Reporting
+
+#### **Grams of Carbon Dioxide Equivalent (gCO₂e)**
+- **Definition**: A small-scale unit used to measure greenhouse gas emissions, often applied to individual products, activities, or small systems.
+- **Example Use**: Emissions per kilometer traveled by a car.
+- **Conversion**: $$ 1 \, \text{gCO₂e} = 0.000001 \, \text{tCO₂e} $$.
+
+---
+
+#### **Kilograms of Carbon Dioxide Equivalent (kgCO₂e)**
+- **Definition**: A mid-scale unit often used for household-level emissions or specific activities like energy use or waste generation.
+- **Example Use**: Emissions from heating a home for one day.
+- **Conversion**: $$ 1 \, \text{kgCO₂e} = 0.001 \, \text{tCO₂e} $$.
+
+---
+
+#### **Tonnes of Carbon Dioxide Equivalent (tCO₂e)**
+- **Definition**: A standard unit for measuring greenhouse gas emissions on a larger scale, such as for businesses, projects, or small regions.
+- **Example Use**: Annual emissions of a single car or the carbon footprint of an average household.
+- **Conversion**: $$ 1 \, \text{tCO₂e} = 1,000 \, \text{kgCO₂e} $$.
+
+---
+
+#### **Kilotonnes of Carbon Dioxide Equivalent (ktCO₂e)**
+- **Definition**: A larger unit used to report emissions from industrial facilities, cities, or sectors like transportation or energy production.
+- **Example Use**: Annual emissions from a medium-sized power plant.
+- **Conversion**: $$ 1 \, \text{ktCO₂e} = 1,000 \, \text{tCO₂e} = 1,000,000 \, \text{kgCO₂e} $$.
+
+---
+
+#### **Millions of Tonnes of Carbon Dioxide Equivalent (MtCO₂e)**
+- **Definition**: A very large unit used to express national or global greenhouse gas emissions or reductions.
+- **Example Use**: Total annual emissions of a country or the impact of a large-scale climate policy.
+- **Conversion**: $$ 1 \, \text{MtCO₂e} = 1,000,000 \, \text{tCO₂e} = 1,000 \, \text{ktCO₂e} $$.
+
+---
+
+#### **Gigatonnes of Carbon Dioxide Equivalent (GtCO₂e)**
+- **Definition**: The largest commonly used unit for global-scale reporting of greenhouse gas emissions and targets.
+- **Example Use**: Total global annual emissions or cumulative reductions needed to meet international climate goals (like limiting warming to 1.5°C).
+- **Conversion**: $$ 1 \, \text{GtCO₂e} = 1,000 MtCO₂e = 1,000,000 ktCO₂e = 1,000,000,000 tCO₂e $$.
+
+---
+
+#### **Carbon Dioxide Equivalent (CO₂e)**
+- **Definition**: A metric that expresses the impact of all greenhouse gases in terms of the equivalent amount of CO₂ that would produce the same global warming effect. It is calculated using the global warming potential (GWP) of each gas relative to CO₂.
+- **Formula**:
+  $$
+  CO₂e = (\text{Mass of Gas}) \times (\text{GWP of Gas})
+  $$
+
+---
+
+### Summary Table
+
+| Unit         | Abbreviation | Scale               | Conversion to tCO₂e      | Example Use Case                              |
+|--------------|--------------|---------------------|---------------------------|----------------------------------------------|
+| Grams        | gCO₂e        | Small-scale         | $$ 0.000001\,\text{tCO₂e} $$ | Emissions per km driven by a car             |
+| Kilograms    | kgCO₂e       | Household-level     | $$ 0.001\,\text{tCO₂e}   $$ | Daily household energy use                   |
+| Tonnes       | tCO₂e        | Standard unit       | $$ 1\,\text{tCO₂e}       $$ | Annual footprint of an average household     |
+| Kilotonnes   | ktCO₂e       | Industrial-level    | $$ 1,000\,\text{tCO₂e}   $$ | Emissions from a power plant                 |
+| Millions     | MtCO₂e       | National-level      | $$ 1,000,000\,\text{tCO₂e} $$ | Total annual emissions of a country          |
+| Gigatonnes   | GtCO₂e       | Global-scale        | $$ 1,000,000,000\,\text{tCO₂e} $$ | Global annual emissions                      |
+
+This glossary focuses on units relevant to carbon dioxide and greenhouse gas reporting and provides essential context for understanding their applications across different scales.