tag:forum.survo.fi,2006:forum-305Nabble - Getting started with Survo R2024-03-29T02:00:02Ztag:forum.survo.fi,2006:post-360Installation2013-09-19T12:53:43Z2014-04-24T02:26:42ZReijo Sund
<h2>Introduction</h2><br/>Survo R is distributed as a collection of R packages. The only mandatory package to use Survo R is <b><a href="http://forum.survo.fi/Survo-R-NEWS-td192.html" target="_top" rel="nofollow" link="external">muste</a></b> that is a standard R package and it can be installed as any other R package. Once package is installed, just enter the command <i>library(muste)</i> and if you want to launch the editor enter the command <i>survo()</i>.
<br/><br/>However, in order to avoid common pitfalls we recommend installation in the following way. First check notes for your system below and perform required actions as suggested. Then continue to Survo R installation part at the end.
<br/><br/><h3>Notes for Windows users</h3><br/>There is a separate all-in-one installation file available that contains all you need to use Survo R in Windows (R, Ghostscript, all Survo R components and other suggested R packages). To use this option, follow the <a href="http://www.survo.fi/muste/mustewin.html" target="_top" rel="nofollow" link="external">separate instructions</a>.
<br/><br/>Otherwise, make sure that you have <a href="http://www.cran.r-project.org/doc/manuals/R-admin.html#Installing-R-under-Windows" target="_top" rel="nofollow" link="external">installed R</a> version 3.0.1 or higher on your computer. We strongly suggest that you install R under some user owned location, such as C:\R\. During the installation, choose customized startup options and select SDI (separate windows interface). After installation, follow the general instructions below.
<br/><br/><h3>Notes for Mac OS X users</h3><br/>First make sure that your operating system is up-to-date (Apple menu - System update)!
<br/><br/><a href="http://www.cran.r-project.org/doc/manuals/R-admin.html#Installing-R-under-OS-X" target="_top" rel="nofollow" link="external">Install R</a> version 3.0.1 or higher to your computer using the default options of the installer (you need the Tcl/Tk components, so don't uncheck them). For R 3.1.0 it is recommended to use Snow Leopard binary installation package even with Mavericks.
<br/><br/>You also need to install XQuartz from <a href="http://http://xquartz.macosforge.org" target="_top" rel="nofollow" link="external">http://xquartz.macosforge.org</a>. Download the disk image (dmg) file for XQuartz. When you open this file by double-clicking on it, you'll find XQuartz.pkg; double-click on it to run the installer, clicking through all the defaults. After the installation is ready, it is recommended to restart your computer.
<br/><br/>It is likely that you would like to change the default key bindings of the function keys F1-F12 while using Survo R. To do that, open your System Preferences and select Keyboard. Select "Keyboard" tab and make sure that the box next to "Use all F1, F2, etc. keys as standard function keys as normal" is checked. In addition, switch to "Keyboard Shortcuts" tab, select "Expose and Spaces" and uncheck the bindings of F8-F11 keys.
<br/><br/>After all this, follow the general instructions below.
<br/><br/><h3>Notes for Linux users</h3><br/><a href="http://www.cran.r-project.org/doc/manuals/R-admin.html#Installing-R-under-Unix_002dalikes" target="_top" rel="nofollow" link="external">Install R</a> version 3.0.1 or higher to your system. Follow the general instructions below to install Survo R. It is strongly suggested that you install Survo R related stuff into a user package library under home directory so that the use of Survo R is possible without running R as root.
<br/><br/><h2>Install Survo R</h2><br/>Make sure that you have access to internet, Start R and execute the following command:
<br/><pre>source("http://www.survo.fi/install.R")</pre><br/>This will install Survo R and other related packages as well as provide autoupdate feature for these packages. If you have problems with installation, please check <a href="http://forum.survo.fi/Frequently-asked-questions-f359.html" target="_top" rel="nofollow" link="external">frequently asked questions</a>. If problem persists, please post a message describing your problem to the forum.
<br/><br/>
tag:forum.survo.fi,2006:post-308Introduction2013-06-13T05:53:15Z2013-06-19T12:47:26ZKimmo Vehkalahti
<h2>Introduction</h2><br/>Survo is a general computing environment for data analysis: managing and processing of data, using methods of statistical analysis, visualizing data by statistical graphics as well as working with many types of computations and calculations. In addition to managing numerical data, it includes efficient tools for writing and editing textual information. <b>Whatever you do, Survo provides you with flexible ways of planning, managing, organizing, completing and documenting your jobs.</b><br/><br/>Getting started with Survo requires some practising. This short guide helps you to get started. After that, you will easily learn more from other sources of information, such as the <a href="http://www.survo.fi/books/1992/Survo_Book_1992_with_comments.pdf" target="_top" rel="nofollow" link="external">web version of the Survo book</a>.
<br/><br/>As the basic ideas and principles are similar in all versions of Survo, we will most often use the general name "Survo". However, the name of this guide refers to "Survo R", the open-source version of Survo, which is freely available as an R package. Indeed, as this guide is meant to be more focused on Survo R, we will use that name at least when referring to Survo R specific topics.
<br/><br/><h3>Survo editor</h3><br/>All the functions of Survo are tied together by a special text editor. Although there are a few menus available in Survo R, the actual interface of Survo is based on using that text editor. The idea is that operations or commands, their specifications and comments are written very freely in the edit field that is a wide and open space in the editor.
<br/><br/>As soon as an operation is <b>activated</b>, it will typically write its results back in the same edit field. This means that the way of working is highly interactive all the time, and any output might serve as the input for the next operation. What is essential and important here is that the whole working process will be more or less automatically documented and repeatable. It is the key to an extremely efficient way of working, called <b>editorial approach</b>.
<br/><br/><b>We will look at the Survo editor and the way of working with it later.</b><br/><br/><h3>Some bits of history</h3><br/>Survo has been the lifework of professor Seppo Mustonen since the early 1960s. During the decades, numerous versions of Survo (like SURVO 66, SURVO 76 and SURVO 84C) have existed on different computer platforms. The current versions are SURVO MM (the standalone Windows version) and SURVO R (the open-source version build as a package for R). Survo R was originally suggested in 2009 by Reijo Sund. From 2009 to 2013 the project was called "Muste". For historical details, there is a <a href="http://www.survo.fi/publications/index.html" target="_top" rel="nofollow" link="external">catalog of publications related to Survo</a> on the Survo website, linking to a number of documents available in PDF form.
<br/><br/>There are many original ideas and innovations inside Survo. The most important innovation has been the editorial approach, that has its origin in Mustonen's need of printing musical notes (!) in 1979. This invention changed the interface of Survo completely in the beginning of the 1980s. Since then, all versions of Survo have been based on the editorial approach. <a href="http://www.survo.fi/demos/ex6.html" target="_top" rel="nofollow" link="external">A GIF demo on the Survo website</a> tells more about this exciting bit of history.
<br/><br/>(KV 2013-06-19)
<br/>
tag:forum.survo.fi,2006:post-307Keyboard shortcuts2013-06-13T05:31:08Z2014-01-17T07:57:17ZReijo Sund
Some commonly required keyboard shortcuts in Survo R:
<br/><br/><b>alt+F3</b> - copy a line (or lines)
<br/><b>alt+F9</b> - insert a new line below the current line and move cursor to that line
<br/><b>shift+enter</b> - insert a new line and move rest of the current line to that line and move cursor to the beginning of new line
<br/><b>ctrl+o</b> - insert a new line and move rest of the current line to that line
<br/><b>alt+F10</b> - delete the current line
<br/><b>ctrl+end</b> - delete end of line
<br/><b>ctrl+k</b> - delete end of line, delete next line or move next line to end of current line
<br/><b>end</b> - move cursor to the end of line
<br/><b>ctrl+e</b> - move cursor to the end of line
<br/><b>ctrl+r</b> - execute current or selected lines as R-script in R
<br/><b>ctrl+s</b> - save edit field
<br/><b>ctrl+z</b> - undo edit (load previously saved edit field)
<br/><b>shift+ctrl+z</b> - redo edit (load next saved edit field)
<br/><b>ctrl+c</b> - copy selection to clipboard
<br/><b>ctrl+x</b> - cut selection to clipboard (with insert mode off clears selection block=Cut, with insert mode deletes lines=Cut rows)
<br/><b>shift+ctrl+x</b> - cut selection to clipboard and delete selected parts from lines
<br/><b>ctrl+v</b> - paste selection from clipboard (with insert mode off overwrites=Paste, with insert mode inserts lines=Paste rows)
<br/><b>shift+ctrl+v</b> - paste selection from clipboard by inserting columns before current end of line (=Paste columns)
<br/><b>F9</b> - change insert status
<br/><b>ctrl+m</b> - change insert status
<br/>mac only: <b>fn+enter</b> - change insert status
<br/><b>alt+selection with mouse</b> - switch between select block and select lines
<br/><b>F8</b> - exit
<br/><b>ctrl + insert</b> - copy to clipboard
<br/><b>shift + insert</b> - paste from clipboard
<br/><b>alt+F4</b> - mark and copy blocks
<br/><b>F2 M C</b> - converts the word from lowercase to uppercase
<br/><b>F2 M L</b> - converts the word from uppercase to lowercase
<br/><b>F2 M X</b> - exchanges the current and the next word
<br/><b>F2 down F2 down</b> - go to the end of edit field
<br/><b>home home home</b> - go to the beginning of edit field
<br/><b>F2 enter</b> - change column to be returned after pressing enter
<br/><b>F5</b> - select shadow (color of writing)