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

Tutorial 02 #259

Merged
merged 10 commits into from
Dec 20, 2023
Merged

Tutorial 02 #259

merged 10 commits into from
Dec 20, 2023

Conversation

nick-harder
Copy link
Member

This commit adds the new example.
It also edits multiple docstring transitioning to the google style docstings. The whole common folder has been edited.
Tests have been also slightly modified, purely cosmetical changes where all marketconfigs have now parameter_name=parameter for easier reading.

-adjust index for documentation
-reformulate docstrings in World to google format
-forecaster
-scenario loader
-units operator
-market objects
-utils
-outputs
-added named variable calling for all MarketConfig calls
-removed unused variables from storage
-edited docstring formatting
@nick-harder nick-harder requested a review from kim-mskw December 7, 2023 15:45
Copy link

codecov bot commented Dec 7, 2023

Codecov Report

All modified and coverable lines are covered by tests ✅

Comparison is base (dd9a744) 78.45% compared to head (0c9d45d) 78.49%.
Report is 3 commits behind head on main.

Additional details and impacted files
@@            Coverage Diff             @@
##             main     #259      +/-   ##
==========================================
+ Coverage   78.45%   78.49%   +0.04%     
==========================================
  Files          39       39              
  Lines        4260     4260              
==========================================
+ Hits         3342     3344       +2     
+ Misses        918      916       -2     
Flag Coverage Δ
pytest 78.49% <100.00%> (+0.04%) ⬆️

Flags with carried forward coverage won't be shown. Click here to find out more.

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

Copy link
Contributor

@kim-mskw kim-mskw left a comment

Choose a reason for hiding this comment

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

Love the tutorials, only have minor remarks/questions :)

assume/common/forecasts.py Show resolved Hide resolved
assume/common/market_objects.py Show resolved Hide resolved
assume/common/outputs.py Outdated Show resolved Hide resolved
trained_actors_path="",
)

Notes:
Copy link
Contributor

Choose a reason for hiding this comment

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

Ah okay so the extra information is now always marked as note in this section and then below?

Copy link
Member Author

Choose a reason for hiding this comment

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

yes, the idea is to have a description but extra contents go here

Copy link
Contributor

Choose a reason for hiding this comment

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

Yeah I was just wondering about the label "notes". But then we do it this way.

Copy link
Contributor

Choose a reason for hiding this comment

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

I documented that as well

Comment on lines +134 to +135
forecaster: Optional[Forecaster] = None,
manager_address: Optional[Any] = None,
Copy link
Contributor

Choose a reason for hiding this comment

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

Nice that you included the type hint! Can you document that in a todo so that the others will do that as well?

Copy link
Member

Choose a reason for hiding this comment

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

Where is this still missing?

Copy link
Contributor

Choose a reason for hiding this comment

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

Done ;)

docs/source/examples_basic.rst Outdated Show resolved Hide resolved
Copy link
Contributor

Choose a reason for hiding this comment

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

Love the way it is sturcterd of wirting the csv files by oneself basically, very straight forward :)

  • Change the first header to the name of the file as well? Than it would be consitent.
  • rename file name to have tutorial instead of examepl? Similar to folder?
  • In "Creating Input files" we should link an overview of what units are currently implemented to now which ones can be used. Or what do you think?
  • similarly the list of attributes below? Should we not just link it to avoid double book keeping? But maybe that is just not possible.

examples/notebooks/04_Reinforcement_learning_example.ipynb Outdated Show resolved Hide resolved
Copy link
Member

@maurerle maurerle left a comment

Choose a reason for hiding this comment

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

Looks good

assume/common/market_objects.py Show resolved Hide resolved
@maurerle
Copy link
Member

@maurerle
Copy link
Member

This is how it should look like:
image

This is how the GPT-docs style shows up:
image

We can merge this as usual and fix it afterwards.
I don't think that there is an automated way to parse the GPT docs suggestions and fix them.

@kim-mskw kim-mskw merged commit b3aa9c1 into main Dec 20, 2023
4 checks passed
@kim-mskw kim-mskw deleted the tutorial_02 branch December 20, 2023 18:34
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.

3 participants