<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
</head>
<body style="word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space;" class="">
Markus and Co.
<div class=""><br class="">
</div>
<div class="">This is something CoMSES Net (Network for Computational Modeling in Social and Ecological Sciences:
<a href="http://www.comses.net" class="">http://www.comses.net</a>) has been working with for some years now. We maintain a software code library, where researchers can publish model code. We also provide for the option of code peer review, which can happen
when code is submitted to the library for review along with a paper sent to a journal, or independent of any paper review. Code that has passed peer review is currently assigned a “handle” from
<a href="http://handle.net" class="">handle.net</a>. <a href="http://handle.net" class="">
Handle.net</a> is the organization that oversees the digital identifier ecosystem. DOI’s are commercial instances and handles are open source instances, but both are ultimately under the purview of
<a href="http://handle.net" class="">handle.net</a>. With a new grant from NSF, CoMSES Net is now part of a new national data infrastructure network in the US. One of our plans is to transition from handles to DOI’s because these are more widely recognized.</div>
<div class=""><br class="">
</div>
<div class="">Given all this, we’ve had to think quite a bit about how to ‘publish’ model code and assign identifiers. As Vaclav points out there are significant issues with versioning. What happens with a new version? We’ve adopted a conceptual position that
we are not a versioning repository primarily, but a place where authors can publish ‘finished’ code used in a research project or product. We are trying to treat this like a library and journal environment in that sense. We allow for minor revisions to correct
errors (including as a response to reviews). But if a new product (e.g., a research paper) uses a new version of model code, we consider that a new digital object published, which could get a new handle/DOI distinct from a version of a model used for an earlier
product. This remains something that is complicated to implement in practice. But the concept involves the reason for giving out the handle/DOI in the first place.</div>
<div class=""><br class="">
</div>
<div class="">Currently, only about 10% of published model based science makes code available for review or reuse. We think it is increasingly important that researchers share the code that is an important component to scientific practice in the same way they
share research protocols and results—and are increasingly encouraged to share data. But sharing code takes effort, and even researchers with the best intentions may find it difficult to find the time or energy to make code available. So we are trying to create
incentives that will have some value in the academic/research world, including citable products. All models published in the CoMSES Net library have automatically generated citations. Those that have passed peer review, verifying some degree of software quality,
are also given permanent identifiers (handles/DOIs), with the idea that researchers can put them on their CVs where they at least have the possibility of gaining them some recognition for the work carried out. That is, we consider a DOI as an incentive for
sharing code and a bit of a lever to get others to cite that code if they use it. </div>
<div class=""><br class="">
</div>
<div class="">We are still trying to work out how best to handle improvements (bug fixes) to a model vs. new models. We are moving our library to a Git environment, but are still working out how to implement our concept of “published” snapshots of code in a
library/journal in versions and releases in Git. We do have a roadmap and are working on it, but we don’t yet have a solution in place. </div>
<div class=""><br class="">
</div>
<div class="">Where is all this leading? We need to ask what is the value to assigning DOIs to GRASS code, how might they benefit GRASS developers, and how might they be used by GRASS software users? I don’t see that they provide the kind of incentives that
CoMSES Net is envisioning for computational model developers. Most DOIs are assigned to finished products as digital objects. From that perspective, GRASS could get a DOI, but not its component modules. But what about each version of GRASS? GRASS has formal
releases, but not its components. Some code is in the released code base and other is in addons. There is ongoing development in the SVN. GRASS is a digital object of course, as are its component code modules, but it is a dynamic, living one and not a static
one. Perhaps there are other benefits to working out the complications of where and when to assign DOIs in the GRASS ecosystem. But it will be good to start with a discussion of why and for whom we would do it. </div>
<div class=""><br class="">
</div>
<div class="">(I’m copying Allen Lee from the CoMSES Net leadership team as he has thought a lot about this and might have other things to add.)</div>
<div class=""><br class="">
</div>
<div class="">Cheers</div>
<div class="">Michael</div>
<div class=""><br class="">
<div class="">
<div style="letter-spacing: normal; orphans: auto; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; widows: auto; word-spacing: 0px; -webkit-text-stroke-width: 0px; word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space;" class="">
<div style="letter-spacing: normal; orphans: auto; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; widows: auto; word-spacing: 0px; -webkit-text-stroke-width: 0px; word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space;" class="">
<div style="orphans: 2; text-align: -webkit-auto; text-indent: 0px; widows: 2; word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space;" class="">
<span class="Apple-style-span" style="border-collapse: separate; border-spacing: 0px;">
<div style="word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space;" class="">
<span class="Apple-style-span" style="border-collapse: separate; orphans: 2; text-indent: 0px; widows: 2; border-spacing: 0px;">
<div style="word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space;" class="">
<span class="Apple-style-span" style="border-collapse: separate; orphans: 2; text-indent: 0px; widows: 2; border-spacing: 0px;">
<div style="word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space;" class="">
<span class="Apple-style-span" style="border-collapse: separate; orphans: 2; text-indent: 0px; widows: 2; border-spacing: 0px;">
<div style="word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space;" class="">
<span class="Apple-style-span" style="border-collapse: separate; orphans: 2; text-indent: 0px; widows: 2; border-spacing: 0px;">
<div style="word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space;" class="">
<span class="Apple-style-span" style="border-collapse: separate; orphans: 2; text-indent: 0px; widows: 2; border-spacing: 0px;">
<div style="word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space;" class="">
<span class="Apple-style-span" style="border-collapse: separate; orphans: 2; text-indent: 0px; widows: 2; border-spacing: 0px;">
<div style="word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space;" class="">
<span class="Apple-style-span" style="border-collapse: separate; orphans: 2; text-indent: 0px; widows: 2; border-spacing: 0px;">
<div style="word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space;" class="">
<div class="">
<div style="color: rgb(0, 0, 0); font-family: Helvetica; font-size: 12px; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; line-height: normal; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-decorations-in-effect: none; -webkit-text-stroke-width: 0px;" class="">
____________________</div>
<div style="font-variant: normal; letter-spacing: normal; line-height: normal; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-stroke-width: 0px;" class="">
<font face="Helvetica" size="3" class="">C. Michael Barton</font></div>
<div style="font-variant: normal; letter-spacing: normal; line-height: normal; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-stroke-width: 0px;" class="">
<font face="Helvetica" size="3" class="">Director, Center for Social Dynamics & Complexity </font></div>
<div style="font-variant: normal; letter-spacing: normal; line-height: normal; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-stroke-width: 0px;" class="">
<font face="Helvetica" size="3" class="">Professor of Anthropology, School of Human Evolution & Social Change</font></div>
<div class=""><font face="Helvetica" size="3" class="">Head, Graduate Faculty in Complex Adaptive Systems Science</font></div>
<div style="font-variant: normal; letter-spacing: normal; line-height: normal; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-stroke-width: 0px;" class="">
<font face="Helvetica" size="3" class="">Arizona State University</font></div>
<div style="color: rgb(0, 0, 0); font-family: Helvetica; font-size: 12px; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; line-height: normal; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-decorations-in-effect: none; -webkit-text-stroke-width: 0px;" class="">
<br class="">
</div>
<font face="Helvetica" size="3" class=""><font class="">voice: </font><font class="">480-965-6262 (SHESC), 480-965-8130/727-9746 (CSDC)</font><br class="">
<font class="">fax: 480-965-7671 (SHESC), 480-727-0709 (CSDC)</font><br class="">
</font>
<div style="font-variant: normal; letter-spacing: normal; line-height: normal; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-stroke-width: 0px;" class="">
<font face="Helvetica" size="3" class="">www: <a href="http://www.public.asu.edu/~cmbarton" class="">
http://www.public.asu.edu/~cmbarton</a>, <a href="http://csdc.asu.edu" class="">http://csdc.asu.edu</a></font></div>
<br class="">
</div>
<br class="">
</div>
</span><br class="Apple-interchange-newline">
</div>
</span><br class="Apple-interchange-newline">
</div>
</span><br class="Apple-interchange-newline">
</div>
</span><br class="Apple-interchange-newline">
</div>
</span><br class="Apple-interchange-newline">
</div>
</span><br class="Apple-interchange-newline">
</div>
</span><br class="Apple-interchange-newline">
</div>
</span><br class="Apple-interchange-newline">
</div>
<br class="Apple-interchange-newline">
</div>
<br class="Apple-interchange-newline">
</div>
<br class="Apple-interchange-newline">
<br class="Apple-interchange-newline">
</div>
<br class="">
<div>
<blockquote type="cite" class="">
<div class="">On Nov 17, 2016, at 8:19 AM, Vaclav Petras <<a href="mailto:wenzeslaus@gmail.com" class="">wenzeslaus@gmail.com</a>> wrote:</div>
<br class="Apple-interchange-newline">
<div class="">
<div dir="ltr" class="">
<div class="gmail_extra"><br class="">
<div class="gmail_quote">On Thu, Nov 17, 2016 at 6:04 AM, Markus Neteler <span dir="ltr" class="">
<<a target="_blank" href="mailto:neteler@osgeo.org" class="">neteler@osgeo.org</a>></span> wrote:<br class="">
<blockquote style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex" class="gmail_quote">
<div class="gmail-a3s gmail-aXjCH gmail-m15871f5882b84acc" id="gmail-:l7">The question for me is: what do we need to do for that? Since a DOI<br class="">
refers to a state in time, GRASS GIS module DOIs might be attached to<br class="">
releases since they evolve over time. How would that practically work?</div>
</blockquote>
</div>
<br class="">
</div>
<div class="gmail_extra"></div>
<div class="gmail_extra">There are some services which can give you DOI for SW. From what I understood, DOI for a specific version in version control is often encourage, but that wouldn't work if you want to add the DOI back to the source or documentation because
you just advanced the version in version control. Associating DOI with release makes more sense but than what to do with addons which (at least usually) don't have releases? Also some modules don't change between releases of GRASS GIS. Does this mean same
DOI or different one?<br class="">
<br class="">
</div>
<div class="gmail_extra">Also, one module would accumulate different DOIs over time. Can we than accumulate number of citations for one module?<br class="">
<br class="">
</div>
<div class="gmail_extra">Another idea (for core modules) is assigning DOI to GRASS GIS release and then use DOI with hash (...doi.../123456#r.slope.aspect) similarly to how the TBI AV-Portal references an exact time in a video. I hope Peter has a better idea
if this makes at least some sense or it is completely off.<br class="">
</div>
<div class="gmail_extra"><br class="">
</div>
<div class="gmail_extra">Anyway, my current vision, partially related and partially unrelated, is to have a `Cite as` section in the manual unique for each module which would be generated from info stored in the parser information. Using parser is more flexible
than putting it to the HTML directly and `Cite as` is more clear than including the info into `References` section. The info for `Cite as` can be DOI for the module or a paper associated with the module.<br class="">
</div>
</div>
_______________________________________________<br class="">
grass-psc mailing list<br class="">
<a href="mailto:grass-psc@lists.osgeo.org" class="">grass-psc@lists.osgeo.org</a><br class="">
https://urldefense.proofpoint.com/v2/url?u=http-3A__lists.osgeo.org_mailman_listinfo_grass-2Dpsc&d=CwIGaQ&c=AGbYxfJbXK67KfXyGqyv2Ejiz41FqQuZFk4A-1IxfAU&r=vxOW6PLS28MPea_dWUwPfRf71TAIziRDuFqWJimQN1I&m=W18Hd2l-RIPN2JNtbqtFwgXUKafPbozpYTYDFCpBIgs&s=Be4xx23ZLFo_blFJZx5ODhKZm64o-W8aWH7_pedbP5A&e=
</div>
</blockquote>
</div>
<br class="">
</div>
</body>
</html>