Documentation for SLiM function subsetIndividuals, which is a method of
the SLiM class Subpopulation.
Note that the R function is a stub, it does not do anything in R (except bring
up this documentation). It will only do
anything useful when used inside a slim_block function further
nested in a slim_script
function call, where it will be translated into valid SLiM code as part of a
full SLiM script.
subsetIndividuals(
exclude,
sex,
tag,
minAge,
maxAge,
migrant,
tagL0,
tagL1,
tagL2,
tagL3,
tagL4
)An object of type null or Individual object. Must be of length 1
(a singleton). The default value is NULL. See details for description.
An object of type null or string. Must be of length 1 (a singleton).
The default value is NULL. See details for description.
An object of type null or integer. Must be of length 1 (a singleton).
The default value is NULL. See details for description.
An object of type null or integer. Must be of length 1 (a
singleton). The default value is NULL. See details for description.
An object of type null or integer. Must be of length 1 (a
singleton). The default value is NULL. See details for description.
An object of type null or logical. Must be of length 1 (a
singleton). The default value is NULL. See details for description.
An object of type null or logical. Must be of length 1 (a
singleton). The default value is NULL. See details for description.
An object of type null or logical. Must be of length 1 (a
singleton). The default value is NULL. See details for description.
An object of type null or logical. Must be of length 1 (a
singleton). The default value is NULL. See details for description.
An object of type null or logical. Must be of length 1 (a
singleton). The default value is NULL. See details for description.
An object of type null or logical. Must be of length 1 (a
singleton). The default value is NULL. See details for description.
An object of type Individual object.
Documentation for this function can be found in the official SLiM manual: page 746.
Returns a vector of individuals subset from the individuals in the target subpopulation. The parameters specify constraints upon the subset of individuals that will be returned. Parameter exclude, if non- NULL, may specify a specific individual that should not be included (typically the focal individual in some operation). Parameter sex, if non-NULL, may specify a sex ("M" or "F") for the individuals to be returned, in sexual models. Parameter tag, if non-NULL, may specify a tag property value for the individuals to be returned. Parameters minAge and maxAge, if non-NULL, may specify a minimum or maximum age for the individuals to be returned, in nonWF models. Parameter migrant, if non-NULL, may specify a required value for the migrant property of the individuals to be returned (so T will require that individuals be migrants, F will require that they not be). Finally, parameters tagL0, tagL1, tagL2, tagL3, and tagL4, if non-NULL, may specify a required value (T or F) for the corresponding properties (tagL0, tagL1, tagL2, tagL3, and tagL4) of the individuals to be returned. Note that if any tag/tagL parameter is specified as non-NULL, that tag/tagL property must have a defined value for every individual in the subpopulation, otherwise an error may result (although this requirement will not necessarily be checked comprehensively by this method in every invocation). This method is shorthand for getting the individuals property of the subpopulation, and then using operator [] to select only individuals with the desired properties; besides being much simpler than the equivalent Eidos code, it is also much faster. See sampleIndividuals() for a similar method that returns a sample taken from a chosen subset of individuals.
This is documentation for a function in the SLiM software, and has been reproduced from the official manual, which can be found here: http://benhaller.com/slim/SLiM_Manual.pdf. This documentation is Copyright © 2016-2020 Philipp Messer. All rights reserved. More information about SLiM can be found on the official website: https://messerlab.org/slim/
Other Subpopulation:
Subpopulation,
addCloned(),
addCrossed(),
addEmpty(),
addRecombinant(),
addSelfed(),
addSpatialMap(),
cachedFitness(),
configureDisplay(),
defineSpatialMap(),
outputMSSample(),
outputSample(),
outputVCFSample(),
pointDeviated(),
pointInBounds(),
pointPeriodic(),
pointReflected(),
pointStopped(),
pointUniform(),
removeSpatialMap(),
removeSubpopulation(),
sampleIndividuals(),
setCloningRate(),
setMigrationRates(),
setSelfingRate(),
setSexRatio(),
setSpatialBounds(),
setSubpopulationSize(),
spatialMapColor(),
spatialMapImage(),
spatialMapValue(),
takeMigrants()