SNL-WaterPower · H0R5E · Nov 4, 2020 · Oct 22, 2020 · Oct 22, 2020 · Nov 3, 2020
diff --git a/.travis.yml b/.travis.yml
@@ -4,9 +4,10 @@ jobs:
   include:
     - stage: pages
       install:
-        - pip install click colorama colorclass future "sphinx==1.8.5" sphinxcontrib-bibtex sphinx_rtd_theme
+        - pip install click colorama colorclass future "sphinx==1.8.5" "sphinxcontrib-bibtex==0.4.2" 
+          sphinx_rtd_theme sphinxcontrib-matlabdomain
+        - pip install git+git://github.com/SuperKogito/sphinxcontrib-pdfembed
         - pip install https://github.com/H0R5E/sphinxcontrib-versioning/archive/v1.8.5_support.zip
-        - pip install git+https://github.com/H0R5E/matlabdomain.git/@function_arguments#egg=matlabdomain
       script:
         - eval "$(ssh-agent -s)"; touch .travis/key; chmod 0600 .travis/key
         - openssl aes-256-cbc -d -K $encrypted_c97e05834f48_key -iv $encrypted_c97e05834f48_iv < .travis/key.enc > .travis/key

diff --git a/README.md b/README.md
@@ -211,8 +211,9 @@ replace slashes (`/`) in paths with backslashes (`\ `).
    ```
    > conda create -c conda-forge -n _sphinx click colorama colorclass future pip "sphinx=1.8.5" sphinxcontrib-bibtex sphinx_rtd_theme 
    > activate _sphinx
+   (_sphinx) > pip install sphinxcontrib-matlabdomain
+   (_sphinx) > pip install git+git://github.com/SuperKogito/sphinxcontrib-pdfembed
    (_sphinx) > pip install https://github.com/H0R5E/sphinxcontrib-versioning/archive/v1.8.5_support.zip
-   (_sphinx) > pip install git+https://github.com/H0R5E/matlabdomain.git/@function_arguments#egg=matlabdomain
    (_sphinx) > conda deactivate
    >
    ```

diff --git a/docs/_static/WecOptTool_webinar_2020_09_29.pdf b/docs/_static/WecOptTool_webinar_2020_09_29.pdf
diff --git a/docs/conf.py b/docs/conf.py
@@ -43,7 +43,8 @@ def setup(app):
     'sphinx.ext.mathjax',
     'sphinxcontrib.matlab',
     'sphinx.ext.napoleon',
-    'sphinxcontrib.bibtex'
+    'sphinxcontrib.bibtex',
+    'sphinxcontrib.pdfembed'
 ]
 
 # Figure numbering

diff --git a/docs/contents.rst b/docs/contents.rst
@@ -3,12 +3,14 @@
    :numbered:
    :caption: User Guide
 
-   user/setup
-   user/optimization
-   user/model
-   user/api
-   user/license
-   user/references
+   user/1setup
+   user/2optimization
+   user/3model
+   user/4cite
+   user/5resources
+   user/6api
+   user/7license
+   user/8references
 
 .. toctree::
    :hidden:

diff --git a/docs/user/setup.rst → docs/user/1setup.rst b/docs/user/setup.rst → docs/user/1setup.rst
diff --git a/docs/user/optimization.rst → docs/user/2optimization.rst b/docs/user/optimization.rst → docs/user/2optimization.rst
diff --git a/docs/user/model.rst → docs/user/3model.rst b/docs/user/model.rst → docs/user/3model.rst
@@ -11,7 +11,7 @@ It is envisioned that the structure of WecOptTool may some day be consolidated b
 Introduction
 ============
 
-The WaveBot example :cite:`Coe2020` will be used to illustrate these concepts in more detail.
+The WaveBot example :cite:`Coe2020initial` will be used to illustrate these concepts in more detail.
 The process for performing a study in WecOptTool can be broken into three distinct steps, which correlate to three files in the WaveBot example:
 
 	* **Designing the device** - |designDevice.m|_ creates the device based on a set of design variables

