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
Category: Energy Systems
Sub Category: Grid Management and Microgrid
Keywords
oemof
Keywords from Contributors
archiving transforms measur generic optimize observation conversion compose projection animals
Last synced: about 3 hours ago
JSON representation
Repository metadata
Models and optimizes capacity & dispatch of electricity supply systems, off-grid or connected to a (weak) central grid
- Host: GitHub
- URL: https://github.com/rl-institut/offgridders
- Owner: rl-institut
- License: gpl-3.0
- Created: 2018-10-16T15:06:05.000Z (over 6 years ago)
- Default Branch: dev
- Last Pushed: 2024-07-18T15:40:58.000Z (9 months ago)
- Last Synced: 2025-04-20T06:34:34.235Z (7 days ago)
- Topics: oemof
- Language: Python
- Homepage:
- Size: 152 MB
- Stars: 23
- Watchers: 6
- Forks: 9
- Open Issues: 46
- Releases: 14
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: 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 A_main_script.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 metadata
- Name: Reiner Lemoine Institut
- Login: rl-institut
- Email:
- Kind: organization
- Description:
- Website: http://www.reiner-lemoine-institut.de
- Location: Berlin/Germany
- Twitter:
- Company:
- Icon url: https://avatars.githubusercontent.com/u/18393972?v=4
- Repositories: 78
- Last ynced at: 2024-04-16T01:19:33.863Z
- Profile URL: https://github.com/rl-institut
GitHub Events
Total
- Watch event: 1
- Issue comment event: 1
Last Year
- Watch event: 1
- Issue comment event: 1
Committers metadata
Last synced: 5 days ago
Total Commits: 1,107
Total Committers: 6
Avg Commits per committer: 184.5
Development Distribution Score (DDS): 0.379
Commits in past year: 0
Committers in past year: 0
Avg Commits per committer in past year: 0.0
Development Distribution Score (DDS) in past year: 0.0
| Name | 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:
- netplus.ch: 1
- rl-institut.de: 1
Issue and Pull Request metadata
Last synced: 1 day ago
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 request: 78
Bot issues: 0
Bot pull requests: 6
Past year issues: 1
Past year pull requests: 0
Past year average time to close issues: N/A
Past year average time to close pull requests: N/A
Past year issue authors: 1
Past year pull request authors: 0
Past year average comments per issue: 7.0
Past year average comments per pull request: 0
Past year merged pull request: 0
Past year bot issues: 0
Past year bot pull requests: 0
Top 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)
Top Pull Request Authors
- smartie2076 (55)
- santiagoinfantinom (26)
- dependabot[bot] (6)
- Bachibouzouk (3)
- marc-juanpera (3)
- adnanalakori (2)
- remmyd (1)
Top Issue Labels
- enhancement (16)
- bug (16)
- help wanted (3)
- to keep in mind (3)
- question (2)
- good first issue (2)
- documentation (2)
- dependencies (1)
Top Pull Request Labels
- enhancement (8)
- dependencies (6)
- bug (4)
Dependencies
- sphinx ==2.3.1
- sphinx_rtd_theme *
- 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
- 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
- black ==19.10b0 test
- pytest ==5.3.1 test
Score: 6.025865973825315