Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add industry variables #90

Draft
wants to merge 14 commits into
base: main
Choose a base branch
from
Draft

Conversation

macflo8
Copy link

@macflo8 macflo8 commented Apr 10, 2024

This PR is a first draft to add industry and bulk/specialty materials related variables to the data template.

The following variable "categories" are added:

  • Demand of material commodities in total and by demand sector
  • Stocks of commodities by sector
  • Production of commodities
  • Total and collected scrap by commodity
  • Trade of material commodities

Copy link
Member

@danielhuppmann danielhuppmann left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks @macflo8 for this well-structured PR. I made quite a few comments, so it might make sense to split this PR into several components for easier review and discussion...

definitions/variable/industry/tag_production_units.yaml Outdated Show resolved Hide resolved
definitions/variable/industry/demand.yaml Outdated Show resolved Hide resolved
@@ -0,0 +1,16 @@
# material demand by commodity and demand sector
- Demand|Iron and Steel|Steel|{Demand Sector}:
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Is there a reason why this is not {Iron Commodity}?

description: x {Pulp and Paper Commodity} scrap from {Demand Sector}
unit: Mt/yr

- Total Scrap|Iron and Steel|Steel|{Demand Sector}:
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The difference between collected and total scrap is not clear to me - what is uncollected scrap?

Copy link

@GamzeUnlu95 GamzeUnlu95 Apr 16, 2024

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The idea behind "collected scrap" was that it is collected to be recycled. In this case, uncollected scrap is not collected in the recycling system and would be dumped. The word "recycled" can be easier to understand.

definitions/variable/industry/scrap.yaml Outdated Show resolved Hide resolved
definitions/variable/industry/tag_nonfer_commodities.yaml Outdated Show resolved Hide resolved
- Non-Ferrous Metals Commodity:
- Aluminum:
description: Aluminum, commonly produced by electrolysis of alumina or re-melting of scrap
- Secondary Aluminum:
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Should "Secondary Aluminum" a subcategory of Aluminum?

@@ -0,0 +1,19 @@
- Production|{Industry Sector} [{Production Unit}]: # ???: do we need this aggregate?
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Probably not needed, so let's leave this out until we find a relevant use case


- Production|Iron and Steel|{Iron Commodity} [{Production Unit}]:
description: Production of {Iron Commodity} in {Production Unit}
unit: Mt/yr
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

You use the tag-list for "Production Unit", but the "Value"-variable should not have the unit Mt/yr but USD_2010/yr. So either you also set the units depending on the tag-list or you only create the Volumne-variable-variant in this PR.

@macflo8
Copy link
Author

macflo8 commented Apr 16, 2024

Thanks @danielhuppmann for the suggestions! Most of the variable names were copied from the NAVIGATE template, but I agree that some variable names should be improved/changed.

@danielhuppmann
Copy link
Member

You can either rephrase the description or put the entire string in quotes to avoid the error when starting with a {Tag}...

About the renaming, yes, we should use previous projects as starting point but improve and harmonize where possible. You can add the variable-name from the previous project as an attribute so that we can implement automated translation/migration later, see the example below...

- Population|Clean Cooking Access:

@@ -0,0 +1,32 @@

- Collected Scrap|Iron and Steel|Steel|{Demand Sector}:
description: Steel scrap from {Demand Sector}
Copy link

@GamzeUnlu95 GamzeUnlu95 Apr 16, 2024

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

In the description, we can clarify that "collected scrap" is the amount that is collected to be recycled.

- Collected Scrap|Iron and Steel|Steel|{Demand Sector}:
description: Steel scrap from {Demand Sector}
unit: Mt/yr
- Collected Scrap|Non-Metallic Minerals|{Non-Metallic Minerals Commodity}|{Demand Sector}:
Copy link

@GamzeUnlu95 GamzeUnlu95 Apr 16, 2024

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actually, scrap is a terminology used for metals but not so much for other materials. We can either use it just for metals or to be consistent across all materials, we could adopt the terminology "waste" which can cover metals, non-metallic minerals, plastics, and others. In this case "Collected Waste" might sound confusing. To be more comprehensive we can have something like e.g. "Waste|Non-Metalic Minerals", "Waste|Recycling|Non-Metalic Minerals", (and later if needed other waste treatment methods "Waste|Landfilling|Non-Metallic Minerals", "Waste|Other|Non-Metallic Minerals", "Waste|Downcycling|Non-Metallic Minerals")

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Separating these variables into Scrap vs Waste and call it Total (with an extended description, please) vs. Recycled makes a lot of sense to me, thanks!

@@ -0,0 +1,13 @@
- Non-Ferrous Metals Commodity:
- Aluminum:

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

As another subcategory of aluminum, we could add bauxite here similar to including iron ore.

unit: Mt/yr

- Export|Industry|Iron and Steel|{Iron Commodity}|{Production Unit}:
description: Production of {Iron Commodity}

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

In the description, not production but export



- Import|Industry|{Industry Sector}|{Production Unit}: # ???: do we need this aggregate?
description: Total production of commodities by sector

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

In the description, not production but import

1) remove unused files
2) update variable descriptions and add tags
3) fix paper commodity names
4) comment out unused material stock variables for now
Resolve error with {Tag} at beginning of line
Rename "Production Unit" tag to "Accounting Type"
Add tag-specific units
Rename all mentions of "demand" to "consumption"

As "Production" is used for materials instead of "Supply", "Demand"
should be called renamed to "Consumption"
Move "Accounting Type" tag from subcategory to bracket

As agreed in IAMconsortium#55 methods/units should not be a subcategory but put into
brackets of a variable category
Add missing NAVIGATE variables and add "navigate" value where applicable
Copy link
Member

@danielhuppmann danielhuppmann left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks @macflo8 for continuing this PR, see a few inline comments...

@@ -0,0 +1,16 @@
# material demand by commodity and demand sector
- Consumption|Iron and Steel|Steel|{Consumption Sector}:
description: consumption of steel commodities in {Consumption Sector}
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Sorry, I think my previous comment led to a misunderstanding - please capitalize in the description a variable but start with lower-case in the description of tag-lists

Comment on lines +1 to +2

- Collected Scrap|Iron and Steel|Steel|{Consumption Sector}:
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- Collected Scrap|Iron and Steel|Steel|{Consumption Sector}:
- Collected Scrap|Iron and Steel|Steel|{Consumption Sector}:

description: simplest alcohol used as precursor for various chemicals and fuels
- Formaldehyde:
description: simplest aldehyde, mainly used to produce resins
- Formaldehyde resins:
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- Formaldehyde resins:
- Formaldehyde Resins:

description: most produced fertiliser type
- Methanol:
description: simplest alcohol used as precursor for various chemicals and fuels
- Formaldehyde:
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

What's the difference between this type and resins? Can something be added to clearly distinguish this from the resins?

# Industry sectors as used in IEA World Energy Balances (2022 Edition)
- Industry Sector:
- Mining:
description: industry sectors categorized as ISIC Rev. 4 Divisions 07 and 08 and Group 099
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggest to still repeat the actual sector name in the description

Suggested change
description: industry sectors categorized as ISIC Rev. 4 Divisions 07 and 08 and Group 099
description: industry sectors categorized as ISIC Rev. 4 Divisions 07 and 08 and Group 099

description: industry sectors categorized as ISIC Rev. 4 Divisions 41-43
- Iron and Steel:
description: industry sectors categorized as ISIC Rev. 4 Group 241 and Class 2431
- Non-ferrous Metals:
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- Non-ferrous Metals:
- Non-Ferrous Metals:

description: industry sectors categorized as ISIC Rev. 4 Group 241 and Class 2431
- Non-ferrous Metals:
description: industry sectors categorized as ISIC Rev. 4 Group 242 and Class 2432, basic industries
- Non-metallic Minerals:
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- Non-metallic Minerals:
- Non-Metallic Minerals:

description: industry sectors categorized as ISIC Rev. 4 Divisions 20 and 21
- Machinery:
description: industry sectors categorized as ISIC Rev. 4 Divisions 25-28
- Transport equipment:
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- Transport equipment:
- Transport Equipment:

description: industry sectors categorized as ISIC Rev. 4 Divisions 10-12
- Paper and Pulp:
description: industry sectors categorized as ISIC Rev. 4 Divisions 17 and 18
- Textile and leather:
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- Textile and leather:
- Textile and Leather:

@@ -0,0 +1,15 @@
- Production|Iron and Steel|{Iron Commodity} [{Accounting Type}]:
description: production of {Iron Commodity} in {Accounting Type}
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Please add "given as {Accounting Type}" to all variables where the Accounting-Type is used

Suggested change
description: production of {Iron Commodity} in {Accounting Type}
description: production of {Iron Commodity} given as {Accounting Type}

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

4 participants