[GRASS-user] reference for publications?

James_Maas_MED · June 7, 2016, 1:50pm

Is there a specific reference that you would like us to use when citing GRASS in publications? I can't find it on the website.

Thanks,

Jim

--
Dr. Jim Maas
Norwich Medical School

Ahmadou_Dicko · June 7, 2016, 2:39pm

Hi,

You have a dedicated page on the wiki: https://grasswiki.osgeo.org/wiki/GRASS_Citation_Repository

I would personally cite:

Neteler, M., Bowman, M.H., Landa, M., Metz, M. (2012) “GRASS GIS: A multi-purpose open source GIS.” Environmental Modelling & Software. Vol 31, pp. 124–130

@article{neteler2012grass,
  title={{GRASS GIS: a multi-purpose Open Source GIS}},
  author={Neteler, M. and Bowman, M.H. and Landa, M. and Metz, M.},
  journal={Environmental Modelling 364e38c14262ed9301badf0b5fe3cd03 Software},
  year={2012},
  volume = {31},
  pages = {124–130},
  publisher={Elsevier},
  doi = "10.1016/j.envsoft.2011.11.014"
}

Cheers,

···

On Tue, Jun 7, 2016 at 3:50 PM, Jim Maas <j.maas@uea.ac.uk> wrote:

Is there a specific reference that you would like us to use when citing GRASS in publications? I can’t find it on the website.

Thanks,

Jim

–
Dr. Jim Maas
Norwich Medical School

grass-user mailing list
grass-user@lists.osgeo.org
http://lists.osgeo.org/mailman/listinfo/grass-user

–

Ahmadou H. DICKO, PhD
Data hacker and climate change economist
Post-doctoral researcher
CIRAD - UMR15 CIRAD/INRA Control of exotic and emerging diseases
email : ahmadou-hamady.dicko@cirad.fr
twitter : @dickoah
github : github/dickoa
portable: +33 7 68 16 11 58

neteler · June 7, 2016, 2:44pm

On Jun 7, 2016 4:06 PM, “Jim Maas” <j.maas@uea.ac.uk> wrote:

Is there a specific reference that you would like us to use when citing GRASS in publications? I can’t find it on the website.

Jim,

yes, there is but it is apparently too much hidden on the web site.
I’ll send it to you but where did you expect it and not find it? Just to improve it on this occasion.

Best
Markus

veroandreo · June 7, 2016, 2:46pm

Hi Jim,

You can also cite the software as in the next link:

https://grass.osgeo.org/home/about-us/
→ Citing GRASS GIS software

Best,
Vero

···

2016-06-07 11:44 GMT-03:00 Markus Neteler <neteler@osgeo.org>:

On Jun 7, 2016 4:06 PM, “Jim Maas” <j.maas@uea.ac.uk> wrote:

Is there a specific reference that you would like us to use when citing GRASS in publications? I can’t find it on the website.

Jim,

yes, there is but it is apparently too much hidden on the web site.
I’ll send it to you but where did you expect it and not find it? Just to improve it on this occasion.

Best
Markus

grass-user mailing list
grass-user@lists.osgeo.org
http://lists.osgeo.org/mailman/listinfo/grass-user

James_Maas_MED · June 7, 2016, 2:47pm

Thanks Markus,

Under documentation .... with a link to it from the main page?

Best,

Jim

On 07/06/16 15:44, Markus Neteler wrote:

On Jun 7, 2016 4:06 PM, "Jim Maas" <j.maas@uea.ac.uk <mailto:j.maas@uea.ac.uk>> wrote:
>
> Is there a specific reference that you would like us to use when citing GRASS in publications? I can't find it on the website.

Jim,

yes, there is but it is apparently too much hidden on the web site.
I'll send it to you but where did you expect it and not find it? Just to improve it on this occasion.

Best
Markus

--
Dr. Jim Maas
Norwich Medical School
University of East Anglia

veroandreo · June 7, 2016, 2:51pm

Hi Markus,

2016-06-07 11:46 GMT-03:00 Veronica Andreo <veroandreo@gmail.com>:

Hi Jim,

You can also cite the software as in the next link:

