Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Standardize citation method in PyHC software #36

Open
rebeccaringuette opened this issue Sep 11, 2024 · 2 comments
Open

Standardize citation method in PyHC software #36

rebeccaringuette opened this issue Sep 11, 2024 · 2 comments

Comments

@rebeccaringuette
Copy link

Interested in having a common way across all PyHC packages to retrieve the correct citation (e.g. BibTex) for the software package, and to include the software version number and DOI in that information. For the R language, the citation information can be retrieved by using

citation("package_name")

but there is no such standardization in Python. SunPy offers the

sunpy.__citation__

option. What do other packages offer programmatically? If not many others have this feature already, could we go with the method SunPy already has?

@wtbarnes
Copy link
Contributor

We also provide some narrative guidance in our documentation: https://docs.sunpy.org/en/stable/citation.html, the general idea being that you should cite a DOI corresponding to the exact version as well as our v1.0 paper which is a more formal publication. I wonder if we could just standardize on this recommendation or something similar?

@rebeccaringuette
Copy link
Author

Clarifying the scope here. This is pointing to the programmatic citation method, which would benefit PyHC users to have standardized across the packages to make it easier for them to cite your packages.
Could add to this conversation exactly what would be cited. My opinion is to cite the specific version of the package, not the general DOI and not an associated publication DOI. For specific versions attached to a JOSS paper, that DOI could work, but would need to be updated in the package software for future versions.
Also, if this is standardized, the current citation could be programmatically incorporated into the PyHC listing, the Heliophysics Software Search Interface now in development, and the PyHC software environment(s).

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

2 participants