Add page on Surface Albedo (#13)

* add albedo nb, references, update requirements

* suggestions from review

Author: kandersolar

doc-requirements.txt

@@ -1,4 +1,5 @@
 sphinx==4.5.0
 nbsphinx==0.8.9
 sphinx-book-theme==0.3.3
-ipython==8.10.0
+ipython==8.10.0
+sphinxcontrib-bibtex==2.5.0

environment.yml

@@ -6,5 +6,9 @@ dependencies:
     - pip:
         - h5pyd==0.11.0
         - haversine==2.7.0
+        - matplotlib==3.5.2
+        - numpy==1.22.3
+        - pandas==1.5.0
         - pvlib==0.9.3
+        - scipy==1.7.3
         - watermark==2.3.1

source/conf.py

@@ -13,14 +13,22 @@
 # -- General configuration ---------------------------------------------------
 # https://www.sphinx-doc.org/en/master/usage/configuration.html#general-configuration
 
-extensions = ['nbsphinx']
+extensions = [
+    'nbsphinx',
+    'sphinxcontrib.bibtex',
+]
 
 templates_path = ['_templates']
 exclude_patterns = []
 
 nbsphinx_execute = 'never'
 nbsphinx_requirejs_path = ''  # disable requirejs; already loaded by theme
 
+# https://sphinxcontrib-bibtex.readthedocs.io/en/latest/usage.html#configuration
+bibtex_default_style = 'plain'
+bibtex_reference_style = 'label'
+bibtex_bibfiles = ['references.bib']
+
 # -- Options for HTML output -------------------------------------------------
 # https://www.sphinx-doc.org/en/master/usage/configuration.html#options-for-html-output
 

source/index.rst

@@ -57,3 +57,5 @@ This project uses many open-source software packages, including:
    pages/tmy-vs-single
    pages/numerical-precision
    pages/2300-artifact
+   pages/albedo
+   pages/references

source/pages/albedo.ipynb

@@ -0,0 +1,8 @@
+
+References
+==========
+
+This page lists citations for the various NSRDB publications referenced elsewhere
+on this website.
+
+.. bibliography::

source/pages/references.rst

@@ -0,0 +1,35 @@
+@article{sengupta2022recent,
+    title = {Recent Improvements in the {N}ational {S}olar {R}adiation {D}atabase ({NSRDB})},
+    author = {Sengupta, Manajit and Habte, Aron and Xie, Yu and Buster, Grant and Bannister, Mike and Rossol, Michael and Edwards, Paul and Maclaurin, Galen and Rosenlieb, Evan and Yang, Jaemo and Sky, Haiku and Roberts, Billy},
+    url = {https://www.osti.gov/biblio/1906326},
+    journal = {NREL/PO-5D00-83375},
+    year = {2022},
+    month = {December}
+}
+
+@misc{sengupta2022webinar,
+  title        = "2022 {N}ational {S}olar {R}adiation {D}atabase Webinar",
+  author       = "{National Renewable Energy Laboratory}",
+  howpublished = "\url{https://www.youtube.com/watch?v=BzNoYACXCOY}",
+  year         = 2022,
+  month        = "November",
+}
+
+@article{sengupta2019evolution,
+    title = {Evolution of {NREL}'s {N}ational {S}olar {R}adiation {D}atabase ({NSRDB})},
+    author = {Sengupta, Manajit and Habte, Aron M and Xie, Yu and Rossol, Michael N and Buster, Grant},
+    url = {https://www.osti.gov/biblio/1569455},
+    journal = {NREL/PO-5D00-74137},
+    year = {2019},
+    month = {September},
+}
+
+@techreport{maclaurin2016albedo,
+  doi = {10.2172/1335471},
+  year = {2016},
+  month = {December},
+  number = {NREL/TP-6A20-67306},
+  author = {Galen Maclaurin and Manajit Sengupta and Yu Xie and Nicholas Gilroy},
+  title = {Development of a {MODIS}-Derived Surface Albedo Data Set: An Improved Model Input for Processing the {NSRDB}},
+  institution = {National Renewable Energy Laboratory}
+}