https://grass.osgeo.org/home/about-us/
--> Citing GRASS GIS software

Jim,

yes, there is but it is apparently too much hidden on the web site.
I'll send it to you but where did you expect it and not find it? Just to
improve it on this occasion.

what about adding the same citation we find in the website to g.version?

would that be possible? Something similar as citation() in R.

cheers,
Vero

neteler · June 7, 2016, 3:22pm

On Jun 7, 2016 4:51 PM, “Veronica Andreo” <veroandreo@gmail.com> wrote:

Hi Markus,

2016-06-07 11:46 GMT-03:00 Veronica Andreo <veroandreo@gmail.com>:

Hi Jim,

You can also cite the software as in the next link:

https://grass.osgeo.org/home/about-us/
→ Citing GRASS GIS software

… still it is often not found. Let’s see where Jim was expecting it.

yes, there is but it is apparently too much hidden on the web site.
I’ll send it to you but where did you expect it and not find it? Just to improve it on this occasion.

what about adding the same citation we find in the website to g.version? would that be possible? Something similar as citation() in R.

Definitely yes. AFAIK there is an open ticket for that but due to traveling I cannot check at time.

cheers,
Markus

veroandreo · June 7, 2016, 3:39pm

Hi again

···

[…]

Definitely yes. AFAIK there is an open ticket for that but due to traveling I cannot check at time.

Here: https://trac.osgeo.org/grass/ticket/947
rather old ticket

cheers,
Vero

Carlos_Guano_Grohman · June 7, 2016, 4:25pm

A bit OT but…

