Metadata

Much of the information in the FinBIF database consists of metadata that helps provide context for occurrence records and other information in FinBIF.

General metadata

You can see some of the metadata available in {finbif} by calling the finbif_metadata function without any arguments.

finbif_metadata()
Click to show/hide output.

#>                metadata_name
#> 1          regulatory_status
#> 2                   red_list
#> 3                    country
#> 4                     region
#> 5               bio_province
#> 6               municipality
#> 7            bird_assoc_area
#> 8  finnish_occurrence_status
#> 9               habitat_type
#> 10         habitat_qualifier
#> 11                life_stage
#> 12              record_basis
#> 13         restriction_level
#> 14        restriction_reason
#> 15              sex_category
#> 16                    source
#> 17                taxon_rank


Calling finbif_metadata() and specifying one of the metadata categories will display a data.frame with the requested metadata.

finbif_metadata("red_list")
Click to show/hide output.

#>           code name                 
#> MX.iucnCR CR   Critically Endangered
#> MX.iucnDD DD   Data Deficient       
#> MX.iucnEN EN   Endangered           
#> MX.iucnEX EX   Extinct              
#> MX.iucnEW EW   Extinct in the Wild  
#> MX.iucnLC LC   Least Concern        
#> MX.iucnNT NT   Near Threatened      
#> MX.iucnNA NA   Not Applicable       
#> MX.iucnNE NE   Not Evaluated        
#> MX.iucnRE RE   Regionally Extinct   
#> MX.iucnVU VU   Vulnerable           


Special cases

Some more complex metadata is accessed with other {finbif} functions

Informal groups

Informal taxonomic groups and their relationships can be displayed with finbif_informal_groups()

finbif_informal_groups(limit = 2)
#> Algae
#>   --Macro algae
#>       --Brown algae and yellow green algae
#>       --Green algae
#>       --Red algae
#>       --Stoneworts
#> Birds
#>   --Birds of prey and owls
#>       --Birds of prey
#>       --Owls
#>   --Waterbirds
#> ...137 more groups

You can select a subgroup by specifying a parent informal group as a function argument.

finbif_informal_groups("Crustaceans")
#> Crustaceans
#>   --Macrocrustaceans
#>       --Amphipods, isopods, opossum shrimps
#>       --Crabs, shrimps and crayfishes
#>       --Other macrocrustaceans
#>       --Woodlice
#>   --Microcrustaceans
#>       --Branchiopoda
#>       --Copepods
#>       --Seed shrimps

Collections

Another special case of metadata is finbif_collections(). Collections are the highest level of record aggregation in the FinBIF database.

You can subset collection metadata by using the filter and select arguments.

finbif_collections(
  filter = geographic_coverage == "Finland",
  select = c("collection_name", "taxonomic_coverage", "count")
)
Click to show/hide output.

#>         collection_name                   taxonomic_coverage                count  
#> HR.1227 Priv. coll. Mikko Heikkinen       Biota                                  62
#> HR.1349 JYV - Fungal collections          <NA>                                13477
#> HR.1350 JYV - Lichen collections          <NA>                                  608
#> HR.1351 JYV - Bryophyte collections       <NA>                                 8367
#> HR.1467 Per-Eric Grankvist´s butterly co… Lepidoptera                             5
#> HR.1487 JYV - Fish collections            <NA>                                 1371
#> HR.1507 Lingonblad Birger och Hjördis bu… Lepidoptera                          2796
#> HR.157  Point counts of breeding terrest… Birds, landbirds                   393361
#> HR.1592 Herbarium of The Ark Nature Cent… <NA>                                 7871
#> HR.1687 Papilionoidea of Coll. Lauro      Papilionoidea                         550
#> HR.1688 Noctuidae I of Coll. Lauro        Noctuidae                             614
#> HR.1689 Noctuidae II of Coll. Lauro       Noctuidae                             839
#> HR.1690 Noctuidae III, Bombycoidea, Sphi… Noctuidae, Bombycoidea, Geometri…     521
#> HR.1691 Drepanidae & Geometridae of Coll… Drepanidae, Geometridae              1408
#> HR.175  National Finnish butterfly monit… Lepidoptera                        450525
#> HR.1916 Wildlife triangle                 Siberian flying squirrel (Pterom…   18560
#> HR.200  Finnish Insect Database           Insecta                           3725381
#> HR.2009 Fish observation data from the n… invasive alien fish species - mu…   35582
#> HR.2049 Invasive alien species control    Invasive species                     1502
#> HR.206  The Finnish Nature League's Spri… biota                              119323
#> HR.2089 Håkan Lindberg collection         Hymenoptera                          2435
#> HR.209  Atlas of Finnish Macrolepidoptera Macrolepidoptera                  1218555
#> HR.2129 Fungal atlas                      fungi                              116519
#> HR.2209 KUO Arachnida collection          Arachnida                               3
#> HR.2289 Specimens that lack collecting i… <NA>                                  109
#> HR.2691 Luomus line transect censuses of… Aves                               628987
#> HR.2692 Censuses of breeding birds - Are… Aves                                14963
#> HR.3051 VieKas LIFE project invasive spe… <NA>                                 1545
#> HR.3071 Observing species on milk farms   <NA>                                  529
#> HR.3211 iNaturalist Suomi Finland         biota                              691050
#> HR.3491 LajiGIS: Aquatic species survey   Biota                              643837
#> HR.3553 LajiGIS: Species monitoring sites Biota                              731965
#> HR.3671 Bird of prey nests for protection Aves                                13323
#> HR.3691 eBird                             Aves                              1100308
#> HR.3791 Invasive species observations     Biota                                3268
#> HR.39   Winter Bird Census                Aves, Mammalia                    1483842
#> HR.3911 Bumblebee census                  Bumblebees                          29949
#> HR.3991 Waterbird counts, Luomus dataset  Aves                                39236
#> HR.3992 Waterbird counts, Luke dataset 2… Aves                                30145
#> HR.4011 Salmonidae in streams             Salmonidae                          12630
#> HR.4051 LajiGIS: Species monitoring site… Aquila chrysaetos; Haliaeetus al…    8669
#> HR.4091 Retkikasvio                       <NA>                                   84
#> HR.4131 Butterflies in Finnish agricultu… Papilionoidea, Others              356987
#> HR.4191 Porvoo Museum / Butterfly Collec… Lepidoptera                         10417
#> HR.4251 LajiGIS: Species mapping and sur… Biota                              490816
#> HR.435  Löydös Open Invasive Species Obs… Biota                               19232
#> HR.4352 NFI rare tree species             <NA>                                  995
#> HR.4412 Tiira.fi: The Fourth Breeding Bi… Aves                               329445
#> HR.4471 4th Finnish Bird Atlas 2022–2025… Aves                               165551
#> HR.4511 Finnish National Moth Monitoring  Bombycoidea, Noctuoidea, Sphingi… 1156373
#> HR.4611 Observations by FCG Finnish Cons… <NA>                                  462
#> HR.4612 Pollinator monitoring, line tran… Insecta                              7885
#> HR.4672 Observations from publications    Biota                                 127
#> HR.4711 Flying squirrel monitoring        Pteromys volans                      2509
#> HR.4991 Bird atlas observations manually… Aves                                 6620
#> HR.5095 Dragonfly complete lists          Odonata                                29
#> HR.5155 Observations from electronic sou… Biota                                1372
#> HR.5196 Pollinator monitoring, pan traps  Insecta                              5688
#> HR.5235 Finnish butterflies - complete l… Lepidoptera, Papilinoidea              21
#> HR.5236 Charismatic flowering plants - c… Tracheophyta                          277
#> HR.60   Monitoring scheme of birds and m… Aves, Mammalia                     874130
#> HR.627  Alien mammal species observation… Invasive alien mammal species – …    3094
#> HR.808  E. Sjöholm´s butterfly collection Lepidoptera                          4951
#> HR.847  Atlas of amphibians and reptiles… Amphibia, Reptilia                   6690


