search

spine-tools / SpineOpt.jl

A highly adaptable modelling framework for multi-energy systems
https://www.tools-for-energy-system-modelling.org/
GNU General Public License v3.0
58 stars 13 forks source link
electricity energy energy-system-modelling energy-systems julia-language modelling-framework

readme

SpineOpt.jl

Docs codecov Join the chat at https://gitter.im/spine-tools/SpineOpt.jl

A Julia package containing a state-of-the-art energy system optimization model.

:loudspeaker: Community and how to ask help :rocket:

There are four main ways to get help with SpineOpt.

  1. Monthly user meetings for Spine Toolbox and SpineOpt. There you can connect with other users, present problems and exchange experiences. New and old users equally welcome. The meetings are held first Tuesday of every month at 3pm CEST :calendar: ics zip and can be joined here. For meeting updates, please checkout this discussion.
  2. Gitter (i.e. Matrix) chat service. You need to register but allows to ask quick questions and hopefullly get quick answers.
  3. Discussion forum (support section) can be used when you don't know how to get something done or you don't quite know why something isn't working. It's highly appreciated if other users can contribute by helping each other (developers are short on time).
  4. Issue tracker should be used only when there is a missing feature or something should work but it's not working. Update your tools and test with latest software before submitting an issue. In case of new feature, make sure there is no existing issue. Issues reporting bugs should provide sufficient information to enable locating and fixing the bug.

Getting started

We highly recommend you to go through the getting started chapter of the documentation.

The chapter explains in great detail the different ways to install SpineOpt. The prerequisites are also mentioned here.

The chapter also explains how to set up a minimal workflow to test your installation. This part also includes some explanations on what you see during the setup so you can already get a bit familiar with using SpineOpt.

If any issues arise during the first two steps, you can consult the trouble shooting section.

Once you have succesfully installed and verified the correct functioning of SpineOpt, you can start learning how to use SpineOpt. To that end you can visit the tutorials chapter of the documentation. The tutorials cover the different features of SpineOpt (the underlying files of the tutorials are part of our tests so these should always be up to date, though the text/images may lag behind some times).

Reporting Issues and Contributing

For contributing and instructions on reporting issues, see CONTRIBUTING.md

License

SpineOpt is licensed under GNU Lesser General Public License version 3.0 or later.

Citing SpineOpt

Please cite this article when referring to SpineOpt in scientific writing.

Ihlemann, M., Kouveliotis-Lysikatos, I., Huang, J., Dillon, J., O'Dwyer, C., Rasku, T., Marin, M., Poncelet, K., & Kiviluoma, J. (2022). SpineOpt: A flexible open-source energy system modelling framework. Energy Strategy Reviews, 43, [100902]. https://doi.org/10.1016/j.esr.2022.100902

Acknowledgements

EU emblem This work has been partially supported by EU project Mopo (2023-2026), which has received funding from European Climate, Infrastructure and Environment Executive Agency under the European Union’s HORIZON Research and Innovation Actions under grant agreement N°101095998.
EU emblem This work has been partially supported by EU project Spine (2017-2021), which has received funding from the European Union’s Horizon 2020 research and innovation programme under grant agreement No 774629.