g.citation - GRASS GIS manual

NAME

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

KEYWORDS

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; 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
- Formats
NOTES
EXAMPLES
KNOWN ISSUES
SEE ALSO
AUTHORS

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

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.

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)