buildPointls: Read a data file

Description

This reads a data file into a data frame, performs various checks, assign namesto columns, and can select rows.

Usage

buildPointls(dataFile = blackbox.getOption("dataFile"), respCols = NULL,
             subsetRows = NULL, ycolname, cleanResu = "")

Arguments

dataFile

Name of data file

respCols

A way to select response columns in later analyses (see Details). NULL or a numeric vector.

subsetRows

A set of rows to select. All rows are retained if this is NULL

ycolname

A name to be given to the response variable; willbe used in many further outputs.

cleanResu

A connection, or a character string naming a file for some nicely formated output. If "" (the default), print to the standard output connection.

Value

A data frame with as many columns as the input table. As a side effect, the function sets the blackbox.options ycolname and respCols to respectively the input ycolname and to the column names deduced from the input respCols indices.

Details

The input file is a an ASCII numeric data table with the following columns. The first columns contain values of all canonical parameters of the model in canonical order, as given by blackbox.getOption{"ParameterNames"}. Pairs of lines may have identical parameter vectors, but not more than pairs. The next columns may all be used as response variables. respCols identifies columns that will be used to construct the smoothed response (but all columns are retained in this function's return value). If it is NULL, then the last column will be used. If a numeric vector, it identifies response columns (where column 1 is the first column after the parameters columns) which values will be summed to construct the response variable.