PyPSA / pypsa-eur

PyPSA-Eur: A Sector-Coupled Open Optimisation Model of the European Energy System
https://pypsa-eur.readthedocs.io/
309 stars 209 forks source link

Add `Citation.cff` #264

Closed fneum closed 2 years ago

fneum commented 2 years ago

https://twitter.com/natfriedman/status/1420122675813441540?s=20

euronion commented 2 years ago

That's nice!

Maybe we can create a pre-commit hook to automate the CFF creation using doi2cff ? https://github.com/citation-file-format/doi2cff

We'd have to do some housekeeping on the archived release on Zenodo (author names). The current version yields this:

>doi2cff init 10.5281/zenodo.4309093

# YAML 1.2
# Metadata for citation of this software according to the CFF format (https://citation-file-format.github.io/)
cff-version: 1.0.3
message: If you use this software, please cite it using these metadata.
# FIXME title as repository name might not be the best name, please make human readable
title: 'PyPSA/pypsa-eur: v0.3.0'
doi: 10.5281/zenodo.4309093
# FIXME splitting of full names is error prone, please check if given/family name are correct
authors:
- given-names: Jonas
  family-names: Hörsch
- given-names: Fabian
  family-names: Neumann
  affiliation: KIT
- given-names: FabianHofmann
  family-names: ''
- given-names: Jeroen
  family-names: Peters
- given-names: JanFrederickUnnewehr
  family-names: ''
- given-names: euronion
  family-names: ''
- given-names: Tom
  family-names: Brown
- given-names: Martha
  family-names: Maria
  affiliation: Karlsruhe Institute of Technology
- given-names: arnaud-leroy
  family-names: ''
  affiliation: KIT
- given-names: Max
  family-names: Parzen
  affiliation: University of Edinburgh
version: 0.3.0
date-released: 2020-12-07
repository-code: https://github.com/PyPSA/pypsa-eur
license: other-open

Also: Should the software release be cited using the CITATIONS.cff or the original paper? (I'd say the first one is the correct one, the second option the common one).

fneum commented 2 years ago

I think the idea is to do it the other way around. Github Citation.cff will be used as input to zenodo: https://twitter.com/ZENODO_ORG/status/1420357001490706442?s=20

euronion commented 2 years ago

Indeed, you are right!

Example repo:

https://github.com/daniel-jettka/software-citation-dhd/tree/main

and respective Zenodo repo:

https://zenodo.org/record/5106391