| migrate {FlyingR} | R Documentation |
Range Estimation
Description
Practical range estimation of birds using methods from Pennycuick (2008).
Usage
migrate(file, header = TRUE, sep = ",", quote = "\"", dec = ".",
fill = TRUE, comment.char = "", ...,
data = NULL, settings = list(), method = "cmm",
speed_control = 1, min_energy_protein = 0.05)
Arguments
file |
Path to file where data resides. |
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 with required columns: body mass (Kg), fat mass (Kg), muscle mass (Kg), wing span (m), wing area (m^2), order / taxon (passerines = 1, non passerines = 2). |
settings |
A list for re-defining constants. See details for these with default values from Pennycuick(2008) and Pennycuick(1998). |
method |
Methods for protein energy consumption from muscle mass |
speed_control |
One of two speed control methods. By default 1 is used. 0 is the alternative. The former holds the true airspeed constant while the latter holds the ratio of true airspeed to the minimum power speed constant (V:Vmp constant). |
min_energy_protein |
Percentage of energy attributed to protein due to metabolism. Default value is 5 percent (0.05). If method "csw" or "csp" is chosen, 2 would be attained from consuming protein in the airframe mass. |
Details
The option *control takes the following arguments
ppc: Profile power constant (8.4).
fed: Energy content of fuel from fat (3.9E+07).
ped: Energy content of protein (1.8E+07).
g: Acceleration due to gravity (9.81).
mce: Mechanical conversion efficiency [0,1]. Efficiency at which mechanical power is converted to chemical power (0.23).
ipf: Induced power factor (1.2).
vcp: Ventilation and circulation power (1.1).
airDensity: Air density at cruising altitude (1.00).
bdc: Body drag coefficient (0.1).
alpha: Basal metabolism factors in passerines and non passerines (6.25, 3.79).
delta: Basal metabolism factors in passerines and non passerines (0.724, 0.723) alpha*bodyMass^delta.
mipd: Inverse power density of the mitochondria (1.2E-06).
speedRatio: True air speed to minimum power speed ratio (1.2).
muscDensity: Density of the flight muscles (1060).
phr: Protein hydration ratio (2.2). Whenever protein is consumed from the muscle mass some amount of water is lost in the process. This water is estimated as the mass of dry protein time the phr.
Value
S3 class object with range estimates based on methods defined and settings
range estimates (Km)
remaining body mass (Kg)
remaining fat mass (Kg)
remaining muscle mass (Kg)
minimum power speed at start of flight (m/s)
minimum power speed at end of flight (m/s)
taxon (order)
Author(s)
Brian Masinde
Examples
migrate(data = birds, settings = list(fed = 3.89*10^7))
migrate(data = birds, method = "cmm", settings = list(airDensity = 0.905))