Science Score: 72.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
    Found CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
    Found .zenodo.json file
  • DOI references
  • Academic publication links
    Links to: zenodo.org
  • Committers with academic emails
    3 of 5 committers (60.0%) from academic institutions
  • Institutional organization owner
    Organization kth-desa has institutional domain (www.energy.kth.se)
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (13.9%) to scientific vocabulary

Keywords

climate energy-demand groundwater jordan morocco water water-demand water-desalination weap
Last synced: 6 months ago · JSON representation ·

Repository

Basic Info
  • Host: GitHub
  • Owner: KTH-dESA
  • License: mit
  • Language: Python
  • Default Branch: master
  • Size: 91.6 MB
Statistics
  • Stars: 5
  • Watchers: 4
  • Forks: 4
  • Open Issues: 23
  • Releases: 1
Topics
climate energy-demand groundwater jordan morocco water water-demand water-desalination weap
Created over 6 years ago · Last pushed almost 2 years ago
Metadata Files
Readme License Citation

README.md

DOI

Climate, Land and Energy Analytical study of Potential Nexus Issues in Jordan and Morocco

This repository contains the working code for the “Implementing the 2030 Agenda for water efficiency/productivity and water sustainability in NENA countries” project. The project is funded by the UN Food and Agricultural Organization, KTH is providing analyses and support on decision making across the climate, land, energy and water spheres in Morocco and Jordan.

The Jordan and Moroccan Souss-Massa basin cases

The Nexus analysis developed for the Jordan and the Moroccan Souss-Massa basin cases, softlinks a water balance model developed by SEI and the countries stakeholders using the Water Evaluation and Planning system (WEAP), and the GIS-based energy model developed by KTH. The model uses WEAP for estimating water supplies based on climate-driven hydrological routines that calculate rainfall runoff and groundwater recharge. It estimates usage patterns for the main water sectors, evaluates the productivity of cropping systems under different climate futures and assess their impact on energy and water systems. Furthermore, the energy component implements GIS-based methodologies to estimate energy requirements for groundwater and surface water pumping, new water desalination projects and major wastewater treatment plants. Finally, solar PV pumping is evaluated as a clean option to supply electricity for the agricultural sector.

Installation

To install the required dependencies, install the miniconda or conda package manager and create two conda environments running conda env create -n <name-of-environment> -f envs/notebook.yml and conda env create -n <name-of-environment> -f envs/snakemake.yml in the conda shell or git bash (replace <name-of-environment> by a custom name for your environment). Afterwards, activate the environment with conda activate <name-of-environment>.

The notebook environment is intended to run the standalone jupyter notebooks, provided for each step of the model. While the snakemake environment is intended for running the entire automated workflow of the project.

Running the model

Jupyter notebooks

To run the model, first activate the previously created conda environment for notebooks by running conda activate <name-of-environment> and then type jupyter notebook. Alternatively, you can start the Anaconda navigator, select the previously created environment and start a Jupyter notebook session. Open any of the runner files of either model and follow the steps.

Snakemake

Activate the previously created conda environment for snakemake by running conda activate <name-of-environment>. Then open the snakemake file of the model you wish to run and set the user inputs to the ones desired: ```python

################### User defined parameters

dash_folder = "dashboard" #set the dashboard folder

CLIMATE = ['Trend', 'Climate Change'] #define the list of climates to run SCENARIOS = ['Reference', 'Desalination','Irrigation Intensification', 'Reference Wastewater Reuse', 'Desalination Wastewater Reuse'] WRATE = [0] BTRATE = [0] PVRATE = [0] GRIDRATE = [0] PVLEVELS = [10, 20, 50] BUTANEPHASEOUT_SCENARIOS = [None, 2040, 2030]

`` Runsnakemake -s Morocco\ model/snakefile -n` for a dry run (of the Moroccan case). This will list all of the different jobs the workflow would run, without actually running anything.

Finally, run snakemake -s Morocco\ model/snakefile -j to run all of the listed jobs.

Visualazing results

Results for te case studies of Jordan and the Souss-Massa river basin, can be explored through interactive dashboards found in: * Jordan: https://jordan-nexus-model.herokuapp.com/ * Moroco: https://souss-massa-nexus.herokuapp.com/

For exploration of results locally, you can run the visualization from your machine in a local host by running python Morocco\ model/dashboard/index.py (for the Moroccan case) and going to http://localhost:8080/ in your browser. Notice that you would need to create and environment using one of the environment.yml files found inside each case dashboard folder, and activate it before running the dashboard locally.

