Skip to contents

Create bird flight traits

Source: R/bird_create.R
bird_create.Rd

This function returns a list with the four morphological information necessary to construct the power curve: mass, wing span, wing aspect ratio, and body frontal area.

When any of these variables are missing, we query the AVONET database using the scientific name from the Clements Checklist.

Usage

bird_create(
  scientific_name,
  mass = NULL,
  wing_span = NULL,
  wing_aspect = NULL,
  wing_area = NULL,
  body_frontal_area = NULL,
  species_name = deprecated()
)

Arguments

scientific_name

Scientific name of the species

mass

Mass of the bird in kilograms

wing_span

Wing span in meters

wing_aspect

Wing aspect ratio (no unit)

wing_area

Wing area in meter square

body_frontal_area

Body frontal area in meter square

species_name

[Deprecated] Use scientific_name instead

Value

List containing mass, wing span, wing aspect ratio, and body frontal area.

See also

Other bird: print.bird()

Other movement: graph_set_movement(), graph_transition(), plot_graph_movement(), speed2prob(), tag_download_wind()

Examples

# Using AVONET dataset
bird_create("Acrocephalus arundinaceus")
#> 
#> ── GeoPressureR `bird` object ──────────────────────────────────────────────────
#> • Scientific name: Acrocephalus arundinaceus
#> • Mass: 0.03 (kg).
#> • Body frontal area: 0 (m^2).
#> • Wing span: 0.2 (m).
#> • Wing aspect: 7.1 (-).

# Using AVONET dataset + custom values
bird_create("Acrocephalus arundinaceus", wing_aspect = 8)
#> 
#> ── GeoPressureR `bird` object ──────────────────────────────────────────────────
#> • Scientific name: Acrocephalus arundinaceus
#> • Mass: 0.03 (kg).
#> • Body frontal area: 0 (m^2).
#> • Wing span: 0.2 (m).
#> • Wing aspect: 8 (-).

# Import your own bird. You will need mass, and at least two of wing_span,
# wing_aspect or wing_area.
bird_create("Madynuss nutshell", mass = 8, wing_span = 0.2, wing_aspect = 4)
#> 
#> ── GeoPressureR `bird` object ──────────────────────────────────────────────────
#> • Scientific name: Madynuss nutshell
#> • Mass: 8 (kg).
#> • Body frontal area: 0 (m^2).
#> • Wing span: 0.2 (m).
#> • Wing aspect: 4 (-).