RKWard: Difference between revisions

From KDE UserBase Wiki
(Created page with "{{Construction}} 600px|thumb|center == Overview == RKWard is an integrated development environment (IDE) built on top of the KDE Development Platform for...")
 
(Marked this version for translation)
 
(10 intermediate revisions by 5 users not shown)
Line 1: Line 1:
{{Construction}}
<languages />
 
<translate>


<!--T:1-->
[[File:Rkward.png|600px|thumb|center]]
[[File:Rkward.png|600px|thumb|center]]




== Overview ==
== Overview == <!--T:2-->


RKWard is an integrated development environment (IDE) built on top of the KDE Development Platform for the [http://www.r-project.org R programming language], a language heavily oriented for statistics and data manipulation,
<!--T:3-->
'''RKWard''' is an integrated development environment (IDE) built on top of the KDE Development Platform for the [http://www.r-project.org R programming language], a scripting language heavily oriented for statistics and data manipulation,


== Features ==
== Features == <!--T:4-->


*Development environment with syntax highlighting, code completion, object browser, and data editor
<!--T:5-->
*Development environment with syntax highlighting, code completion, object browser, help browser


<!--T:6-->
*Transparent interface to R
*Transparent interface to R


<!--T:7-->
*Graphical tools to access R's statistical and graphing functions
*Graphical tools to access R's statistical and graphing functions
*Integrated data editor


*Integrated R prompt for read-eval-print-loop (REPL) work
<!--T:8-->
*Integrated interactive R Console


<!--T:9-->
*R package management
*R package management


<!--T:10-->
*Loading/Saving R's workspace states
*Loading/Saving R's workspace states


<!--T:11-->
*Extensible through ECMAscript plugins
*Extensible through ECMAscript plugins




== Modes of operation ==
== Use of RKWard as an IDE for R == <!--T:12-->


RKWard can be used in two different ways: either like a normal IDE; that is to write code which then will be incorporated in programs or scripts, via an interactive session where the code is immediately evalued (this is the preferred way of working of R programmers) and a mixture of both.
<!--T:13-->
R is an interpreted language, and '''RKWard''' allows to use the R language interactively, just like on a "regular" R console, but with added features like syntax highlighting and support for pasting data from spreadsheet applications. Further, RKWard provides typical IDE features: An integrated script editor, file browser, object viewer, etc.  


== Interactive interpreter ==
=== Interactive interpreter === <!--T:14-->


RKward offers an integrated R prompt which can be used in a so-called "read-eval-print-loop" (REPL) way.
<!--T:15-->
'''RKward''' offers an integrated R prompt which can be used to work with the R engine, interactively.


<!--T:16-->
[[File:Rkward prompt.png|400px|thumb|center|The interactive prompt]]
[[File:Rkward prompt.png|400px|thumb|center|The interactive prompt]]


<!--T:17-->
The prompt is by all intents and purposes identical to the R console prompt, with some additional capabilities. For example, along with function name completion, it supports ''calltips'' (pop-up boxes which show a function's signature) and also various way of copying and pasting the code.
The prompt is by all intents and purposes identical to the R console prompt, with some additional capabilities. For example, along with function name completion, it supports ''calltips'' (pop-up boxes which show a function's signature) and also various way of copying and pasting the code.


<!--T:18-->
This way operates like a normal R session: commands are inputted, output and other objects are created, and results can be shown or saved to disk using R's own functions.
This way operates like a normal R session: commands are inputted, output and other objects are created, and results can be shown or saved to disk using R's own functions.


== Programming in RKward ==
=== Programming in RKward === <!--T:19-->
 
<!--T:20-->
[[File:Rkward programming.png|500px|thumb|center|The code editor]]


TBD
<!--T:21-->
Programming in '''RKWard''' is done like in any other IDE: the code editor offers completion, syntax highlighting, and calltips. The code editor however offers additional functions that can be used in an interactive session. Specific commands can be issued to execute all the currently loaded code, or only the selected code: this is particularly useful when writing functions to be then prototyped in an interactive session.


== Taking a look at R objects ==
== Taking a look at R objects == <!--T:22-->


Since working in R often involves loading "libraries" (add-on packages) and creating multiple objects, RKward offers an interface to inspect and show the objects loaded in memory by R.
<!--T:23-->
An R session typically involves many data (and function) objects. Literally thousands more may be loaded from "libraries" (add-on packages). '''RKward''' offers an interface to browse and inspect the objects loaded in the R workspace.


<!--T:24-->
[[File:Rkward object browser.png|220px|thumb|center|The object browser]]
[[File:Rkward object browser.png|220px|thumb|center|The object browser]]


The object browser allows access to both R's global environment and the packages's own environment. Additional information are available either as tooltips or by double-clicking items, which will open a new tab in RKWard's interface showing information on the object in question.


== Data manipulation ==
<!--T:25-->
The object browser allows access to both R's global environment (where, typically, user data is kept) and the environments of add-on packages. Additional information are available either as tooltips or by double-clicking items, which will open a new tab in '''RKWard's''' interface showing information on the object in question.
 
== Data manipulation == <!--T:26-->


Along with code aids, RKward has a way to handle data directly from the program. In particular, one can view matrices and ''data frames'' (R's own definition of data tables) in the interface, or create new ones.
<!--T:27-->
Along with code aids, '''RKward''' provides support for handling data, conveniently. In particular, one can view and edit matrices and ''data frames'' (R's own definition of data tables) in the interface, or create new ones.


TBD file import
<!--T:28-->
Existing data can be imported: R supports loading text files (TSV/CSV) and also data from widely used statistics programs such as STATA or SPSS. '''RKWard''' provides easy to use dialogs for this data import functionality.


The interface can show the column names, the types of te columns (numbers, strings, etc.) and the data itself, using a spreadsheet-like user interface.


<!--T:29-->
[[File:Rkward import.png|450px|thumb|center|The TSV import dialog]]


<!--T:30-->
The interface can show the column names, the types of the columns (numbers, strings, etc.) and the data itself, using a spreadsheet-like user interface.
<!--T:31-->
[[File:Rkward data browser.png|500px|thumb|center|The data browser]]
[[File:Rkward data browser.png|500px|thumb|center|The data browser]]




There is direct support for editing and data manipulaiton. TBD make it more in depth.
<!--T:32-->
There is direct support for editing and data manipulaiton: for example, adding rows or columns, changing row headers, and also the data type of the columns themselves, acting like a simplified spreadsheet.
 
== Interactive statistics and plotting == <!--T:33-->
 
<!--T:34-->
'''RKWard''' offers simplified front-ends to a number of R's statistical functions and to generate graphs for data. These can be accessed from the <menuchoice>Analysis</menuchoice>, <menuchoice>Plots</menuchoice> and <menuchoice>Distributions</menuchoice> menus.
 
 
<!--T:35-->
[[File:Rkward analysis.png|450px|thumb|center|One of the many analysis aids]]
 
 
<!--T:36-->
For example, many type of plots can be executed through the functions in the aforementioned menus. Each function (as the example above shows) has its dedicated configuration dialog, where any compatible object from R's global namespace can be used.  Also the dialogs offer shortcuts to specific plot or analysis options. Results are then output in HTML form in '''RKWard's''' main window, where they can be exported or saved.
 
== Combining statistical analysis and programming == <!--T:38-->
 
<!--T:39-->
For each action carried out using graphical dialogs, '''RKWard''' shows the corresponding R code, transparently. This allows users to copy and paste code to their own scripts, easily, to automate complex tasks. "Run again" links in '''RKWard's''' output window allow to repeat an analysis (with or without modified settings), in just a few clicks.


== Interactive statistics and plotting ==
== More information == <!--T:40-->


RKWard offers simplified front-ends to a number of R's statistical functions and to generate graphs for data. These can be accessed from the ''Analysis'', ''Plots'' and ''Distributions'' menus.
<!--T:41-->
The [http://rkward.sf.net RKWard homepage] has more information, in particular on extending RKWard with custom plugins, and also [http://sourceforge.net/apps/mediawiki/rkward/index.php?title=Screenshots more screenshots].


TBD examples and a screenshot
<!--T:37-->
[[Category:Science]]
</translate>

Latest revision as of 15:42, 24 October 2011

Other languages:


Overview

RKWard is an integrated development environment (IDE) built on top of the KDE Development Platform for the R programming language, a scripting language heavily oriented for statistics and data manipulation,

Features

  • Development environment with syntax highlighting, code completion, object browser, help browser
  • Transparent interface to R
  • Graphical tools to access R's statistical and graphing functions
  • Integrated data editor
  • Integrated interactive R Console
  • R package management
  • Loading/Saving R's workspace states
  • Extensible through ECMAscript plugins


Use of RKWard as an IDE for R

R is an interpreted language, and RKWard allows to use the R language interactively, just like on a "regular" R console, but with added features like syntax highlighting and support for pasting data from spreadsheet applications. Further, RKWard provides typical IDE features: An integrated script editor, file browser, object viewer, etc.

Interactive interpreter

RKward offers an integrated R prompt which can be used to work with the R engine, interactively.

The interactive prompt

The prompt is by all intents and purposes identical to the R console prompt, with some additional capabilities. For example, along with function name completion, it supports calltips (pop-up boxes which show a function's signature) and also various way of copying and pasting the code.

This way operates like a normal R session: commands are inputted, output and other objects are created, and results can be shown or saved to disk using R's own functions.

Programming in RKward

The code editor

Programming in RKWard is done like in any other IDE: the code editor offers completion, syntax highlighting, and calltips. The code editor however offers additional functions that can be used in an interactive session. Specific commands can be issued to execute all the currently loaded code, or only the selected code: this is particularly useful when writing functions to be then prototyped in an interactive session.

Taking a look at R objects

An R session typically involves many data (and function) objects. Literally thousands more may be loaded from "libraries" (add-on packages). RKward offers an interface to browse and inspect the objects loaded in the R workspace.

The object browser


The object browser allows access to both R's global environment (where, typically, user data is kept) and the environments of add-on packages. Additional information are available either as tooltips or by double-clicking items, which will open a new tab in RKWard's interface showing information on the object in question.

Data manipulation

Along with code aids, RKward provides support for handling data, conveniently. In particular, one can view and edit matrices and data frames (R's own definition of data tables) in the interface, or create new ones.

Existing data can be imported: R supports loading text files (TSV/CSV) and also data from widely used statistics programs such as STATA or SPSS. RKWard provides easy to use dialogs for this data import functionality.


The TSV import dialog


The interface can show the column names, the types of the columns (numbers, strings, etc.) and the data itself, using a spreadsheet-like user interface.


The data browser


There is direct support for editing and data manipulaiton: for example, adding rows or columns, changing row headers, and also the data type of the columns themselves, acting like a simplified spreadsheet.

Interactive statistics and plotting

RKWard offers simplified front-ends to a number of R's statistical functions and to generate graphs for data. These can be accessed from the Analysis, Plots and Distributions menus.


One of the many analysis aids


For example, many type of plots can be executed through the functions in the aforementioned menus. Each function (as the example above shows) has its dedicated configuration dialog, where any compatible object from R's global namespace can be used. Also the dialogs offer shortcuts to specific plot or analysis options. Results are then output in HTML form in RKWard's main window, where they can be exported or saved.

Combining statistical analysis and programming

For each action carried out using graphical dialogs, RKWard shows the corresponding R code, transparently. This allows users to copy and paste code to their own scripts, easily, to automate complex tasks. "Run again" links in RKWard's output window allow to repeat an analysis (with or without modified settings), in just a few clicks.

More information

The RKWard homepage has more information, in particular on extending RKWard with custom plugins, and also more screenshots.