Brief description
Learn more about the OPTIMG project on its project page.
This code is directly forked from previous open-source work open-plan-tool.
This repository contains the code for the user interface. The simulations are performed by [django-oemof]https://github.com/rl-institut/django-oemof) on a dedicated server. Once a simulation is over the results are sent back to the user interface were one can analyse them.
Prior to be able to develop locally, you might need to install postgres and create a local database, simply google install postgres
followed by your os name (linux/mac/windows
)
- Create a virtual environment using
python=3.10
- Activate your virtual environment
- Move to the
app
folder withcd app
- Install the dependencies with
pip install -r requirements/postgres.txt
- Install extra local development dependencies with
pip install -r dev_requirements.txt
- Create environment variables for communication with the database (only replace content surrounded by
<>
)
SQL_ENGINE=django.db.backends.postgresql
SQL_DATABASE=<your db name>
SQL_USER=<your user name>
SQL_PASSWORD=<your password>
SQL_HOST=localhost
SQL_PORT=5432
DEBUG=(True|False)
- Add an environment variable
MVS_API_HOST
and set the url of the simulation server you wish to use for your models (to use the MVS server, it should be https://mvs-open-plan.rl-institut.de) - To automatically download PV potential based on coordinates, add an environment variable
RN_API_TOKEN
containing your API token from https://www.renewables.ninja/ - To automatically fetch currency exchange rates, add an environment variable
EXCHANGE_RATES_API_TOKEN
containing your API token from https://www.exchangerate-api.com/ - Execute the
local_setup.sh
file (. local_setup.sh
on linux/macbash local_setup.sh
on windows). Answer yes if prompted - Start the local server with
python manage.py runserver
- You can then login with
testUser
andASas12,.
or create your own account
The following commands should get everything up and running, using the web based version of the MVS API.
You need to be able to run docker-compose inside your terminal. If you can't you should install Docker desktop first.
- Clone the repository locally
git clone --single-branch --branch dev https://github.com/rl-institut/WEFEgui.git wefe_gui
- Move inside the created folder (
cd wefe_gui
) - Edit the
.envs/epa.postgres
and.envs/db.postgres
environment files-
Change the value assigned to
EPA_SECRET_KEY
with a randomly generated one -
Make sure to replace dummy names with you preferred names
-
The value assigned to the variables
POSTGRES_DB
,POSTGRES_USER
,POSTGRES_PASSWORD
in.envs/db.postgres
should match the ones of the variablesSQL_DATABASE
,SQL_USER
,SQL_PASSWORD
in.envs/epa.postgres
, respectively -
Define an environment variable
MVS_HOST_API
in.envs/epa.postgres
and set the url of the simulation server you wish to use for your models (for exampleMVS_API_HOST="<url to your favorite simulation server>"
), you can deploy your own simulation server locally if you need -
To automatically download PV potential based on coordinates, add an environment variable
RN_API_TOKEN
containing your API token from https://www.renewables.ninja/ -
To automatically fetch currency exchange rates, add an environment variable
EXCHANGE_RATES_API_TOKEN
containing your API token from https://www.exchangerate-api.com/ -
Assign the domain of your website (without
http://
orhttps://
) toTRUSTED_HOST
, see https://docs.djangoproject.com/en/4.2/ref/settings/#csrf-trusted-origins for more information
-
Next you can either provide the following commands inside a terminal (with ubuntu you might have to prepend sudo
)
docker-compose --file=docker-compose-postgres.yml up -d --build
(you can replacepostgres
bymysql
if you want to use mysql)docker-compose --file=docker-compose-postgres.yml exec -u root app_pg sh initial_setup.sh
(this will also load a default testUser account with sample scenario).
Or you can run a python script with the following command
python deploy.py -db postgres
Finally
- Open browser and navigate to http://localhost:8080 (or to http://localhost:8090 if you chose to use
mysql
instead ofpostgres
): you should see the login page of the cp_nigeria app - You can then login with
testUser
andASas12,.
or create your own account
If you use a proxy you will need to set USE_PROXY=True
and edit PROXY_ADDRESS=http://proxy_address:port
with your proxy settings in .envs/epa.postgres
.
NOTE: If you wish to use mysql instead of postgres, simply replace
postgres
bymysql
andapp_pg
byapp
in the above commands or filenames
You can access a preconfigured project using the following login credentials:
testUser:ASas12,.
To remove the application (including relevant images, volumes etc.), one can use the following commands in terminal:
docker-compose down --file=docker-compose-postgres.yml -v
you can add --rmi local
if you wish to also remove the images (this will take you a long time to rebuild the docker containers from scratch if you want to redeploy the app later then)
Or you can run a python script with the following command
python deploy.py -db postgres --down