Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

Confusion about the `CommodityType` parameter

Open
#492 1 comment 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
2/5
Estimated time
1-3 hours
Newbie friendliness
35/100
Issue type
Documentation
Clarity
Mostly clear
Activity status
Stale
Tech stack
python
Domain
documentation

Research direction

Start with the linked CommodityType documentation, then compare the heat and cook examples in the example models/tutorials. Read the is_enduse function and its handling of Energy, Environmental, and Service. Done means the documentation and examples clearly agree on the valid end-use value and explain why.

Written by the indexing model from the issue text.

Description

documentation

The documentation for this parameter states that "Service" should be used for end-use commodities such as heating, however the example models/tutorials use "Energy" for the heat and cook commodities. This is confusing and needs to be clarified.

Looking at the code, "Energy" and "Environmental" are the only CommodityType options that are directly referenced. For end-use commodities, the important thing is that they get picked up by the is_enduse function, but this will be true for any products that are not the "Environmental" type (so it doesn't actually matter if it's "Service" or "Energy")

Dominant language
Python
Stars
29
Forks
12
PR merge metrics
No merged PRs in 30d

Getting set up

  • No Dockerfile or Docker Compose file
  • Has a pull request template
  • No contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from EnergySystemsModellingLab/MUSE_OS

All issues in EnergySystemsModellingLab/MUSE_OS

Similar issues

More Python issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.