Credits

Conceptualization: Youssef Almulla, Camilo Ramirez, Brian Joyce, Annette Huber-Lee
and Francesco Fuso-Nerini
Methodology: Youssef Almulla and Camilo Ramirez on the energy model, Youssef Almulla on the decarbonization strategies of the agricultural sector, Camilo Ramirez on the softlinking of models, Brian Joyce on the water-agriculture (WEAP-MABIA) model, all on the participatory approach and overall Nexus approach
Software: Camilo Ramirez & Youssef Almulla
Management and Advisory support: Annette Huber-Lee & Francesco Fuso-Nerini

Acknowledgements
We would like to acknowledge the Food and Agricultural Organization (FAO), the Jordan Ministry of Water and Irrigation, the Regional Office for Agricultural Development in Souss-Massa (ORMVA), and a special thanks goes to Domitille Vallee and Jiro Ariyama (FAO), and Prof. Lahcen Kenny (FAO consultant) for their valuable contribution to this work by providing many of the input data and validating modelling assumptions.

Owner

  • Name: KTH division of Energy Systems
  • Login: KTH-dESA
  • Kind: organization
  • Location: Sweden

Citation (CITATION.cff)

cff-version: 1.0
message: "If you use this software, please cite it as below."
authors:
- family-names: "Ramírez"
  given-names: "Camilo"
  orcid: "https://orcid.org/0000-0002-7217-3838"
- family-names: "Almulla"
  given-names: "Youssef"
  orcid: "https://orcid.org/0000-0003-3015-8610"
title: "Climate, Land and Energy Analytical study of Potential Nexus Issues in Jordan and Morocco"
version: 1.0
doi: 10.5281/zenodo.6521305
date-released: 2022-05-03
url: "https://github.com/KTH-dESA/FAO"

GitHub Events

Total
  • Watch event: 1
  • Fork event: 1
Last Year
  • Watch event: 1
  • Fork event: 1

Committers

Last synced: about 2 years ago

All Time
  • Total Commits: 188
  • Total Committers: 5
  • Avg Commits per committer: 37.6
  • Development Distribution Score (DDS): 0.537
Past Year
  • Commits: 0
  • Committers: 0
  • Avg Commits per committer: 0.0
  • Development Distribution Score (DDS): 0.0
Top Committers
Name Email Commits
Camilo Ramirez c****g@k****e 87
Camilo Ramirez Gomez c****g@U****E 74
Camilo Ramírez c****o 12
Youssef Almulla a****a@U****E 10
Youssef Almulla 4****7 5
Committer Domains (Top 20 + Academic)

Issues and Pull Requests

Last synced: about 2 years ago

All Time
  • Total issues: 58
  • Total pull requests: 42
  • Average time to close issues: 6 months
  • Average time to close pull requests: less than a minute
  • Total issue authors: 2
  • Total pull request authors: 1
  • Average comments per issue: 0.16
  • Average comments per pull request: 0.0
  • Merged pull requests: 42
  • Bot issues: 0
  • Bot pull requests: 0
Past Year
  • Issues: 0
  • Pull requests: 0
  • Average time to close issues: N/A
  • Average time to close pull requests: N/A
  • Issue authors: 0
  • Pull request authors: 0
  • Average comments per issue: 0
  • Average comments per pull request: 0
  • Merged pull requests: 0
  • Bot issues: 0
  • Bot pull requests: 0
Top Authors
Issue Authors
  • camiloramirezgo (52)
  • JZF07 (6)
Pull Request Authors
  • camiloramirezgo (42)
Top Labels
Issue Labels
Jordan (25) enhancement (23) Morocco (22) Visualisation (21) methodology (12) Nexus tool (11) bug (9) documentation (5)
Pull Request Labels
Jordan (2) enhancement (2) documentation (1) Morocco (1) Visualisation (1)

Dependencies

Jordan model/dashboard/environment.yml conda
  • boto3
  • dash
  • dash-bootstrap-components
  • geopandas
  • json
  • openpyxl
  • pip
  • python-decouple
  • xlrd
Morocco model/dashboard/environment.yml conda
  • boto3
  • dash
  • dash-bootstrap-components
  • json
  • openpyxl
  • pandas
  • pip
  • python-decouple
  • s3fs
  • xlrd
environment.yml pypi