{"id":28615939,"url":"https://github.com/powergridmodel/power-grid-model-workshop","last_synced_at":"2025-07-23T19:04:27.215Z","repository":{"id":39288502,"uuid":"495754604","full_name":"PowerGridModel/power-grid-model-workshop","owner":"PowerGridModel","description":"Workshop assignments on power-grid-model: A distribution power system analysis library","archived":false,"fork":false,"pushed_at":"2025-06-06T06:53:33.000Z","size":1299,"stargazers_count":24,"open_issues_count":4,"forks_count":10,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-06-06T07:31:48.614Z","etag":null,"topics":["jupyter-notebook","python","tutorial"],"latest_commit_sha":null,"homepage":"","language":"Jupyter Notebook","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/PowerGridModel.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2022-05-24T09:27:25.000Z","updated_at":"2025-06-06T06:53:35.000Z","dependencies_parsed_at":"2023-10-23T09:29:53.053Z","dependency_job_id":"5a686794-9fda-480d-aff4-3760724e20d2","html_url":"https://github.com/PowerGridModel/power-grid-model-workshop","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/PowerGridModel/power-grid-model-workshop","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PowerGridModel%2Fpower-grid-model-workshop","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PowerGridModel%2Fpower-grid-model-workshop/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PowerGridModel%2Fpower-grid-model-workshop/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PowerGridModel%2Fpower-grid-model-workshop/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/PowerGridModel","download_url":"https://codeload.github.com/PowerGridModel/power-grid-model-workshop/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PowerGridModel%2Fpower-grid-model-workshop/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":266737576,"owners_count":23976390,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-07-23T02:00:09.312Z","response_time":66,"last_error":null,"robots_txt_status":null,"robots_txt_updated_at":null,"robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["jupyter-notebook","python","tutorial"],"created_at":"2025-06-12T02:10:42.902Z","updated_at":"2025-07-23T19:04:27.196Z","avatar_url":"https://github.com/PowerGridModel.png","language":"Jupyter Notebook","readme":"\u003c!--\nSPDX-FileCopyrightText: Contributors to the Power Grid Model project \u003cpowergridmodel@lfenergy.org\u003e\n\nSPDX-License-Identifier: MPL-2.0\n--\u003e\n\n# Power Grid Model Workshop\n\nThe steps for the workshop are to follow `Power Flow Example.ipynb` and `Power Flow Assignment.ipynb` simultaneously.\nTo complete the workshop on your own, go through `Power Flow Example` notebook while completing the respective assignment from at each checkpoint.\nIf you like to be guided through the workshop, please visit our [Power Grid Model Workshop](https://www.youtube.com/watch?v=Y8ejfZnnfPM) recording.\n\n## Pre-knowledge\n\nParticipants are expected to have knowledge of \n[Juypter Notebook](https://jupyter.org/) and\n[numpy](https://numpy.org/).\n\nIt is recommended to read the numpy structured array \n[documentation](https://numpy.org/doc/stable/user/basics.rec.html).\n\n## Preparation\n\nPlease create the relevant environment before the workshop. If you encounter problems, please raise a question in the [discussion board](https://github.com/orgs/PowerGridModel/discussions)\n\n### Preparation for Windows (beginners guide)\n\n1. [Download](https://github.com/PowerGridModel/power-grid-model-workshop/archive/refs/heads/main.zip) (or \n   checkout) this workshop/repository and remember the destination location. For example: \n   `C:\\Users\\YourUserName\\Downloads\\power-grid-model-workshop`.\n\n1. Install the latest [Python](https://www.python.org/ftp/python/3.13.3/python-3.13.3-amd64.exe) version.\n   You probably want the **Windows installer (64-bit)** under **Stable Release**.\n\n1. Now open a terminal (Windows-Key + R, type `cmd`, press **OK**) and use the `cd` (change dir) command to navigate\n   to the folder where you downloaded the workshop. For example:\n   ```shell\n   C:\\Users\\YourUserName\u003e cd Downloads\\power-grid-model-workshop\n   C:\\Users\\YourUserName\\Downloads\\power-grid-model-workshop\u003e_\n   ```\n1. Optional: Create and activate a virtual environment. You can skip this step, but it helps you to keep your system\n   clean, as we will be installing about 70 Python packages in the next step.\n   ```shell\n   \u003e python -m venv venv\n   \u003e venv\\Scripts\\activate\n   ```\n1. install Power Grid Model and some other packages we'll use for this workshop:\n    ```shell\n    \u003e pip install power-grid-model jupyter pandas matplotlib\n    ```\n1. Now run jupyter notebook. It will probably (depending on your system) automatically open a browser at\n   http://localhost:8888. If not, the console output will tell you where to find the jupyter notebook server.\n    ```shell\n    \u003e jupyter notebook\n    ```\n1. Try any of the `.ipynb` files, for example\n   [`Power Flow Example.ipynb`](http://localhost:8888/notebooks/examples/Power%20Flow%20Example.ipynb) and press the `\u003e\u003e` \n   button to run the entire file. Note that the last section in the Power Flow Example is about error handling, so \n   don't get scared if you see some error messages there.\n\n\n### Next time, pick up where you left off\n\n1. Open a terminal (Windows-Key + R, type `cmd`, press **OK**) and use the `cd` (change dir) command to navigate\n   to the folder where you downloaded the workshop. For example:\n   ```shell\n   C:\\Users\\YourUserName\u003e cd Downloads\\power-grid-model-workshop\n   C:\\Users\\YourUserName\\Downloads\\power-grid-model-workshop\u003e_\n   ```\n2. Optional: Activate the virtual environment (if you created one initially).\n   ```shell\n   \u003e venv\\Scripts\\activate\n   ```\n3. Run jupyter notebook. It will probably (depending on your system) automatically open a browser at\n   http://localhost:8888. If not, the console output will tell you where to find the jupyter notebook server.\n    ```shell\n    \u003e jupyter notebook\n    ```\n    \n### Preparation for WSL2 or Linux (for advanced users)\n\nIf you know WSL2/Linux you should be able to configure environment yourself.\n\n```shell\n\u003e pip install power-grid-model jupyter pandas\n\u003e jupyter notebook\n```\n\nOpen the jupyter notebook [`Power Flow Example.ipynb`](http://localhost:8888/Power%20Flow%20Example.ipynb), try to run it. \n\n## License\n\nThis project is licensed under the Mozilla Public License, version 2.0 - see [LICENSE](LICENSE) for details.\n\n## Contributing\n\nPlease read [CODE_OF_CONDUCT](https://github.com/PowerGridModel/.github/blob/main/CODE_OF_CONDUCT.md) and [CONTRIBUTING](https://github.com/PowerGridModel/.github/blob/main/CONTRIBUTING.md) for details on the process \nfor submitting pull requests to us.\n\nVisit [Contribute](https://github.com/PowerGridModel/power-grid-model-workshop/contribute) for a list of good first issues in this repo.\n\n## Contact\n\nPlease read [SUPPORT](https://github.com/PowerGridModel/.github/blob/main/SUPPORT.md) for how to connect and get into contact with the Power Grid Model project.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpowergridmodel%2Fpower-grid-model-workshop","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpowergridmodel%2Fpower-grid-model-workshop","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpowergridmodel%2Fpower-grid-model-workshop/lists"}