The initiating function of an optimization run which will interactively check user-inputs. If all inputs are correct, an optimization will be started.
windfarmGA(
dns,
layer,
Polygon1,
GridMethod,
Projection,
sourceCCL,
sourceCCLRoughness,
vdirspe,
Rotor = 30,
fcrR = 5,
n = 10,
topograp = FALSE,
iteration = 20,
referenceHeight = 50,
RotorHeight = 50,
SurfaceRoughness = 0.14,
Proportionality = 1,
mutr = 0.008,
elitism = TRUE,
nelit = 7,
selstate = "FIX",
crossPart1 = "EQU",
trimForce = TRUE,
weibull,
weibullsrc,
Parallel,
numCluster,
verbose = FALSE,
plotit = FALSE
)The data source name (interpretation varies by driver <U+2014> for some drivers, dsn is a file name, but may also be a folder)
The layer name
The considered area as SpatialPolygon, SimpleFeature Polygon or coordinates as matrix/data.frame
Should the polygon be divided into rectangular or hexagonal grid cells? The default is "Rectangular" grid. Hexagonal grids are computed when assigning "h" or "hexagon" to this input variable.
A spatial reference system. Depending on your PROJ-version,
it should either be a numeric `EPSG-code` or a `Proj4-string`.
Default is EPSG:3035
The path to the Corine Land Cover raster (.tif). Only required when the terrain effect model is activated.
The source to the adapted Corine Land Cover legend
as .csv file. Only required when terrain effect model is activated. As
default a .csv file within this package (~/extdata) is taken that
was already adapted manually.
A data.frame containing the wind speeds, directions and
probabilities. See windata_format.
The rotor radius in meter
A numeric value used for grid spacing. Default is 5
The amount of turbines
Boolean value, which indicates if the terrain effect model
should be enabled or not. Default is FALSE
The number of iterations. Default is 20
The height at which the incoming wind speeds were
measured. Default is RotorHeight
The height of the turbine hub
A surface roughness length in meters.
With the terrain effect model, a surface roughness is calculated for every
grid cell using the elevation and land cover data. Default is 0.3
A numeric value used for the grid calculation, as it
determines the percentage a grid cell must overlay the area.
Default is 1
A numeric mutation rate. Default is 0.008
Boolean value, which indicates whether elitism should be
activated or not. Default is TRUE
If elitism is TRUE, this input determines the amount
of individuals in the elite group. Default is 7
Determines which selection method is used, "FIX" selects a constant percentage and "VAR" selects a variable percentage, depending on the development of the fitness values. Default is "FIX"
Determines which crossover method is used, "EQU" divides
the genetic code at equal intervals and "RAN" divides the genetic code at
random locations. Default is "EQU"
If TRUE the algorithm will use a probabilistic
approach to correct the windfarms to the desired amount of turbines.
If FALSE the adjustment will be random. Default is FALSE
A boolean value that specifies whether to take Weibull
parameters into account. If TRUE, the wind speed values
of vdirspe are ignored. The algorithm will calculate the mean
wind speed for every wind turbine according to the Weibull parameters.
Default is FALSE
A list of Weibull parameter rasters, where the first list
item must be the shape parameter raster `k` and the second item must be the
scale parameter raster `a` of the Weibull distribution. If no list is given,
then rasters included in the package are used instead, which currently only
cover Austria. This variable is only used if weibull = TRUE.
A boolean value, indicating whether parallel processing should
be used. The *parallel* and *doParallel* packages are used for parallel
processing. Default is FALSE
If Parallel is TRUE, this variable defines the
number of clusters to be used. Default is 2
If TRUE it will print information for every generation.
Default is FALSE
If TRUE it will plot the best windfarm of every generation.
Default is FALSE
The result is a matrix with aggregated values per generation; the best individual regarding energy and efficiency per generation, some fuzzy control variables per generation, a list of all fitness values per generation, the amount of individuals after each process, a matrix of all energy, efficiency and fitness values per generation, the selection and crossover parameters, a matrix with the generational difference in maximum and mean energy output, a matrix with the given inputs, a dataframe with the wind information, the mutation rate per generation and a matrix with all tested wind farm layouts.
A terrain effect model can be included in the optimization process.
Therefore, a digital elevation model will be downloaded automatically via the
elevatr::get_elev_raster function. A land cover raster can also be
downloaded automatically from the EEA-website, or the path to a raster file
can be passed to sourceCCL. The algorithm uses an adapted version of the
Raster legend ("clc_legend.csv"), which is stored in the package directory
~/inst/extdata. To use other values for the land cover roughness
lengths, insert a column named "Rauhigkeit_z" to the .csv file,
assign a surface roughness length to all land cover types. Be sure that all
rows are filled with numeric values and save the file with ";"
separation. Assign the path of the file to the input variable
sourceCCLRoughness of this function.
Other Genetic Algorithm Functions:
crossover(),
fitness(),
genetic_algorithm(),
init_population(),
mutation(),
selection(),
trimton()