Skip to contents

Splitting a MoveStack or MoveBurst into a list of Move objects. Splitting a DBBMMStack into a list of DBBMM objects.

Usage

# S4 method for MoveStack,missing
split(x, f, drop=FALSE, ...)

Arguments

x

a moveStack, moveBurst or DBBMMStack object

f

not needed

drop

not needed

...

Currently not implemented

Details

A MoveStack is split into a list of Move objects by the trackId slot of the given MoveStack, obtaining one move object per unique trackId (usually corresponding to animal names). For staking this list of move objects use moveStack.

A MoveBurst object is split into a list of Move objects by the burstId slot of the given MoveBurst. One move object per burst (e.g. segment with given behavior) is obtained. Every location where the burst is switched will be recycled.

A DBBMMStack is split into a list of DBBMM objects by the trackId slot of the given DBBMMStack.

Value

'list'

Note

After splitting any object, the coordinates in the @coords slot in the resulting objects are named "coords.x1" and "coords.x2" (due to the usage of functions of other packages within this function).

Author

Marco Smolla & Anne Scharf

Examples

## splitting a MoveStack
data(fishers)
split(fishers)
#> $Leroy
#> class       : Move 
#> features    : 919 
#> extent      : -73.93067, -73.84366, 42.70898, 42.7687  (xmin, xmax, ymin, ymax)
#> crs         : +proj=longlat +datum=WGS84 +no_defs 
#> variables   : 20
#> names       :      timestamp, eobs.battery.voltage, eobs.horizontal.accuracy.estimate, eobs.key.bin.checksum, eobs.speed.accuracy.estimate,    eobs.start.timestamp, eobs.status, eobs.temperature, eobs.type.of.fix, eobs.used.time.to.get.fix, ground.speed, heading, height.above.ellipsoid,      utm.easting,     utm.northing, ... 
#> min values  :     1234354605,                 3596,                              3.07,               3258904,                         0.27, 2009-02-11 12:14:59.000,           A,               13,                3,                         4,         0.01,       0,                 -169.6, 587507.837877134, 4729143.16566605, ... 
#> max values  : 1236158219.998,                 3666,                             97.02,            4291715164,                        33.04, 2009-03-04 09:15:01.000,           A,               35,                3,                       119,        31.71,  359.79,                    349, 594679.382402579, 4735720.47868847, ... 
#> timestamps  : 2009-02-11 12:16:45 ... 2009-03-04 09:16:59.998 Time difference of 21 days  (start ... end, duration) 
#> sensors     : gps 
#> indiv. data : eobs.fix.battery.voltage, manually.marked.outlier, visible, sensor.type, individual.taxon.canonical.name, tag.local.identifier, individual.local.identifier, study.name, study.timezone, behavioural.classification 
#> indiv. value: 0 NA true gps Martes pennanti 74 Leroy Urban fisher GPS tracking Eastern Standard Time NA 
#> unused rec. : 1071 
#> date created: 2023-01-20 15:56:43 
#> 
#> $Ricky.T
#> class       : Move 
#> features    : 1000 
#> extent      : -73.90627, -73.86868, 42.82073, 42.84787  (xmin, xmax, ymin, ymax)
#> crs         : +proj=longlat +datum=WGS84 +no_defs 
#> variables   : 20
#> names       :      timestamp, eobs.battery.voltage, eobs.horizontal.accuracy.estimate, eobs.key.bin.checksum, eobs.speed.accuracy.estimate,    eobs.start.timestamp, eobs.status, eobs.temperature, eobs.type.of.fix, eobs.used.time.to.get.fix, ground.speed, heading, height.above.ellipsoid,      utm.easting,     utm.northing, ... 
#> min values  :     1265734883,                 3449,                              2.05,               4650399,                         0.22, 2010-02-09 17:00:00.000,           A,              -12,                3,                         3,            0,       0,                  -66.9, 589371.663697607, 4741523.16795979, ... 
#> max values  : 1266568086.999,                 3732,                             80.64,            4292563084,                        32.18, 2010-02-19 08:27:59.000,           A,               15,                3,                       120,        43.12,  359.79,                  231.6, 592472.208433074, 4744523.82522186, ... 
#> timestamps  : 2010-02-09 17:01:23 ... 2010-02-19 08:28:06.999 Time difference of 10 days  (start ... end, duration) 
#> sensors     : gps 
#> indiv. data : eobs.fix.battery.voltage, manually.marked.outlier, visible, sensor.type, individual.taxon.canonical.name, tag.local.identifier, individual.local.identifier, study.name, study.timezone, behavioural.classification 
#> indiv. value: NA NA true gps Martes pennanti 1016 Ricky.T Urban fisher GPS tracking Eastern Standard Time NA 
#> unused rec. : 1888 
#> date created: 2023-01-20 15:56:43 
#> 

