Title: | Access to the Global Inventory of Floras and Traits (GIFT) |
---|---|
Description: | Retrieving regional plant checklists, species traits and distributions, and environmental data from the Global Inventory of Floras and Traits (GIFT). More information about the GIFT database can be found at <https://gift.uni-goettingen.de/about> and the map of available floras can be visualized at <https://gift.uni-goettingen.de/map>. The API and associated queries can be accessed according the following scheme: <https://gift.uni-goettingen.de/api/extended/index2.0.php?query=env_raster>. |
Authors: | Pierre Denelle [aut, cre] , Patrick Weigelt [aut] |
Maintainer: | Pierre Denelle <[email protected]> |
License: | GPL (>= 2) |
Version: | 1.3.2 |
Built: | 2024-11-11 10:37:12 UTC |
Source: | https://github.com/biogeomacro/gift |
Retrieve GIFT checklists that fulfill specific criteria.
GIFT_checklists( taxon_name = "Tracheophyta", complete_taxon = TRUE, floristic_group = c("all", "native", "endemic", "naturalized")[2], complete_floristic = TRUE, geo_type = c("All", "Mainland", "Island")[1], ref_excluded = NULL, suit_geo = FALSE, shp = NULL, coordinates = NULL, overlap = "centroid_inside", remove_overlap = FALSE, area_threshold_island = 0, area_threshold_mainland = 100, overlap_threshold = 0.1, by_ref_ID = FALSE, taxonomic_group = TRUE, namesmatched = FALSE, list_set_only = FALSE, GIFT_version = "latest", api = "https://gift.uni-goettingen.de/api/extended/" )
GIFT_checklists( taxon_name = "Tracheophyta", complete_taxon = TRUE, floristic_group = c("all", "native", "endemic", "naturalized")[2], complete_floristic = TRUE, geo_type = c("All", "Mainland", "Island")[1], ref_excluded = NULL, suit_geo = FALSE, shp = NULL, coordinates = NULL, overlap = "centroid_inside", remove_overlap = FALSE, area_threshold_island = 0, area_threshold_mainland = 100, overlap_threshold = 0.1, by_ref_ID = FALSE, taxonomic_group = TRUE, namesmatched = FALSE, list_set_only = FALSE, GIFT_version = "latest", api = "https://gift.uni-goettingen.de/api/extended/" )
taxon_name |
Character string corresponding to the taxonomic group of interest. |
complete_taxon |
logical stating you want to retrieve checklists that
only contain the exhaustive list of the |
floristic_group |
Character among the following options: |
complete_floristic |
logical stating you want to retrieve checklists
that only contain the exhaustive list of the |
geo_type |
Character string, either |
ref_excluded |
A vector listing potential ref_IDs that shall be ignored when assembling the set of regions and checklists fulfilling the given criteria. Checklists from these references will not be returned. NULL by default. |
suit_geo |
logical indicating whether only regions classified as suit_geo should be considered (see details). |
shp |
Shapefile provided by the user. |
coordinates |
Custom set of coordinates. The format is a two columns data.frame, the first one being longitudes and the second being latitudes of the vertices of a polygon. If the data.frame only includes two rows, the function assumes that the values are the four limits (min and max. longitude and latitude) of a bounding box. |
overlap |
A character string defining the criteria to use in order to
retrieve checklists. Available options are |
remove_overlap |
a logical stating whether you want to retrieve checklists that overlap or not. |
area_threshold_island |
A number stating from which surface the smallest overlapping polygon is kept. By default set to 0 square kilometer (meaning that by default the smallest islands will be conserved). |
area_threshold_mainland |
When two polygons overlap, the smallest or the biggest one can be kept. When the surface of the smallest polygon exceeds this number, the smallest polygon is kept. Otherwise, we keep the bigger one. Set by default 100 square-kilometers. |
overlap_threshold |
A number ranging from 0 to 1, indicating at what percentage of overlap, partially overlapping polygons should be kept. |
by_ref_ID |
logical indicating whether the removal of overlapping regions shall be applied by ref_ID only. Note that regions overlapping with other regions from the same resource will be removed even if there are other references available for those regions. |
taxonomic_group |
logical. When set to |
namesmatched |
logical. |
list_set_only |
logical stating whether you only want the metadata or if you also want to retrieve the species lists. |
GIFT_version |
character string defining the version of the GIFT
database to use. The function retrieves by default the |
api |
character string defining from which API the data will be retrieved. |
Here is the detail of each data.frame and their columns:
ref_ID - Identification number of each reference.
type- What type the source is.
subset- What information regarding the status of species is
available.
native_indicated- Whether native status of species is available in
the source.
natural_indicated - Whether naturalized status of species is
available in the source.
end_ref - Whether endemism information is available in the
source.
restricted - Whether the access to this reference is
restricted.
taxon_ID- Identification number of species.
list_ID - Identification number of each list.
end_list - Whether endemism information is available in the list.
entity_ID- Identification number of the polygon of the list.
geo_entity - Name of the location.
suit_geo - Is the polygon suitable.
entity_class - Type of polygon.
entity_type - Name of the location.
taxon_name - Name of the group of taxa available.
For the second data frame with the species, each column refers to:
ref_ID - Identification number of each reference.
list_ID - Identification number of each list
work_ID - Identification number of each species name, after taxonomic
harmonization.
genus_ID - Identification number of each genus, after taxonomic
harmonization.
species - Species name, after taxonomic harmonization.
questionable - Whether the species occurrence is questionable.
native - Whether the species is native.
quest_native - Whether the native information is questionable.
naturalized - Whether the species is naturalized.
endemic_ref - Whether the species is endemic within the reference.
quest_end_ref - Whether the endemic_ref information is
questionable.
endemic_list - Whether the species is endemic within the list.
quest_end_list - Whether the endemic_list information is
questionable.
cons_status - Conservation status of the species.
family - Family of the species.
tax_group - Taxonomic group of the species.
While the arguments taxon_name
in combination with complete_taxon = TRUE
and floristic_group
in combination with complete_floristic = TRUE
make
sure to only get back checklists for regions for which GIFT has lists
aiming at covering both the entire taxonomic group and floristic subset (for
example native vascular plants), it does not mean that the checklists are
complete (include all species). We therefore flagged regions in GIFT for
which the combination of all checklists is obviously incomplete as
suit_geo = 0
. This has however only been done only for native angiosperms
and the assessment has been subjective. Set suit_geo = TRUE
if you only
want to consider regions classified as suit_geo
.
List with two data frames: the checklist with species and the list of ID.
Denelle, P., Weigelt, P., & Kreft, H. (2023). GIFT—An R package to access the Global Inventory of Floras and Traits. Methods in Ecology and Evolution, 14, 2738-2748. https://doi.org/10.1111/2041-210X.14213 Weigelt, P, König, C, Kreft, H. GIFT – A Global Inventory of Floras and Traits for macroecology and biogeography. J Biogeogr. 2020; 47: 16– 43. https://doi.org/10.1111/jbi.13623
data("western_mediterranean") ex <- GIFT_checklists(shp = western_mediterranean, overlap = "centroid_inside", taxon_name = "Angiospermae", list_set_only = TRUE) # set to FALSE to get species composition
data("western_mediterranean") ex <- GIFT_checklists(shp = western_mediterranean, overlap = "centroid_inside", taxon_name = "Angiospermae", list_set_only = TRUE) # set to FALSE to get species composition
Retrieve meta data of GIFT checklists for regions that are covered by checklists jointly fulfilling specific criteria.
GIFT_checklists_conditional( taxon_name = "Tracheophyta", floristic_scope = c("all", "native", "native and naturalized", "native and historically introduced", "endangered", "endemic", "naturalized", "other subset")[1:4], ref_excluded = NULL, type_ref = c("Account", "Catalogue", "Checklist", "Flora", "Herbarium collection", "Key", "Red list", "Report", "Species Database", "Survey"), entity_class = c("Island", "Island/Mainland", "Mainland", "Island Group", "Island Part"), native_indicated = FALSE, natural_indicated = FALSE, end_ref = FALSE, end_list = FALSE, suit_geo = FALSE, complete_taxon = TRUE, GIFT_version = "latest", api = "https://gift.uni-goettingen.de/api/extended/", list_set = NULL, taxonomy = NULL )
GIFT_checklists_conditional( taxon_name = "Tracheophyta", floristic_scope = c("all", "native", "native and naturalized", "native and historically introduced", "endangered", "endemic", "naturalized", "other subset")[1:4], ref_excluded = NULL, type_ref = c("Account", "Catalogue", "Checklist", "Flora", "Herbarium collection", "Key", "Red list", "Report", "Species Database", "Survey"), entity_class = c("Island", "Island/Mainland", "Mainland", "Island Group", "Island Part"), native_indicated = FALSE, natural_indicated = FALSE, end_ref = FALSE, end_list = FALSE, suit_geo = FALSE, complete_taxon = TRUE, GIFT_version = "latest", api = "https://gift.uni-goettingen.de/api/extended/", list_set = NULL, taxonomy = NULL )
taxon_name |
Character string corresponding to the taxonomic group of interest. |
floristic_scope |
A vector listing floristic scopes of the references
to be considered.
Options are: |
ref_excluded |
A vector listing potential ref_IDs that shall be ignored
when assembling the set of regions and checklists fulfilling the given
criteria. Checklists from these references will not be returned. |
type_ref |
Character, options are |
entity_class |
Character, options are |
native_indicated |
Logical, whether only lists where native status is available should be retrieved. |
natural_indicated |
Logical, whether only lists where natural status is available should be retrieved. |
end_ref |
Logical, whether only lists where endemism at the reference level is available should be retrieved. |
end_list |
Logical, whether only lists where endemism at the list level is available should be retrieved. |
suit_geo |
logical indicating whether only regions classified as suit_geo should be considered (see details). |
complete_taxon |
Logical, default |
GIFT_version |
character string defining the version of the GIFT
database to use. The function retrieves by default the |
api |
character string defining from which API the data will be retrieved. |
list_set |
list_set |
taxonomy |
default |
Here is what each column refers to:
ref_ID - Identification number of each reference.
type - What type the source is.
subset - What information regarding the status of species is
available.
native_indicated - Whether native status of species is available in
the source.
natural_indicated - Whether naturalized status of species is
available in the source.
end_ref - Whether endemism information is available in the source.
restricted - Whether the access to this reference is restricted.
taxon_ID - Identification number of species.
list_ID - Identification number of each list.
end_list - Whether endemism information is available in the list.
entity_ID - Identification number of the polygon of the list.
geo_entity - Name of the location.
suit_geo - Is the polygon suitable.
entity_class - Type of polygon.
entity_type - Name of the location.
taxon_name - Name of the group of taxa available.
A data frame with 16 columns.
Denelle, P., Weigelt, P., & Kreft, H. (2023). GIFT—An R package to access the Global Inventory of Floras and Traits. Methods in Ecology and Evolution, 14, 2738-2748. https://doi.org/10.1111/2041-210X.14213 Weigelt, P, König, C, Kreft, H. GIFT – A Global Inventory of Floras and Traits for macroecology and biogeography. J Biogeogr. 2020; 47: 16– 43. https://doi.org/10.1111/jbi.13623
ex <- GIFT_checklists_conditional(taxon_name = "Embryophyta", floristic_scope = c("all", "native", "native and naturalized", "native and historically introduced", "endangered", "endemic", "naturalized", "other subset")[7], type_ref = c("Account", "Catalogue", "Checklist","Flora", "Herbarium collection", "Key", "Red list", "Report", "Species Database", "Survey"), entity_class = c("Island", "Island/Mainland", "Mainland", "Island Group", "Island Part"), native_indicated = FALSE, natural_indicated = FALSE, end_ref = FALSE, end_list = FALSE, suit_geo = TRUE, complete_taxon = TRUE, list_set = NULL, taxonomy = NULL)
ex <- GIFT_checklists_conditional(taxon_name = "Embryophyta", floristic_scope = c("all", "native", "native and naturalized", "native and historically introduced", "endangered", "endemic", "naturalized", "other subset")[7], type_ref = c("Account", "Catalogue", "Checklist","Flora", "Herbarium collection", "Key", "Red list", "Report", "Species Database", "Survey"), entity_class = c("Island", "Island/Mainland", "Mainland", "Island Group", "Island Part"), native_indicated = FALSE, natural_indicated = FALSE, end_ref = FALSE, end_list = FALSE, suit_geo = TRUE, complete_taxon = TRUE, list_set = NULL, taxonomy = NULL)
Raw checklists, to combine with other functions.
GIFT_checklists_raw( ref_ID = NULL, list_ID = NULL, namesmatched = FALSE, taxon_name = "Tracheophyta", floristic_group = "all", list_set = NULL, taxonomy = NULL, GIFT_version = "latest", api = "https://gift.uni-goettingen.de/api/extended/" )
GIFT_checklists_raw( ref_ID = NULL, list_ID = NULL, namesmatched = FALSE, taxon_name = "Tracheophyta", floristic_group = "all", list_set = NULL, taxonomy = NULL, GIFT_version = "latest", api = "https://gift.uni-goettingen.de/api/extended/" )
ref_ID |
A vector defining the IDs of the references to retrieve.
|
list_ID |
A vector defining the IDs of the lists to retrieve.
|
namesmatched |
Logical. |
taxon_name |
Character string corresponding to the taxonomic group of interest. |
floristic_group |
Character string among these options:
|
list_set |
|
taxonomy |
|
GIFT_version |
character string defining the version of the GIFT
database to use. The function retrieves by default the |
api |
character string defining from which API the data will be retrieved. |
Here is what each column refers to:
ref_ID - Identification number of each reference
list_ID - Identification number of each list
orig_ID - Identification number of each species name, unchanged from
the sources
name_ID - Identification number of each reference
genus - Genus of each species
species_epithet - Epithet of each species
subtaxon - If needed, subtaxon of the species
author - Name of the author who described the species
matched - Whether a match was found when using a taxonomic
backbone
epithetscore - Matching score for the epithet
overallscore - Matching score for the overall species name
resolved - Whether the species name was resolved
service - Service used for the taxonomic harmonization
work_ID - Identification number of each species name, after
taxonomic harmonization
genus_ID - Identification number of each genus, after taxonomic
harmonization
species - Species name, after taxonomic harmonization
questionable - Whether the species occurrence is questionable
native - Whether the species is native
quest_native - Whether the native information is questionable
naturalized - Whether the species is naturalized
endemic_ref - Whether the species is endemic within the reference
quest_end_ref - Whether the endemic_ref information is
questionable
endemic_list- Whether the species is endemic within the list
quest_end_list - Whether the endemic_list information is
questionable
cons_status - Conservation status of the species
A data frame with 15 or 29 columns (depending on namesmatched). This data frame contains the species checklist for a given reference/list.
Denelle, P., Weigelt, P., & Kreft, H. (2023). GIFT—An R package to access the Global Inventory of Floras and Traits. Methods in Ecology and Evolution, 14, 2738-2748. https://doi.org/10.1111/2041-210X.14213 Weigelt, P, König, C, Kreft, H. GIFT – A Global Inventory of Floras and Traits for macroecology and biogeography. J Biogeogr. 2020; 47: 16– 43. https://doi.org/10.1111/jbi.13623
ex <- GIFT_checklists_raw(list_ID = c(1,5))
ex <- GIFT_checklists_raw(list_ID = c(1,5))
Retrieve taxonomic or trait coverage (for a given trait) of all species, native species, naturalized species and endemic species per taxonomic group and geographic region combination. This function works with taxonomic groups above the genus level.
GIFT_coverage( what = "taxonomic_coverage", taxon_name = "Embryophyta", trait_ID = "1.1.1", GIFT_version = "latest", api = "https://gift.uni-goettingen.de/api/extended/" )
GIFT_coverage( what = "taxonomic_coverage", taxon_name = "Embryophyta", trait_ID = "1.1.1", GIFT_version = "latest", api = "https://gift.uni-goettingen.de/api/extended/" )
what |
character indicating whether |
taxon_name |
Name of the taxonomic group you want to retrieve coverage
for. See |
trait_ID |
Identification number of the trait you want to retrieve
coverage for. See |
GIFT_version |
character string defining the version of the GIFT
database to use. The function retrieves by default the |
api |
character string defining from which API the data will be retrieved. |
The output has 9 columns:
entity_ID - Identification number of GIFT polygons
total - taxonomic or trait coverage for all species
total_rst - taxonomic or coverage for all species considering
restricted resources
native - taxonomic or trait coverage for native species
native_rst - taxonomic or trait coverage for native species
considering restricted resources
naturalized - taxonomic or trait coverage for naturalized species
naturalized_rst - taxonomic or trait coverage for naturalized species
considering restricted resources
endemic_min - taxonomic or trait coverage for endemic species
endemic_min_rst - taxonomic or trait coverage for endemic species
considering restricted resources
In the case of taxonomic coverage, a '1' means that species composition data is available for the given combination of taxonomic group and geographic region while 'NA' means that no data is available. This can differ depending on whether restricted data in GIFT is considered or not (columns with or without _rst at the end).
In the case of trait coverage, the proportion of species of a given taxonomic group with information on the defined trait is reported per geographic region.
A data frame with either taxonomic or trait coverage per GIFT polygon.
Denelle, P., Weigelt, P., & Kreft, H. (2023). GIFT—An R package to access the Global Inventory of Floras and Traits. Methods in Ecology and Evolution, 14, 2738-2748. https://doi.org/10.1111/2041-210X.14213 Weigelt, P, König, C, Kreft, H. GIFT – A Global Inventory of Floras and Traits for macroecology and biogeography. J Biogeogr. 2020; 47: 16– 43. https://doi.org/10.1111/jbi.13623
ex <- GIFT_coverage(what = "taxonomic_coverage", taxon_name = "Angiospermae") ex2 <- GIFT_coverage(what = "trait_coverage", taxon_name = "Angiospermae", trait_ID = "1.2.1")
ex <- GIFT_coverage(what = "taxonomic_coverage", taxon_name = "Angiospermae") ex2 <- GIFT_coverage(what = "trait_coverage", taxon_name = "Angiospermae", trait_ID = "1.2.1")
Retrieve environmental data associated to each GIFT checklists. Sources of environmental variables can come from raster layers or from shape files (miscellaneous). Users need to define what variables they are interested in and then ask for a set of summary statistics (in case of raster layers).
GIFT_env( entity_ID = NULL, miscellaneous = if (is.null(rasterlayer)) "area" else NULL, rasterlayer = NULL, sumstat = "mean", GIFT_version = "latest", api = "https://gift.uni-goettingen.de/api/extended/" )
GIFT_env( entity_ID = NULL, miscellaneous = if (is.null(rasterlayer)) "area" else NULL, rasterlayer = NULL, sumstat = "mean", GIFT_version = "latest", api = "https://gift.uni-goettingen.de/api/extended/" )
entity_ID |
A vector defining the ID of the lists to retrieve.
|
miscellaneous |
character vector or list specifying the miscellaneous
data to retrieve. . A list of all miscellaneous layers for which precomputed
information exists in the database can be viewed in the output table
returned by |
rasterlayer |
character vector or list specifying the raster
data to retrieve. A list of all raster layers for which precomputed
information exists in the database can be viewed in the output table
returned by |
sumstat |
Vector or list indicating the desired summary statistics out
of Important note |
GIFT_version |
character string defining the version of the GIFT
database to use. The function retrieves by default the |
api |
character string defining from which API the data will be retrieved. |
The columns of the data.frame are the following:
entity_ID - Identification number of the polygon
geo_entity - Name of the polygon
The other columns relate to the environmental variables the user asked for.
A data frame with the environmental values per polygon (entity_ID).
Denelle, P., Weigelt, P., & Kreft, H. (2023). GIFT—An R package to access the Global Inventory of Floras and Traits. Methods in Ecology and Evolution, 14, 2738-2748. https://doi.org/10.1111/2041-210X.14213 Weigelt, P, König, C, Kreft, H. GIFT – A Global Inventory of Floras and Traits for macroecology and biogeography. J Biogeogr. 2020; 47: 16– 43. https://doi.org/10.1111/jbi.13623
GIFT_env_meta_misc()
and GIFT_env_meta_raster()
ex <- GIFT_env(entity_ID = c(1,5), miscellaneous = c("perimeter", "biome"), rasterlayer = c("mn30_grd", "wc2.0_bio_30s_01"), sumstat = list(c("mean", "med"), "max"))
ex <- GIFT_env(entity_ID = c(1,5), miscellaneous = c("perimeter", "biome"), rasterlayer = c("mn30_grd", "wc2.0_bio_30s_01"), sumstat = list(c("mean", "med"), "max"))
Retrieve the metadata of all miscellaneous environmental layers accessible in GIFT.
GIFT_env_meta_misc( api = "https://gift.uni-goettingen.de/api/extended/", GIFT_version = "latest" )
GIFT_env_meta_misc( api = "https://gift.uni-goettingen.de/api/extended/", GIFT_version = "latest" )
api |
character string defining from which API the data will be retrieved. |
GIFT_version |
character string defining the version of the GIFT
database to use. The function retrieves by default the |
Here is what each column refers to:
dataset - Name of the source dataset.
variable - Name of the environmental layer.
description- Description.
unit - Unit.
num - Whether the environmental layer is numeric or not.
ref_long - Full reference to cite when using an environmental layer.
A data frame with 6 columns.
Denelle, P., Weigelt, P., & Kreft, H. (2023). GIFT—An R package to access the Global Inventory of Floras and Traits. Methods in Ecology and Evolution, 14, 2738-2748. https://doi.org/10.1111/2041-210X.14213 Weigelt, P, König, C, Kreft, H. GIFT – A Global Inventory of Floras and Traits for macroecology and biogeography. J Biogeogr. 2020; 47: 16– 43. https://doi.org/10.1111/jbi.13623
ex <- GIFT_env_meta_misc()
ex <- GIFT_env_meta_misc()
Retrieve the metadata of every environmental raster accessible in GIFT.
GIFT_env_meta_raster( api = "https://gift.uni-goettingen.de/api/extended/", GIFT_version = "latest" )
GIFT_env_meta_raster( api = "https://gift.uni-goettingen.de/api/extended/", GIFT_version = "latest" )
api |
character string defining from which API the data will be retrieved. |
GIFT_version |
character string defining the version of the GIFT
database to use. The function retrieves by default the |
Here is what each column refers to:
dataset - Name of the source dataset
layer_name - Name of the environmental layer
layer - Full name
description - Description
unit - Unit
coord_system - Coordinate system
resolution - Resolution
extent - Extent
version - Version of the source
ref_long - Full reference to cite when using an environmental layer
A data frame with 10 columns.
Denelle, P., Weigelt, P., & Kreft, H. (2023). GIFT—An R package to access the Global Inventory of Floras and Traits. Methods in Ecology and Evolution, 14, 2738-2748. https://doi.org/10.1111/2041-210X.14213 Weigelt, P, König, C, Kreft, H. GIFT – A Global Inventory of Floras and Traits for macroecology and biogeography. J Biogeogr. 2020; 47: 16– 43. https://doi.org/10.1111/jbi.13623
ex <- GIFT_env_meta_raster()
ex <- GIFT_env_meta_raster()
Retrieves the metadata of each checklist within GIFT.
GIFT_lists( api = "https://gift.uni-goettingen.de/api/extended/", GIFT_version = "latest" )
GIFT_lists( api = "https://gift.uni-goettingen.de/api/extended/", GIFT_version = "latest" )
api |
character string defining from which API the data will be retrieved. |
GIFT_version |
character string defining the version of the GIFT
database to use. The function retrieves by default the |
Here is what each column refers to:
ref_ID - Identification number of each reference.
Columns type and subset indicate what information can be
found in each reference. Similarly, native_indicated,
natural_indicated and end_ref indicate respectively
whether native, naturalized and endemic species were stated in the
reference. restricted refers to the availability of the reference,
taxon_ID to the taxonomic group available in a reference.
list_ID is the identification number of a checklist within a
reference, entity_ID of the associated polygon. geo_entity
associates a name to this identification number. suit_geo indicates
whether the checklist is suitable for use, entity_class and
entity_unit give additional details about the polygon.
A data frame with 15 columns.
Denelle, P., Weigelt, P., & Kreft, H. (2023). GIFT—An R package to access the Global Inventory of Floras and Traits. Methods in Ecology and Evolution, 14, 2738-2748. https://doi.org/10.1111/2041-210X.14213 Weigelt, P, König, C, Kreft, H. GIFT – A Global Inventory of Floras and Traits for macroecology and biogeography. J Biogeogr. 2020; 47: 16– 43. https://doi.org/10.1111/jbi.13623
ex <- GIFT_lists()
ex <- GIFT_lists()
Identify overlapping regions in a set of GIFT regions and choose only non-overlapping regions based on size and overlap criteria
GIFT_no_overlap( entity_IDs = NULL, area_threshold_island = 0, area_threshold_mainland = 100, overlap_threshold = 0.1, geoentities_overlap = NULL, api = "https://gift.uni-goettingen.de/api/extended/", GIFT_version = "latest" )
GIFT_no_overlap( entity_IDs = NULL, area_threshold_island = 0, area_threshold_mainland = 100, overlap_threshold = 0.1, geoentities_overlap = NULL, api = "https://gift.uni-goettingen.de/api/extended/", GIFT_version = "latest" )
entity_IDs |
A vector of IDs of the regions for which we want to check overlap |
area_threshold_island |
A number stating from which surface the smallest overlapping polygon is kept. By default set to 0 square kilometer (meaning that by default the smallest islands will be conserved). |
area_threshold_mainland |
When two polygons overlap, the smallest or the biggest one can be kept. When the surface of the smallest polygon exceeds this number, the smallest polygon is kept. Otherwise, we keep the bigger one. Set by default 100 square-kilometers. |
overlap_threshold |
A number ranging from 0 to 1, indicating at what percentage of overlap, partially overlapping polygons should be kept. |
geoentities_overlap |
A table coming from GIFT indicating the overlap in km^2 between pairs of polygons. |
api |
character string defining from which API the data will be retrieved. |
GIFT_version |
character string defining the version of the GIFT
database to use. The function retrieves by default the |
A vector of entity_IDs (identification numbers of polygons) non-overlapping.
Denelle, P., Weigelt, P., & Kreft, H. (2023). GIFT—An R package to access the Global Inventory of Floras and Traits. Methods in Ecology and Evolution, 14, 2738-2748. https://doi.org/10.1111/2041-210X.14213 Weigelt, P, König, C, Kreft, H. GIFT – A Global Inventory of Floras and Traits for macroecology and biogeography. J Biogeogr. 2020; 47: 16– 43. https://doi.org/10.1111/jbi.13623
ex <- GIFT_no_overlap(entity_IDs = c(10071, 12078)) # Andalusia and Spain. # We get Andalusia because it is smaller than Spain and larger than 100 km² ex2 <- GIFT_no_overlap(entity_IDs = c(10071, 12078), area_threshold_mainland = 100000) # since Andalusia is smaller than # 100,000 km² large, the larger entity (Spain) is chosen here.
ex <- GIFT_no_overlap(entity_IDs = c(10071, 12078)) # Andalusia and Spain. # We get Andalusia because it is smaller than Spain and larger than 100 km² ex2 <- GIFT_no_overlap(entity_IDs = c(10071, 12078), area_threshold_mainland = 100000) # since Andalusia is smaller than # 100,000 km² large, the larger entity (Spain) is chosen here.
Calculate the spatial overlap between GIFT polygons and shapefiles coming from other resources
GIFT_overlap( resource = "glonaf", GIFT_version = "latest", api = "https://gift.uni-goettingen.de/api/extended/" )
GIFT_overlap( resource = "glonaf", GIFT_version = "latest", api = "https://gift.uni-goettingen.de/api/extended/" )
resource |
A character string indicating from which resource the
spatial overlap is calculated. Available options are |
GIFT_version |
character string defining the version of the GIFT
database to use. The function retrieves by default the |
api |
character string defining from which API the data will be retrieved. |
The columns of the data.frame are the following:
entity_ID - Identification number of the GIFT polygon
glonaf_ID (or gmba_ID) - Identification number of the polygon
from the other resource
overlap12 - Spatial overlap in percentage between GIFT polygon and
the external polygon
overlap21 - The other way around
A data frame with the spatial overlap.
Denelle, P., Weigelt, P., & Kreft, H. (2023). GIFT—An R package to access the Global Inventory of Floras and Traits. Methods in Ecology and Evolution, 14, 2738-2748. https://doi.org/10.1111/2041-210X.14213 Weigelt, P, König, C, Kreft, H. GIFT – A Global Inventory of Floras and Traits for macroecology and biogeography. J Biogeogr. 2020; 47: 16– 43. https://doi.org/10.1111/jbi.13623
glonaf <- GIFT_overlap(resource = "glonaf") gmba <- GIFT_overlap(resource = "gmba")
glonaf <- GIFT_overlap(resource = "glonaf") gmba <- GIFT_overlap(resource = "gmba")
Retrieve a phylogeny of the plant species available in GIFT. The phylogeny table is not available for GIFT_version 1.0, 2.0, 2.1 and 2.2.
GIFT_phylogeny( clade = "Tracheophyta", as_tree = TRUE, return_work_ID = FALSE, work_ID_subset = NULL, api = "https://gift.uni-goettingen.de/api/extended/", GIFT_version = "latest" )
GIFT_phylogeny( clade = "Tracheophyta", as_tree = TRUE, return_work_ID = FALSE, work_ID_subset = NULL, api = "https://gift.uni-goettingen.de/api/extended/", GIFT_version = "latest" )
clade |
Character string indicating the taxonomic group of interest corresponding to the node labels in the phylogeny. |
as_tree |
Logical, whether you want the phylogeny to be returned as a
phylogenetic tree ( |
return_work_ID |
Logical, whether you want to retrieve the species'
names or their identification number (work_ID) in the GIFT database.
|
work_ID_subset |
A vector of work_ID to prune the phylogenetic tree.
|
api |
character string defining from which API the data will be retrieved. |
GIFT_version |
character string defining the version of the GIFT
database to use. The function retrieves by default the |
Here is what each column refers to:
taxon_label - Name of the taxonomic group
work_ID - Standardized species name IDs for the species at the tips
of the tree
edge_length - Edge length
lft - Left border of a given taxon in the Newick sequence
rgt - Right border of a given taxon in the Newick sequence
A data frame with 5 columns or a tree object.
Denelle, P., Weigelt, P., & Kreft, H. (2023). GIFT—An R package to access the Global Inventory of Floras and Traits. Methods in Ecology and Evolution, 14, 2738-2748. https://doi.org/10.1111/2041-210X.14213 Weigelt, P, König, C, Kreft, H. GIFT – A Global Inventory of Floras and Traits for macroecology and biogeography. J Biogeogr. 2020; 47: 16– 43. https://doi.org/10.1111/jbi.13623
ex <- GIFT_phylogeny(clade = "Tracheophyta", as_tree = FALSE)
ex <- GIFT_phylogeny(clade = "Tracheophyta", as_tree = FALSE)
Retrieve the metadata of every reference accessible in GIFT.
GIFT_references( api = "https://gift.uni-goettingen.de/api/extended/", GIFT_version = "latest" )
GIFT_references( api = "https://gift.uni-goettingen.de/api/extended/", GIFT_version = "latest" )
api |
character string defining from which API the data will be retrieved. |
GIFT_version |
character string defining the version of the GIFT
database to use. The function retrieves by default the |
Here is what each column refers to:
ref_ID - Identification number of the reference
ref_long - Full reference for the reference
geo_entity_ref - Name of the location
type - What type the source is
subset - What information regarding the status of species is
available
taxon_ID - Identification number of the group of taxa available
taxon_name - Name of the group of taxa available
checklist - Is the source a checklist
native_indicated - Whether native status of species is available in
the source
natural_indicated - Whether naturalized status of species is
available in the source
end_ref - Whether endemism information is available in the source
traits - Whether trait information is available in the source
restricted - Whether the access to this reference is restricted
proc_date - When the source was processed
A data frame with 14 columns.
Denelle, P., Weigelt, P., & Kreft, H. (2023). GIFT—An R package to access the Global Inventory of Floras and Traits. Methods in Ecology and Evolution, 14, 2738-2748. https://doi.org/10.1111/2041-210X.14213 Weigelt, P, König, C, Kreft, H. GIFT – A Global Inventory of Floras and Traits for macroecology and biogeography. J Biogeogr. 2020; 47: 16– 43. https://doi.org/10.1111/jbi.13623
ex <- GIFT_references()
ex <- GIFT_references()
Retrieves miscellaneous information for GIFT regions.
GIFT_regions( api = "https://gift.uni-goettingen.de/api/extended/", GIFT_version = "latest" )
GIFT_regions( api = "https://gift.uni-goettingen.de/api/extended/", GIFT_version = "latest" )
api |
character string defining from which API the data will be retrieved. |
GIFT_version |
character string defining the version of the GIFT
database to use. The function retrieves by default the |
Here is the detail of each column:
entity_ID - Identification number of GIFT polygons
geo_entity - Name of GIFT polygons
suit_geo - Whether the polygon is suitable
entity_class - Class of the polygon
entity_type - Type of the polygon
TDWG_lvl3_ID - Whether the polygon is a TDWG region (see
https://www.tdwg.org/)
country - Whether the polygon is a country
A data frame with 7 columns.
Denelle, P., Weigelt, P., & Kreft, H. (2023). GIFT—An R package to access the Global Inventory of Floras and Traits. Methods in Ecology and Evolution, 14, 2738-2748. https://doi.org/10.1111/2041-210X.14213 Weigelt, P, König, C, Kreft, H. GIFT – A Global Inventory of Floras and Traits for macroecology and biogeography. J Biogeogr. 2020; 47: 16– 43. https://doi.org/10.1111/jbi.13623
ex <- GIFT_regions()
ex <- GIFT_regions()
Retrieve species richness of all species, native species, naturalized species and endemic species per taxonomic group and geographic region combination.
GIFT_richness( taxon_name = "Embryophyta", GIFT_version = "latest", api = "https://gift.uni-goettingen.de/api/extended/" )
GIFT_richness( taxon_name = "Embryophyta", GIFT_version = "latest", api = "https://gift.uni-goettingen.de/api/extended/" )
taxon_name |
Taxonomic group to retrieve species richness for. |
GIFT_version |
character string defining the version of the GIFT
database to use. The function retrieves by default the |
api |
character string defining from which API the data will be retrieved. |
The output has 5 columns:
entity_ID - Identification number of the geographic region
total - total species richness
native - number of native species
naturalized - number of naturalized species
endemic_min - number of endemic species
The number of endemic species is a conservative count not counting occurrences of species which go back to infraspecific taxa.
A data frame with species richness values for different floristic subsets per geographic region in GIFT.
Denelle, P., Weigelt, P., & Kreft, H. (2023). GIFT—An R package to access the Global Inventory of Floras and Traits. Methods in Ecology and Evolution, 14, 2738-2748. https://doi.org/10.1111/2041-210X.14213 Weigelt, P, König, C, Kreft, H. GIFT – A Global Inventory of Floras and Traits for macroecology and biogeography. J Biogeogr. 2020; 47: 16– 43. https://doi.org/10.1111/jbi.13623
ex <- GIFT_richness(taxon_name = "Angiospermae")
ex <- GIFT_richness(taxon_name = "Angiospermae")
Get shapefile of GIFT regions for selected regions.
GIFT_shapes( entity_ID = NULL, api = "https://gift.uni-goettingen.de/api/extended/", GIFT_version = "latest" )
GIFT_shapes( entity_ID = NULL, api = "https://gift.uni-goettingen.de/api/extended/", GIFT_version = "latest" )
entity_ID |
A vector defining the IDs of the regions. |
api |
character string defining from which API the data will be retrieved. |
GIFT_version |
character string defining the version of the GIFT
database to use. The function retrieves by default the |
Here is the detail of each column:
entity_ID - Identification number of the polygon
geo_entity - Name of the polygon
point_x - Longitude of the centroid of the polygon
point_y - Latitude of the centroid of the polygon
area - Area in km2 of the polygon
x_min - Minimum longitude of the polygon
x_max - Maximum longitude of the polygon
y_min - Minimum latitude of the polygon
y_max - Maximum latitude of the polygon
entity_class - Class of the polygon
entity_type - Type of the entity
polygon_source - Source of the polygon
geometry - Geometry column from sf
A spatial data.frame with 13 columns.
Denelle, P., Weigelt, P., & Kreft, H. (2023). GIFT—An R package to access the Global Inventory of Floras and Traits. Methods in Ecology and Evolution, 14, 2738-2748. https://doi.org/10.1111/2041-210X.14213 Weigelt, P, König, C, Kreft, H. GIFT – A Global Inventory of Floras and Traits for macroecology and biogeography. J Biogeogr. 2020; 47: 16– 43. https://doi.org/10.1111/jbi.13623
ex <- GIFT_shapes(entity_ID = c(677, 200)) plot(sf::st_geometry(ex), col = ex$entity_ID)
ex <- GIFT_shapes(entity_ID = c(677, 200)) plot(sf::st_geometry(ex), col = ex$entity_ID)
Retrieve checklists overlapping with a shape file or a set of coordinates.
GIFT_spatial( shp = NULL, coordinates = NULL, overlap = "centroid_inside", entity_ID = NULL, GIFT_version = "latest", api = "https://gift.uni-goettingen.de/api/extended/" )
GIFT_spatial( shp = NULL, coordinates = NULL, overlap = "centroid_inside", entity_ID = NULL, GIFT_version = "latest", api = "https://gift.uni-goettingen.de/api/extended/" )
shp |
Shapefile provided by the user. Its Coordinate Reference System (CRS) must be set to WGS84 (EPSG code 4326). |
coordinates |
Custom set of coordinates. The format is a two columns data.frame, the first one being longitudes and the second being latitudes of the vertices of a polygon. If the data.frame only includes two rows, the function assumes that the values are the four limits (min and max. longitude and latitude) of a bounding box. |
overlap |
A character string defining the criteria to use in order to
retrieve checklists. Available options are |
entity_ID |
Constrain the list of regions to be received by a predefined set of entity_IDs. E.g. this list could come from GIFT_checklists_conditional(). |
GIFT_version |
character string defining the version of the GIFT
database to use. The function retrieves by default the |
api |
character string defining from which API the data will be retrieved. |
A data frame with 3 columns: entity_ID the identification number of a polygon, geo_entity_ref its name, and coverage which indicates the percentage of overlap between the provided shape and the different polygons of GIFT.
Denelle, P., Weigelt, P., & Kreft, H. (2023). GIFT—An R package to access the Global Inventory of Floras and Traits. Methods in Ecology and Evolution, 14, 2738-2748. https://doi.org/10.1111/2041-210X.14213 Weigelt, P, König, C, Kreft, H. GIFT – A Global Inventory of Floras and Traits for macroecology and biogeography. J Biogeogr. 2020; 47: 16– 43. https://doi.org/10.1111/jbi.13623
# With a shapefile data("western_mediterranean") ex <- GIFT_spatial(shp = western_mediterranean, overlap = "centroid_inside") # With a shapefile coming from GIFT spain <- GIFT_shapes(entity_ID = 10071) ex_spain <- GIFT_spatial(shp = spain) # With a point custom_point <- cbind(9.9, 51) ex2 <- GIFT_spatial(coordinates = custom_point, overlap = "extent_intersect") # With an extent custom_extent <- cbind(c(-13, -18), c(27.5, 29.3)) ex3 <- GIFT_spatial(coordinates = custom_extent, overlap = "extent_intersect") # With a custom polygon custom_polygon <- cbind(c(-18, -16.9, -13, -13, -18, -18), c(29.3, 33, 29.3, 27.5, 27.5, 29.3)) ex4 <- GIFT_spatial(coordinates = custom_polygon, overlap = "extent_intersect") #With a linestring custom_linestring <- rbind(c(9.9, 51), c(2.35, 48.9)) custom_linestring <- sf::st_as_sf(as.data.frame(custom_linestring), coords = c("V1", "V2")) custom_linestring <- dplyr::summarise(custom_linestring, geometry = sf::st_combine(geometry)) sf::st_crs(custom_linestring) <- sf::st_crs(western_mediterranean) ex5 <- GIFT_spatial(shp = custom_linestring, overlap = "extent_intersect")
# With a shapefile data("western_mediterranean") ex <- GIFT_spatial(shp = western_mediterranean, overlap = "centroid_inside") # With a shapefile coming from GIFT spain <- GIFT_shapes(entity_ID = 10071) ex_spain <- GIFT_spatial(shp = spain) # With a point custom_point <- cbind(9.9, 51) ex2 <- GIFT_spatial(coordinates = custom_point, overlap = "extent_intersect") # With an extent custom_extent <- cbind(c(-13, -18), c(27.5, 29.3)) ex3 <- GIFT_spatial(coordinates = custom_extent, overlap = "extent_intersect") # With a custom polygon custom_polygon <- cbind(c(-18, -16.9, -13, -13, -18, -18), c(29.3, 33, 29.3, 27.5, 27.5, 29.3)) ex4 <- GIFT_spatial(coordinates = custom_polygon, overlap = "extent_intersect") #With a linestring custom_linestring <- rbind(c(9.9, 51), c(2.35, 48.9)) custom_linestring <- sf::st_as_sf(as.data.frame(custom_linestring), coords = c("V1", "V2")) custom_linestring <- dplyr::summarise(custom_linestring, geometry = sf::st_combine(geometry)) sf::st_crs(custom_linestring) <- sf::st_crs(western_mediterranean) ex5 <- GIFT_spatial(shp = custom_linestring, overlap = "extent_intersect")
Retrieve the whole set of plant species available in GIFT.
GIFT_species( api = "https://gift.uni-goettingen.de/api/extended/", GIFT_version = "latest" )
GIFT_species( api = "https://gift.uni-goettingen.de/api/extended/", GIFT_version = "latest" )
api |
character string defining from which API the data will be retrieved. |
GIFT_version |
character string defining the version of the GIFT
database to use. The function retrieves by default the |
Here is what each column refers to:
work_ID - Identification number of the species
genus_ID - Identification number of the genus
work_genus - Genus name after taxonomic harmonization
work_species - Species name after taxonomic harmonization
work_author - Author who described the species (after taxonomic
harmonization)
A data frame with 5 columns.
Denelle, P., Weigelt, P., & Kreft, H. (2023). GIFT—An R package to access the Global Inventory of Floras and Traits. Methods in Ecology and Evolution, 14, 2738-2748. https://doi.org/10.1111/2041-210X.14213 Weigelt, P, König, C, Kreft, H. GIFT – A Global Inventory of Floras and Traits for macroecology and biogeography. J Biogeogr. 2020; 47: 16– 43. https://doi.org/10.1111/jbi.13623
ex <- GIFT_species()
ex <- GIFT_species()
Retrieve the distribution of one species from GIFT checklists.
GIFT_species_distribution( genus = "Fagus", epithet = "sylvatica", namesmatched = FALSE, remove_overlap = FALSE, area_th_island = 0, area_th_mainland = 100, overlap_th = 0.1, by_ref_ID = FALSE, aggregation = FALSE, GIFT_version = "latest", api = "https://gift.uni-goettingen.de/api/extended/" )
GIFT_species_distribution( genus = "Fagus", epithet = "sylvatica", namesmatched = FALSE, remove_overlap = FALSE, area_th_island = 0, area_th_mainland = 100, overlap_th = 0.1, by_ref_ID = FALSE, aggregation = FALSE, GIFT_version = "latest", api = "https://gift.uni-goettingen.de/api/extended/" )
genus |
Character string corresponding to the genus of the species of interest. |
epithet |
Character string corresponding to the epithet of the species of interest. |
namesmatched |
Logical |
remove_overlap |
a logical stating whether you want to
retrieve checklists that overlap or not. |
area_th_island |
A number stating from which surface the smallest overlapping polygon is kept. By default set to 0 square kilometer (meaning that by default the smallest islands will be conserved). |
area_th_mainland |
When two polygons overlap, the smallest or the biggest one can be kept. When the surface of the smallest polygon exceeds this number, the smallest polygon is kept. Otherwise, we keep the bigger one. Set by default 100 square-kilometers. |
overlap_th |
A number ranging from 0 to 1, indicating at what percentage of overlap, partially overlapping polygons should be kept. |
by_ref_ID |
logical indicating whether the removal of overlapping regions shall be applied by ref_ID only. Note that regions overlapping with other regions from the same resource will be removed even if there are other references available for those regions. |
aggregation |
A logical stating whether you want to aggregate in a simpler way the floristic status of species per entity_ID. For example, two lists associated to the same entity_ID could describe a species both as native and non-native. In that case, the aggregation would consider the species to be native. Reverse for naturalized and alien. |
GIFT_version |
character string defining the version of the GIFT
database to use. The function retrieves by default the |
api |
character string defining from which API the data will be retrieved. |
Here is the detail of each data.frame and their columns:
ref_ID - Identification number of the reference
list_ID - Identification number of the list
entity_ID - Identification number of the polygon
name_ID - Identification number of the genus before taxonomic
harmonization
cf_genus - Whether the genus name is uncertain
cf_species - Whether the species' epithet is uncertain
aff_species - Species' epithet uncertain
questionable - Whether the species name is questionable
native - Is the species native
quest_native - Is the native status questionable
naturalized - Is the species naturalized
endemic_ref - Is the species endemic at the reference level
quest_end_ref - Is the endemic_ref status questionable
endemic_list - Is the species endemic at the list level
quest_end_list - Is the endemic_list status questionable
genus - Genus name before taxonomic harmonization
species_epithet - Epithet before taxonomic harmonization
subtaxon - Subtaxon name before taxonomic harmonization
author - Author who described the species before taxonomic
harmonization
matched - Is the species name matched in the taxonomic backbone
epithetscore - Matching score for the epithet
overallscore - Overall matching score for the species
resolved - Is the species name resolved in the taxonomic backbone
synonym -Is the species a synonym in the taxonomic backbone
matched_subtaxon -Is the sub-species name matched in the taxonomic
backbone
accepted - Is the species name accepted in the taxonomic backbone
service - Service use for the taxonomic harmonization
work_ID -Identification number of the species after taxonomic
harmonization
taxon_ID -Identification number of the taxonomic group
work_genus - Identification number of the genus after taxonomic
harmonization
work_species_epithet - Identification number of the species epithet
after taxonomic harmonization
work_species - Species name (after taxonomic harmonization)
work_author - Author who described the species (after taxonomic
harmonization)
A data frame with 33 columns.
Denelle, P., Weigelt, P., & Kreft, H. (2023). GIFT—An R package to access the Global Inventory of Floras and Traits. Methods in Ecology and Evolution, 14, 2738-2748. https://doi.org/10.1111/2041-210X.14213 Weigelt, P, König, C, Kreft, H. GIFT – A Global Inventory of Floras and Traits for macroecology and biogeography. J Biogeogr. 2020; 47: 16– 43. https://doi.org/10.1111/jbi.13623
ex <- GIFT_species_distribution()
ex <- GIFT_species_distribution()
Retrieve all name matching information for one taxonomic name. All results are returned, where the name is either found in the unstandardized or taxonomically standardized names.
GIFT_species_lookup( genus = "", epithet = "", namesmatched = FALSE, api = "https://gift.uni-goettingen.de/api/extended/", GIFT_version = "latest" )
GIFT_species_lookup( genus = "", epithet = "", namesmatched = FALSE, api = "https://gift.uni-goettingen.de/api/extended/", GIFT_version = "latest" )
genus |
character string defining the genus name to be looked for. |
epithet |
character string defining the specific epithet to be looked for. |
namesmatched |
Logical |
api |
character string defining from which API the data will be retrieved. |
GIFT_version |
character string defining the version of the GIFT
database to use. The function retrieves by default the |
Here is what each column refers to:
orig_ID - Identification number of the species before taxonomic
harmonization
orig_genus - Genus before taxonomic harmonization
name_ID - Identification number of the genus before taxonomic
harmonization
cf_genus- Whether the genus name is uncertain
genus- Genus before taxonomic harmonization
cf_species- Whether the species' epithet is uncertain
aff_species- Species' epithet uncertain
species_epithet- Epithet of the species before taxonomic
harmonization
subtaxon- Subtaxon of the species before taxonomic harmonization
author- Author who described the species (before taxonomic
harmonization)
matched- Is the species matched in the taxonomic backbone
epithetscore- Matching score for the epithet
overallscore- Overall matching score for the species
resolved- Is the species name resolved in the taxonomic backbone
synonym- Is the species name a synonym in the taxonomic backbone
matched_subtaxon- Is the subtaxon matched in the taxonomic backbone
accepted- Is the species name accepted in the taxonomic backbone
service- Service use for the taxonomic harmonization
work_ID- Identification number of the species after taxonomic
harmonization
taxon_ID- Identification number of the taxonomic group
work_genus- Identification number of the genus after taxonomic
harmonization
work_species_epithet- Identification number of the species epithet
after taxonomic harmonization
work_species - Species name (after taxonomic harmonization)
work_author- Author who described the species (after taxonomic
harmonization)
A data frame with 19 columns (or 24 if namesmatched = TRUE).
Denelle, P., Weigelt, P., & Kreft, H. (2023). GIFT—An R package to access the Global Inventory of Floras and Traits. Methods in Ecology and Evolution, 14, 2738-2748. https://doi.org/10.1111/2041-210X.14213 Weigelt, P, König, C, Kreft, H. GIFT – A Global Inventory of Floras and Traits for macroecology and biogeography. J Biogeogr. 2020; 47: 16– 43. https://doi.org/10.1111/jbi.13623
ex <- GIFT_species_lookup(genus = "Fagus", epithet = "sylvatica")
ex <- GIFT_species_lookup(genus = "Fagus", epithet = "sylvatica")
Assign taxonomic groups of various hierarchical level to species from GIFT
(work_ID
).
GIFT_taxgroup( work_ID = NULL, taxon_lvl = c("family", "order", "higher_lvl")[1], return_ID = FALSE, GIFT_version = "latest", api = "https://gift.uni-goettingen.de/api/extended/", taxonomy = NULL, species = NULL )
GIFT_taxgroup( work_ID = NULL, taxon_lvl = c("family", "order", "higher_lvl")[1], return_ID = FALSE, GIFT_version = "latest", api = "https://gift.uni-goettingen.de/api/extended/", taxonomy = NULL, species = NULL )
work_ID |
A vector defining the IDs of the species to retrieve
taxonomic groups for. |
taxon_lvl |
taxonomic level to retrieve names for. |
return_ID |
logical indicating whether to give back taxon_IDs instead of names. |
GIFT_version |
character string defining the version of the GIFT
database to use. The function retrieves by default the |
api |
character string defining from which API the data will be retrieved. |
taxonomy |
option to supply taxonomy object here if loaded already to
avoid double loading. For internal use within GIFT functions. If |
species |
option to supply species names object here if loaded already
to avoid double loading. For internal use within GIFT functions. If |
A vector with the taxonomic group of the species used as input.
Denelle, P., Weigelt, P., & Kreft, H. (2023). GIFT—An R package to access the Global Inventory of Floras and Traits. Methods in Ecology and Evolution, 14, 2738-2748. https://doi.org/10.1111/2041-210X.14213 Weigelt, P, König, C, Kreft, H. GIFT – A Global Inventory of Floras and Traits for macroecology and biogeography. J Biogeogr. 2020; 47: 16– 43. https://doi.org/10.1111/jbi.13623
ex <- GIFT_taxgroup(work_ID = c(1, 4, 7, 8), taxon_lvl = "family")
ex <- GIFT_taxgroup(work_ID = c(1, 4, 7, 8), taxon_lvl = "family")
Retrieves the taxonomy of GIFT.
GIFT_taxonomy( GIFT_version = "latest", api = "https://gift.uni-goettingen.de/api/extended/" )
GIFT_taxonomy( GIFT_version = "latest", api = "https://gift.uni-goettingen.de/api/extended/" )
GIFT_version |
character string defining the version of the GIFT
database to use. The function retrieves by default the |
api |
character string defining from which API the data will be retrieved. |
Here is what each column refers to:
taxon_ID - the identification number of each taxonomic entry.
taxon_name - names describing taxa.
taxon_name - author name for a given taxon.
taxon_lvl - splits every taxon in genus, family, order or
superior orders. Taxonomy is a linear sequence of left and right borders
for each taxon. This is nested, for example left and right borders of a
genus would fall between the left and right borders of the corresponding
family.
lft - left border of one taxon in the taxonomic sequence.
rgt - right border of one taxon in the taxonomic sequence.
A data frame with 6 columns.
Denelle, P., Weigelt, P., & Kreft, H. (2023). GIFT—An R package to access the Global Inventory of Floras and Traits. Methods in Ecology and Evolution, 14, 2738-2748. https://doi.org/10.1111/2041-210X.14213 Weigelt, P, König, C, Kreft, H. GIFT – A Global Inventory of Floras and Traits for macroecology and biogeography. J Biogeogr. 2020; 47: 16– 43. https://doi.org/10.1111/jbi.13623
ex <- GIFT_taxonomy()
ex <- GIFT_taxonomy()
Retrieve specific trait values.
GIFT_traits( trait_IDs = "", agreement = 0.66, bias_ref = TRUE, bias_deriv = TRUE, api = "https://gift.uni-goettingen.de/api/extended/", GIFT_version = "latest" )
GIFT_traits( trait_IDs = "", agreement = 0.66, bias_ref = TRUE, bias_deriv = TRUE, api = "https://gift.uni-goettingen.de/api/extended/", GIFT_version = "latest" )
trait_IDs |
a character string indicating which trait you want to retrieve. Traits must belong to the available list of traits. |
agreement |
Percentage of resources that agree on an aggregated trait value, entries below this threshold will be omitted. |
bias_ref |
When FALSE, exclude entries that are only based on a resource that potentially introduces a bias (e.g. a resource only including trees). |
bias_deriv |
When FALSE, exclude entries that are only based on a derivation that potentially introduces a bias (e.g. all phanerophytes being woody but some life forms being ambiguous). |
api |
character string defining from which API the data will be retrieved. |
GIFT_version |
character string defining the version of the GIFT
database to use. The function retrieves by default the |
Here is the detail of each column:
trait_ID - Identification number of the trait
work_ID - Identification number of the taxonomically harmonized
species
species - Species name
trait_value - Value of the trait
agreement - Agreement score between the different sources for that
trait value, only for categorical traits
cv - Coefficient of variation for the different sources for that
trait value, only for numeric traits
n - Number of sources leading to the trait value
references - ref_ID from which we got the trait information
A long-format data frame with 6 columns: trait_ID
, work_ID
, species
,
trait_value
, agreement
and references
.
Denelle, P., Weigelt, P., & Kreft, H. (2023). GIFT—An R package to access the Global Inventory of Floras and Traits. Methods in Ecology and Evolution, 14, 2738-2748. https://doi.org/10.1111/2041-210X.14213 Weigelt, P, König, C, Kreft, H. GIFT – A Global Inventory of Floras and Traits for macroecology and biogeography. J Biogeogr. 2020; 47: 16– 43. https://doi.org/10.1111/jbi.13623
self_fertilization <- GIFT_traits(trait_IDs = "3.1.1", agreement = 0.66, bias_ref = FALSE, bias_deriv = FALSE)
self_fertilization <- GIFT_traits(trait_IDs = "3.1.1", agreement = 0.66, bias_ref = FALSE, bias_deriv = FALSE)
Retrieve metadata of the functional traits coming from GIFT.
GIFT_traits_meta( api = "https://gift.uni-goettingen.de/api/extended/", GIFT_version = "latest" )
GIFT_traits_meta( api = "https://gift.uni-goettingen.de/api/extended/", GIFT_version = "latest" )
api |
Character string corresponding to the API. |
GIFT_version |
character string defining the version of the GIFT database to use. The function retrieves by default the most up-to-date version. |
Here is what each column refers to:
Lvl1 - First level of the trait classification
Category - Name of the first level of classification
Lvl2 - Second level of the trait classification
Trait1 - Name of the second level of classification
Lvl3 - Identification number of the trait
Trait2 - Trait name
Units - Trait unit
type - Trait type
comment - Comment
count - How many entries for that traits are in the database
A data frame with 10 columns.
Denelle, P., Weigelt, P., & Kreft, H. (2023). GIFT—An R package to access the Global Inventory of Floras and Traits. Methods in Ecology and Evolution, 14, 2738-2748. https://doi.org/10.1111/2041-210X.14213 Weigelt, P, König, C, Kreft, H. GIFT – A Global Inventory of Floras and Traits for macroecology and biogeography. J Biogeogr. 2020; 47: 16– 43. https://doi.org/10.1111/jbi.13623
ex <- GIFT_traits_meta()
ex <- GIFT_traits_meta()
Retrieve non-aggregated trait values at the level of the bibliographic references and un-standardized species names in GIFT.
GIFT_traits_raw( trait_IDs = "", derived = TRUE, bias_ref = TRUE, bias_deriv = TRUE, api = "https://gift.uni-goettingen.de/api/extended/", GIFT_version = "latest" )
GIFT_traits_raw( trait_IDs = "", derived = TRUE, bias_ref = TRUE, bias_deriv = TRUE, api = "https://gift.uni-goettingen.de/api/extended/", GIFT_version = "latest" )
trait_IDs |
a character string indicating which traits you want to
retrieve. Traits must belong to the available list of traits. See
|
derived |
include logically derived traits. |
bias_ref |
When |
bias_deriv |
When |
api |
character string defining from which API the data will be retrieved. |
GIFT_version |
character string defining the version of the GIFT
database to use. The function retrieves by default the |
Here is the detail of each column:
trait_derived_ID - Identification number of the trait record in the
database
ref_ID - Identification number of the reference
orig_ID - Identification number of the species, as it came in the
source
trait_ID - Identification number of the trait
trait_value - Value of the trait (coded as character, even for
continuous trait)
derived - Is the trait value derived from another information (e.g.
phanerophytes are woody)
bias_deriv - Is the derivation potentially introducing a bias
bias_ref - Is the resource potentially introducing a bias
name_ID - Identification number of the species before being
resolved
cf_genus - Whether the genus name is uncertain
genus - Genus of the species
cf_species - Whether the species' epithet is uncertain
aff_species - Species' epithet uncertain
species_epithet - Epithet of the species
subtaxon - Sub-taxon name
author - Author who described the species
matched - Was the species name matched in the taxonomic backbone
epithetscore - Matching score for the epithet
overallscore - Overall matching score
resolved - Was the species name resolved in the taxonomic
backbone
service - Taxonomic backbone used for taxonomic harmonization
work_ID - Identification number of the taxonomically harmonized
species
genus_ID - Identification number of the taxonomically harmonized
genus
work_genus - Genus name (after taxonomic harmonization)
work_species - Species name (after taxonomic harmonization)
work_author - Name of the author who described the species
geo_entity _ref - Name of the region of the reference
ref_long - Full reference to cite
A data.frame with 28 columns.
Denelle, P., Weigelt, P., & Kreft, H. (2023). GIFT—An R package to access the Global Inventory of Floras and Traits. Methods in Ecology and Evolution, 14, 2738-2748. https://doi.org/10.1111/2041-210X.14213 Weigelt, P, König, C, Kreft, H. GIFT – A Global Inventory of Floras and Traits for macroecology and biogeography. J Biogeogr. 2020; 47: 16– 43. https://doi.org/10.1111/jbi.13623
GIFT_traits_meta()
and GIFT_traits()
succulence <- GIFT_traits_raw(trait_IDs = c("4.10.1"))
succulence <- GIFT_traits_raw(trait_IDs = c("4.10.1"))
Retrieve specific trait values at a high taxonomic level.
GIFT_traits_tax( trait_IDs = "", agreement = 0.66, bias_ref = TRUE, bias_deriv = TRUE, api = "https://gift.uni-goettingen.de/api/extended/", GIFT_version = "latest" )
GIFT_traits_tax( trait_IDs = "", agreement = 0.66, bias_ref = TRUE, bias_deriv = TRUE, api = "https://gift.uni-goettingen.de/api/extended/", GIFT_version = "latest" )
trait_IDs |
a character string indicating which trait you want to retrieve. Traits must belong to the available list of traits. |
agreement |
Percentage of resources that agree on an aggregated trait value, entries below this threshold will be omitted. |
bias_ref |
When |
bias_deriv |
When |
api |
character string defining from which API the data will be retrieved. |
GIFT_version |
character string defining the version of the GIFT
database to use. The function retrieves by default the |
Here is the detail of each column:
taxon_ID - Identification number of the taxon
taxon_name - Name of the taxon
agreement - Agreement score between the different sources for that
trait value, only for categorical traits
references - Source of the trait values (ref_ID
)
negative - Does the record indicate the absence of trait value in
taxon_ID
and then one column per trait with the respective trait values
A long-format data frame with 7 columns: taxon_ID
, taxon_name
,
trait_value
, agreement
, references
and negative
.
Denelle, P., Weigelt, P., & Kreft, H. (2023). GIFT—An R package to access the Global Inventory of Floras and Traits. Methods in Ecology and Evolution, 14, 2738-2748. https://doi.org/10.1111/2041-210X.14213 Weigelt, P, König, C, Kreft, H. GIFT – A Global Inventory of Floras and Traits for macroecology and biogeography. J Biogeogr. 2020; 47: 16– 43. https://doi.org/10.1111/jbi.13623
ex <- GIFT_traits_tax(trait_IDs = c("1.2.1", "1.4.1"), bias_ref = FALSE, bias_deriv = FALSE)
ex <- GIFT_traits_tax(trait_IDs = c("1.2.1", "1.4.1"), bias_ref = FALSE, bias_deriv = FALSE)
Returns a table with information on the different versions of the database
GIFT_versions()
GIFT_versions()
Here is what each column refers to:
ID - Identification number of the version
version - Version number
description - What were the major updates about
A data frame with 4 columns.
Denelle, P., Weigelt, P., & Kreft, H. (2023). GIFT—An R package to access the Global Inventory of Floras and Traits. Methods in Ecology and Evolution, 14, 2738-2748. https://doi.org/10.1111/2041-210X.14213 Weigelt, P, König, C, Kreft, H. GIFT – A Global Inventory of Floras and Traits for macroecology and biogeography. J Biogeogr. 2020; 47: 16– 43. https://doi.org/10.1111/jbi.13623
ex <- GIFT_versions()
ex <- GIFT_versions()
Shape file encompassing the western part of the Mediterranean basin. CRS is WGS84.
data("western_mediterranean")
data("western_mediterranean")
An object of class "sf"
data(western_mediterranean)
data(western_mediterranean)