Menu.exportTab {RcmdrPlugin.DoE}

Using the export menu

Description

This help file describes the design exporting options. Default choices are no exporting for design generation forms or exporting an html file and an rda file, when separately calling the export routine.

Details

design information

At the top of the form, the design name is shown (provided on the first tab of the design generation form) or can be chosen from the designs available in the R work space.

(How to) export radio buttons

determine the type(s) of export file(s). Choices are that
no export file is generated (export tabs on design generation menus),
OR all file types listed below are generated,
OR only an rda file is generated,
OR an rda file and an html file are generated,
OR an rda file and a csv file are generated.
If Microsoft Excel is to be used in providing the actual experimenters with an annotated file for experimentation, usage of an html file is recommended. After the experiment has been carried out, the data can be stored as csv and reimported into R, where they can be processed using the structural information from the design, if the stored rda file is also provided.

decimal separator radio buttons

determine the decimal separator to be used; relevant, if the data contain decimal numbers; the default uses the OutDec option of the R system, the other choices explicity determine the decimal separator. If chosen correctly, the html file can be opened in Excel with decimal numbers read as such; furthermore, decimal separator “,” is taken to also mean separator “;”, i.e. csv files also use the matching separator (decimal separator comma goes with separator semicolon and corresponds to read.csv2, decimal separator point goes with separator comma and corresponds to read.csv).

The Storage Directory

can be changed with the selection button. For the separate export menu, the chosen directory will become the new working directory; this is not the case for the Export tab in design creation menus.

Provide the file name

without ending in the file names field. Files with this name and the appropriate endings are produced, as chosen by the “(How to) export” radio buttons.

The replace checkbox

can be checked, if you want to replace previously created files. In this context, note that the rda file exports an R workspace that ONLY includes the generated design and NOT the complete R workspace content.
If you want to store the complete R workspace, use the appropriate menu item on the R commander file menu (usually the left-most menu).

Note

The purpose of exporting to html or csv format is the possibility to edit response data outside of R, e.g. for persons without access to R who conduct the experiment.

The resulting edited data file can be stored in csv format and re-imported into R. If re-importing is done with the appropriate menu item in the Import sub menu of the Design menu, providing the stored rda file along with the edited data file, all structural information stored with the design is available.

If users prefer to store the edited data file in a format different from csv, the data can be re-imported in two steps: First, the edited data file must be imported with R-Commanders Data management menu. Afterwards, the response information can be added to the design using the menu item Add response variable(s) ... from the sub menu Modify design of the menu Design.

Author(s)

Ulrike Groemping

See Also

See Also function export.design from package DoE.base for the function that actually does the exporting