## splitting a DBBMMStack
data(dbbmmstack)
split(dbbmmstack)
#> $Leroy
#> class      : DBBMM 
#> dimensions : 45, 21, 945  (nrow, ncol, ncell)
#> resolution : 617.1116, 617.1116  (x, y)
#> extent     : -6478.702, 6480.641, -13884.56, 13885.46  (xmin, xmax, ymin, ymax)
#> crs        : +proj=aeqd +lat_0=42.778423 +lon_0=-73.8871629 +x_0=0 +y_0=0 +datum=WGS84 +units=m +no_defs 
#> source     : memory
#> names      : Leroy 
#> values     : 0, 0.08993285  (min, max)
#> 
#> 
#> $Ricky.T
#> class      : DBBMM 
#> dimensions : 45, 21, 945  (nrow, ncol, ncell)
#> resolution : 617.1116, 617.1116  (x, y)
#> extent     : -6478.702, 6480.641, -13884.56, 13885.46  (xmin, xmax, ymin, ymax)
#> crs        : +proj=aeqd +lat_0=42.778423 +lon_0=-73.8871629 +x_0=0 +y_0=0 +datum=WGS84 +units=m +no_defs 
#> source     : memory
#> names      : Ricky.T 
#> values     : 0, 0.7150807  (min, max)
#> 
#> 

## splitting a MoveBurst
data(leroy)
behav <- c(rep(c("a","b","c","a"),each=200), rep("b", 118))
leroyBurst <- burst(x=leroy, f=behav)
split(leroyBurst)
#> $a
#> class       : Move 
#> features    : 201 
#> extent      : -73.92547, -73.84369, 42.71322, 42.76135  (xmin, xmax, ymin, ymax)
#> crs         : +proj=longlat +datum=WGS84 +no_defs 
#> variables   : 17
#> names       :      timestamp, eobs.battery.voltage, eobs.horizontal.accuracy.estimate, eobs.key.bin.checksum, eobs.speed.accuracy.estimate,    eobs.start.timestamp, eobs.status, eobs.temperature, eobs.type.of.fix, eobs.used.time.to.get.fix, ground.speed, heading, height.above.ellipsoid,      utm.easting,     utm.northing, ... 
#> min values  :     1234354605,                 3613,                              3.33,               7099154,                         0.66, 2009-02-11 12:14:59.000,           A,               13,                3,                         4,         0.02,       0,                  -21.7,   587922.0542426, 4729603.50416053, ... 
#> max values  : 1234701087.998,                 3666,                             66.56,            4267017594,                        26.88, 2009-02-15 12:30:01.000,           A,               35,                3,                       117,          8.5,  359.79,                  247.4, 594677.013690768, 4734873.06667374, ... 
#> timestamps  : 2009-02-11 12:16:45 ... 2009-02-15 12:31:27.998 Time difference of 4 days  (start ... end, duration) 
#> sensors     : gps 
#> indiv. data : eobs.fix.battery.voltage, manually.marked.outlier, visible, sensor.type, individual.taxon.canonical.name, tag.local.identifier, individual.local.identifier, study.name, study.timezone 
#> indiv. value: 0 NA true gps Martes pennanti 74 Leroy Urban fisher GPS tracking Eastern Standard Time 
#> unused rec. : 1071 
#> study name  : Urban fisher GPS tracking 
#> date created: 2023-01-20 15:56:43 
#> 
#> $b
#> class       : Move 
#> features    : 201 
#> extent      : -73.91662, -73.84688, 42.71257, 42.7687  (xmin, xmax, ymin, ymax)
#> crs         : +proj=longlat +datum=WGS84 +no_defs 
#> variables   : 17
#> names       :      timestamp, eobs.battery.voltage, eobs.horizontal.accuracy.estimate, eobs.key.bin.checksum, eobs.speed.accuracy.estimate,    eobs.start.timestamp, eobs.status, eobs.temperature, eobs.type.of.fix, eobs.used.time.to.get.fix, ground.speed, heading, height.above.ellipsoid,      utm.easting,     utm.northing, ... 
#> min values  : 1234701087.998,                 3615,                              3.07,               6327401,                         0.91, 2009-02-15 12:30:01.000,           A,               15,                3,                         4,         0.01,       0,                 -169.6, 588668.811265858, 4729527.88934694, ... 
#> max values  : 1235093511.001,                 3657,                             97.02,            4291715164,                        33.04, 2009-02-20 01:30:02.000,           A,               30,                3,                       119,         5.56,  359.14,                  194.1, 594419.595725403, 4735720.47868847, ... 
#> timestamps  : 2009-02-15 12:31:27.998 ... 2009-02-20 01:31:51.001 Time difference of 5 days  (start ... end, duration) 
#> sensors     : gps 
#> indiv. data : eobs.fix.battery.voltage, manually.marked.outlier, visible, sensor.type, individual.taxon.canonical.name, tag.local.identifier, individual.local.identifier, study.name, study.timezone 
#> indiv. value: 0 NA true gps Martes pennanti 74 Leroy Urban fisher GPS tracking Eastern Standard Time 
#> unused rec. : 1071 
#> study name  : Urban fisher GPS tracking 
#> date created: 2023-01-20 15:56:43 
#> 
#> $c
#> class       : Move 
#> features    : 201 
#> extent      : -73.93067, -73.84366, 42.70898, 42.76054  (xmin, xmax, ymin, ymax)
#> crs         : +proj=longlat +datum=WGS84 +no_defs 
#> variables   : 17
#> names       :      timestamp, eobs.battery.voltage, eobs.horizontal.accuracy.estimate, eobs.key.bin.checksum, eobs.speed.accuracy.estimate,    eobs.start.timestamp, eobs.status, eobs.temperature, eobs.type.of.fix, eobs.used.time.to.get.fix, ground.speed, heading, height.above.ellipsoid,      utm.easting,     utm.northing, ... 
#> min values  : 1235093511.001,                 3608,                              3.84,              10019552,                         0.27, 2009-02-20 01:30:02.000,           A,               15,                3,                         4,         0.01,       0,                 -118.2, 587507.837877134, 4729143.16566605, ... 
#> max values  :     1235473234,                 3663,                             67.07,            4272999177,                        29.82, 2009-02-24 11:00:02.000,           A,               33,                3,                       118,        10.71,  359.79,                  211.7, 594679.382402579, 4734785.50751939, ... 
#> timestamps  : 2009-02-20 01:31:51.001 ... 2009-02-24 11:00:34 Time difference of 4 days  (start ... end, duration) 
#> sensors     : gps 
#> indiv. data : eobs.fix.battery.voltage, manually.marked.outlier, visible, sensor.type, individual.taxon.canonical.name, tag.local.identifier, individual.local.identifier, study.name, study.timezone 
#> indiv. value: 0 NA true gps Martes pennanti 74 Leroy Urban fisher GPS tracking Eastern Standard Time 
#> unused rec. : 1071 
#> study name  : Urban fisher GPS tracking 
#> date created: 2023-01-20 15:56:43 
#> 
#> $a
#> class       : Move 
#> features    : 201 
#> extent      : -73.93002, -73.84489, 42.71004, 42.76453  (xmin, xmax, ymin, ymax)
#> crs         : +proj=longlat +datum=WGS84 +no_defs 
#> variables   : 17
#> names       :      timestamp, eobs.battery.voltage, eobs.horizontal.accuracy.estimate, eobs.key.bin.checksum, eobs.speed.accuracy.estimate,    eobs.start.timestamp, eobs.status, eobs.temperature, eobs.type.of.fix, eobs.used.time.to.get.fix, ground.speed, heading, height.above.ellipsoid,      utm.easting,     utm.northing, ... 
#> min values  :     1235473234,                 3614,                              3.07,               3258904,                         0.38, 2009-02-24 11:00:02.000,           A,               17,                3,                         6,         0.01,       0,                 -106.3, 587556.004256023,  4729259.4423023, ... 
#> max values  : 1235908850.998,                 3662,                             82.69,            4275072585,                        32.17, 2009-03-01 12:00:00.000,           A,               32,                3,                       116,         17.2,  359.14,                    349, 594572.809680951, 4735257.18816836, ... 
#> timestamps  : 2009-02-24 11:00:34 ... 2009-03-01 12:00:50.998 Time difference of 5 days  (start ... end, duration) 
#> sensors     : gps 
#> indiv. data : eobs.fix.battery.voltage, manually.marked.outlier, visible, sensor.type, individual.taxon.canonical.name, tag.local.identifier, individual.local.identifier, study.name, study.timezone 
#> indiv. value: 0 NA true gps Martes pennanti 74 Leroy Urban fisher GPS tracking Eastern Standard Time 
#> unused rec. : 1071 
#> study name  : Urban fisher GPS tracking 
#> date created: 2023-01-20 15:56:43 
#> 
#> $b
#> class       : Move 
#> features    : 119 
#> extent      : -73.91325, -73.86532, 42.72992, 42.76393  (xmin, xmax, ymin, ymax)
#> crs         : +proj=longlat +datum=WGS84 +no_defs 
#> variables   : 17
#> names       :      timestamp, eobs.battery.voltage, eobs.horizontal.accuracy.estimate, eobs.key.bin.checksum, eobs.speed.accuracy.estimate,    eobs.start.timestamp, eobs.status, eobs.temperature, eobs.type.of.fix, eobs.used.time.to.get.fix, ground.speed, heading, height.above.ellipsoid,      utm.easting,     utm.northing, ... 
#> min values  : 1235908850.998,                 3596,                              3.07,              41550132,                         0.58, 2009-03-01 12:00:00.000,           A,               16,                3,                         8,         0.06,       0,                 -127.7,  588917.85723749, 4731447.99129103, ... 
#> max values  : 1236158219.998,                 3652,                             67.33,            4284985441,                        25.29, 2009-03-04 09:15:01.000,           A,               32,                3,                       118,        31.71,  357.83,                  192.5, 592890.421185377, 4735172.88594116, ... 
#> timestamps  : 2009-03-01 12:00:50.998 ... 2009-03-04 09:16:59.998 Time difference of 3 days  (start ... end, duration) 
#> sensors     : gps 
#> indiv. data : eobs.fix.battery.voltage, manually.marked.outlier, visible, sensor.type, individual.taxon.canonical.name, tag.local.identifier, individual.local.identifier, study.name, study.timezone 
#> indiv. value: 0 NA true gps Martes pennanti 74 Leroy Urban fisher GPS tracking Eastern Standard Time 
#> unused rec. : 1071 
#> study name  : Urban fisher GPS tracking 
#> date created: 2023-01-20 15:56:43 
#>