offgridders

Models and optimizes capacity & dispatch of electricity supply systems, off-grid or connected to a (weak) central grid

https://github.com/rl-institut/offgridders

Science Score: 13.0%

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

  • CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
  • DOI references
  • Academic publication links
  • Committers with academic emails
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (14.9%) to scientific vocabulary

Keywords

oemof

Keywords from Contributors

projection interactive serializer measurement cycles packaging charts network-simulation archival shellcodes
Last synced: 10 months ago · JSON representation

Repository

Models and optimizes capacity & dispatch of electricity supply systems, off-grid or connected to a (weak) central grid

Basic Info
  • Host: GitHub
  • Owner: rl-institut
  • License: gpl-3.0
  • Language: Python
  • Default Branch: dev
  • Homepage:
  • Size: 152 MB
Statistics
  • Stars: 23
  • Watchers: 6
  • Forks: 10
  • Open Issues: 46
  • Releases: 14
Topics
oemof
Created over 7 years ago · Last pushed almost 2 years ago
Metadata Files
Readme Changelog Contributing License

README.md

Tool description

The simulation tool Offgridders * generates a model of an user-defined electricity supply system, optimizes the capacities of the system's generation, storage and electrical components and then performs a dispatch optimization of the optimized capacities.

Offgridders is written in python3 and utilizes the Open Energy Modelling Framework (Website) (Code) and as such uses linerarized component models. The electricity system can include AC- as well as DC demand, inverters/rectifiers, a connection to a central electricity grid (optional: with blackouts), diesel generator, PV panels, wind plant and storage. It is possible to allow a defined annual shortage or force a renewable share or system stability constraint. For a visualization of the components and demands to be included, see the Readthedocs: Definition of an electricity supply system.

Examples for electricity systems that can be simulated with Offgridders: * Off-grid micro grid, purely fossil-fuelled or hybridized * On-grid micro grid, either only consuming or also feeding into the central grid * Off-grid SHS * Backup systems (diesel generator, SHS, ...) to ensure reliable supply of consumers connected to weak national grids

If you have questions regarding the tool's execution or it's code pieces, please drop an issue so that as time goes by, I can build an FAQ for offgridders as well as improve its features.

*) previous working name: oesmot - Open Electricity System Modelling and Optimization Tool

Setup

  • Download and integrate cbc solver.
  • Open Anaconda prompt, create environment with python==3.6
  • Run: pip install -r requirements.txt
  • Execute test data: python Offgridders.py
  • Run your own simulations by defining the path to your input excel file: python Offgridders.py ./inputs/test_input_template.xlsx

When working as a dev, you need to install additional packages with pip install -r requirements_dev.txt

For Details: See Readthedocs: Installation

Literature

For further reading please refer to Readthedocs: Literature

Change log

MicroGridDesignTool_V3.0

  • New excel template - not compatible with previous versions
  • Taking into account investments into storage power
  • currently working with oemof 0.2.2

MicroGridDesignTool_V2.1

  • Error messages
  • Bugfix: Working renewable constraint
  • Bugfix: Excel-issues with max_shortage=='default' error (from columns='unnamed')

MicroGridDesignTool_V2.0

Major changes: * New excel template * DC and AC bus, connected with inverters/rectifiers, possible AC/DC demand * Forced battery charge criteria (linearized) * Minimal renewable share criteria not working! * Console execution via "python3 Amainscript.py FILE.xlsx"

MicroGridDesignTool_V1.1

  • Fixed termination due to undefined 'comments', occurring when simulation without sensitivity analysis is performed
  • New constraint: Renewable share (testing needed)
  • Added DC bus including rectifier/inverter (testing needed -> Flows, calculated values)
  • Enabled demand AC + demand DC (testing needed -> Flows, calculated values)
  • PV charge only through battery can be enabled by not inluding a rectifier (testing needed -> Flows, calculated values)
  • New Constraint: Linearized forced charge when national grid available
  • New Constraint: Discharge of battery only when maingrid experiences blackout
  • New Constraint: Inverter from DC to AC bus only active when blackout occurs

MicroGridDesignTool_V1.0

  • Simulation of off- or on-grid energy system (not only MG)
  • 1 hr timesteps, 1 to 365 days evaluation time
  • All input data via excel sheet
  • Easy case definition

Open issues

  • Timestep lengh 15 Min
  • Inlcude generation of network diagram
  • Demand shortage per timestep

Owner

  • Name: Reiner Lemoine Institut
  • Login: rl-institut
  • Kind: organization
  • Location: Berlin/Germany

GitHub Events

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

Committers

Last synced: 11 months ago

All Time
  • Total Commits: 1,107
  • Total Committers: 6
  • Avg Commits per committer: 184.5
  • Development Distribution Score (DDS): 0.379
Past Year
  • Commits: 0
  • Committers: 0
  • Avg Commits per committer: 0.0
  • Development Distribution Score (DDS): 0.0
Top Committers
Name Email Commits
Santiago infantino s****o@g****m 687
smartie2076 m****n@r****e 345
smartie2076 g****i 67
Pierre Francois p****c@n****h 3
marc-juanpera m****5@g****m 3
dependabot[bot] 4****] 2
Committer Domains (Top 20 + Academic)

Issues and Pull Requests

Last synced: 10 months ago

All Time
  • Total issues: 79
  • Total pull requests: 96
  • Average time to close issues: about 2 months
  • Average time to close pull requests: 12 days
  • Total issue authors: 13
  • Total pull request authors: 7
  • Average comments per issue: 1.87
  • Average comments per pull request: 1.17
  • Merged pull requests: 78
  • Bot issues: 0
  • Bot pull requests: 6
Past Year
  • Issues: 1
  • Pull requests: 0
  • Average time to close issues: N/A
  • Average time to close pull requests: N/A
  • Issue authors: 1
  • Pull request authors: 0
  • Average comments per issue: 7.0
  • Average comments per pull request: 0
  • Merged pull requests: 0
  • Bot issues: 0
  • Bot pull requests: 0
Top Authors
Issue Authors
  • smartie2076 (55)
  • santiagoinfantinom (11)
  • JLuij (2)
  • oum96-mah (2)
  • detroitobi (1)
  • 96said96 (1)
  • remmyd (1)
  • Bachibouzouk (1)
  • JassemKh (1)
  • Johanido (1)
  • mahendrark (1)
  • equerikiol (1)
  • IlariaDelF (1)
Pull Request Authors
  • smartie2076 (55)
  • santiagoinfantinom (26)
  • dependabot[bot] (6)
  • Bachibouzouk (3)
  • marc-juanpera (3)
  • adnanalakori (2)
  • remmyd (1)
Top Labels
Issue Labels
enhancement (16) bug (16) help wanted (3) to keep in mind (3) question (2) good first issue (2) documentation (2)
Pull Request Labels
enhancement (8) dependencies (6) bug (4)

Dependencies

docs/docs_requirements.txt pypi
  • sphinx ==2.3.1
  • sphinx_rtd_theme *
requirements.txt pypi
  • Pyomo ==5.7.0
  • matplotlib ==3.0.0
  • oemof.network ==0.4.0rc0
  • oemof.solph ==0.4.1
  • oemof.tools ==0.4.0
  • pandas ==0.23.4
  • pip ==21.1
  • scipy ==1.4.1
  • xlrd ==1.2.0
  • xlsxwriter ==1.2.7
requirements_dev.txt pypi
  • PyUtilib ==6.0.0 development
  • black ==20.8b1 development
  • decorator ==4.3.0 development
  • dill ==0.2.8.2 development
  • idna ==2.7 development
  • kiwisolver ==1.0.1 development
  • libgraph ==0.0.3 development
  • nose ==1.3.7 development
  • numexpr ==2.6.8 development
  • numpy ==1.14.5 development
  • ply ==3.11 development
  • pyparsing ==2.2.2 development
  • python-dateutil ==2.7.3 development
  • pytz ==2018.5 development
  • setuptools ==40.4.3 development
  • six ==1.11.0 development
  • tables ==3.4.4 development
  • urllib3 ==1.26.5 development
tests/test_requirements.txt pypi
  • black ==19.10b0 test
  • pytest ==5.3.1 test
setup.py pypi