diff --git a/docs/user/4cite.rst b/docs/user/4cite.rst
@@ -0,0 +1,22 @@
+*****************
+Citing WecOptTool
+*****************
+
+If WecOptTool has been significant in your research, and you would like to acknowledge the project in your academic publication, we suggest citing the following paper:
+
+*  Coe, R.G., Bacelli, G., Olson, S., Neary, V.S., Topper, M.B.R. (2020). Initial conceptual demonstration of control co-design for WEC optimization. 
+   *Journal of Ocean Engineering and Marine Energy (in press).* DOI: |nbsp| `10.36227/techrxiv.12928898 <https://doi.org/10.36227/techrxiv.12928898>`__.
+
+*In BibTeX format*:: 
+
+    @article{       Coe2020initial,
+     author       = {Ryan G. Coe and Giorgio Bacelli and Sterling Olson and Vincent S. Neary 
+                     and Mathew B. R. Topper},
+     doi          = {10.36227/techrxiv.12928898},
+     journal      = {Journal of Ocean Engineering and Marine Energy (in press)},
+     title        = {Initial conceptual demonstration of control co-design for {WEC} optimization},
+     year         = {2020}
+    }
+
+.. |nbsp| unicode:: 0xA0 
+   :trim:
diff --git a/docs/user/5resources.rst b/docs/user/5resources.rst
@@ -0,0 +1,21 @@
+*********
+Resources
+*********
+
+This page provides additional resources for users of WecOptTool.
+
+Webinar
+=======
+
+A one hour webinar :cite:`coe2020webinar` was presented on September 29th 2020. This webinar provides interested users with a tutorial and background.
+
+:pdfembed:`src:../_static/WecOptTool_webinar_2020_09_29.pdf#view=fitH&zoom=scale&toolbar=1, height:450, width:700, align:middle`
+
+Additional Reading
+==================
+
+The following references specifically focusing on WecOptTool are available:
+
+	* **Optimal control of wave energy converters** :cite:`Bacelli2014` - While written years before the development of WecOptTool, Giorgio Bacelli's doctoral thesis provides much of the framework upon which WecOptTool is based.
+	* **Initial conceptual demonstration of control co-design for WEC optimization** :cite:`Coe2020initial` - This paper presents the basic framework of WecOptTool along with a series of examples using the Sandia WaveBot.
+
diff --git a/docs/user/api.rst → docs/user/6api.rst b/docs/user/api.rst → docs/user/6api.rst
diff --git a/docs/user/license.rst → docs/user/7license.rst b/docs/user/license.rst → docs/user/7license.rst
diff --git a/docs/user/8references.rst b/docs/user/8references.rst
@@ -0,0 +1,8 @@
+**********
+References
+**********
+
+This page list supporting references for WecOptTool.
+
+.. bibliography:: WecOptTool_refs.bib
+   :style: unsrt
diff --git a/docs/user/WecOptTool_refs.bib b/docs/user/WecOptTool_refs.bib
@@ -1,30 +1,53 @@
 
 
-@Article{Coe2020,
-  author = {Ryan G. Coe and Giorgio Bacelli and Sterling Olson and Vincent S. Neary and Mathew B. R. Topper},
-  title  = {{Initial conceptual demonstration of control co-design for WEC optimization}},
-  year   = {2020},
-  journal= {Journal of Ocean Engineering and Marine Energy (under review)},
-  doi    = {10.36227/techrxiv.12928898.v1}
-}
+@phdthesis{Bacelli2014,
+	Address = {Maynooth, Ireland},
+	Author = {Bacelli, Giorgio},
+	Date-Added = {2020-10-21 19:27:54 -0600},
+	Date-Modified = {2020-10-21 19:27:54 -0600},
+	File = {Bacelli2014.pdf:pdfs\\Bacelli2014.pdf:PDF},
+	School = {National University of Ireland, Maynooth},
+	Title = {Optimal control of wave energy converters},
+	Type = {{PhD}},
+	Url = {http://mural.maynoothuniversity.ie/6753/},
+	Year = {2014},
+	Bdsk-Url-1 = {http://mural.maynoothuniversity.ie/6753/}}
 
-@Book{Falnes2002,
-  title		= {Ocean Waves and Oscillating Systems},
-  author	= {Johannes Falnes},
-  publisher	= {Cambridge University Press},
-  year		= {2002},
-  address	= {Cambridge; New York},
-  doi 		= {10.1017/CBO9780511754630}
-}
+@misc{coe2020webinar,
+	Author = {Ryan G. Coe and Giorgio Bacelli and Sterling Olson and Vincent S. Neary and Mathew B. R. Topper},
+	Date-Added = {2020-10-21 19:23:10 -0600},
+	Date-Modified = {2020-10-21 19:24:32 -0600},
+	Doi = {10.13140/RG.2.2.16353.94564},
+	Howpublished = {Online},
+	Month = {September},
+	Title = {WecOptTool Sept. 2020 Webinar},
+	Year = {2020}}
 
-@Article{Bacelli2014a,
-  author    = {Bacelli, Giorgio and Ringwood, John V},
-  journal   = {IEEE Transactions on Sustainable Energy},
-  title     = {Numerical optimal control of wave energy converters},
-  year      = {2014},
-  number    = {2},
-  pages     = {294--302},
-  volume    = {6},
-  publisher = {IEEE},
-  doi 		= {10.1109/TSTE.2014.2371536}
-}
+@article{Coe2020initial,
+	Author = {Ryan G. Coe and Giorgio Bacelli and Sterling Olson and Vincent S. Neary and Mathew B. R. Topper},
+	Doi = {10.36227/techrxiv.12928898},
+	Journal = {Journal of Ocean Engineering and Marine Energy (in press)},
+	Title = {{Initial conceptual demonstration of control co-design for WEC optimization}},
+	Year = {2020},
+	Bdsk-Url-1 = {https://doi.org/10.36227/techrxiv.12928898}}
+
+@book{Falnes2002,
+	Address = {Cambridge; New York},
+	Author = {Johannes Falnes},
+	Doi = {10.1017/CBO9780511754630},
+	Publisher = {Cambridge University Press},
+	Title = {Ocean Waves and Oscillating Systems},
+	Year = {2002},
+	Bdsk-Url-1 = {https://doi.org/10.1017/CBO9780511754630}}
+
+@article{Bacelli2014a,
+	Author = {Bacelli, Giorgio and Ringwood, John V},
+	Doi = {10.1109/TSTE.2014.2371536},
+	Journal = {IEEE Transactions on Sustainable Energy},
+	Number = {2},
+	Pages = {294--302},
+	Publisher = {IEEE},
+	Title = {Numerical optimal control of wave energy converters},
+	Volume = {6},
+	Year = {2014},
+	Bdsk-Url-1 = {https://doi.org/10.1109/TSTE.2014.2371536}}
diff --git a/docs/user/references.rst b/docs/user/references.rst
diff --git a/examples/WaveBot/README.md b/examples/WaveBot/README.md
@@ -6,10 +6,9 @@ A preprint is avaialable at <https://doi.org/10.36227/techrxiv.12928898>.
 ```
 @Article{WecDesignOptimizationTool,
 	author = "Ryan G. Coe and Giorgio Bacelli and Sterling Olson and Vincent S. Neary and Mathew B. R. Topper",
-	title = "{Initial conceptual demonstration of control co-design for WEC optimization}",
-	year = "2020",
-	month = "9",
-	url = "https://www.techrxiv.org/articles/preprint/Initial_conceptual_demonstration_of_control_co-design_for_WEC_optimization/12928898",
-	doi = "10.36227/techrxiv.12928898.v1"
+  	title  = {{Initial conceptual demonstration of control co-design for WEC optimization}},
+  	year   = {2020},
+  	journal= {Journal of Ocean Engineering and Marine Energy (in press)},
+  	doi    = {10.36227/techrxiv.12928898}
 }
 ```