This function computes Functional Evenness (FEve) following Villéger et al.
(2008). NB: By definition FEve is equal to `NA`

when the number of species
per site is strictly lower than 3.

## Arguments

- traits
Trait matrix with species as rows and traits as columns. It has to contain exclusively numerical values. This can be either a

`matrix`

, a`data.frame`

, or a`Matrix::Matrix()`

object.- sp_com
Site-species matrix with sites as rows and species as columns if not provided, the function considers all species with equal abundance in a single site. This can be either a

`matrix`

, a`data.frame`

, or a`Matrix::Matrix()`

object.- dist_matrix
A dissimilarity matrix that can be provided instead of a trait data.frame (default:

`NULL`

). This can be either a`matrix`

, a`data.frame`

, or a`Matrix::Matrix()`

object.

## Value

a data.frame with two columns:

`site`

character column that contains site names based on input`sp_com`

row names,`FEve`

numeric column that contains FEve values corresponding to each site.

If the `sp_com`

argument is not provided or if `sp_com`

doesn't have rownames,
arbitrary rownames `s1`

, `s2`

, `s3`

, etc. will be used.

NB: By definition FEve is equal to `NA`

when the number of species per site
is strictly lower than 3.

## Parallelization

The computation of this function can be parallelized thanks to
`future::plan()`

. To get more information on how to parallelize your
computation please refer to the parallelization vignette with:
`vignette("fundiversity_1-parallel", package = "fundiversity")`

.

## References

Villéger, S., Mason, N.W.H., Mouillot, D., 2008. New Multidimensional Functional Diversity Indices for a Multifaceted Framework in Functional Ecology. Ecology 89, 2290–2301. doi:10.1890/07-1206.1

## Examples

```
data(traits_birds)
fd_feve(traits_birds)
#> site FEve
#> 1 s1 0.3743341
```