By default, finbif_collections() only displays the lowest level collections. Higher level, “supercollections” can be viewed by setting supercollections = TRUE and you can limit the output to collections with a minimum number of records in them with the nmin argument.

collections <- finbif_collections(supercollections = TRUE, nmin = 10000)

The finbif_collections() function returns a data.frame where the row names are the ID number of the collection.

finbif_collections(supercollections = TRUE)["HR.128", "collection_name"]
Click to show/hide output.

#> Collections of the Finnish Museum of Natural History Luomus


You can see the child collections of a supercollection by specifying the ID as a filter. Note that the children of supercollections may also be supercollections.

finbif_collections(is_part_of == "HR.128", supercollections = TRUE)
Click to show/hide output.

#>         collection_name abbreviation description online_url has_children is_part_of data_quality
#> HR.129  Collections of… H            Herbarium … <NA>        TRUE        HR.128     MY.dataQual…
#> HR.160  Zoological col… MZH          The collec… http://ww…  TRUE        HR.128     MY.dataQual…
#> HR.173  Zoological mon… <NA>         Monitoring… <NA>        TRUE        HR.128     MY.dataQual…
#> HR.1849 Genomic resour… <NA>         Genomic re… <NA>        TRUE        HR.128     MY.dataQual…
#> HR.203  Löydös Open Fi… <NA>         A service … https://l… FALSE        HR.128     <NA>        
#> HR.435  Löydös Open In… <NA>         A service … https://l… FALSE        HR.128     MY.dataQual…
#> HR.447  Hatikka.fi obs… <NA>         Hatikka.fi… http://ha… FALSE        HR.128     MY.dataQual…
#> HR.48   Ringing and re… TIPU         Dataset co… <NA>        TRUE        HR.128     MY.dataQual…
#>         methods   collection_type taxonomic_coverage geographic_coverage temporal_coverage
#> HR.129  <NA>      MY.collectionT… <NA>               <NA>                <NA>             
#> HR.160  <NA>      MY.collectionT… Animalia           World               1700 to present  
#> HR.173  <NA>      MY.collectionT… <NA>               Finland             1950-            
#> HR.1849 Sampling… MY.collectionT… Biota              World               2000-            
#> HR.203  <NA>      MY.collectionT… biota              world               2013-            
#> HR.435  <NA>      MY.collectionT… Biota              Finland             2015-            
#> HR.447  <NA>      MY.collectionT… Biota              World               <NA>             
#> HR.48   <NA>      MY.collectionT… Aves               Ringing data: Finl… 1913-            
#>         secure_level count   
#> HR.129  <NA>                2
#> HR.160  MX.secureLe…      742
#> HR.173  <NA>          5160221
#> HR.1849 <NA>                1
#> HR.203  <NA>            39375
#> HR.435  <NA>            19232
#> HR.447  <NA>          2010032
#> HR.48   <NA>         12910437