summary.vp {bioRad} | R Documentation |
Inspect a vertical profile (vp
)
Description
R base functions for inspecting a vertical profile of biological targets
(vp
) object.
Usage
## S3 method for class 'vp'
summary(object, ...)
is.vp(x)
## S3 method for class 'vp'
dim(x)
Arguments
object |
A |
... |
Additional arguments affecting the summary produced. |
x |
A |
Details
A vertical profile of biological targets contains a collection of quantities,
organized in different (typically equally spaced) altitude layers (height
bins) above the earth's surface. A vertical profile (vp
) object is a list
containing:
-
radar
: Radar identifier. -
datetime
: Nominal time of the volume to which the scan belongs in UTC. -
data
: A data.frame with the profile's quantities organized per height bin. Useget_quantity()
to access these:-
height
: Height bin (lower bound) in m above sea level. -
u
: Ground speed component west to east in m/s. -
v
: Ground speed component south to north in m/s. -
w
: Vertical speed (unreliable!) in m/s. -
ff
: Horizontal ground speed in m/s. -
dd
: Ground speed direction in degrees clockwise from north. -
sd_vvp
: VVP radial velocity standard deviation in m/s. -
gap
: Angular data gap detected in T/F. -
dbz
: Animal reflectivity factor in dBZ. -
eta
: Animal reflectivity in cm^2/km^3. -
dens
: Animal density in animals/km^3. -
DBZH
: Total reflectivity factor (bio + meteo scattering) in dBZ. -
n
: Number of data points used for the ground speed estimates (quantitiesu
,v
,w
,ff
,dd
). -
n_all
: Number of data points used for the radial velocity standard deviation estimate (quantitysd_vvp
). -
n_dbz
: Number of data points used for reflectivity-based estimates (quantitiesdbz
,eta
,dens
). -
n_dbz_all
: Number of data points used for the total reflectivity estimate (quantityDBZH
).
-
-
attributes
: List of the vertical profile'swhat
,where
andhow
attributes.
Value
For summary.vp()
: prints summary of the vp
object.
For is.vp()
: TRUE
for an object of class vp
, otherwise
FALSE
.
For dim.vp()
: number of heights and quantities in a vertical
profile (vp
).
Conventions
-
NA
: Maps tonodata
in the ODIM convention: value to denote areas void of data (never radiated). -
NaN
: Maps toundetect
in the ODIM convention: denote areas below the measurement detection threshold (radiated but nothing detected). The value is also used when there are too few datapoints to calculate a quantity. -
0
: Maps to0
in the ODIM convention: denote areas where the quantity has a measured value of zero (radiated and value zero detected or inferred).
It depends on a radar's detection threshold or signal to noise ratio whether
it safe to assume an undetect
is equivalent to zero. When dealing with
close range data only (within 35 km), it is typically safe to assume aerial
densities (dens
) and reflectivities (eta
) are in fact zero in case of
undetects.
See Also
Examples
# Check if an object is of class vp
is.vp(example_vp)
# Get summary info
example_vp # Same as summary(example_vp) or print(example_vp)
# Get dimensions
dim(example_vp)