The “GRASS in the Wild” page (https://grasswiki.osgeo.org/wiki/GRASS_in_the_wild) has links to Zotero and Google Scholar, plus a list of my publications (I guess the idea of people adding their publications in the wiki didn’t worked as expected). I guess we could remove the list of my articles and leave only the links to Zotero and GS (they’re there as well).

Carlos

···

On Tue, Jun 7, 2016 at 11:47 AM, Jim Maas <j.maas@uea.ac.uk> wrote:

Thanks Markus,

Under documentation … with a link to it from the main page?

Best,

Jim

On 07/06/16 15:44, Markus Neteler wrote:

On Jun 7, 2016 4:06 PM, “Jim Maas” <j.maas@uea.ac.uk mailto:[j.maas@uea.ac.uk](mailto:j.maas@uea.ac.uk)> wrote:

Is there a specific reference that you would like us to use when citing GRASS in publications? I can’t find it on the website.

Jim,

yes, there is but it is apparently too much hidden on the web site.
I’ll send it to you but where did you expect it and not find it? Just to improve it on this occasion.

Best
Markus

–
Dr. Jim Maas
Norwich Medical School
University of East Anglia

grass-user mailing list
grass-user@lists.osgeo.org
http://lists.osgeo.org/mailman/listinfo/grass-user

–

Prof. Carlos Henrique Grohmann
Institute of Energy and Environment - Univ. of São Paulo, Brazil

Digital Terrain Analysis | GIS | Remote Sensing -

http://carlosgrohmann.com
http://orcid.org/0000-0001-5073-5572

Can’t stop the signal.

neteler · June 8, 2016, 9:02pm

Jim,

On Tue, Jun 7, 2016 at 4:47 PM, Jim Maas <j.maas@uea.ac.uk> wrote:

Thanks Markus,

Under documentation .... with a link to it from the main page?

as a start I have added it here:

https://grass.osgeo.org/documentation/
--> Citing GRASS GIS

Hope this improves the visibility of this important issue: please cite
GRASS GIS!

Markus

neteler · June 9, 2016, 12:52pm

On Tue, Jun 7, 2016 at 5:39 PM, Veronica Andreo <veroandreo@gmail.com> wrote:

Hi again

[..]

Definitely yes. AFAIK there is an open ticket for that but due to
traveling I cannot check at time.

Here: https://trac.osgeo.org/grass/ticket/947
rather old ticket

Yep. Now I worked on that:

g.version -x

gives you citation options similar to R's citation() function.

Please check if the text is ok.

cheers,
Markus

veroandreo · June 9, 2016, 2:07pm

Hello Markus,

···

[…]

Definitely yes. AFAIK there is an open ticket for that but due to
traveling I cannot check at time.

Here: https://trac.osgeo.org/grass/ticket/947
rather old ticket

Yep. Now I worked on that:

g.version -x

gives you citation options similar to R’s citation() function.

Cool! Thanks!

Please check if the text is ok.

The text seems fine to me. Just some ideas/questions:

What about adding something like “See citation options with: g.version -x” below “See the licence terms with: g.version -c” in the welcome screen in the terminal?
And also an example of how to cite an add-on?
Why YEAR isn’t picked up automatically from the version? Would that be a mess? Or is it on purpose just to remain generic?

Cheers,
Vero

neteler · June 9, 2016, 2:43pm

On Thu, Jun 9, 2016 at 4:07 PM, Veronica Andreo <veroandreo@gmail.com> wrote:
…

The text seems fine to me. Just some ideas/questions:

What about adding something like “See citation options with: g.version -x”
below “See the licence terms with: g.version -c” in the welcome screen in
the terminal?

Yes. done in r68658, it now looks like this:

…
Welcome to GRASS GIS 7.3.svn
GRASS GIS homepage: http://grass.osgeo.org
This version running through: Bash Shell (/bin/bash)
Help is available with the command: g.manual -i
See the licence terms with: g.version -c
See citation options with: g.version -x
Start the GUI with: g.gui wxpython
When ready to quit enter: exit

GRASS 7.3.svn (nc_spm_08_grass7):~ >

I have also homogenised the flag style

g.version
…
Flags:
-c Print also the copyright message
-x Print also the citation options <<— new
-b Print also the build information
…

And also an example of how to cite an add-on?

Please write one On the other hand I omitted it to not highlight a single one.

Why YEAR isn’t picked up automatically from the version? Would that be a
mess? Or is it on purpose just to remain generic?

Mess - the CITATION file which is read by g.version would need to be parsed for that.

Some regex/string magic would do that but I am not able to implement string replacement stuff.

Anyone?

Best,

Markus

–
Markus Neteler
http://www.mundialis.de - free data with free software
http://grass.osgeo.org
http://courses.neteler.org/blog

wenzeslaus · June 10, 2016, 2:27pm

On Thu, Jun 9, 2016 at 10:43 AM, Markus Neteler <neteler@osgeo.org> wrote:

> - And also an example of how to cite an add-on?

Please write one On the other hand I omitted it to not highlight a
single one.

I was actually recently thinking about a need to have citation for every
module. Perhaps this was already discussed. Many modules (in core or in
addons) have associated paper. Now it is often in REFERENCES (if at all)
but it is not clear that this is the way to cite it because there are also
the actual references used to write the module. A special section CITE
AS/CITATION would be more explicit. The content could be generated using
`r.slope.aspect --citation` (or `r.slope.aspect --cite-as`) and the
information could be stored in the module together with module description.
Alternatively, the section can be just hand written as the REFERENCES
section but the flag might give us more options related to defaults or
alternative citations.

Should we have a ticket to track this?

neteler · June 10, 2016, 3:56pm

On Fri, Jun 10, 2016 at 4:27 PM, Vaclav Petras <wenzeslaus@gmail.com> wrote:

I was actually recently thinking about a need to have citation for every
module. Perhaps this was already discussed.

Not too much but I think the same. Each module needs to come with its
own "How to cite" section which could be autogenerated if not already
present in the HTML page.

Many modules (in core or in
addons) have associated paper. Now it is often in REFERENCES (if at all) but
it is not clear that this is the way to cite it because there are also the
actual references used to write the module.

Agreed.

A special section CITE
AS/CITATION would be more explicit. The content could be generated using
`r.slope.aspect --citation` (or `r.slope.aspect --cite-as`) and the
information could be stored in the module together with module description.
Alternatively, the section can be just hand written as the REFERENCES
section but the flag might give us more options related to defaults or
alternative citations.

I suggest to manually add the respective citation only where
appropriate, otherwise (in most cases) autogenerate it. Where it
doesn't fit then, it could be manually overridden.

Should we have a ticket to track this?

Yes.

Markus