Title: | Simulation of Bird Flight Range |
---|---|
Description: | Functions for range estimation in birds based on Pennycuick (2008) and Pennycuick (1975), 'Flight' program which compliments Pennycuick (2008) requires manual entry of birds which can be tedious when there are thousands of birds to estimate. Implemented are two ODE methods discussed in Pennycuick (1975) and time-marching computation method "constant muscle mass" as in Pennycuick (1998). See Pennycuick (1975, ISBN:978-0-12-249405-5), Pennycuick (1998) <doi:10.1006/jtbi.1997.0572>, and Pennycuick (2008, ISBN:9780080557816). |
Authors: | Brian Masinde [aut, cre], Krzysztof Bartoszek [ctb, ths] |
Maintainer: | Brian Masinde <[email protected]> |
License: | Apache License |
Version: | 0.1.3 |
Built: | 2024-11-07 04:27:49 UTC |
Source: | https://github.com/cran/flying |
Preset birds data, extracted from Flight program. Fat mass percentage generated randomly where zero.
birds
birds
A data frame with 28 observations and 5 variables not counting the name.
Name of bird species
Body mass in Kg. Includes fuel. All-up mass with crop empty. Not to be confused with lean mass.
Length of wings spread out in metres
Mass of fat that is consumable as fuel in Kg
Order of the spicies (passerine vs non-passerine)
Area of both wing projected on a flat surface in metres squared
Mass in Kg. of flight muscles
Practical range estimation of birds using methods in Pennycuik (1975) Mechanics of Flight. These methods are based on Breguet equations.
flysim(file, header = TRUE, sep = ",", quote = "\"", dec = ".", fill = TRUE, comment.char = "", ..., data = NULL, settings = list())
flysim(file, header = TRUE, sep = ",", quote = "\"", dec = ".", fill = TRUE, comment.char = "", ..., data = NULL, settings = list())
file |
Arguments for path to data. |
header |
Logical. If TRUE use first row as column headers |
sep |
separator |
quote |
The set of quoting characters. see read.csv |
dec |
The character used in the file for decimal points. |
fill |
See read.csv |
comment.char |
For more details see read.csv |
... |
further arguments see read.csv |
data |
A data frame. |
settings |
A list for re-defining constants. See details. |
The option *settings takes the arguments (those particulary required by this function)
ppc: Profile power constant
eFat: Energy content of fuel from fat
g: Accelaration due to gravity
mce: Mechanical conversion efficiency [0,1]
ipf: Induced power factor
vcp: Ventilation and circulation power
airDensity: Air density at cruising altitude
bdc: Body drag coefficient
alpha: Basal metabolism factors in passerines and non passerines
delta: Basal metabolism factors in passerines and non passerines alpha*bodyMass^delta
S3 class object with range estimates based on methods defined and settings used
range estimates (Km)
settings used
data
Brian Masinde
flysim(data = birds, settings = list(eFat = 3.89*10^7)) flysim(data = birds, settings = list(airDensity = 0.905))
flysim(data = birds, settings = list(eFat = 3.89*10^7)) flysim(data = birds, settings = list(airDensity = 0.905))
Practical range estimation of birds using methods in Pennycuick (1998) and Pennycuick (2008).
migrate(file, header = TRUE, sep = ",", quote = "\"", dec = ".", fill = TRUE, comment.char = "", ..., data = NULL, settings = list(), method = "cmm", speed_control = "constant_speed", protein_met = 0)
migrate(file, header = TRUE, sep = ",", quote = "\"", dec = ".", fill = TRUE, comment.char = "", ..., data = NULL, settings = list(), method = "cmm", speed_control = "constant_speed", protein_met = 0)
file |
The name of the file which the data are to read from |
header |
Logical. If TRUE use first row as column headers |
sep |
separator |
quote |
The set of quoting characters. see read.csv |
dec |
The character used in the file for decimal points |
fill |
See read.csv |
comment.char |
For more details see read.csv |
... |
further arguments see read.csv |
data |
A data frame |
settings |
A list for re-defining constants. See details |
method |
Methods for fuel management |
speed_control |
One of two speed control methods. By default constant_speed is used. vvmp_constant is the alternative. The former holds the true airspeed constant while the latter holds the ratio of true airspeed and minimum power speed constant |
protein_met |
Percentage of energy attributed to protein and metabolism |
The option *control takes the folowing arguments
ppc: Profile power constant
eFat: Energy content of fuel from fat
eProtein: Energy content of protein
g: Accelaration due to gravity
mce: Mechanical conversion efficiency [0,1]
ipf: Induced power factor
vcp: Ventilation and circulation power
airDensity: Air density at cruising altitude
bdc: Body drag coefficient
alpha: Basal metabolism factors in passerines and non passerines
delta: Basal metabolism factors in passerines and non passerines alpha*bodyMass^delta
invPower
speedRatio: True air speed to minimum power speed ratio
muscDensity: Density of the flight muscles.
phr: Protein hydration ratio
S3 class object with range estimates based on methods defined and settings
data as a data frame
range estimates (Km)
fuel
settings (named vector)
Brian Masinde
migrate(data = birds, settings = list(eFat = 3.89*10^7)) migrate(data = birds, method = "cmm", settings = list(airDensity = 0.905))
migrate(data = birds, settings = list(eFat = 3.89*10^7)) migrate(data = birds, method = "cmm", settings = list(airDensity = 0.905))