Skip to content

02 - How to get started with the Open Energy Family and Platform#

You will learn how to register as a user with the Open Energy Platform (OEP) and why and how to register also with GitHub.

You can provide feedback to this course on GitHub: https://github.com/OpenEnergyPlatform/academy/issues/164

For whom is this training and what can you learn?#

This module is aimed at researchers, policy makers and any interested person, who - wants to interact as a user with the OEP - wants to contribute to development of the OEP and Open Energy Family (OEF) members

After reading the sections of this training course you will - be able to interact as a user with the OEP - understand why a GitHub account is needed to contribute to development - be able to register with GitHub

How do I get started with the OEP?#

How do I register with the Open Energy Platform?

To upload your data to open energy database of the OEP, you require a user account on the OEP. Here, we show you how to register with the OEP. Click the Login button on the top right of the homepage and choose the option Create a new account. You can also go directly to Register. Then fill out the required fields and click on Submit. You will receive an activation email at the email address you provided. Please follow the instructions received in the email. After successfully activating and logging into your account, you will see your information as in the screenshot:

image

This includes your profile information and any data tables you have already contributed to the OEP. Under Settings, you will be able to view your API token, by clicking Show token:

image

The API token is necessary to make authenticated requests to the API (API = Application Programming Interface). You will use the API in case you want to connect to the OEP using programming skills.

Why and how to register with GitHub?#

Why register with GitHub?

When you interact with the OEP you also interact with the Open Energy Family (OEF). The development of the OEF and OEP is a community effort that takes place openly at GitHub in the GitHub group Open Energy Platform. There, the various family members of the OEF are developed in different repositories. We welcome you to participate in their development. To be able to do so, you will thus need to register with GitHub. You can do so at no cost.

How to register with GitHub and become part of the Open Energy Family team?

If you do not yet have a GitHub account, you need to register with GitHub. You will then need to become a member of the group OpenEnergyPlatform by getting invited to the group. This works as follows: Get in touch via the OpenEnergy Platform contact form. Fill in the form with your request to be added to the OpenEnergyPlatform group on GitHub. An example text is provided in the screenshot below.

image

The response is not automated and thus not immediate. Please wait until you receive an invitation to the GitHub group.

We collected a few links to GitHub and git basics here for your first steps.

About this course#

logo