Include legacy documentation in pdf and MS Word format - General & El…

…astoDyn (#805)

* Add documentation resources to user docs

* Add InflowWind Manual pdf

* Consolidate Other Docs page

* Add more documentation resources

* Note that legacy docs may be out of date

* Add unofficial FAST theory manual

* Corrections and updates

* Add a link to OutListParameters in user docs

docs/source/dev/index.rst

@@ -103,10 +103,13 @@ generally debugging and building out features.
 Other Documentation
 ~~~~~~~~~~~~~~~~~~~
 Additional documentation exists that may be useful for developers seeking deeper
-understanding of the solver and mathematics.  This documentation is not generally
-necessary for most development efforts.
-
-.. toctree::
-   :maxdepth: 1
-
-   other_docs.rst
+understanding of the solver and mathematics.
+
+- `NWTC Programmer’s Handbook <https://drive.google.com/file/d/1bDV1fBkiZUWs6Tkzb6nhCMUQvHpN_OtM/view?usp=sharing>`_
+   This is an overview of programming guidelines for FAST 8. While some syntax and minor details have
+   changed in OpenFAST, most of this guide is still relevant.
+- :download:`OutListParameters.xlsx <../../OtherSupporting/OutListParameters.xlsx>`
+   This Excel file contains the full list of outputs for each module.  It is used to generate the
+   Fortran code for the output channel list handling for each module (this code is generally in
+   the _IO.f90 files).  The MATLAB script available in the
+   `matlab-toolbox <https://github.com/OpenFAST/matlab-toolbox>`__ repository at *Utilities/GetOutListParameters.m*.

docs/source/user/elastodyn/index.rst

@@ -1,18 +1,51 @@
 ElastoDyn Users Guide and Theory Manual
 =======================================
 
-.. only:: html
+This document offers a quick reference guide for the ElastoDyn software
+program. It is intended to be used by the general user in combination
+with other OpenFAST manuals. The manual will be updated as new releases are
+issued and as needed to provide further information on advancements or
+modifications to the software. For general information on OpenFAST,
+users should refer to section :numref:`general-reference-docs`.
 
-   This document offers a quick reference guide for the ElastoDyn software
-   program. It is intended to be used by the general user in combination
-   with other OpenFAST manuals. The manual will be updated as new releases are
-   issued and as needed to provide further information on advancements or
-   modifications to the software.
+.. note::
 
-   The documentation here is incomplete.
+   We are in the process of migrating the documentation from FAST 8 to
+   OpenFAST. For reference, various portions of old documentation are
+   provided here. While most of it is still directly applicable
+   to OpenFAST, portions may be out of date.
 
-
+
+The following documents are a detailed derivation of the equations of
+motion of ElastoDyn. These documents have not been compiled into a report,
+so they contain mostly equations and little explanatory text. A reader
+with a background in kinematics and dynamics may be able to comprehend
+the equations. The documents make the most sense if studied in the following order:
+
+1. :download:`FASTDOFs.xls <../../../OtherSupporting/ElastoDyn/FASTDOFs.xls>`:
+   Contains a listing of the DOF indices used by the equations of motion in FAST.
+2. :download:`FASTCoordinateSystems.doc <../../../OtherSupporting/ElastoDyn/FASTCoordinateSystems.doc>`:
+   Documents the transformation matrices relating each coordinate system in FAST. Unfortunately, there are no pictures in this document that diagram these coordinate systems. They can hopefully be visualized by means of the transformation matrices.
+3. :download:`FASTKinematics.doc <../../../OtherSupporting/ElastoDyn/FASTKinematics.doc>`:
+   Documents the linear position, velocity, and acceleration vectors of each "important" point in the system and documents the angular velocity and acceleration vectors of each "important" reference frame in the system.  Also included is documentation of the partial velocity vectors needed by Kane's dynamics.
+4. :download:`FASTKinetics.doc <../../../OtherSupporting/ElastoDyn/FASTKinetics.doc>`:
+   Documents the derivation of the equations of motion using Kane's dynamics.
+5. :download:`FASTLoads.doc <../../../OtherSupporting/ElastoDyn/FASTLoads.doc>`:
+   Documents how the output loads are computed using terms from the equations of motion.
+6. :download:`FASTMotions.doc <../../../OtherSupporting/ElastoDyn/FASTMotions.doc>`:
+   Documents how the output motions are computed using variables from the equations of motion.
+7. :download:`FASTLogicFlow.doc <../../../OtherSupporting/ElastoDyn/FASTLogicFlow.doc>`:
+   Contains a listing of the subroutine names used by FAST. The names are listed in the order they are called within the program.
+
+There a few minor errors in the equations documented in these papers
+that may be clear after understanding the equations. The implemented code does
+not have these errors. The papers do not describe the Fortran source code and
+variable naming conventions, but a source code comparison is possible
+with careful study.
+
+Note that the "unofficial FAST Theory Manual" applies to the structural
+equations of FAST v7 and the ElastoDyn module of FAST v8 and OpenFAST.
+
 .. toctree::
 
    input.rst
-

docs/source/user/index.rst

@@ -3,28 +3,78 @@
 User Documentation
 ==================
 
-This section contains documentation for the OpenFAST module-coupling environment and its underlying modules.
-Documentation covers usage of models, underlying theory, and in some cases module verification.
+We are in the process of transitioning legacy FAST v8 documentation, which can be found at https://www.nrel.gov/wind/nwtc.html.
+
+.. note::
 
-We are in the process of transitioning legacy FAST v8 documentation, which can be found at https://nwtc.nrel.gov/.
-Details on the transition from FAST v8 to OpenFAST may be found in :numref:`fast_to_openfast`
+    Much of the documentation here is legacy documentation from FAST v8. While most of it is still
+    directly applicable to OpenFAST, portions may be out of date.
 
+
+.. _general-reference-docs:
+
+General
+~~~~~~~
 .. toctree::
    :maxdepth: 1
 
+   fast_to_openfast.rst
    api_change.rst
    input_file_overview.rst
-   aerodyn/index.rst
-   aerodyn-olaf/index.rst
-   aerodyn-aeroacoustics/index.rst
-   beamdyn/index.rst
-   subdyn/index.rst
-   elastodyn/index.rst
-   hydrodyn/index.rst
-   inflowwind/index.rst
-   servodyn/index.rst
-   servodyn-stc/StC_index.rst
-   fast_to_openfast.rst
-   cppapi/index.rst
-   fast.farm/index.rst
 
+Workshop material, legacy documentation, and other resources are listed below.
+
+- `Workshop Presentations <https://drive.google.com/drive/folders/1BDDfcnIyvmZCwf7eFo0ISI7aF_FMAOvt?usp=sharing>`_
+- :download:`Old FAST v6 User’s Guide <../../OtherSupporting/Old_FAST6_UsersGuide.pdf>`
+- :download:`FAST v8 README <../../OtherSupporting/FAST8_README.pdf>`
+- `Implementation of Substructure Flexibility and Member-Level Load Capabilities for Floating Offshore Wind Turbines in OpenFAST <https://www.nrel.gov/docs/fy20osti/76822.pdf>`_
+- `FAST modularization framework for wind turbine simulation: full-system linearization <https://www.nrel.gov/docs/fy17osti/67015.pdf>`_
+- `Full-System Linearization for Floating Offshore Wind Turbines in OpenFAST <https://www.nrel.gov/docs/fy19osti/71865.pdf>`_ 
+- :download:`FAST with Labview <../../OtherSupporting/UsingFAST4Labview.pdf>`
+- :download:`OutListParameters.xlsx <../../OtherSupporting/OutListParameters.xlsx>` - Contains the full list of outputs for each module.
+
+
+Module Documentation
+~~~~~~~~~~~~~~~~~~~~
+This section contains documentation for the OpenFAST module-coupling environment and its underlying modules.
+Documentation covers usage of models, underlying theory, and in some cases module verification.
+
+.. toctree::
+   :maxdepth: 1
+
+   AeroDyn <aerodyn/index.rst>
+   OLAF <aerodyn-olaf/index.rst>
+   Aeroacoustics <aerodyn-aeroacoustics/index.rst>
+   BeamDyn <beamdyn/index.rst>
+   SubDyn <subdyn/index.rst>
+   ElastoDyn <elastodyn/index.rst>
+   HydroDyn <hydrodyn/index.rst>
+   InflowWind <inflowwind/index.rst>
+   ServoDyn <servodyn/index.rst>
+   Structural Control <servodyn-stc/StC_index.rst>
+   C++ API <cppapi/index.rst>
+   FAST.Farm <fast.farm/index.rst>
+
+
+Modularization Framework
+~~~~~~~~~~~~~~~~~~~~~~~~
+
+Information specific to the modularization framework of OpenFAST is provided here. These are a collection
+of publications, presentations, and past studies on the subject.
+
+- `The New Modularization Framework for the FAST Wind Turbine CAE Tool <https://www.nrel.gov/docs/fy13osti/57228.pdf>`_
+- :download:`Example Module Implementation Plans <../../OtherSupporting/ModulePlan_GasmiPaperExamples.doc>`
+- :download:`Module and Mesh-Mapping Linearization Implementation Plan <../../OtherSupporting/LinearizationOfMeshMapping_Rev18_Rev2.doc>`
+- :download:`Interpolation of DCMs <../../OtherSupporting/DCM_Interpolation/DCM_Interpolation.pdf>` - A summary of the mathematics used in the interpolation of DCM (direction cosine matrices) using logarithmic mapping and matrix exponentials.
+- :download:`Set-point Linearization Development Plan <../../OtherSupporting/DevelopmentPlan-SetPoint-Linearization.pdf>`
+
+.. - :download:`OpenFAST Steady State Solution <../../OtherSupporting/OpenFASTSteadyStateSolution_Rev7.doc>`
+
+
+Glue Code and Mesh Mapping
+~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+- `FAST Modular Wind Turbine CAE Tool: Nonmatching Spatial and Temporal Meshes <https://www.nrel.gov/docs/fy14osti/60742.pdf>`_
+- `FAST Modular Framework for Wind Turbine Simulation: New Algorithms and Numerical Examples <https://dx.doi.org/10.2514/6.2015-1461>`_
+- :download:`OpenFAST Algorithms <../../OtherSupporting/OpenFAST_Algorithms/OpenFAST_Algorithms.pdf>` - A summary of the solve method used in the glue code.
+- :download:`Predictor-Corrector Approach <../../OtherSupporting/ProposedPCApproach_Rev4.docx>`

docs/source/user/inflowwind/index.rst

@@ -9,8 +9,8 @@ InflowWind Users Guide and Theory Manual
    issued and as needed to provide further information on advancements or
    modifications to the software.
 
-   The information here is incomplete. Please see the 
-   `InflowWind Manual <https://wind.nrel.gov/nwtc/docs/InflowWind_Manual.pdf>`__
+   The information here is incomplete. Please see the original
+   :download:`InflowWind Manual <InflowWind_Manual.pdf>`
    until it has been converted to OpenFAST's documentation style.
 
 

docs/source/user/input_file_overview.rst

@@ -1,8 +1,8 @@
 .. _input_file_overview:
 
 
-Overview of input file formats
-==============================
+Input file formats
+==================
 
 OpenFAST uses two primary input file formats: *value column* where the first
 value on the line is read, and *key+value* where a value and keyword pair are