Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

proposed wake model ontology #62

Open
wants to merge 1 commit into
base: develop
Choose a base branch
from
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
142 changes: 142 additions & 0 deletions windIO/plant/wind_energy_system.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -26,6 +26,148 @@ properties:
description: Specific attributes of the entire wind energy system
type: object
properties:

#~~
flow_model:
title: Flow model
description: Flow model used in wind farm design
type: object
additionalProperties: true
properties:
name:
title: Flow model name
type: string
enum: ["foxes", "pyWake", "pyWakeEllipSys", "codeSaturne", "wayve", "floris"]
analyses:
wind_deficit_model:
title: Wind deficit model
description: Wake wind deficit model used in AEP calculations
type: object
additionalProperties: true # to be set to False in a future release
properties:
name:
title: Wake model name
type: string
enum: ["Jensen", "Bastankhah2014", "Bastankhah2016", "TurbOPark"]
wake_expansion_coefficient:
title: wake expansion coefficient
type: object
properties:
k_a:
title: Wake expansion coefficient
type: float # (default 0.04)
k_b:
title: Factor to multiply TI
type: float # (default 0)
free_stream_ti:
title: Flag deciding to use freestream or waked TI
type: bool # (default to False)
ceps:
title: Bastankhah c_epsilon factor
type: float
use_effective_ws:
title: flag to use freestream wind speed for deficit computation
type: bool

axial_induction_model:
title: axial induction model
type: string
enum: ["1D", "Madsen"]

deflection_model:
title: Deflection model
description: defines the deviation of the path of the wake centerline in the crossflow direction (only for wake steering)
#description: Deflection model used in AEP calculations
type: object
additionalProperties: true
properties:
name:
title: Deflection model name
type: string
enum: ["None", "Jimenez", "Batankhah2016"]
beta:
title: Jimenez deflection coefficient
type: float
# (Batankhah2016 only works with Batankhah2016 wind deficit)

turbulence_model:
title: Turbulence model
description: Turbulence model used in AEP calculations
type: object
additionalProperties: true
properties:
name:
title: Turbulence model name
type: string
enum: ["STF2005", "STF2017", "IEC-TI-2019", "CrespoHernandez", "GCL"]
# Q: IEC versus Franson
# note: We assume same shape as wind deficit for now
coefficents:
title: coefficients
type: array

superposition_model:
title: Superposition model
description: Superposition model used in AEP calculations
type: object
additionalProperties: true
properties:
ws_superposition:
title: Speed superposition model name
type: string
enum: ["Linear", "Squared", "Max", "Product"]
ti_superposition:
title: TI superposition model name
type: string
enum: ["Linear", "Squared", "Max", "Product"]

rotor_averaging:
title: Rotor average
description: Rotor averaging model used in AEP calculations
type: object
additionalProperties: true
properties:
grid:
title: Grid type
type: string
n_x_grid_points:
title: Number of x grid points
type: integer
n_y_grid_points:
title: Number of y grid points
type: integer
background_averaging: # (velocity and TI)
title: Averaging model for background velocity and TI
type: string
enum: ["center", "grid"]
wake averaging: # velocity and TI averaging
title: Averaging model for wake velocity and TI
type: string
enum: ["center", 'grid'] # Assume the grid is not used for tophat model because analytic solution is available
wind_speed_exponent_for_power:
type: int
wind_speed_exponent_for_ct:
type: int


blockage_model:
title: Blockage model
description: Blockage averaging model used in AEP calculations
type: object
additionalProperties: true
properties:
name:
title: Blockage model name
type: string
enum: ['None', 'RankineHalfBody', 'Rathmann', 'SelfSimilarityDeficit', 'SelfSimilarityDeficit2020']
parameters:
title: Blockage Model Parameters
type: array
#ss_alpha:
# title: ss_alpha factor for SelfSimilarityDeficit2020
# type: float


#~~
net_AEP:
title: Net AEP for the plant/site
Expand Down
Loading