suitability {ALUES}

Suitability Scores/Class of the Land Units

Description

This function calculates the suitability scores and class of the land units.

Usage

suitability(
  x,
  y,
  mf = "triangular",
  sow_month = NULL,
  minimum = NULL,
  maximum = "average",
  interval = NULL,
  sigma = NULL
)

Arguments

x

a data frame consisting the properties of the land units;

y

a data frame consisting the requirements of a given characteristics (terrain, soil, water and temperature) for a given crop (e.g. coconut, cassava, etc.);

mf

membership function with default assigned to "triangular" fuzzy model. Other fuzzy models included are "trapezoidal" and "gaussian".

sow_month

sowing month of the crop. Takes integers from 1 to 12 (inclusive), representing the twelve months of the year. So if sets to 1, the function assumes sowing month to be January.

minimum

factor's minimum value. If NULL (default), minimum is set to 0. But if numeric of length one, say 0.5, then minimum is set to 0.5, for all factors. To set multiple minimums for multiple factors, simply concatenate these into a numeric vector, the length of this vector should be equal to the number of factors in input land units parameters. However, it can also be set to "average", please refer to the online documentation for more, link in the "See Also" section below.

maximum

maximum value for factors. To set multiple maximums for multiple factors, simply concatenate these into a numeric vector, the length of this vector should be equal to the number of factors in input land units parameters. However, it can also be set to "average", please refer to the online documentation for more, link in the "See Also" section below.

interval

domains for every suitability class (S1, S2, S3). If fixed (NULL), the interval would be 0 to 25% for N (Not Suitable), 25% to 50% for S3 (Marginally Suitable), 50% to 75% for S2 (Moderately Suitable), and 75% to 100% for (Highly Suitable). If "unbias", the package will take into account the shape of the membership function, and provide the appropriate suitability class intervals. However, it can also be customized by specifying the limits of the suitability classes. Please refer to the online documentation for more, link in the "See Also" section below.

sigma

If mf = "gaussian", then sigma represents the constant sigma in the Gaussian formula.

Value

A list with the following components:

• "Factors Evaluated" - a character of factors that matched between the input land units factor and the targetted crop requirement factor

• "Suitability Score" - a data frame of suitability scores for each of the matched factors

• "Suitability Class" - a data frame of suitability classes for each of the matched factors

• "Factors' Minimum Values" - a numeric of minimum values used in the membership function for computing the suitability scores

• "Factors' Minimum Values" - a numeric of maximum values used in the membership function for computing the suitability scores

• "Factors' Weights" - a numeric of weights of the factors specified in the input crop requirements

• "Crop Evaluated" - a character of the name of the targetted crop requirement dataset

#' @seealso https://alstat.github.io/ALUES/