Plant Schema#
Type: objectA file used as input or output of a wind farm model
Name
Type: stringName of the wind energy system
definition of a site
Type: objectA file used as input or output of a wind plant model (for overall energy production estimation)
Name
Type: stringName of the plant site
Boundaries
Definition of the site boundaries
The following properties are required:
- polygons
The following properties are required:
- circle
Polygons
Type: arrayA group of polygons that define the site boundary
Must contain a minimum of 1
items
Each item of this array must be:
Circle
Type: objectA circle
Center
Type: objectThe center coordinate of a circle
X coordinate
Type: numberWest-East coordinate
Units: m
Y coordinate
Type: numberSouth-North coordinate
Units: m
(Optional) Z coordinate
Type: numberHeight coordinate
Units: m
(Optional) Coordinate reference system
Type: stringCoordinate reference system described as a PROJ string
Radius
Type: numberThe radius of a circle
Units: m
Exclusions
Definition of any site exclusions
The following properties are required:
- polygons
The following properties are required:
- circle
Polygons
Type: array of objectA group of polygons that define the site exclusions
Must contain a minimum of 1
items
Each item of this array must be:
Circle
Type: objectA circle
Center
Type: objectThe center coordinate of a circle
X coordinate
Type: numberWest-East coordinate
Units: m
Y coordinate
Type: numberSouth-North coordinate
Units: m
(Optional) Z coordinate
Type: numberHeight coordinate
Units: m
(Optional) Coordinate reference system
Type: stringCoordinate reference system described as a PROJ string
Radius
Type: numberThe radius of a circle
Units: m
Energy resource
Type: objectTODO
Name
Type: stringName of the plant resource
Wind resource
Resource where data optionally depend on windspeed, winddirection and/or position
The following properties are required:
- probability
The following properties are required:
- weibull_a
- weibull_k
- sector_probability
The following properties are required:
- time
- wind_speed
- wind_direction
Timestamps for the data points
Data with custom dimensions
Type: arrayNo Additional Items
Each item of this array must be:
Data with custom dimensions
Type: objectWind directions
Wind directions in degrees, [0,360]
Data with custom dimensions
Type: objectNo Additional Items
Each item of this array must be:
No Additional Items
No Additional Items
Wind speeds in m/s
Wind turbine IDs
Type: objectWind turbine id
Data with custom dimensions
Type: arrayNo Additional Items
Each item of this array must be:
Data with custom dimensions
Type: objectWest-East position
South-North position
Reference height
Probability of flow cases [0,1]
Same definition as site_energy_resource_wind_resource_wind_direction_oneOf_i0Weibull scale
Type: objectData with custom dimensions
Type: objectNo Additional Items
Each item of this array must be:
No Additional Items
No Additional Items
Weibull shape
Type: objectData with custom dimensions
Type: objectNo Additional Items
Each item of this array must be:
No Additional Items
No Additional Items
probability of wind directions
Type: objectProbability of wind sector [0,1]
Data with custom dimensions
Type: objectNo Additional Items
Each item of this array must be:
No Additional Items
No Additional Items
Turbulence intensity
Type: objectData with custom dimensions
Type: objectNo Additional Items
Each item of this array must be:
No Additional Items
No Additional Items
Reference height
Type: numberShear
Type: objectMonin-Obukhov length (m)
Type: objectData with custom dimensions
Type: objectNo Additional Items
Each item of this array must be:
No Additional Items
No Additional Items
Roughness height (m)
Type: objectData with custom dimensions
Type: objectNo Additional Items
Each item of this array must be:
No Additional Items
No Additional Items
Turbulent kinetic energy
Type: objectData with custom dimensions
Type: objectNo Additional Items
Each item of this array must be:
No Additional Items
No Additional Items
Turbulent dissipation
Type: objectData with custom dimensions
Type: objectNo Additional Items
Each item of this array must be:
No Additional Items
No Additional Items
Potential Temperature (K)
Type: objectData with custom dimensions
Type: objectNo Additional Items
Each item of this array must be:
No Additional Items
No Additional Items
Friction velocity (m/s)
Type: objectData with custom dimensions
Type: objectNo Additional Items
Each item of this array must be:
No Additional Items
No Additional Items
Ground Temperature (K)
Type: objectTemperature of the ground in Kelvin
Data with custom dimensions
Type: objectNo Additional Items
Each item of this array must be:
No Additional Items
No Additional Items
Stability of the atmosphere
Type: objectRoughness length in meters
Data with custom dimensions
Type: objectNo Additional Items
Each item of this array must be:
No Additional Items
No Additional Items
atmoshpheric boundary layer height
Type: objectData with custom dimensions
Type: objectNo Additional Items
Each item of this array must be:
No Additional Items
No Additional Items
Capping inversion thickness in units of meters
Type: objectData with custom dimensions
Type: objectNo Additional Items
Each item of this array must be:
No Additional Items
No Additional Items
capping inversion strength in units of Kelvin
Type: objectData with custom dimensions
Type: objectNo Additional Items
Each item of this array must be:
No Additional Items
No Additional Items
capping inversion height in units of meters
Type: objectData with custom dimensions
Type: objectNo Additional Items
Each item of this array must be:
No Additional Items
No Additional Items
lapse rate in units of K/m
Type: objectData with custom dimensions
Type: objectNo Additional Items
Each item of this array must be:
No Additional Items
No Additional Items
Coriolis Parameter
Type: objectData with custom dimensions
Type: objectNo Additional Items
Each item of this array must be:
No Additional Items
No Additional Items
Sheer stress x
Type: objectData with custom dimensions
Type: objectNo Additional Items
Each item of this array must be:
No Additional Items
No Additional Items
Sheer stress y
Type: objectData with custom dimensions
Type: objectNo Additional Items
Each item of this array must be:
No Additional Items
No Additional Items
Bathymetry
Type: objectx, y, and depth field of water depth
Coordinates
Type: objectAn array of x and y coordinates associated with different depths
Same definition as CoordinatesNo Additional Items
Each item of this array must be:
An array of depth values
Units: m
Elevation
Type: objectTODO
Roads
Type: objectTODO
Definition of the wind energy conversion system
Type: objectA file used to define either a single wind farm or multiple wind farms with turbine type mappings and additional built environment components
Name of the wind farm or wind farm system
Position of wind turbines. Supports single or multiple layouts.
No Additional Items
Each item of this array must be:
(Optional) List of turbine types corresponding to turbine positions.
No Additional ItemsEach item of this array must be:
List of turbine id/tags
No Additional ItemsEach item of this array must be:
Turbine Definition
Type: object(Optional) The full turbine definition for the entire wind farm
Name
Type: stringName of the turbine definition
Performance
Definition of the turbine performance characteristics
The following properties are required:
- Cp_curve
- Ct_curve
The following properties are required:
- power_curve
- Ct_curve
The following properties are required:
- rated_power
- rated_wind_speed
- cutin_wind_speed
- cutout_wind_speed
- Ct_curve
Rated wind speed
Type: numberUnits: m/s
Cut-in wind speed
Type: numberUnits: m/s
Cut-out wind speed
Type: numberUnits: m/s
Rated speed
Type: numberUnits: W
Generator Efficiency
Type: numberThe efficiency of converting mechanical to electrical power
Value must be greater or equal to 0
and lesser or equal to 1
Hub height
Type: numberUnits: m
Rotor diameter
Type: numberUnits: m
Tip-speed ratio
Type: number(Optional) List of turbine types used for layouts. Required if turbine_types is used in layouts.
Each additional property must conform to the following schema
Turbine Definition
Type: objectA simplified (from the turbine schema) definition of the turbines used in the plant.
Same definition as turbinesInformation about electrical substations
No Additional ItemsEach item of this array must be:
Electrical substation
Type: objectSubstation capacity
Type: numberCapacity of the electrical substation in megawatts
Units: MW
Electrical collection array
Type: objectDefinition of electrical collection array (cable layout) for wind farm.
Edges of cable layout
Type: arrayList of edges (branches) in the cable layout [[fromnode, tonode, cable_type], ...].
No Additional ItemsCables
Type: objectList of the cables
Cable type
Type: arrayList of available cable types
Units: mm^2
Cross section
Type: arrayList of cable cross sections
Units: mm^2
Cable capacity
Type: arrayList of cable capacities
No Additional ItemsCable cost
Type: arrayList of cable costs
Units: USD/m
Attributes
Type: objectSpecific attributes of the entire wind energy system
Wind deficit model
Type: objectWake wind deficit model used in AEP calculations
Wake model name
Type: enum (of string)Must be one of:
- "Jensen"
- "Bastankhah2014"
- "Bastankhah2016"
- "TurbOPark"
- "SuperGaussian"
Bastankhah c_epsilon factor
Type: numberflag to use freestream wind speed for deficit computation
Type: booleanaxial induction model
Type: enum (of string)Must be one of:
- "1D"
- "Madsen"
Rotor average
Type: objectRotor averaging model used in AEP calculations
Grid type
Type: stringNumber of x grid points
Type: integerNumber of y grid points
Type: integerAveraging model for background velocity and TI
Type: enum (of string)Must be one of:
- "center"
- "grid"
Averaging model for wake velocity and TI deficit
Type: enum (of string)Must be one of:
- "center"
- "grid"
Information to handle parallel runs on HPC clusters
Type: objectnumber of nodes used to run the wind farm flow case
Type: integernumber of tasks per node
Type: integerwall time for each run
Type: integerrun partition name
Type: stringwckey name if any
Type: stringnumber of nodes used to run the wind farm flow case
Type: integernumber of tasks per node
Type: integerwall time for each run
Type: integerrun partition name
Type: stringtype of run with the flow api
Type: enum (of string)Must be one of:
- "simulate"
- "postprocess"
list of terms added to the APM model
Type: objectmomentum flux parametrization above the farm
Type: objecttype of APM momentum flux parametrization
Type: enum (of string)Must be one of:
- "None"
- "constant_flux"
settings for wake model coupling in high-fidelity atmospheric models
Type: objectwake model coupling method
Type: enum (of string)wake model coupling method (see https://dx.doi.org/10.1088/1742-6596/2767/9/092079)
Must be one of:
- "VM"
- "PB"
- "US"
method-specific settings for wake model coupling in atmospheric model
Type: objectRatio of filter length to shape function spacing
Type: numberRatio of filter length to shape function spacing used by the VM method. Has to be specified when using "VM", no effect otherwise.
Upstream distance
Type: numberUpstream distance where the background velocity is evaluated. Has to be specified when using "US", no effect otherwise.
choice of wake tool for coupling to atmospheric flow model
Type: stringsettings for the subgrid on which wake model velocities are defined
Type: objectWhether or not a subgrid is included
Type: booleanWhether or not a subgrid is included. Can not be False when using VM or when using the "subgrid" dispersive stress parametrization.
Ratio of average turbine diameter to subgrid spacing
Type: numberOutputs
Type: objectOutput parameters and configurations for the wind energy system
output folder name
Type: stringname of the folder where the output files are written
Handling of simulation runs
outputs related to each turbine
Type: objectoutputs for each turbine as the individual turbine power, velocity..
Name of the file that will contain the turbine outputs
Type: stringthis is an netcdf file containing the required outputs
Output Variables
Type: array of stringList of turbine variables to output
No Additional ItemsEach item of this array must be:
configuration of the flow field outputs
Type: objectflow field output variables and files
Report
Type: booleanFlag to output flow fields
Name of the file that will contain the flow field
Type: stringthis is an netcdf file containing the required outputs
Output Variables
Type: array of stringList of flow field variables to output
No Additional ItemsEach item of this array must be:
planes at which the flow field variables will be stored
Type: objectdescription of vertical planes
type of vertical discretization
Type: enum (of string)Must be one of:
- "hub_heights"
- "plane_list"
z plane values for sample type 'grid'
Type: array of numberNo Additional Items
Each item of this array must be:
type of horizontal discretization
Type: enum (of string)Must be one of:
- "grid"
- "original_grid"
x bounds for sample type 'grid'
Type: array of numberNo Additional Items
Each item of this array must be:
y bounds for sample type 'grid'
Type: array of numberNo Additional Items
Each item of this array must be:
number of points in the x direction for 'grid'
Type: integernumber of points in the y direction for 'grid'
Type: integerx grid spacing for sample type 'grid'
Type: numbery grid spacing for sample type 'grid'
Type: numberOutputs
Type: objectOutput parameters and configurations for the wind energy system
Output Name
Type: stringName for the output configuration
Flow Field
Type: objectConfiguration for flow field output
Time
Type: array of integerSpecific times for flow field output
No Additional ItemsEach item of this array must be:
Output Variables
Type: array of stringList of flow field variables to output
No Additional ItemsEach item of this array must be:
List of design variables
Type: objectDesign variables of the system
Array of design variables
Type: object😅 ERROR in schema generation, a referenced schema could not be loaded, no documentation here unfortunately 🏜️
Wind turbine types installed
Type: object😅 ERROR in schema generation, a referenced schema could not be loaded, no documentation here unfortunately 🏜️
Number of turbines installed
Type: objectHub heights of installed turbines
Type: objectOptimisation constraints functions
Type: objectList of constraint functions
Minimum inter-turbine spacing
Parcels and exclusion zones
Type: objectList of parcel polygons
Type: objectDefinition of the site boundaries
The following properties are required:
- polygons
The following properties are required:
- circle
Polygons
Type: arrayA group of polygons that define the site boundary
Must contain a minimum of 1
items
Each item of this array must be:
Circle
Type: objectA circle
Center
Type: objectThe center coordinate of a circle
X coordinate
Type: numberWest-East coordinate
Units: m
Y coordinate
Type: numberSouth-North coordinate
Units: m
(Optional) Z coordinate
Type: numberHeight coordinate
Units: m
(Optional) Coordinate reference system
Type: stringCoordinate reference system described as a PROJ string
Radius
Type: numberThe radius of a circle
Units: m
List of exclusion zone polygons
Type: objectDefinition of any site exclusions
The following properties are required:
- polygons
The following properties are required:
- circle
Polygons
Type: array of objectA group of polygons that define the site exclusions
Must contain a minimum of 1
items
Each item of this array must be:
Circle
Type: objectA circle
Center
Type: objectThe center coordinate of a circle
X coordinate
Type: numberWest-East coordinate
Units: m
Y coordinate
Type: numberSouth-North coordinate
Units: m
(Optional) Z coordinate
Type: numberHeight coordinate
Units: m
(Optional) Coordinate reference system
Type: stringCoordinate reference system described as a PROJ string
Radius
Type: numberThe radius of a circle
Units: m
Initial layout
Type: objectA file used to define either a single wind farm or multiple wind farms with turbine type mappings and additional built environment components
Name of the wind farm or wind farm system
Position of wind turbines. Supports single or multiple layouts.
No Additional Items
Each item of this array must be:
(Optional) List of turbine types corresponding to turbine positions.
No Additional ItemsEach item of this array must be:
List of turbine id/tags
No Additional ItemsEach item of this array must be:
Turbine Definition
Type: object(Optional) The full turbine definition for the entire wind farm
Same definition as turbines(Optional) List of turbine types used for layouts. Required if turbine_types is used in layouts.
Each additional property must conform to the following schema
Turbine Definition
Type: objectA simplified (from the turbine schema) definition of the turbines used in the plant.
Same definition as turbinesInformation about electrical substations
No Additional ItemsEach item of this array must be:
Electrical collection array
Type: objectDefinition of electrical collection array (cable layout) for wind farm.
Edges of cable layout
Type: arrayList of edges (branches) in the cable layout [[fromnode, tonode, cable_type], ...].
No Additional ItemsCables
Type: objectList of the cables
Cable type
Type: arrayList of available cable types
Units: mm^2
Cross section
Type: arrayList of cable cross sections
Units: mm^2
Cable capacity
Type: arrayList of cable capacities
No Additional ItemsCable cost
Type: arrayList of cable costs
Units: USD/m
Initial turbine types
Type: objectInitial number turbines
Type: objectInitial turbine hub heights
Type: objectFinal layout
Type: objectA file used to define either a single wind farm or multiple wind farms with turbine type mappings and additional built environment components
Name of the wind farm or wind farm system
Position of wind turbines. Supports single or multiple layouts.
No Additional Items
Each item of this array must be:
(Optional) List of turbine types corresponding to turbine positions.
No Additional ItemsEach item of this array must be:
List of turbine id/tags
No Additional ItemsEach item of this array must be:
Turbine Definition
Type: object(Optional) The full turbine definition for the entire wind farm
Same definition as turbines(Optional) List of turbine types used for layouts. Required if turbine_types is used in layouts.
Each additional property must conform to the following schema
Turbine Definition
Type: objectA simplified (from the turbine schema) definition of the turbines used in the plant.
Same definition as turbinesInformation about electrical substations
No Additional ItemsEach item of this array must be:
Electrical collection array
Type: objectDefinition of electrical collection array (cable layout) for wind farm.
Edges of cable layout
Type: arrayList of edges (branches) in the cable layout [[fromnode, tonode, cable_type], ...].
No Additional ItemsCables
Type: objectList of the cables
Cable type
Type: arrayList of available cable types
Units: mm^2
Cross section
Type: arrayList of cable cross sections
Units: mm^2
Cable capacity
Type: arrayList of cable capacities
No Additional ItemsCable cost
Type: arrayList of cable costs
Units: USD/m