read.mask {secr} | R Documentation

## Read Habitat Mask From File

### Description

Read coordinates of points on a habitat mask from a text file.

### Usage

    read.mask(file, spacing = NULL, ...)

### Arguments

`file` | character string with name of text file
`spacing` | spacing of grid points in metres
`...` | other arguments to pass to `read.table`

### Details

Usually, the x and y coordinates are the first two values on each line, separated by white space. If the file starts with a line of column headers and 'header = TRUE' is passed to `read.table` in the ... argument then 'x' and 'y' need not be the first two fields.

If the grid cell size `spacing` is not provided then an attempt is made to infer it from the minimum spacing of points. This can be slow and may demand more memory than is available. In rare cases (highly fragmented masks) it may also yield the wrong answer.

### Value

object of class `mask` with type 'user'

### Author(s)

Murray Efford murray.efford@otago.ac.nz

### See Also

`mask`

### Examples

    ## Replace file name with a valid local name and remove '#'
    # read.mask (file = 'c:\\myfolder\\mask.txt', spacing = 3, header = TRUE)
    ## 'mask.txt' should have lines like this
    # x   y
    # 265 265
    # 268 265
    # ...

[Package secr version 1.3.0 Index]