diff --git a/README.md b/README.md index 7a7d94500f..c80f1c7acf 100644 --- a/README.md +++ b/README.md @@ -7,11 +7,11 @@ latest release - - + + - - + + @@ -50,19 +50,8 @@ zenodo reference - - JOSS reference - - - - - Downloads - - - PyPI downloads - - - conda-forge downloads + + DOI badge @@ -99,17 +88,32 @@ The long-term success of pvlib-python requires substantial community support. Citing ====== -If you use pvlib-python in a published work, please cite: +Many of the contributors to pvlib python work in institutions where +citation metrics are used in performance or career evaluations. If you +use pvlib python in a published work, please cite: - William F. Holmgren, Clifford W. Hansen, and Mark A. Mikofski. +**Recommended citation for the pvlib python project** + + Anderson, K., Hansen, C., Holmgren, W., Jensen, A., Mikofski, M., and Driesse, A. + "pvlib python: 2023 project update." + Journal of Open Source Software, 8(92), 5994, (2023). + https://doi.org/10.21105/joss.05994 + + +**Recommended citation for pvlib iotools** + + Jensen, A., Anderson, K., Holmgren, W., Mikofski, M., Hansen, C., Boeman, L., Loonen, R. + "pvlib iotools —- Open-source Python functions for seamless access to solar irradiance data." + Solar Energy, 266, 112092, (2023). + https://doi.org/10.1016/j.solener.2023.112092 + +**Historical citation for pvlib python** + + Holmgren, W., Hansen, C., and Mikofski, M. "pvlib python: a python package for modeling solar energy systems." Journal of Open Source Software, 3(29), 884, (2018). https://doi.org/10.21105/joss.00884 -Please also cite the DOI corresponding to the specific version of -pvlib-python that you used. pvlib-python DOIs are listed at -[Zenodo.org](https://zenodo.org/search?page=1&size=20&q=conceptrecid:593284&all_versions&sort=-version) - If you use pvlib-python in a commercial or publicly-available application, please consider displaying one of the "powered by pvlib" logos: @@ -142,10 +146,10 @@ History and acknowledgement =========================== pvlib python started out as a Python translation of the PVLIB MATLAB -toolbox (developed by the `PVPMC `_ at +toolbox (developed by the [PVPMC](https://pvpmc.sandia.gov/) at Sandia National Laboratories) in 2013 and has grown substantially since then. Today it contains code contributions from over a hundred individuals worldwide -and is maintained by a core group of PV modelers from a variety institutions. +and is maintained by a core group of PV modelers from a variety of institutions. pvlib has been supported directly and indirectly by DOE, NumFOCUS, and Google Summer of Code funding, university research projects, diff --git a/docs/sphinx/source/index.rst b/docs/sphinx/source/index.rst index d8d8d9debd..8e5773d639 100644 --- a/docs/sphinx/source/index.rst +++ b/docs/sphinx/source/index.rst @@ -48,28 +48,37 @@ companies that allow their employees to contribute, and from personal time. Citing pvlib python =================== -Many of the contributors to pvlib-python work in institutions where +Many of the contributors to pvlib python work in institutions where citation metrics are used in performance or career evaluations. If you use pvlib python in a published work, please cite: - William F. Holmgren, Clifford W. Hansen, and Mark A. Mikofski. +**Recommended citation for the pvlib python project** + + Anderson, K., Hansen, C., Holmgren, W., Jensen, A., Mikofski, M., and Driesse, A. + "pvlib python: 2023 project update." + Journal of Open Source Software, 8(92), 5994, (2023). + https://doi.org/10.21105/joss.05994 + + +**Recommended citation for pvlib iotools** + + Jensen, A., Anderson, K., Holmgren, W., Mikofski, M., Hansen, C., Boeman, L., Loonen, R. + "pvlib iotools — Open-source Python functions for seamless access to solar irradiance data." + Solar Energy, 266, 112092, (2023). + https://doi.org/10.1016/j.solener.2023.112092 + +**Historical citation for pvlib python** + + Holmgren, W., Hansen, C., and Mikofski, M. "pvlib python: a python package for modeling solar energy systems." Journal of Open Source Software, 3(29), 884, (2018). https://doi.org/10.21105/joss.00884 +**Version specific citation** Please also cite the DOI corresponding to the specific version of pvlib python that you used. pvlib python DOIs are listed at `Zenodo.org `_ -If you use pvlib-python in a commercial or publicly-available -application, please consider displaying one of the "powered by pvlib" -logos: - -.. image:: _images/pvlib_powered_logo_horiz.png - :width: 300 - -.. image:: _images/pvlib_powered_logo_vert.png - :width: 300 Additional pvlib python publications include: @@ -94,6 +103,19 @@ Additional pvlib python publications include: "An Open Source Solar Power Forecasting Tool Using PVLIB-Python," in 43rd Photovoltaic Specialists Conference, 2016. + +Logo +==== +If you use pvlib python in a commercial or publicly-available +application, please consider displaying one of the "powered by pvlib" +logos: + +.. image:: _images/pvlib_powered_logo_horiz.png + :width: 300 + +.. image:: _images/pvlib_powered_logo_vert.png + :width: 300 + License ======= @@ -108,21 +130,12 @@ pvlib python is a `NumFOCUS Affiliated Project