Merge pull request #181 from NREL/gb/bias_nc

Gb/bias nc

docs/source/conf.py

@@ -57,6 +57,8 @@
     "sphinx.ext.napoleon",
     "sphinx_rtd_theme",
     'sphinx_click.ext',
+    "sphinx_tabs.tabs",
+    "sphinx_copybutton",
 ]
 
 intersphinx_mapping = {
@@ -81,7 +83,7 @@
 #
 # This is also used if you do content translation via gettext catalogs.
 # Usually you set "language" from the command line for these cases.
-language = None
+language = 'en'
 
 # List of patterns, relative to source directory, that match files and
 # directories to ignore when looking for source files.
@@ -140,7 +142,7 @@
 # -- Options for HTMLHelp output ---------------------------------------------
 
 # Output file base name for HTML help builder.
-htmlhelp_basename = 'rexdoc'
+htmlhelp_basename = 'sup3rdoc'
 
 # -- Options for LaTeX output ------------------------------------------------
 

sup3r/__init__.py

@@ -2,7 +2,9 @@
 """Super Resolving Renewable Energy Resource Data (SUP3R)"""
 import os
 from sup3r.version import __version__
-import sup3r.cli  # import sets up CLI commands
+# Next import sets up CLI commands
+# This line could be "import sup3r.cli" but that breaks sphinx as of 12/11/2023
+from sup3r.cli import main
 
 __author__ = """Brandon Benton"""
 __email__ = "[email protected]"

sup3r/bias/__init__.py

@@ -2,4 +2,5 @@
 """Bias calculation and correction modules."""
 from .bias_transforms import (global_linear_bc, local_linear_bc,
                               monthly_local_linear_bc)
-from .bias_calc import LinearCorrection, MonthlyLinearCorrection
+from .bias_calc import (LinearCorrection, MonthlyLinearCorrection,
+                        SkillAssessment)

sup3r/bias/bias_correct_means.py

@@ -13,7 +13,6 @@
 
 import numpy as np
 import pandas as pd
-import rioxarray
 import xarray as xr
 from rex import Resource
 from scipy.interpolate import interp1d
@@ -116,6 +115,11 @@ def convert_month_height_tif(self, month, height):
             os.remove(outfile)
 
         if not os.path.exists(outfile) or self.overwrite:
+            try:
+                import rioxarray
+            except ImportError as e:
+                msg = 'Need special installation of "rioxarray" to run this!'
+                raise ImportError(msg) from e
             tmp = rioxarray.open_rasterio(infile)
             ds = tmp.to_dataset("band")
             ds = ds.rename(