Skip to content

Commit

Permalink
Merge remote-tracking branch 'jjonkman/f/fast-farm' into f/fast-farm
Browse files Browse the repository at this point in the history
  • Loading branch information
jjonkman committed Apr 2, 2021
2 parents cc6010b + 65c1715 commit f9df102
Show file tree
Hide file tree
Showing 10 changed files with 89 additions and 84 deletions.
18 changes: 9 additions & 9 deletions docs/source/user/fast.farm/FFarmTheory.rst
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@
FAST.Farm Theory
================

`FAST.Farm <https://nwtc.nrel.gov/FASTFarm>`__ is a multiphysics
FAST.Farm is a multiphysics
engineering tool for predicting the performance and loads of wind
turbines within a wind farm. FAST.Farm uses
`OpenFAST <https://github.com/OpenFAST/openfast>`__ to solve the
Expand Down Expand Up @@ -333,7 +333,7 @@ results in simulations that are computationally inexpensive enough to
run the many simulations necessary for wind turbine/farm design and
analysis.

.. _FF:SC:
.. _FF:Theory:SC:

Super Controller (SC Module)
~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Expand All @@ -356,7 +356,7 @@ through variations in nacelle yaw or tilt, as illustrated in

The *SC* module of FAST.Farm provides an interface to the super
controller dynamic library -- essentially identical to the super controller
available in `SOWFA <https://nwtc.nrel.gov/SOWFA>`__ -- which allows the
available in `SOWFA <https://github.com/NREL/SOWFA>`__ -- which allows the
user of FAST.Farm to implement their own wind-farm-wide control logic in
discrete time and without direct feedthrough of input to output -- perhaps
developed through the application of
Expand Down Expand Up @@ -543,9 +543,9 @@ each rotor.
The wake-dynamics calculations involve many user-specified parameters
that may depend, e.g., on turbine operation or atmospheric conditions
that can be calibrated to better match experimental data or HFM, e.g.,
by running `SOWFA <https://nwtc.nrel.gov/SOWFA>`__ (or equivalent) as a
by running `SOWFA <https://github.com/NREL/SOWFA>`__ (or equivalent) as a
benchmark. Default values have been derived for each calibrated
parameter based on `SOWFA <https://nwtc.nrel.gov/SOWFA>`__
parameter based on `SOWFA <https://github.com/NREL/SOWFA>`__
simulations (:cite:`ff-Doubrawa18_1`), but these can be
overwritten by the user of FAST.Farm.

Expand Down Expand Up @@ -1316,20 +1316,20 @@ ways. The use of the *InflowWind* module in
simple ambient wind, e.g., uniform wind, discrete wind events, or
synthetically generated turbulent wind data. Synthetically generated
turbulence can be from, e.g.,
`TurbSim <https://nwtc.nrel.gov/TurbSim>`__ or the Mann model, in which
TurbSim or the Mann model, in which
the wind is propagated through the wind farm using Taylor’s
frozen-turbulence assumption. This method is most applicable to small
wind farms or a subset of wind turbines within a larger wind farm.
FAST.Farm can also use ambient wind generated by a high-fidelity
precursor LES simulation of the entire wind farm (without wind turbines
present), such as the ABLSolver preprocessor of
`SOWFA <https://nwtc.nrel.gov/SOWFA>`__. This atmospheric precursor
`SOWFA <https://github.com/NREL/SOWFA>`__. This atmospheric precursor
simulation captures more physics than synthetic turbulence -- as
illustrated in :numref:`FF:ABLSolver` -- including atmospheric
stability, wind-farm-wide turbulent length scales, and complex terrain
effects. It is more computationally expensive than using the ambient
wind modeling options of *InflowWind*, but it is much less
computationally expensive than a `SOWFA <https://nwtc.nrel.gov/SOWFA>`__
computationally expensive than a `SOWFA <https://github.com/NREL/SOWFA>`__
simulation with multiple wind turbines present.

FAST.Farm requires ambient wind to be available in two different
Expand Down Expand Up @@ -1445,7 +1445,7 @@ In previous implementations of DWM, the wind turbine and wake dynamics
were solved individually or serially, not considering two-way
wake-merging interactions. Additionally, there was no method available
to calculate the disturbed wind in zones of wake overlap. Wake merging
is illustrated by the `SOWFA <https://nwtc.nrel.gov/SOWFA>`__ simulation
is illustrated by the `SOWFA <https://github.com/NREL/SOWFA>`__ simulation
of :numref:`FF:WakeMerg`. In FAST.Farm, the wake-merging
submodel of the *AWAE* module identifies zones of wake overlap between
all wakes across the wind farm by finding wake volumes that overlap in
Expand Down
4 changes: 2 additions & 2 deletions docs/source/user/fast.farm/FutureWork.rst
Original file line number Diff line number Diff line change
Expand Up @@ -94,12 +94,12 @@ releases:

- Interface FAST.Farm to the Wind-Plant Integrated System Design &
Engineering Model
(`WISDEM <https://nwtc.nrel.gov/WISDEM>`__\ :math:`^\text{TM}`) for
(`WISDEM <https://github.com/NREL/WISDEM>`__\ :math:`^\text{TM}`) for
systems-engineering applications (multidisciplinary design, analysis,
and optimization; uncertainty quantification; and so on).

- Develop a wrapper for stand-alone
`AeroDyn <https://nwtc.nrel.gov/AeroDyn>`__ – the aerodynamics module
AeroDyn – the aerodynamics module
of OpenFAST (or an equivalent BEM tool) – as an alternative to
OpenFAST to support advanced performance-only wind-farm analysis that
is much more computationally efficient than FAST.Farm analysis using
Expand Down
8 changes: 3 additions & 5 deletions docs/source/user/fast.farm/InputFiles.rst
Original file line number Diff line number Diff line change
Expand Up @@ -71,9 +71,7 @@ in FAST.Farm is used the same way as the level set in stand-alone
OpenFAST, but the **AbortLevel** set in FAST.Farm will override the
levels set in the OpenFAST primary input file of each wind turbine in
the wind farm. Setting FAST.Farm to abort on fatal errors is typical,
but see the `FAST v8 ReadMe
document <https://wind.nrel.gov/nwtc/docs/README_FAST8.pdf>`__ for
additional guidance.
but see the FAST v8 ReadMe document for additional guidance.

**TMax** [sec] is the total length of the simulation to be run. The
first output is calculated at :math:`t=0`; the last output is calculated
Expand Down Expand Up @@ -108,7 +106,7 @@ name must be in quotations** and can contain an absolute or a relative
path. The super controller is used in conjunction with individual wind
turbine controllers defined in the style of the DISCON dynamic library
of the DNV GL’s Bladed wind turbine software package, with minor
modification. See :numref:`FF:SC` for more information.
modification. See :numref:`FF:sec:SupCon` for more information.

.. _FF:Input:VTK:

Expand Down Expand Up @@ -484,7 +482,7 @@ zero. If the DEFAULT keyword is specified in place of a numerical value,
[**Mod_WakeDiam=4**]. If the DEFAULT keyword is specified in place of a
numerical value, **Mod_WakeDiam** is set to :math:`1`.

**C_WakeDiam** [-] (:math:`C_{WakeDIam}`) is the calibrated parameter
**C_WakeDiam** [-] (:math:`C_{WakeDiam}`) is the calibrated parameter
for the wake diameter calculation and must be greater than zero and less
than :math:`0.99`. It is unused when **Mod_WakeDiam=1**. If the DEFAULT
keyword is specified in place of a numerical value, **C_WakeDiam** is
Expand Down
14 changes: 7 additions & 7 deletions docs/source/user/fast.farm/Introduction.rst
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@
Introduction
============

`FAST.Farm <https://nwtc.nrel.gov/FASTFarm>`__ is a midfidelity
FAST.Farm is a midfidelity
multiphysics engineering tool for predicting the power performance and
structural loads of wind turbines within a wind farm. FAST.Farm uses
`OpenFAST <https://github.com/OpenFAST/openfast>`__ to solve the
Expand Down Expand Up @@ -54,8 +54,8 @@ diameters) affect wake meandering.
FAST.Farm is a nonlinear time-domain multiphysics engineering tool
composed of multiple submodels, each representing different physics
domains of the wind farm. FAST.Farm is implemented as open-source
software that follows the programming requirements of the `FAST
modularization framework <https://nwtc.nrel.gov/FAST-Developers>`__,
software that follows the programming requirements of the FAST
modularization framework,
whereby the submodels are implemented as modules interconnected through
a driver code. The submodel hierarchy of FAST.Farm is illustrated in
:numref:`FF:FFarm`.
Expand Down Expand Up @@ -91,7 +91,7 @@ Super Controller Module
-----------------------

The *SC* module of FAST.Farm -- essentially identical to the super
controller available in `SOWFA <https://nwtc.nrel.gov/SOWFA>`__ allows
controller available in `SOWFA <https://github.com/NREL/SOWFA>`__ allows
wind-farm-wide control logic to be implemented by the user, including
sending and receiving commands from the individual turbine controllers
in OpenFAST. The logic of such a super controller could be developed
Expand Down Expand Up @@ -144,7 +144,7 @@ many user-specified parameters that may depend, e.g., on turbine
operation or atmospheric conditions and can be calibrated to better
match experimental data or by using an HFM solution as a benchmark.
Default values have been derived for each calibrated parameter based on
`SOWFA <https://nwtc.nrel.gov/SOWFA>`__ simulations, but these can be
`SOWFA <https://github.com/NREL/SOWFA>`__ simulations, but these can be
overwritten by the user.

The wake-deficit evolution is solved in discrete time on an axisymmetric
Expand Down Expand Up @@ -293,14 +293,14 @@ or an interface to the *InflowWind* module in OpenFAST. The use of the
*InflowWind* module enables the use of simple ambient wind, e.g.,
uniform wind, discrete wind events, or synthetically generated turbulent
wind data. Synthetically generated turbulence can be generated from,
e.g., `TurbSim <https://nwtc.nrel.gov/TurbSim>`__ or the Mann model, in
e.g., TurbSim or the Mann model, in
which the wind is propagated through the wind farm using Taylor’s
frozen-turbulence assumption. This method is most applicable to small
wind farms or a subset of wind turbines within a larger wind farm.
FAST.Farm can also use ambient wind generated by a high-fidelity
precursor large-eddy simulation (LES) of the entire wind farm (without
wind turbines present), such as the atmospheric boundary layer solver
(ABLSolver) preprocessor of `SOWFA <https://nwtc.nrel.gov/SOWFA>`__.
(ABLSolver) preprocessor of `SOWFA <https://github.com/NREL/SOWFA>`__.
This atmospheric precursor simulation captures more physics than
synthetic turbulence -- as illustrated in
:numref:`FF:ABLSolver` -- including atmospheric stability,
Expand Down
Loading

0 comments on commit f9df102

Please sign in to comment.