pop.index2: Calculation of population index based on average distance...

Description Usage Arguments Details Value Author(s) References See Also Examples

View source: R/pop.index2.R

Description

Calculates population index of a meteor shower for a given magnitude data, specified time period, minimum and maximum bin size, and number of meteors.

Usage

1
pop.index2(data,date.start,date.end,shw,kmin=0.01,kmax=1,num,gamma=1) 

Arguments

data

data frame consisting of visual meteor magnitude data.

date.start

character vector or factor specifying start date, given in "%Y-%m-%d %H:%M:%S" format (UTC timezone).

date.end

character vector or factor specifying end date, given in "%Y-%m-%d %H:%M:%S" format (UTC timezone).

shw

character string consisting of three capital letters which represent meteor shower code.

kmin

numeric vector specifying minimum bin size, in degrees of solar longitude. By default, it is equal to 0.01. Minimum accepted value is 0.001.

kmax

numeric vector specifying maximum bin size, in degrees of solar longitude. By default, it is equal to 1. Maximum accepted values is 5.

num

numeric vector specifying total number of meteors per interval.

gamma

numeric vector specifying zenith exponent. It takes value between 1 (default) and 2.

Details

Optimal bin size algorithm is used. It searches for an optimal bin size between minimum bin size kmin and maximum bin size kmax with total number of meteors per bin num. If there are not enough meteors, a maximum bin size is used. For further calculations, only observing intervals with lengths smaller or equal to optimal bin are used.

Average distance from the limiting magnitude, as difference between the limiting magnitude and average meteor magnitude, is calculated for each observing time interval. Final average distance from the limiting magnitude is calculated as a weighted average of all individual average distances, where numbers of meteors in each observing interval represent weights. Conversion of average distance from limiting magnitude to population index is done using natural spline interpolation spline of table values popind. Error margins of population index are calculated using bilinear interpolation interp2 of table values popind.err.

If total number of meteors per bin is smaller than 10, NA values are returned for population index and its standard error. For the case when total number of meteors is greater than 9369, polynomial regression of second degree is used in calculation of standard error of population index.

Value

Data frame containing following vectors

sollong

numeric Mean of observers' solar longitudes weighted by N_{obs}/C_{obs}, observers' numbers of meteors divided by total correction factor

date

POSIXct Calendar date and time in UTC corresponding to sollong

nINT

numeric Number of observing time intervals

nSHW

numeric Number of observed meteors belonging to the shower

pop.index

numeric Population index

r.error

numeric Error margins of population index

Author(s)

Kristina Veljkovic

References

Arlt, R. (2003). Bulletin 19 of the International Leonid Watch: Population index study of the 2002 Leonid meteors. WGN, Journal of the IMO,31:3, 77-87.

See Also

pop.index,pop.index.plot

Examples

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
## calculate population index for observations of 2015 Orionids, 
## time period around maximum, 21th to 25th October, 
## min bin size 0.16 degrees (4 hours), max bin size 1 degree, 
## number of meteors equals 100 
## First select magnitude data for Orionids activity from 21th to 25th October, 
## limiting magnitudes above 5, radiant elevation above 20 degrees, 
## percentage of clouds below 20
ori2015mag<-filter(magn2015,date.start="2015-10-21",date.end="2015-10-25",
shw="ORI",P.up=20,mag.low=5,h.low=20)
pop.index2(ori2015mag,date.start="2015-10-21",date.end="2015-10-25",shw="ORI",
kmin=0.16,kmax=1,num=100)

MetFns documentation built on May 1, 2019, 6:28 p.m.