SVD Toolbox for diagnostics

docs/explanations/model_diagnostics/index.rst

@@ -5,6 +5,11 @@ Model Diagnostics Workflow
     :depth: 3
     :local:
 
+.. toctree::
+    :maxdepth: 1
+
+    svd_analysis
+
 Introduction
 ------------
 

docs/explanations/model_diagnostics/svd_analysis.rst

@@ -0,0 +1,8 @@
+SVD Analysis
+============
+
+.. contents::
+    :depth: 3
+    :local:
+
+TBA

docs/reference_guides/core/util/diagnostics/svd_toolbox.rst

@@ -0,0 +1,17 @@
+SVD Toolbox
+===========
+
+The IDAES SVD Toolbox is an advanced diagnostics tool for helping to identify scaling and degeneracy issues in models using Singular Value Decomposition and is accessible through the ``DiagnosticsToolbox``. Further discussion of how to use and interpret SVD results can be found :ref:`here<explanations/model_diagnostics/svd_analysis:SVD Analysis>`.
+
+.. autoclass:: idaes.core.util.model_diagnostics.SVDToolbox
+    :members:
+
+SVD Callbacks
+-------------
+
+The SVD Toolbox supports callbacks to select the SVD analysis tool to use. Two callbacks are provided to make use of methods avaialable in Scipy.
+
+.. automodule:: idaes.core.util.model_diagnostics
+    :noindex:
+    :members: svd_dense, svd_sparse
+

docs/reference_guides/core/util/model_diagnostics.rst

@@ -7,12 +7,13 @@ The IDAES toolset contains a number of utility functions which can be useful for
     :maxdepth: 1
 
     diagnostics/diagnostics_toolbox
+    diagnostics/svd_toolbox
     diagnostics/degeneracy_hunter
 
 Other Methods
 ^^^^^^^^^^^^^
 
 .. automodule:: idaes.core.util.model_diagnostics
-    :exclude-members: DegeneracyHunter, DiagnosticsToolbox
+    :exclude-members: DegeneracyHunter, DiagnosticsToolbox, SVDToolbox, svd_dense, svd_sparse
     :members: