Add link to GRS layout optimization paper (#932)

* Align title style with other docs pages * Add citation to published Torque paper. * Add DOI for paper. * Line ending that ruff didnt catch locally
NREL · Jun 26, 2024 · 494ea45 · 494ea45
1 parent 084e931
commit 494ea45
Show file tree

Hide file tree

Showing 4 changed files with 22 additions and 5 deletions.
diff --git a/docs/heterogeneous_map.ipynb b/docs/heterogeneous_map.ipynb
@@ -4,7 +4,9 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "# HeterogeneousMap"
+    "(heterogeneous_map)=\n",
+    "\n",
+    "# Heterogeneous Map"
    ]
   },
   {

diff --git a/docs/layout_optimization.md b/docs/layout_optimization.md
@@ -1,6 +1,6 @@
 
 (layout_optimization)=
-# Layout optimization
+# Layout Optimization
 
 The FLORIS package provides layout optimization tools to place turbines within a specified
 boundary area to optimize annual energy production (AEP) or wind plant value. Layout
@@ -59,8 +59,8 @@ turbine placement
 - Set up to run cheap constraint checks prior to more expensive objective function evaluations
 to accelerate optimization
 
-The algorithm, described in full in an upcoming paper that will be linked here when it is
-publicly available, moves a random turbine and random distance in a random direction; checks
+The algorithm, described in full in {cite:t}`SinnerFleming2024grs`,
+moves a random turbine and random distance in a random direction; checks
 that constraints are satisfied; evaluates the objective function (AEP or value); and then
 commits to the move if there is an objective function improvement. The main tuning parameter
 is the probability mass function for the random movement distance, which is a dictionary to be

diff --git a/docs/references.bib b/docs/references.bib
@@ -272,3 +272,17 @@ @Article{bay_2022
 URL = {https://wes.copernicus.org/preprints/wes-2022-17/},
 DOI = {10.5194/wes-2022-17}
 }
+
+@article{SinnerFleming2024grs,
+doi = {10.1088/1742-6596/2767/3/032036},
+url = {https://dx.doi.org/10.1088/1742-6596/2767/3/032036},
+year = {2024},
+month = {jun},
+publisher = {IOP Publishing},
+volume = {2767},
+number = {3},
+pages = {032036},
+author = {Michael Sinner and Paul Fleming},
+title = {Robust wind farm layout optimization},
+journal = {Journal of Physics: Conference Series},
+}
diff --git a/floris/optimization/layout_optimization/layout_optimization_random_search.py b/floris/optimization/layout_optimization/layout_optimization_random_search.py
@@ -140,7 +140,8 @@ def __init__(
         use_value=False,
     ):
         """
-        _summary_
+        Optimize layout using genetic random search algorithm. Details of the algorithm can be found
+        in Sinner and Fleming, 2024: https://dx.doi.org/10.1088/1742-6596/2767/3/032036
 
         Args:
             fmodel (_type_): _description_