create_species: Creates a new species

View source: R/gen3sis_species.R

create_speciesR Documentation

Creates a new species

Description

Creates a new species

Usage

create_species(initial_cells, config)

Arguments

initial_cells

a list of initial sites (strings) to occupy

config

the configuration information

Details

This function is to be used in the create_ancestor_species function at the configuration of a simulation. It will create a species object representing one species in the simulation occupying the given list of initial sites

Value

returns a newly created species occupying the provided initial cells

Examples

## Not run: 
# inside a create_ancestor_species function of a config taking a landscape and a config
# create_species creates a new species

# define range of species for the entire world in this case lat long system
range <- c(-180, 180, -90, 90)

## select coordinates within the range stipulated above
# takes landscape coordinates
co <- landscape$coordinates
# select coordinates within the range
selection <- co[, "x"] >= range[1] &
  co[, "x"] <= range[2] &
  co[, "y"] >= range[3] &
  co[, "y"] <= range[4]
# get the initial cells
initial_cells <- rownames(co)[selection]

# call create_species
new_species <- create_species(initial_cells, config)

# extra: set local adaptation to max optimal temp equals local temp
new_species$traits[ , "temp"] <- landscape$environment[,"temp"]

# extra: set a certaintrait (e.g. traitX) to one on all populations of this species
new_species$traits[ , "tratiX"] <- 1
  

## End(Not run)

gen3sis documentation built on Nov. 22, 2023, 5:07 p.m.