MetFns (version 2.1.0)

filter: Global filter

Description

Various data selections for a given visual meteor data. Wrapper function for filters by shower code, date, time period, IMO observer code, observer's name, geographical coordinates, site, country, limiting magnitude, correction factor for field-of-view obstruction, solar longitude, radiant elevation and total correction factor.

Usage

filter(data,year = NULL,month.beg = NULL,month.end=month.beg,day.beg = NULL,
day.end = day.beg,time.beg=0,time.end=2359,shw = NULL,imocode = NULL,
long.low = 0,long.up = 180,ew = c("E", "W"),lat.low = 0,lat.up = 90,
ns = c("N", "S"),name = NULL,fname = NULL,site = NULL,country = NULL,
mag.low = 3,mag.up = 8,F.low = 1,F.up = 3,sol.low = 0,sol.up = 360,
Ralpha = NULL,Delta = NULL,h.low = 10,h.up = 90,r = NULL,C = 5)

Arguments

data

data frame consisting of visual meteor data (rate or magnitude data).

year

numeric vector of length 4 specifying year.

month.beg

numeric vector specifying the beginning month.

month.end

numeric vector specifying the ending month. By default, month.end is set to be equal to month.beg.

day.beg

numeric vector specifying the beginning day.

day.end

numeric vector specifying the ending day. By default, day.end is set to be equal to day.beg.

time.beg

numeric vector (0-2359) specifying lower boundary of time in hours and minutes, corresponding to day.beg. By default, time.beg is set to be equal to 0.

time.end

numeric vector(0-2359) specifying upper boundary of time in hours and minutes, corresponding to day.end. By default, time.end is set to be equal to 2359.

shw

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

imocode

character string consisting of five capital letters which represent IMO observer code.

long.low

numeric vector taking a value between 0 (default) and 180, specifying lower boundary of longitude in degrees.

long.up

numeric vector taking a value between 0 and 180 (default), specifying upper boundary of longitude in degrees.

ew

character vector (E,W), specifying east or west position from the prime meridian.

lat.low

numeric vector taking a value between 0 (default) and 90, specifying lower boundary of latitude in degrees.

lat.up

numeric vector taking a value between 0 and 90 (default), specifying upper boundary of latitude in degrees.

ns

character vector (N,S), specifying north or south position from equator.

name

character string representing observer's last name.

fname

character string representing observer's first name.

site

character string specifying name of the observing site.

country

character string specifying name of the country.

mag.low

numeric vector with value between 3.0 (default) and 8.0, specifying lower boundary of limiting magnitude.

mag.up

numeric vector with value between 3.0 and 8.0 (default), specifying upper boundary of limiting magnitude.

F.low

numeric vector with value between 1.0 (default) and 3.0, specifying lower boundary of correction factor for field-of-view obstruction.

F.up

numeric vector with value between 1.0 and 3.0 (default), specifying upper boundary of correction factor for field-of-view obstruction.

sol.low

numeric vector with value between 0 (default) and 360, specifying lower boundary of solar longitude in degrees.

sol.up

numeric vector with value between 0 and 360 (default), specifying upper boundary of solar longitude in degrees.

Ralpha

numeric vector with value between 0 and 360, specifying right ascension of the radiant, in degrees.

Delta

numeric vector with value between -90 and +90, specifying declination of the radiant, in degrees.

h.low

numeric vector with value between 10 (default) and 90, specifying lower boundary of radiant elevation in degrees.

h.up

numeric vector with value between 10 and 90 (default), specifying upper boundary of radiant elevation in degrees.

r

numeric vector specifying population index of a meteor shower.

C

numeric vector specifying total correction factor. C=5 is set as a default value.

Details

Depending on the given arguments, the function filter calls one or more particular filters for selection of visual meteor data.

References

http://www.imo.net/data/visual

Rendtel J. and Arlt R., editors (2008). IMO Handbook For Meteor Observers. IMO, Potsdam.

See Also

filter.shw, filter.datetime, filter.imocode, filter.obsname, filter.site, filter.country, filter.gc, filter.mag, filter.F, filter.sol, filter.h, filter.totcor

Examples

## select rate and magnitude data for observations of 1997 Perseids, time period 28th July
## to 16th August, radiant elevation higher than 20 degrees, 
## total correction factor smaller than 5(default)
data(rate97)
filter(rate97,year=1997,month.beg=7,month.end=8,day.beg=28,day.end=16,shw="PER",h.low=20)

data(magn97)
filter(magn97,year=1997,month.beg=7,month.end=8,day.beg=28,day.end=16,shw="PER",h.low=20)