search

OpenEnergyPlatform / academy

The Open Energy Academy is a collection of courses, tutorials, and questions for the Open Energy Family
https://openenergyplatform.github.io/academy/
GNU Affero General Public License v3.0
16 stars 6 forks source link

Feedback course 03: Download - Find and download / interact with data #165

Open han-f opened 1 year ago

han-f commented 1 year ago

Please review course 03: https://openenergyplatform.github.io/academy/courses/03_download/ and provide your feedback below as comments. Feedback can include pointing out errors (such as broken links, things that do not work as described) any suggestions for improvements, things that you are expecting from such a course but find they are missing etc.

Please make sure to reference the link to the material that you refer to in your comment (the courses link to various materials)

TilmanKie commented 1 year ago
  1. I think I can understand what I have to do, to use the REST-full-HTTP API in Python. But it's complicated and much and unfortunately I can't install python. I do not have the necessary rights on my laptop, so I can't try it by myself.
  2. Perhaps it would be help to give one or two more information in the "course 03" at "How can I download data" about what you need to do if you want to use the REST-full-HTTP API in Python. For example that it is necessary to install Python and the Jupyther Notebook. When I read the "course 03" the first time I thought it would be easy and then I had to follow more then three links. That was unexpected and complicated for me. The information could help you to know what to expect. The detailed information can be linked of course.
  3. Also at "How can I interact with data" I would appreciate some more information what information the tutorial provides. There is the same description as in "How can I download data".
  4. I think the courses are very clear and well structured!
TilmanKie commented 1 year ago

@wingechr

TilmanKie commented 1 year ago

I had no previous knowledge of python, so I had some problems to understand where I can use the code. I tryed "cmd.exe", "spider" and "Jupyte Notebook", only then I understood. I think it took a lot of time. Some errors:

  1. "Process query result data and save to file (tutorial)": Code at setup token did not work And the last code at "Create a .xlsx file with...." did not work (ModuleNotFoundError: No module named 'xlsxwriter')
  2. "Data queries via API (tutorial)": "Select data from a table" -> response 404

At "how can I download data" and "How can I interact with data" there is two times the same link. Is this right?

But in general I understood python and the OEP well :D

han-f commented 1 year ago

Thanks @TilmanKie for the feedback and going through figuring out how to use python - I have created two separate issues for the tutorials: #175 and #176, so the authors can take it from there.

The tutorial that is linked twice not only shows how to download data, but also some interaction. So for now I think it is ok that it is linked twice.