nodal.local: Computes Blau statuses for individuals with respect to a...

View source: R/nodal.local.R

nodal.localR Documentation

Computes Blau statuses for individuals with respect to a primary membership

Description

Computes two measures: whether an individual is within the niche of the primary membership specified, and whether the individual is a member of the primary membership but outside of that membership's niche.

Usage

nodal.local(blauObj, focal.niche = NULL, dev.range, ecologies.off = FALSE)

Arguments

blauObj

An object of class blau initialized with the function blau. Individuals will automatically be placed in niches with the function niches if this has not been done manually.

focal.niche

Specifies a focial niche by name of the organization.

dev.range

When creating niches, indicates standard deviation around the mean in each dimension to include in niche. A larger value will make niches larger and therefore include more individuals.

ecologies.off

Defaults to FALSE. If set to TRUE, treats all individuals as in the same ecology, even if ecology identifiers (ecology.ids) have been specified. Will call the niches function and overwrite its output even if it has been manually called by the user.

Details

This provides information about the focal membership for each individual.

FocNicher: Provides information on how many niches a person is in including the focal niche (it may also be accessed manually by object$isInNiche). A value of 0 indicates a person is not in any niche. A value of 1 indicates the person is only in the focal niche. A value of more than 1 indicates the person is in more than the focal niche. ((it may be more intuitive if we use two columns: in focal niche and total # niches))

MemNotNiche: indicates whether an individual is a member of the focal membership but outside of the focal niche. This indicates that an individual is atypical compared to other group members.

Value

A matrix stored in object$nodalLocal with two columns, each containing one of the two measures. Row names are node names provided with the blau function.

Examples

data(TwoCities)
b <- blau(TwoCities, node.ids = 'respID', ecology.ids = 'samp')
#will automatically compute niches
b0 <- nodal.local(b, dev.range = rep(1.5, 10), focal.niche = 'grppta') 
# 10 is the number of dimensions in the command line above 

Blaunet documentation built on Sept. 27, 2022, 9:05 a.m.