paleotree (version 1.0)

binTimeData: Bin Temporal Ranges in Discrete Intervals

Description

Converts a matrix of continuous-time first occurances and last occurances for fossil taxa into first and last occurances given in discrete-time intervals, along with information the dates of the given intervals.

Usage

binTimeData(timeData, int.length = 1, start = NA)

Arguments

timeData

Two-column matrix of first and last occurrances in absolute continous time

int.length

Time Interval Length

start

The starting time for calculating the intervals.

Value

• a list containing:
• int.times
  A 2 column matrix with the start and end times of the intervals used.
• taxon.times
  A 2 column matrix with the first and last occurances of taxa in the intervals used, with numbers referring to the row of int.times.

Details

This function takes a matrix of per-taxon first and last occurrances and divides those occurances into time intervals, each interval as long as int.length. As with many functions in the paleotree library, absolute time is always decreasing, i.e. the present day is zero. The numbering of intervals given in the output increase with time, however, as these are in relative time.

See Also

simFossilTaxa,sampleRanges,taxicDivCont

Examples

#Simulate some fossil ranges with simFossilTaxa()
set.seed(444)
taxa<-simFossilTaxa(p=0.1,q=0.1,nruns=1,mintaxa=20,maxtaxa=30,maxtime=1000,nExtant=0)
#simulate a fossil record with imperfect sampling with sampleRanges()
rangesCont<-sampleRanges(taxa,r=0.5)
#Now let's use binTimeData() to bin in intervals of 1 time unit
rangesDisc<-binTimeData(rangesCont,int.length=1)
#plot with taxicDivDisc()
taxicDivDisc(rangesDisc)