relax                 package:relax                 R Documentation

_R _e_d_i_t_o_r: _r_e_l_a_x

_D_e_s_c_r_i_p_t_i_o_n:

     'relax' is an editor for doing data analysis with R and writing
     reports.

_U_s_a_g_e:

     relax(file.name, no.plots = FALSE, cmds = "", but.Wizardry = TRUE)

_A_r_g_u_m_e_n_t_s:

file.name: name of report file to be loaded 

no.plots: if 'TRUE' no plots are integrated into the report text field

    cmds: special operations that are evaluated on start 

but.Wizardry: if 'FALSE' menu 'Wizardry' is not created 

_D_e_t_a_i_l_s:

     'relax' is written in R and Tcl/Tk. 'relax' creates a new window
     (top level Tcl/Tk widget) that consists of two text fields and
     some buttons and menus. Text (chunks) and code (chunks) are
     inserted in the upper text field (report field). Code chunks are
     evaluated by clicking on 'EvalRCode'. Results are shown in the
     lower text field (output field) and will be transfered to the
     report field by pressing on 'Insert'.

     Chunks are separated by separators: A line containing the
     character "@" at its first position indicades the beginning of a
     text chunk. Patterns like '<<*>>=' or '<<'code chunk name'>>='
     define code chunk headers and introduce code chunks. The code of a
     code chunk is the set of R expression found between the header and
     the following text chunk.

     How to work with relax?

   _L_o_a_d _o_f _p_a_c_k_a_g_e '_r_e_l_a_x' in 'R' through: 'library(relax)'.

   _S_t_a_r_t _t_h_e _e_d_i_t_o_r _b_y: 'relax()'.

   _P_l_a_n_R_C_o_d_e: Press 'PlanRCode' and an empty text chunk and an empty
        code chunk without contents appear in the report field (upper
        blue text field). Now you can write down any text between
        "@"-line and the header of next code chunk '<<*>>='. The code
        has to be placed after the header line.

   _E_v_a_l_R_C_o_d_e: 'EvalRCode' evaluates the code (the cursor is pointing
        at) and the results appear in the output field just as in 'R'.

   _R_e_m_o_v_e_O_u_t: 'RemoveOut' clears the output field.

   _I_n_s_e_r_t: 'Insert' transfers the contents of the output text field to
        the upper text field as a new text chunk.

   _S_a_v_e_P_l_o_t: 'SavePlot' copies the graphics device; it creates a
        'postscript' as well as a 'jpeg' file and inserts the LaTeX
        includegraphics reference in the report field as a new text
        chunk.

   _T_r_a_s_h_O_u_t_p_u_t: 'TrashOutput' removes inserted 'R' output from the
        upper field (the cursor is pointing at). 

   _D_o_w_n: 'Down' moves the cursor down to the next code chunk.

   _U_p: 'Up' moves the cursor up to the next code chunk.

   _F_i_l_e: The 'File' menu in the menu bar of 'relax' allows you save the
        report - the contents of the blue text field. The saving
        operation generates two files: a text file (extension: 'rev')
        and a 'html' file. You can load an old report into the upper
        text field (report field) and continue to work on the report.

   _E_d_i_t: Several operations to make editing faster and easier are
        collected in the 'Edit' menu: searching, starting an external
        editor, etc.

   _O_p_t_i_o_n_s: The entries of the 'Options' menu change some of the
        parameter of relax.

   _W_i_z_a_r_d_r_y: With 'Wizardry' you are able to generate LaTeX documents
        (for LaTeXperts only). After saving the raw report you can
        'web' it: this process generates a 'tex'-file that can be
        formated by LaTeX. See your LaTeX companion for syntax. (The
        web syntax fits to the rules of 'noweb'. Therefore, the raw
        files can also be processed by Norman Ramsey's 'noweb' system
        (see: 
         <URL: http://www.eecs.harvard.edu/~nr/noweb/>).

   _C_o_n_f_i_g_u_r_a_t_i_o_n: Some parameters of 'relax' can be modified in
        '...relax/config/settings.relax'.

   _E_n_v_i_r_o_n_m_e_n_t _f_o_r _e_v_a_l_u_a_t_i_o_n: Evaluations of code chunks take place in
        the environment ('revive.env').

   _c_m_d_s: The character vector 'cmds' in environment ('revive.env')
        enables you to define operations of your own. For example,
        'cmds<-"r test1.rev"' forces 'relax' to load file 'test1.rev'.
        'cmds<-c("> 1+1","> 2+2")' results in computing 1+1 and then
        2+2. 'cmds<-"s10"' evaluates code chunk number 10.

_V_a_l_u_e:

     -

_N_o_t_e:

_A_u_t_h_o_r(_s):

     2005 Hans Peter Wolf

_R_e_f_e_r_e_n_c_e_s:

     <URL:
     http://www.wiwi.uni-bielefeld.de/~wolf/software/relax/relax.html>

_S_e_e _A_l_s_o:

_E_x_a_m_p_l_e_s:

     ## The function is currently defined as
     function (workname.sys = "out.rev", no.plots = FALSE, cmds = "", but.Wizardry = TRUE){
           # nearly 5000 lines of R / Tcl/Tk code
     }

