export.nodal {Blaunet}

Outputs all node-level measures computed by the user

Description

Takes any output from nodal functions (niches, nodal.local, nodal.global, or nodal.network) and presents it in one matrix for further analysis outside of Blaunet or output to disk.

Usage

export.nodal(blauObj, niches = TRUE)

Arguments

blauObj

An object of class blau initialized with the function blau. User must have called at least one of the following functions: niches, nodal.local, nodal.global, or nodal.network. Otherwise, there is nothing to export.

niches

Defaults to TRUE. If TRUE, includes the full matrix of individuals located in niches as part of the output. This information may not always be desirable for output, and setting this to FALSE will prevent the full matrix of individuals located in niches from being included.

Details

This function is useful to manipulate the computed nodal Blau statuses and analyze them outside the Blaunet program, either within R or by exporting them to another statistical package.

Value

Returns an object of class data.frame that includes all output from niches, nodal.local, nodal.global, or nodal.network previously computed by the user. The user must manually call one or more of these four functions prior to calling export.nodal. Columns are labeled with the name of the measure. Row names are node names provided with the blau function.

Examples

data(TwoCities)
b <- blau(TwoCities, node.ids = 'respID', ecology.ids = 'samp')
#blau object will store whatever you compute
b <- nodal.global(b, dev.range = rep(1.5, 10)) # 10 is the number of dimensions
b <- nodal.local(b, dev.range = rep(1.5, 10), focal.niche = 'grppta')
# 10 is the number of dimensions in the command line above 
export.nodal(b) #will export global and local
export.nodal(b, niches = FALSE) #suppress niche export