Table of contents

NAME
g.citation - Provide scientific citation for GRASS modules and add-ons.

KEYWORDS
general, metadata, citation

SYNOPSIS
g.citation
g.citation --help
g.citation [-ads] [module=string] format=string [style=string]
[vertical_separator=string] [output=name] [--help] [--verbose] [--quiet] [--ui]

Flags:

-a
Provide citations for all modules
-d
Add GRASS GIS as dependency to citation
Add GRASS GIS as dependency, reference, or additional citation to the
citation of a module if applicable for the format (currently only CFF)
-s
Skip errors, provide warning only
--help
Print usage summary
--verbose
Verbose module output
--quiet
Quiet module output
--ui
Force launching GUI dialog

Parameters:

module=string
GRASS GIS module to be cited
format=string [required]
Citation format or style
Options: bibtex, cff, json, pretty-json, csl-json, citeproc, chicago-footnote, dict,
plain
Default: bibtex
bibtex: BibTeX
cff: Citation File Format
json: JSON
/
 pretty-json: Pretty printed JSON
csl-json: Citation Style Language JSON (citeproc JSON) format Table of contents
citeproc: Use the citeproc-py library to create the citation (CSL)
chicago-footnote: Chicago style for footnotes
dict: Pretty printed Python dictionary
plain: Plain text
style=string
Citation style for the citeproc formatter (CSL)
Default: harvard1
vertical_separator=string
Separator of individual citation records
Inserted before each item
output=name
Path of the output file

DESCRIPTION
g.citation - creates citation or metadata based on documentation of a given module.

Formats

Citation File Format

Citation File Format (CFF) is a YAML based format for citations, specifically
CITATION files to be included with software or code as CITATION.cff.

JSON

Currently, the keys and the overall structure are subject to change, but the plan is to
stabilize it or to provide existing metadata format in JSON. Pretty-printed version is
good, e.g., for saving into files, while the other, compact version is good for further
processing.

Pretty printed Python dictionary

This format is essentially a dump of the internal data structure holding the citation
entry. It should not be used in scripts, i.e. further parsed, for that there are other
formats such as JSON. When this is advantageous is exploring what information the
module was able to acquire for the citation.

NOTES
Don't use the format=dict for further processing. It is meant for exploration of
what information the module acquired.
The structure of the JSON output is yet not guaranteed.

EXAMPLES
g.citation module=v.select format=plain

g.citation f=pretty-json -a -s | grep '"name": ' | sort | uniq

g.citation -s format=citeproc vsep="< p>" -a > all.html

/
KNOWN ISSUES Table of contents

More output formats or styles are needed. The following formats were
suggested so far: csl,datacite,dublincore,json-ld,narcxml
The structure of the JSON output is not guaranteed. It reflects the internal
structure (only the empty entries are removed).
Version and date in CFF output are incomplete.

SEE ALSO
g.search.module

AUTHORS
Vaclav Petras, NCSU GeoForAll Lab (ORCID: 0000-0001-5566-9236)
Peter Loewe, NCSU GeoForAll Lab (ORCID: 0000-0003-2257-0517)
Markus Neteler, NCSU GeoForAll Lab (ORCID: 0000-0003-1916-1966)

SOURCE CODE
Available at: g.citation source code (history)

Main index | General index | Topics index | Keywords index | Graphical index | Full
index

© 2003-2020 GRASS Development Team, GRASS GIS 7.8.4dev Reference Manual