Merge pull request #656 from NREL/develop

FLORIS v3.4

Author: rafmudaf

.github/ISSUE_TEMPLATE/bug_report.md

@@ -17,6 +17,10 @@ This form is written in GitHub's Markdown format. For a reference on this type
 of syntax, see GitHub's documentation:
 https://docs.github.com/en/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax
 
+This template contains guidance for your submission within the < ! - -, - - > blocks.
+These are comments in HTML syntax and will not appear in the submission.
+Be sure to use the "Preview" feature on GitHub to ensure your submission is formatted as intended.
+
 When including code snippets, please paste the text itself and wrap the code block with
 ticks (see the other character on the tilde ~ key in a US keyboard) to format it as code.
 For example, Python code should be wrapped in ticks like this:

.github/ISSUE_TEMPLATE/feature_request.md

@@ -16,6 +16,10 @@ This form is written in GitHub's Markdown format. For a reference on this type
 of syntax, see GitHub's documentation:
 https://docs.github.com/en/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax
 
+This template contains guidance for your submission within the < ! - -, - - > blocks.
+These are comments in HTML syntax and will not appear in the submission.
+Be sure to use the "Preview" feature on GitHub to ensure your submission is formatted as intended.
+
 When including code snippets, please paste the text itself and wrap the code block with
 ticks (see the other character on the tilde ~ key in a US keyboard) to format it as code.
 For example, Python code should be wrapped in ticks like this:

.github/PULL_REQUEST_TEMPLATE.md

@@ -14,6 +14,10 @@ This form is written in GitHub's Markdown format. For a reference on this type
 of syntax, see GitHub's documentation:
 https://docs.github.com/en/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax
 
+This template contains guidance for your submission within the < ! - -, - - > blocks.
+These are comments in HTML syntax and will not appear in the submission.
+Be sure to use the "Preview" feature on GitHub to ensure your submission is formatted as intended.
+
 When including code snippets, please paste the text itself and wrap the code block with
 ticks (see the other character on the tilde ~ key in a US keyboard) to format it as code.
 For example, Python code should be wrapped in ticks like this:

.github/workflows/check-working-examples.yaml

@@ -8,7 +8,7 @@ jobs:
     runs-on: ${{ matrix.os }}
     strategy:
       matrix:
-        python-version: [3.9]
+        python-version: ["3.10"]
         os: [ubuntu-latest] #, macos-latest, windows-latest]
       fail-fast: False
 
@@ -21,7 +21,6 @@ jobs:
     - name: Install project
       run: |
         python -m pip install --upgrade pip
-        pip install -r requirements.txt
         pip install -e .
         pip install nbconvert  # For converting Jupyter notebook to python script in the next step
     - name: Run examples

.github/workflows/continuous-integration-workflow.yaml

@@ -8,9 +8,11 @@ jobs:
     runs-on: ${{ matrix.os }}
     strategy:
       matrix:
-        python-version: [3.9]
+        python-version: ["3.8", "3.9", "3.10"]
         os: [ubuntu-latest] #, macos-latest, windows-latest]
       fail-fast: False
+    env:
+      CODECOV_TOKEN: ${{ secrets.CODECOV_TOKEN }}
 
     steps:
     - uses: actions/checkout@v3
@@ -38,8 +40,9 @@ jobs:
         pip install pytest-cov
         pytest --cov=./ --cov-report=xml tests/ --ignore tests/reg_tests --ignore tests/timing.py --ignore tests/profiling.py
     - name: Upload coverage to Codecov
+      if: ${{ env.CODECOV_TOKEN }}  # Don't attempt to upload if the codecov token is not configured
       uses: codecov/codecov-action@v3
       with:
-        token: ${{ secrets.CODECOV_TOKEN }}
+        token: ${{ env.CODECOV_TOKEN }}
         files: ./coverage.xml
         fail_ci_if_error: true

.github/workflows/deploy-pages.yaml

@@ -15,15 +15,14 @@ jobs:
     - uses: actions/checkout@v2
 
     # Install dependencies
-    - name: Set up Python 3.8
-      uses: actions/setup-python@v2
+    - name: Set up Python
+      uses: actions/setup-python@v4
       with:
-        python-version: 3.8
+        python-version: "3.10"
 
     - name: Install dependencies
       run: |
-        pip install -r docs/requirements.txt
-        pip install -e .
+        pip install -e ".[docs]"
 
     # Build the book
     - name: Build the book

.github/workflows/quality-metrics-workflow.yaml

@@ -8,7 +8,7 @@ jobs:
     runs-on: ${{ matrix.os }}
     strategy:
       matrix:
-        python-version: [3.9]
+        python-version: ["3.10"]
         os: [ubuntu-latest]
       fail-fast: False
 

.gitignore

@@ -3,11 +3,13 @@
 __pycache__/
 .cache
 *.ipynb
+*.ipynb_checkpoints
 *.pyc
 *.egg-info
 dist
 build
 .pytest_cache
+.ruff_cache
 
 # pip meta data
 pip-wheel-metadata

.pre-commit-config.yaml

@@ -7,13 +7,11 @@ repos:
   - id: trailing-whitespace
   - id: end-of-file-fixer
   - id: check-executables-have-shebangs
-  - id: check-json
   - id: check-yaml
+    args: [--unsafe]
   - id: check-merge-conflict
   - id: check-symlinks
   - id: mixed-line-ending
-  # - id: pretty-format-json
-  #   args: [--autofix, --no-sort-keys]
 
 - repo: https://github.com/charliermarsh/ruff-pre-commit
   rev: v0.0.241

docs/_config.yml

@@ -4,8 +4,8 @@
 title: FLORIS
 author: National Renewable Energy Laboratory
 logo: gch.gif
-copyright: '2022'
-only_build_toc_files: true
+copyright: '2023'
+only_build_toc_files: false
 
 # Force re-execution of notebooks on each build.
 # See https://jupyterbook.org/content/execute.html
@@ -23,7 +23,7 @@ bibtex_bibfiles:
 
 # Information about where the book exists on the web
 repository:
-  url: https://github.com/nrel/floris
+  url: https://github.com/NREL/floris
   path_to_book: docs
   branch: main
 
@@ -45,6 +45,7 @@ sphinx:
   - 'sphinx_autodoc_typehints'
   - 'sphinxcontrib.autoyaml'
   - 'sphinx.ext.napoleon'       # Formats google and numpy docstring styles
+  - 'sphinxcontrib.mermaid'
   config:
     html_theme: sphinx_book_theme
     templates_path: