Robbie Morrison:

This is the wiki page for the upcoming 8th Workshop of the Open Energy Modelling Initiative, a grass-roots organization of modellers from various research institutes, universities and companies. The workshop will take place at '''ETH Zürich, Switzerland,''' from '''6-8 June 2018'''.

The primary workshop location will be [http://www.mapsearch.ethz.ch/map/map.do?gebaeudeMap=CHN&lang=en ETH Zürich's CHN building], a 5 minute walk from the Zurich main railway station and close to the city center.

This wiki page will continue to be updated with more information as the programme is developed. Do also sign up to the [https://forum.openmod-initiative.org/ forum] and [https://groups.google.com/forum/#!forum/openmod-initiative mailing list] where all things regarding open energy modelling are discussed.

= About the workshop =

The Openmod Workshops provide a forum for modellers to come together and discuss how to further the use of open data and open software tools in the energy modelling community. Topics range from exchanges about specific types of data (e.g. sources for open data on building stocks or distribution networks) to advocacy and outreach.

Only a small part of the workshop consists of prepared presentations. For the rest of the workshop, participants work together in breakout groups on specific topics. The topics are chosen by the participants themselves, so please get actively involved by suggesting topics! To get the most out of the workshop, it is suggested to consider in advance what you would like to discuss.

Breakout groups should have specific aims, which can be followed up after the workshop, e.g. improving the openmod wiki pages, lobbying a data-holder to change its licencing, improving educational tools, or outreach.

= Practical information =

'''Venue: '''[https://www.usys.ethz.ch/departement/standorte/chn.html ETH Zürich, CHN building]

'''Getting there:''' The workshop location is at ETH Zürich's main campus, located a short walk from Zürich's main station.

'''Map:''' [http://www.openstreetmap.org/relation/4633 OpenStreetMap]

'''Accommodation:''' Participants wishing to stay within 5 minutes walking distance of the workshop can book at [http://www.hotelsunnehus.ch/EN/index.htm Hotel Sunnehus] or [http://www.leoneck.ch/en/home/ Hotel Leoneck]. More information on hotels is available at the [http://www.wohnen.ethz.ch/en/search-accommodation/hotels-hostels.html ETH Zurich housing office].

= Registration =

The registration is now closed. If you are on the waitlist and a place becomes available for you, we will inform you.

A list of currently registered participants including the waitlist is available here: [https://docs.google.com/spreadsheets/d/1tyMt5XW40hbo8s6O5bVkh40fdh_vOROlYF3XimtuvlU/edit?usp=sharing https://docs.google.com/spreadsheets/d/1tyMt5XW40hbo8s6O5bVkh40fdh_vOROlYF3XimtuvlU/edit?usp=sharing].

= Participation =

The openmod workshop is interactive and organised bottom-up through everybody's contributions. Here are three ways in which you can contribute:

*bring a '''poster''' to communicate your research, model, or data;<br/>
*give a '''lightning talk''' to teach others about an interesting tool, method or workflow, or to share an update about new developments in open science more broadly;<br/>
*propose and help organise a '''do-a-thon''' for us to work on together during the workshop.

For more information on how to participate, head over to the discussion forum: [https://forum.openmod-initiative.org/t/call-for-participation-zurich-workshop/758 https://forum.openmod-initiative.org/t/call-for-participation-zurich-workshop/758].<br/>

= Announcements =

Announcements are made on the discussion forum. If you are registered, make sure to head over the forum and stay up to date about the workshop.<br/><br/>[https://forum.openmod-initiative.org/t/zurich-workshop-announcements/756 https://forum.openmod-initiative.org/t/zurich-workshop-announcements/756]

= Programme =

== Day 1 : Wednesday 6 June 2018 ==

from 9:30 Reception and coffee

10:00 - 10:05 Introduction and administrative matters

10:05 - 10:15 Openmod Initiative

10:15 - 11:00 Keynote: Prof. [http://www.up.ethz.ch/people/person-detail.html?persid=45838 Nicolas Gruber], Chairman of the Center for Climate Systems Modeling (C2SM) at ETH Zürich

11:00 - 11:45 Speed dating (speak with 10 random people for 4 minutes each)

11:45 - 12:00 Coffee break

12:00 - 12:30 Do-a-thon preparation

12:30 - 13:30 Lunch

13:30 - 14:00 Do-a-thon preparation

14:00 - 15:30 Do-a-thon session 1

15:30 - 16:00 Coffee break

16:30 - 18:00 Do-a-thon session 2

from 19:00 Dinner reserved near university campus

== Day 2 : Thursday 7 June 2018 ==

9:15 - 9:30 Intro to day 2

9:30 - 11:00 Do-a-thon session 3

11:00 - 11:15 Coffee break

11:15 - 12:45 Do-a-thon session 4

12:45 - 13:30 Lunch

13:30 - 14:00 Poster session

14:00 - 15:30 Do-a-thon session 5

15:30 - 16:00 Coffee break

16:00 - 17:00 Optional 1-minute do-a-thon result pitches and discussion

from 19:00 Joint dinner in town for those interested

== Day 3 : Friday 8 June 2018 ==

9:00 - 9:15 Intro to day 3

9:15 - 10:00 Keynote: [https://exote.ch/blogs/aseigo/about/ Aaron Seigo], former KDE developer and community coordinator, software architect, free software and free culture advocate

10:00 - 10:30 Coffee break

10:30 - 11:15 Lightning talks

11:15 - 12:00 Feedback and next workshop

12:00 - 13:00 Lunch

from 13:00: Non-scientific part — probably a hike in the region (plan for power plant excursions did not work out this time, unfortunately)

= Other things to see and do in Zürich and around =

Apart from all the regular things to see and do in Zürich ([https://www.zuerich.com/en https://www.zuerich.com/en]), here are a few suggestions for events happening at the same time as the workshop:

*'''8/9 June: Buskers Chur''', a buskers festival in the city of Chur (1h train ride from Zürich) [https://buskers-chur.ch https://buskers-chur.ch]<br/>
*'''10 June: Formula-E Zürich''', a race through the city of Zürich with electric cars [https://www.zuricheprix.ch https://www.zuricheprix.ch]
*'''8 June: eDays Symposium ETH Zürich''', as a side event of the Formula-E there will be a symposium at ETH Zürich on sustainable mobility of the future, [https://www.ethz.ch/de/news-und-veranstaltungen/eth-news/news/2018/04/formel-e.html https://www.ethz.ch/de/news-und-veranstaltungen/eth-news/news/2018/04/formel-e.html]

Open Energy Modelling Workshop - Zurich 2018

2018-05-03T16:52:25Z

Robbie Morrison:

Open Energy Modelling Workshop - Zurich 2018

2018-01-25T12:21:01Z

Robbie Morrison:

Open Energy Modelling Workshop - Zurich 2018

2018-01-25T12:20:19Z

Robbie Morrison:

2017-12-21T22:24:30Z

Robbie Morrison:

= Why should you pick a license? =

In other words, why not just put code online without a license? A license clarifies the conditions under which your code can be reused. In the absence of a license, the author still retains propietary copyright, and the conditions under which the code can be used are unclear.<ref name="morin-etal-2012">

{{cite journal
| last1 = Morin | first1 = Andrew
| last2 = Urban | first2 = Jennifer
| last3 = Sliz | first3 = Piotr
| title = A quick guide to software licensing for the scientist-programmer
| date = 26 July 2012
| journal = PLOS Computational Biology
| volume = 8
| issue = 7
| pages = e1002598
| doi = 10.1371/journal.pcbi.1002598
| issn = 1553-7358
| url = http://journals.plos.org/ploscompbiol/article/file?id=10.1371/journal.pcbi.1002598&type=printable
| access-date = 2016-12-10}} {{open access}}
</ref>{{rp|1}} A sentence like "feel free to use this code" does not improve the situation, because it does not clarify to what extent any possible user should "feel free" to use the code. Standard licenses provide pre-defined sets of standard conditions, which both providers and users only have to understand once, and can then later easily recognise and categorise.

Also see "Why is an open-source licence useful?" on the Software Sustainability's [http://www.software.ac.uk/resources/guides/adopting-open-source-licence Choosing an open-source licence page] article.

= Selecting a license =

The most common licenses for a given artifact can be determined by its type: code, data, documentation, or other generic digital "creative work" (reports and figures). For any given project, ''these components can and should be licensed independently by type''.

At the most basic level, one must decide on whether to use a copyleft license or a more permissive license. While copyleft assures that code changes by any future contributors must stay public, permissive licenses only require attribution in derived works.

With these two distinctions (type of work, type of license), the following decision matrix can be drawn:

{| class="wikitable"
|-
!
! Code
! Data
! Documentation
|-
! style="text-align: left" | Copyleft
| GPL, AGPL
| ODbL, {{nowrap|CC BY-SA}} {{pad|1em}}
| {{nowrap|CC BY-SA}}
|-
! style="text-align: left" | Permissive {{pad|1em}}
| MIT, BSD, Apache, ISC{{nnbsp}}<sup>1</sup>{{pad|1em}}
| ODC-BY
| {{nowrap|CC BY}}
|-
! style="text-align: left" | Public domain {{pad|1em}}
| CC0{{pad|1em}}
| PPDL
| CC0
|-
| colspan="4" style="font-size: smaller" | 1. These licenses are compatible with the GPL. This means that projects licensed under GPLv2 or GPLv3 can include code distributed with any of the indicated permissive licenses.<ref>[https://www.gnu.org/licenses/license-list.en.html GNU page on licenses.]</ref>
|}

The following sections elaborate on both options for each type of work: code, data, documentation, and other.

== Code ==

The following minimal questions can give a guideline on whether one should choose a copyleft or a permissive license for a project. The Wikipedia article on [https://en.wikipedia.org/wiki/Free_software_license Free software licenses] gives an in-depth overview on both types and their properties.

*Are you ok with your code becoming part of a '''closed-source''' commercial software product?
**No: GPL
**Yes: permissive licenses (MIT/BSD/Apache)

*Do you want to '''force '''users to publish their improvements to your software, or to software they develop based on your software, under the same licence?
**No: permissive licenses (MIT/BSD/Apache). This makes the code more broadly usable, but also allows people to take the code without sharing their improvements.
**Yes: GPL. This ensures that any future changes and improvements to the code remain free and open

=== Copyleft licenses ===

Developers who use a GPL license must make the source code available if they share or sell an application built upon it. In this case, the source code must also contain any changes the developers may have made. If GPL code is used but not shared or sold, the code need not be published and any improvements may remain private. This has the important consequence that software written under such a license cannot be included in "non-free" software. The GPL family of licenses comprise:

*GPL: the basic GPL license
*LGPL: Lesser GPL: permits non-free software to link to the LGPL-licensed software, which the GPL does not
*AGPL: Affero GNU GPL: this license closes a loophole in the GPL that permits somebody to operate a web application that uses GPL code, without making the code available to users

More information, geared towards the use of copyleft licenses for code, can be found in the article [https://www.gnu.org/licenses/license-recommendations How to choose a license for your own work] on [https://www.gnu.org/ gnu.org].

=== Permissive licenses ===

The article [https://www.freebsd.org/doc/en/articles/bsdl-gpl/article.html Why you should use a BSD style license for your Open Source Project] on [https://www.freebsd.org/ freebsd.org] is recommended. The permissive licenses allow code to be re-used without restrictions, including the possibility of building commercial software whereby the new code is not made public.

The site [http://choosealicense.com/ choosealicense.com] has a great three-column summary of the differences between the major open source licenses. Summarizing their explanations (with links to their license description pages):

*The [http://choosealicense.com/licenses/mit MIT] license is a simple permissive license
*The [http://choosealicense.com/licenses/apache-2.0/ Apache License] adds an additional term explicitly granting the patent rights of code contributors to the users of such code
*The [http://choosealicense.com/licenses/bsd-2-clause/ BSD] license, or its newer even shorter successor [http://choosealicense.com/licenses/isc/ ISC] is virtually identical to MIT, but more succinctly worded

One important aspect of all these licenses is the liability clause. This clause prohibits any code user from holding the code producers liable for damages arising from the use of the software code.

== Data ==

Data in this context includes organized databases holding datasets. Special copyright rules may apply to databases, which, under European law, are protected in their own right, irrespective of the status of the data they contain.

The go-to solution for data licenses comes from the [http://opendatacommons.org/ Open Data Commons] that have created the following three licenses, and a nice [http://opendatacommons.org/guide/ 2-minute guide] on the how and why of data licensing:

*[http://opendatacommons.org/licenses/odbl/ Open Data Commons Open Database License (ODbL)]: this license is used by OpenStretMap
*The [http://opendatacommons.org/licenses/by/1.0/ Open Data Attribution License (ODC-BY)] (analogous to CC BY) differs from the ODbL mainly due to a missing copyleft clause. ODC-BY basically requires that the contributors to the original database be listed.
*[http://opendatacommons.org/licenses/pddl/summary/ Public Domain Dedication and License (PDDL)] is even more permissive and does not require attribution or force derived works to adopt specific license conditions
*Only version{{nbsp}}4.0 [http://creativecommons.org/ Creative Commons] licenses should be used for data. This version has improved provisions for datasets and databases. Please refer to the section [[#Other|Other]] for their properties. See also the related question [http://opendata.stackexchange.com/questions/5995/are-creative-commons-licenses-suitable-for-data are CC licenses suitable for data?] on StackExchange.

In December 2017, individuals in the openmod community made a written submission on the re-use of public sector information in Europe.<ref name="morrison-etal-2017">
{{cite book
| last1 = Morrison | first1 = Robbie
| last2 = Brown | first2 = Tom
| last3 = De Felice | first3 = Matteo
| title = Submission on the re-use of public sector information: with an emphasis on energy system datasets — Release 09
| date = 10 December 2017
| location = Berlin, Germany
| url = https://forum.openmod-initiative.org/uploads/default/original/1X/d659fda325438884e6e78b372772ed7069633f97.pdf
| access-date = 2017-12-13
}} Creative Commons CC BY 4.0 license. {{open access}}
</ref>
The openmod forum ans has a dedicated [https://forum.openmod-initiative.org/t/re-use-of-public-sector-information/476].

== Documentation ==

If you would like your model documentation to be used verbatim on Wikipedia, you need to use one of these Creative Commons licenses:

*CC BY, all versions and ports up to and including 4.0
*CC BY-SA, versions 1.0, 2.0, 2.5, and 3.0

However CC BY-SA 4.0 is '''not''' compatible with Wikipedia. For more information, please see the [https://en.wikipedia.org/wiki/Wikipedia:FAQ/Copyright#Can_I_add_something_to_Wikipedia_that_I_got_from_somewhere_else.3F Wikipedia compatibility table]. The Wikimedia Foundation ran a community discussion on an upgrade to a CC BY-SA 4.0 license in November 2016, but the outcome has not been announced. If this exercise is successful then the compatibility problem just noted will disappear.

The [https://www.gnu.org/copyleft/fdl.html GNU Free Documentation License 1.3] (FDLv1.3) is the GNU alternative to a Creative Commons license.

[http://www.gnu.org GNU] also recommends '''not''' using the following licenses for free documentation:

*CC-NC (non-commercial) license of any form
*CC-ND (no derivatives) license of any form

For more information, please see [https://www.gnu.org/licenses/license-list.html#NonFreeDocumentationLicenses GNU page on nonfree documentation licenses].

== Other ==

The Creative Commons family of licenses are probably the most widely known. As of December 2016, the fourth version of these licenses is current. First, the two "free licenses" are presented:

*[http://creativecommons.org/licenses/by/4.0/ CC BY] (short for attributions, the "by" refers to authoring): requires that the source be named when sharing the original work or any derived work
*[http://creativecommons.org/licenses/by-sa/4.0/ CC BY-SA]: similar to the GPL in that it requires any derived works to be published under a "compatible" (easiest is the same) license. It is the license used by Wikipedia. Version 4.0 is fully compatible with the GPLv3 license.

Only the two previous CC licenses qualify as "free" licenses, as they do not restrict what a user may do with the licensed work. Two "non-free" license components are presented:

*CC NC: the non-commercial option allows one to prohibit any "commercial" usage of their work. However, it is notoriously hard to define ''exactly what constitutes'' a commercial activity. This issue is explained in detail in the brochure [http://openglam.org/files/2013/01/iRights_CC-NC_Guide_English.pdf Consequences, risks and side-effects of the license module "non-commercial use only"]. In any case, the two licenses which result from this component are [http://creativecommons.org/licenses/by-nc/4.0/ CC BY-NC] and, with the share-alike option, [http://creativecommons.org/licenses/by-nc-sa/4.0/ CC BY-NC-SA].
*CC ND (short for no derivitives): this option is available If you do not want changes or improvements to your work to be shared or redistributed. Its main use is by musicians who want to share their music with listeners, but do not wish to allow remixes or cover versions. The resulting licenses are [http://creativecommons.org/licenses/by-nd/4.0/ CC BY-ND] or, by combining it with the NC option, [http://creativecommons.org/licenses/by-nc-nd/4.0/ CC BY-NC-ND].

For inspiration, the Creative Commons homepage lists [https://creativecommons.org/examples a host of example projects licensed under all different licenses] to give an impression of the contexts that triggered various individuals to select a particular license.

= FAQ =

== Why is it a bad idea to use Creative Commons licenses for code? ==

The long answer is given in [http://opensource.stackexchange.com/questions/1717/why-is-cc-by-sa-discouraged-for-code Why is CC BY-SA discouraged for code?] on StackExchange.

The short answer is that the CC licenses are written for creative works (music, film, texts), not software code. Therefore, a CC license leaves many important details (what consitutes a "derived" work, is linking allowed, what about patents?) unspecified. The conclusion: don not use CC licenses for code.

== At what point should I choose or change a license? ==

You should determine and add a licence '''prior''' to the '''first''' release of your project. Ideally that would include “small” releases within your research institute or organization.

Can I change the licence? The important thing is that, when you receive a copy of the source code with a particular license, you have been granted that license. So as long as the license does not have a revocation clause, it is permanent. See the related question on StackOverflow: [http://stackoverflow.com/questions/3498237/what-happens-when-an-open-source-project-changes-its-license What happens when an open source project changes its license?]

A license can be changed. You can swap the licence for the next version or release if '''all''' contributors (meaning copyright holders) agree or have previously agreed to the possibility of doing so, usually via a contributor agreement. Search for "contributor (license/assignment) agreement" online, for pointers on how to enable this up front. See also the [http://opensource.org/faq#contributor-agreements FAQ on contributor agreements on opensource.org], [http://wiki.civiccommons.org/Contributor_Agreements Civic Commons article on contributor agreements].

== What does sublicensing mean? ==

Sublicensing allows somebody to relicense all or part of the licensed software, for example, to use BSD-licensed code in a closed-source commercial application.

"The basic idea ... is that if this is granted, a licensee can become a licensor of some of the rights of the grant they received regardless of any other claim they may have to copyright control over what they distribute." Source: [https://programmers.stackexchange.com/questions/189633/what-sublicense-actually-means https://programmers.stackexchange.com/questions/189633/what-sublicense-actually-means]

= Seeking advice =

Questions related to the selection and use of open source licenses can be posted to our [https://groups.google.com/d/forum/openmod-initiative mailing list]. But remember that the list is public and its traffic is indexed by search engines.

= Further reading =

*The Software Sustainability Institute (UK) provides [http://www.software.ac.uk/resources/guides/adopting-open-source-licence information and answers to frequently asked questions]. The questions dealt with include:
**“Why is an open-source licence useful?”
**“How can I tell the difference between open-source licences?”
**“What happens if I am using someone else's code in my software?”
**“What do I need to do before applying my choice of licence?”

*This Nature commentary article dispels common excuses for not publishing scientific code and argues that code should be published more frequently:

<blockquote>
{{cite journal
| last1 = Barnes | first1 = Nick
| title = Publish your computer code: it is good enough
| date = 13 October 2010
| journal = Nature News
| volume = 467
| issue = 7317
| pages = 753–753
| doi = 10.1038/467753a
| issn = 0028-0836
| url = http://www.nature.com/news/2010/101013/pdf/467753a.pdf
| access-date = 2016-12-10
}}
</blockquote>

*The following paper contains a good overview of different licenses and some of the questions one might ask when deciding on a license, from the point of view of a programming scientist:

<blockquote>
{{cite journal
| last1 = Morin | first1 = Andrew
| last2 = Urban | first2 = Jennifer
| last3 = Sliz | first3 = Piotr
| title = A quick guide to software licensing for the scientist-programmer
| date = 27 July 2012
| journal = PLOS Computational Biology
| volume = 8
| issue = 7
| pages = e1002598
| doi = 10.1371/journal.pcbi.1002598
| issn = 1553-7358
| url = http://journals.plos.org/ploscompbiol/article/file?id=10.1371/journal.pcbi.1002598&type=printable
| access-date = 2016-12-10
}} {{open access}}
</blockquote>

*[https://tldrlegal.com/ TLDRlegal.com] summarizes a wide range of popular licenses in an easy to read format
*Help for choosing a license for software from GitHub at [http://choosealicense.com/ ChooseALicense.com]
*[http://opensource.org Opensource.org]: lots of helpful information especially under the FAQ (provides, for instance, an aswer to “Why not use CC for code?”)
**Open Source Licenses: wallow in the abundance of licenses out there, then come back to the FAQ and read “Which Open Source license should I choose to release my software under?”

*[https://www.wbs-law.de/it-recht/open-source-lizenzen-ein-uberblick-35752/ An article (in German) with overview of different open licenses and problems]
*[http://www.ifross.org/lizenz-center/ A detailed list (in German) of licenses]
*The Journal of Open Research Software (JORS) is a journal dedicated to publishing Open Source research software. It is therefore a useful outlet to publish software source code in, and then be able to reference it from other articles: [http://openresearchsoftware.metajnl.com/ http://openresearchsoftware.metajnl.com/]

= References =

<references/>