Citations#
- class pybamm.Citations[source]#
Entry point to citations management. This object may be used to record BibTeX citation information and then register that a particular citation is relevant for a particular simulation.
Citations listed in pybamm/CITATIONS.bib can be registered with their citation key. For all other works provide a BibTeX Citation to
register()
.Examples
>>> pybamm.citations.register("Sulzer2021") >>> pybamm.citations.register("@misc{Newton1687, title={Mathematical...}}") >>> pybamm.print_citations("citations.txt")
- print(filename=None, output_format='text', verbose=False)[source]#
Print all citations that were used for running simulations. The verbose option is provided to print tags for citations in the output such that it can be seen where the citations were registered due to the use of PyBaMM models and solvers in the code.
Note
If a citation is registered manually, it will not be tagged.
Warning
This function will notify the user if a citation that has been previously registered is invalid or cannot be parsed.
- Parameters:
Examples
pybamm.lithium_ion.SPM() pybamm.Citations.print(verbose=True) or pybamm.print_citations(verbose=True)
will append the following at the end of the list of citations:
Citations registered: Marquis2019 was cited due to the use of SPM
- read_citations()[source]#
Reads the citations in pybamm.CITATIONS.bib. Other works can be cited by passing a BibTeX citation to
register()
.
- register(key)[source]#
Register a paper to be cited, one at a time. The intended use is that
register()
should be called only when the referenced functionality is actually being used.Warning
Registering a BibTeX citation, with the same key as an existing citation, will overwrite the current citation.
- Parameters:
key (str) –
The citation key for an entry in pybamm/CITATIONS.bib or
A BibTeX formatted citation