|
|
| Line 1: |
Line 1: |
| | | | |
| − | ([[http://wiki.openmod-initiative.org/, open source modelling|http://wiki.openmod-initiative.org/]] or [http://platform.openmod-initiative.org/wiki http://platform.openmod-initiative.org/wiki]) | + | ([[[,|open source modelling|http://wiki.openmod-initiative.org/]]] or [http://platform.openmod-initiative.org/wiki http://platform.openmod-initiative.org/wiki])<br/> |
| | | | |
| | The wiki provides information as well for non-modellers or newbies in the modelling field as for model developers. The presented information is developed collaboratively (i.e. discussions in the background). | | The wiki provides information as well for non-modellers or newbies in the modelling field as for model developers. The presented information is developed collaboratively (i.e. discussions in the background). |
| | | | |
| − | <br/>'''Just having a look''' | + | <br/>'''Just having a look''' |
| | | | |
| | The user, who visits the glossary just to have a look, finds a list of all terms given in alphabetical order. With a click on the term she/he gets to a wiki page showing the term and its definition as well as, if existing, its sub-terms and other related terms (ontology). | | The user, who visits the glossary just to have a look, finds a list of all terms given in alphabetical order. With a click on the term she/he gets to a wiki page showing the term and its definition as well as, if existing, its sub-terms and other related terms (ontology). |
| Line 10: |
Line 10: |
| | '''Searching a definition''' | | '''Searching a definition''' |
| | | | |
| − | The wish to clarify the terminology is not limited to beginners and non-modellers, because some terms might be used differently or be vague. A user studying a [[Fact sheets for models, frameworks and scenarios|fact sheet]] might come across a term, that can be hardly interpreted. In order to get to know, how a term is used and understood in the openmod community, the user types the term into a search field and selects the glossary search. The search results will list all glossary entries whose titles or explanations match. With a click on one of the search result the user gets to the wiki page of the selected term. | + | The wish to clarify the terminology is not limited to beginners and non-modellers, because some terms might be used differently or be vague. A user studying a [[Fact sheets for models, frameworks and scenarios|fact sheet]] might come across a term, that can be hardly interpreted. In order to get to know, how a term is used and understood in the openmod community, the user types the term into a search field and selects the glossary search. The search results will list all glossary entries whose titles or explanations match. With a click on one of the search results the user gets to the wiki page of the selected term.<br/> |
| | | | |
| | '''Giving and discussing a definition''' | | '''Giving and discussing a definition''' |
| Line 24: |
Line 24: |
| | = Quality criteria = | | = Quality criteria = |
| | | | |
| − | <u>'''Use Case of all users:'''</u>
| + | As a result of an ongoing discussion process (in the openmod wiki or another specified place) the user finds quality criteria for data, assumptions, models, scenarios and open source code in the openmod wiki. For example:<br/> |
| − | | + | |
| − | As a result of an ongoing discussion process (in the openmod wiki or another specified place) the user finds quality criteria for data, assumptions, models, scenarios and open source code in the openmod wiki. For example: | + | |
| | | | |
| | *Data: source provided, reliable source, licence given, structure of data (i.e. machine readability etc.), ... | | *Data: source provided, reliable source, licence given, structure of data (i.e. machine readability etc.), ... |
| − | *Models: external validation, active community, up-to-date and good documentation (see also [https://docs.google.com/document/d/1Rg6f9iGyVcW7o4SolGi_cstwa66tZiOMVQyzmT1PRsA/edit?pref=2&pli=1 here]), [[Best practices for model websites|good model presentation]] incl. giving an [https://typo3.org/extensions/repository/ overview of available extensions] etc. There is a certain overlap with the elements of the model fact sheet, but here the best practice is presented / discussed. | + | *Models: external validation, plausability tests passed, active community, up-to-date and good documentation (see also [https://docs.google.com/document/d/1Rg6f9iGyVcW7o4SolGi_cstwa66tZiOMVQyzmT1PRsA/edit?pref=2&pli=1 here]), [[Best practices for model websites|good model presentation]] incl. giving an [https://typo3.org/extensions/repository/ overview of available extensions] etc. There is a certain overlap with the elements of the model fact sheet, but here the best practice is presented / discussed.<br/> |
| | *Assumptions: .. | | *Assumptions: .. |
| − | *Scenarios: … | + | *Scenarios: …plausability tests passed...,... |
| − | *Open Source Code: additional to the criteria for good models: good code and developer documentation, ... | + | *Open Source Code: additional to the criteria for good models: good code (regarding common guidelines as (...)) and developer documentation, ... |
| | | | |
| | Specifications / explanations are also given here. The user can also participate in the discussion process. | | Specifications / explanations are also given here. The user can also participate in the discussion process. |
| Line 43: |
Line 41: |
| | | | |
| | = openmod Activities / Events = | | = openmod Activities / Events = |
| − |
| |
| − | '''<u>Use Case of all users:</u>'''
| |
| | | | |
| | As up to now the user finds here the wiki pages for the past and coming events of the openmod initiative with links to the protocols and presentations. | | As up to now the user finds here the wiki pages for the past and coming events of the openmod initiative with links to the protocols and presentations. |
| Line 57: |
Line 53: |
| | | | |
| | = Open Licences = | | = Open Licences = |
| − |
| |
| − | '''<u>Use Case of all users:</u>'''
| |
| | | | |
| | On [[Choosing a license|this wiki page]] the user finds, as before, information with regard to open source licences, copyrights and copylefts. | | On [[Choosing a license|this wiki page]] the user finds, as before, information with regard to open source licences, copyrights and copylefts. |
| Line 69: |
Line 63: |
| | | | |
| | = Best practice guide for collaborative modelling = | | = Best practice guide for collaborative modelling = |
| − |
| |
| − | '''<u>Use Case of model developers:</u>'''
| |
| | | | |
| | On these wiki pages the user finds a selection of tools, energy system modellers recommend / use for the collaborative open source model development. Moreover, proven work flows are presented by users for users, for example: | | On these wiki pages the user finds a selection of tools, energy system modellers recommend / use for the collaborative open source model development. Moreover, proven work flows are presented by users for users, for example: |
| Line 83: |
Line 75: |
| | *Decision making processes | | *Decision making processes |
| | *Asking the community (mailing list or Question and Answer (Q&A) on Stack Overflow with preferred tag) | | *Asking the community (mailing list or Question and Answer (Q&A) on Stack Overflow with preferred tag) |
| − | *perhaps also presentation of negative examples | + | *perhaps also presentation of what didn't work |
| | | | |
| | <u>'''Implementation:'''</u> | | <u>'''Implementation:'''</u> |
| Line 92: |
Line 84: |
| | | | |
| | = Coding Rules / Guidelines / Standards = | | = Coding Rules / Guidelines / Standards = |
| − |
| |
| − | <u>'''Use Case of model developers:'''</u>
| |
| | | | |
| | The model developers document and discuss their rules / guidelines for the coding of energy system models and their components on these wiki pages in order to establish good practice and perhaps to facilitate the process of model integration (see also [[Discussion: Ways of model integration|here]]). The model developers might use the annual openmod workshops to collaboratively develop these best practice standards for software design. | | The model developers document and discuss their rules / guidelines for the coding of energy system models and their components on these wiki pages in order to establish good practice and perhaps to facilitate the process of model integration (see also [[Discussion: Ways of model integration|here]]). The model developers might use the annual openmod workshops to collaboratively develop these best practice standards for software design. |
| − |
| |
| − | ''Differentiation between Coding Rules / Guidelines published by oemof (e.g. git braching model) and by the OpenEnergy Platform required!''
| |
| | | | |
| | Examples for modelling with Python could be: | | Examples for modelling with Python could be: |
The wiki provides information as well for non-modellers or newbies in the modelling field as for model developers. The presented information is developed collaboratively (i.e. discussions in the background).
The user, who visits the glossary just to have a look, finds a list of all terms given in alphabetical order. With a click on the term she/he gets to a wiki page showing the term and its definition as well as, if existing, its sub-terms and other related terms (ontology).
The wish to clarify the terminology is not limited to beginners and non-modellers, because some terms might be used differently or be vague. A user studying a fact sheet might come across a term, that can be hardly interpreted. In order to get to know, how a term is used and understood in the openmod community, the user types the term into a search field and selects the glossary search. The search results will list all glossary entries whose titles or explanations match. With a click on one of the search results the user gets to the wiki page of the selected term.
A logged-in user can on the one hand create a new glossary page in the wiki in order to give a definition of a new term. On the other hand she/he can participate in the discussions belonging to existing glossary entries as well as she/he can change the glossary entries themselves.
The glossary is made up by the wiki pages, which are part of the category called “glossary”.
As a result of an ongoing discussion process (in the openmod wiki or another specified place) the user finds quality criteria for data, assumptions, models, scenarios and open source code in the openmod wiki. For example:
Specifications / explanations are also given here. The user can also participate in the discussion process.
As up to now the user finds here the wiki pages for the past and coming events of the openmod initiative with links to the protocols and presentations.
(Hint: The upcoming openmod workshop will also be presented on the main page (“Connect!”).)
On these wiki pages the user finds a selection of tools, energy system modellers recommend / use for the collaborative open source model development. Moreover, proven work flows are presented by users for users, for example:
The model developers document and discuss their rules / guidelines for the coding of energy system models and their components on these wiki pages in order to establish good practice and perhaps to facilitate the process of model integration (see also here). The model developers might use the annual openmod workshops to collaboratively develop these best practice standards for software design.
