Learn R Programming

RSiena (version 1.1-232)

sienaDataCreateFromSession: Creates a Siena data object from a Siena session file

Description

Reads in a Siena session from file or siena01Gui() and creates a Siena data or group object.

Usage

sienaDataCreateFromSession(filename = NULL, session = NULL,
    modelName = "Siena", edited = NULL, files = NULL,
    getDocumentation=FALSE)

Arguments

filename

Input session file

session

Input session (from siena01Gui)

modelName

Character string of project name

edited

Boolean, indicates whether a file has been edited and therefore should not be re-read. Used internally by siena01Gui.

files

List of data files, used internally by siena01Gui

getDocumentation

Flag to allow documentation of internal functions, not for use by users.

Value

A list with the following components:

OK

Boolean, TRUE indicating success

mydata

A Siena data or group object, of class siena or sienaGroup

myeff

Effects object associated with mydata

Details

Allows creation of data objects of class "Siena" direct from data files rather than from the various Siena network and covariate objects. Is always called by siena01Gui but can also be used directly.

The columns of the gui screen should have the format described below. If a session file is used for input, it should have columns with exactly the same names and in exactly the same order as those below with a row of column headings and no row numbers.

Group

Used to identify the groups when using the multi-group option described in the Manual. Must not contain embedded blanks, and should be identical for all rows which relate to the same group.

Name

Network files or dyadic covariates should use the same name for each file of the set. Other files should have unique names, a list of space separated ones for constant covariates.

File Name

in siena01Gui, usually entered by using a file selection box, after clicking Add.

Format

Only relevant for networks or dyadic covariates. Can be matrix, a single Pajek network (.net) or a Siena network file (and edgelist with three or four columns: from, to, value, wave (optional)). Not tested for dyadic covariates yet!

Period(s)

Only relevant for networks and dyadic covariates. All other files cover all the relevant periods. Indicates the order of the network and dyadic covariate files. Should range from 1 to n within each group. Enter multiple integers with spaces between for Siena network multi-wave files. Use the value 1 or blank for other files which cover multiple periods.

ActorSet

If you have more than one set of nodes, use this column to indicate which is relevant to each file. Should not contain embedded blanks.

Type

Indicate here what type of data the file contains. Options are "network", "behavior", "constant covariate", "changing covariate", "constant dyadic covariate", "changing dyadic covariate", "exogenous event".

Selected

Yes or No. Only files with Yes will be included in the model.

Missing Values

Enter any values which indicate missingness, with spaces between different entries.

Nonzero Codes

Enter any values which indicate ties, with spaces between different entries.

NbrOfActors

For Siena network files, enter the number of actors here.

If using a file for input, it should be of one of the following types:

Extension Type
.csv Comma separated
.dat or .prn Space delimited

Network and covariate files should be text files with a row for each node. The numbers should be separated by spaces or tabs. Exogenous events should be specified by a file with a row for each node. Each row should be consist of a set of pairs of numbers which indicate the periods during which the corresponding actor was present. e.g.

1 3
1.5 3
1 1.4 2.3 3
2.4 3

would describe a network with 4 nodes, and 3 observations. Actor 1 is present all the time, actor 2 joins at time 1.5, actor 3 leaves and time 1.4 then rejoins at time 2.3, actor 4 joins at time 2.4. All intervals are treated as closed.

References

See http://www.stats.ox.ac.uk/~snijders/siena/

See Also

sienaDataCreate, siena

Examples

Run this code
# NOT RUN {
tmp <- sienaDataCreateFromSession("sienaFreshman.csv")
mydata <- tmp$mydata
myeff <- tmp$myeff
# }

Run the code above in your browser using DataLab