Spreadsheet(FilePathOrName)

Spreadsheet(path.or.object, [applySelectionConditions], [recodeTe xtLabelAsFactors], [recodeMissingDataToNA], [getCaseNames], [getTextValues], [attachObject], [username], [password], [connection string], [stationname])

path.or.object – character vector (literal or variable) or a valid COM object pointing to a Statistica spreadsheet, e.g. “c:/data/sample.sta”, “enterprise://SomeFolder1/SomeFile.sta” or “adstudy”.

applySelectionConditions – TRUE (default) or FALSE flag indicating whether selection conditions defined on spreadsheet should be employed.

recodeTextLabelCodesAsFactors – TRUE (default) or FALSE flag indicating whether text labels defined for variables should be treated as factors or text.

recodeMissingDataToNA - TRUE (default) or FALSE flag indicating whether the missing data should be treated as not applicable.

getCaseNames – TRUE (default) or FALSE flag indicating whether row names should be fetched.

getTextValues - TRUE (default) or FALSE flag indicating whether text variables are returned.

attachObject – TRUE or FALSE (default) flag indicating whether spreadsheet should be attached to data frame as an “Object” attribute.

"username, password, connectionstring, stationname" – character strings (default value: “”) to be used to fetch spreadsheets from the enterprise system when user does not have an integrated login.

Use the Spreadsheet() extension to load a specific Statistica data file into R and transfer the data in that file to an R data frame.

Similar to the ActiveDataSet keyword, the return value of the Spreadsheet() function should be treated as a data frame variable with the contents closely matching that of the corresponding Statistica spreadsheet.

One useful feature supported by this function is the use of default search paths for spreadsheet files that are specified only as simple file names. This means that if the function parameter consists only of a file name, e.g., Spreadsheet(“some.sta”), R Integration Support code looks for this file in several locations: first, it checks the folder where the R script itself is located (if it was saved to disk), and then it checks the Examples\Datasets folder for the current Statistica installation. Support code also appends the default .sta file extension if one is not present. Therefore, the following options are available:

  • R scripts can reference the accompanying data sets (placed in the same folder) simply by name.
  • Spreadsheets that are included in every Statistica installation as demonstration/example data sets can be referenced by name in much the same way as built-in R data sets.

Example: 

Spreadsheet("c:\myfiles\mydata.sta") # display the dataset in R console
					 
Spreadsheet("\\server\share\data.sta") # same, but read from a network share 
					 
Spreadsheet("thisdemo.sta") # file in the same folder as this script 
					 
Spreadsheet("enterprise://folder/thisdemo.sta") # file in Statistica Enterprise
					 
# plot a histogram for MEASURE05 variable from Statistica example dataset Adstudy: hist(Spreadsheet("Adstudy")$MEASURE05)
					 
…
					 
advert = Spreadsheet("Adstudy")$ADVERT # retrieve a data frame variable (factor)
					 
is.factor(advert)# => [1] TRUE 
					 
levels(advert) # => [1] “PEPSI” “COKE”