https://wiki.openoffice.org/w/api.php?action=feedcontributions&feedformat=atom&user=WojciechApache OpenOffice Wiki - User contributions [en]2026-08-16T00:35:32ZUser contributionsMediaWiki 1.35.14https://wiki.openoffice.org/w/index.php?title=R_and_Calc:_Bugs_and_Feature_Requests&diff=78784R and Calc: Bugs and Feature Requests2008-05-27T03:56:34Z<p>Wojciech: </p>
<hr />
<div>This section is meant to keep track of the bugs plaguing the add-on, as well as any features people would like to see in upcoming versions. For now, there are three categories on this page:<br />
* '''Bugs: ''' things that need to be fixed urgently (ideally, in the next release).<br />
* '''Feature Requests: ''' things that need to be added at some point in the future, but are not necessary for the healthy functioning of the software.<br />
* '''Implemented Requests: ''' once anything in the categories above is implemented, it is moved here.<br />
<br />
== Bugs ==<br />
<br />
* Passing the following code to RCalcDump causes a NullPointerException:<br />
:: <code>nls(y ~ a*x + b, data = data.frame(cbind(x = c(1.1, 2.1, 3, 3.9), y = c(1, 2, 3, 4))), start=list(a = 1, b = 1))</code><br />
This is likely because the returned R object has embedded REXPs, functions, and environments.<br />
* Passing <code>a<-127</code> to RCalcDump will cause it to print the outputs of the previous statement rather than this one.<br />
* R optional packages must be installed in the default R location... Otherwise they cannot be loaded.<br />
* The add-on needs to be installed manually -- Tools > Extension Manager fails to install properly.<br />
* Very slow in extremely large sets of data (probably due to using TCP/IP to send information).<br />
* RCalcDump does not print matrices and frames properly, but prints columns instead.<br />
* Missing values -- need a good way to deal with missing values. We cannot use a test for non-numeric values because of Factors in R.<br />
* Installation with extension manager on us_en version of OOo OK, and works as desired, but on Hungarian version R Add-On menu item failed to show in the main menu.<br />
* Loading external GUI files in Windows XP seems to not work (the files aren't found) when they are on the Desktop.<br />
<br />
== Feature Requests ==<br />
<br />
* Dynamic array output. As it stands, you need to know the size of the array if you want the RCalcCoder to output properly.<br />
* Make it so the {$BASE} keyword can be replaced with code. Currently, RCalcCaller won't work with<br />
<code>{$OUT#A1}<-var(c(1,2,3,4))</code><br />
But having such code support would be extremely useful.<br />
* Make the actual syntax more intuitive and easier to use.<br />
* The getOutputs() function in the RCalcInterface is very inefficient and should be replaced (''note that this is a fairly substantial coding change'').<br />
* Make the coding window non-modal.<br />
* Allow for saving scripts in spreadsheets.<br />
* Make the "help()" function available through the add-on.<br />
* Communication between data.frames and spreadsheets in Calc.<br />
* Have the ability to update a persistent graphic. Here's the use case:<br />
<ol><br />
# User creates a graph (i.e. a histogram) from data.<br />
# Data changes. User wishes to update the existing graph rather than generating a new one (b/c of format changes, etc.)<br />
# This would be more useful if OpenOffice allowed dynamic linking of objects, which I don't think it does (so that updates to a linked object propagate to linked instances; something that MS Office does fairly well).<br />
</ol><br />
*Plotting:<br />
** OOo has no '''mosaic plot''' which is a good visualization of summary-results of the data-pilot output. [http://stat.ethz.ch/R-manual/R-patched/library/graphics/html/mosaicplot.html mosaicplot R function]<br />
** OOo has no '''fourfold plot''' [http://cran.r-project.org/src/contrib/Descriptions/vcd.html Visualizing Categorical Data] - also includes extended mosaic and much more<br />
* Add a way to loop from the coding window... Even a simple ''Loop:'' command would be useful.<br />
* Visualization.<br />
** 3D scatterplot doesn't work.<br />
** Unclear what a directed graph is.<br />
* Should have option to point to columns rather than contingency tables for Chi-square and Fisher exact tests.<br />
* Kaplan-Meier -- not sure how to enter the CI - I thought it would generate curves to demonstrate upper and lower bounds but not sure how to set it -- I entered the value "95" on the cell.<br />
* ANOVA command doesn't work at times.<br />
* Linear regression and GLM need confidence intervals as results. * ANOVA<br />
* Factor analysis interface is confusing.<br />
* ODE Solver -- what is the syntax for the initial condition?<br />
* Non-linear least squares -- what is the syntax for the start?<br />
<br />
=== Future ===<br />
Here is a List of Ideas. Requires more packages, GUI Interfaces and possibly some coding.<br />
* Have GUI interfaces for:<br />
** the [http://had.co.nz/ggplot2/ ggplot package]<br />
* just more plotting<br />
** '''spie chat''' this one implements pie charts with two parameters (radius and angle, with color codes). [http://addictedtor.free.fr/graphiques/RGraphGallery.php?graph=106 example + code]<br />
* evaluate [http://cran.r-project.org/src/contrib/Views/Finance.html Finance Packages ] for inclusion, with GUI Interface, programming helping functions, documentation, exampels:<br />
** [http://braverock.com/brian/R/PerformanceAnalytics/html/PerformanceAnalytics-package.html Econometric tools for performance and risk analysis]<br />
** [http://www.itp.phys.ethz.ch/econophysics/R/ Rmetrics collection] (also: [http://cran.r-project.org/src/contrib/Descriptions/Rmetrics.html link])<br />
* same for [http://cran.r-project.org/src/contrib/Views/SocialSciences.html Social Sciences]:<br />
** collection of functions in '''Zelig''' ([http://cran.r-project.org/src/contrib/Descriptions/Zelig.html package (look at the long list of vignettes!], [http://gking.harvard.edu/zelig website]) ''Zelig is an easy-to-use program that can estimate, and help interpret the results of, an enormous range of statistical models. It literally is "everyone's statistical software" because Zelig's simple unified framework incorporates everyone else's (R) code.'' - i think, working with a single framework is easier to implement.<br />
** [http://cran.r-project.org/src/contrib/Descriptions/eRm.html eRm: Rasch Model]<br />
** [http://cran.okada.jp.org/src/contrib/Descriptions/plink.html linking]<br />
* [http://cran.r-project.org/src/contrib/Views/ other interesting packages]<br />
* Have a look at the following wiki pages for other ideas to implement in the R way:<br />
** [http://wiki.services.openoffice.org/wiki/Calc/To-Dos/Statistical_Data_Analysis_Tool Calc/To-Dos/Statistical Data Analysis Tool]<br />
** [http://wiki.services.openoffice.org/wiki/Calc/To-Dos/Statistics/Miscellaneous_Data_Analysis Calc/To-Dos/Statistics/Miscellaneous Data Analysis]<br />
* Support for [http://cran.r-project.org/doc/packages/codetools.pdf codetools] for code testing.<br />
* In collaboration with biostats course.<br />
** biostats package<br />
** include videos showing how to use the software<br />
* It would be great to be able to start Rserve from the menu, or even automatically when the first command is activated.<br />
* Although it is nice to have the ability to point to which cells should contain results, it is easier to simply select the top right cell for the results and have the rest automatically populated - this would make things simpler is windows with as many parameter as, for example, the one for ANOVA. Maybe should have both options.<br />
<br />
== Implemented Requests ==<br />
<br />
* '''Fixed bug:''' The following code doesn't seem to work in the RCalcCoder on Windows XP SP2, R 2.5.1:<br />
:: <code>rnorm(1)</code><br />
:: <code>{$OUT#A1}<-{$BASE}</code><br />
* '''Fixed bug:''' The following code doesn't seem to work in the RCalcCoder on Windows XP SP2, R 2.5.1 (seems to be a one character input line problem):<br />
:: <code>3</code><br />
:: <code>{$OUT#A1}<-{$BASE}</code><br />
* '''Fixed bug:''' The *.txt files used for GUI scripting don't load properly on many computers. May have something to do with using "library", and "require" might be a better option.<br />
* '''Fixed bug:''' Passing the following code causes the RCalcCoder to crash:<br />
:: <code>3+3</code><br />
:: <code>{$OUT#C1}<-{$BASE}</code><br />
* '''Fixed bug:''' As it stands, RCalcCaller can't read values from matrices with equations. This code does not work <code>=RTestConnection()</code> with a value of 0 or 1, it will throw an error if we refer to this in code. For example, try the code below:<br />
:: <code>// First, type =RTestConnection() in cell A1.</code><br />
:: <code>a <- {$A1}</code><br />
:: <code>a*3</code><br />
* '''Fixed bug:''' RCalcCaller can't accept String inputs from cells.<br />
* '''Fixed bug:''' Need to implement missing values.<br />
* '''Implemented Feature:''' Need to implement error output -- right now, nothing happens in the coding window.<br />
* '''Fixed bug:''' Need to implement error checking for GUI input fields.<br />
* '''Fixed bug:''' Move the "About" window to the main menu, not the "Advanced" tab.<br />
<br />
[[Category: R and Calc]]</div>Wojciechhttps://wiki.openoffice.org/w/index.php?title=R_and_Calc:_Bugs_and_Feature_Requests&diff=77463R and Calc: Bugs and Feature Requests2008-05-16T04:18:29Z<p>Wojciech: </p>
<hr />
<div>This section is meant to keep track of the bugs plaguing the add-on, as well as any features people would like to see in upcoming versions. For now, there are three categories on this page:<br />
* '''Bugs: ''' things that need to be fixed urgently (ideally, in the next release).<br />
* '''Feature Requests: ''' things that need to be added at some point in the future, but are not necessary for the healthy functioning of the software.<br />
* '''Implemented Requests: ''' once anything in the categories above is implemented, it is moved here.<br />
<br />
== Bugs ==<br />
<br />
* Passing the following code to RCalcDump causes a NullPointerException:<br />
:: <code>nls(y ~ a*x + b, data = data.frame(cbind(x = c(1.1, 2.1, 3, 3.9), y = c(1, 2, 3, 4))), start=list(a = 1, b = 1))</code><br />
This is likely because the returned R object has embedded REXPs, functions, and environments.<br />
* Passing <code>a<-127</code> to RCalcDump will cause it to print the outputs of the previous statement rather than this one.<br />
* R optional packages must be installed in the default R location... Otherwise they cannot be loaded.<br />
* The add-on needs to be installed manually -- Tools > Extension Manager fails to install properly.<br />
* Very slow in extremely large sets of data (probably due to using TCP/IP to send information).<br />
* RCalcDump does not print matrices and frames properly, but prints columns instead.<br />
* Missing values -- need a good way to deal with missing values. We cannot use a test for non-numeric values because of Factors in R.<br />
* Installation with extension manager on us_en version of OOo OK, and works as desired, but on Hungarian version R Add-On menu item failed to show in the main menu.<br />
<br />
== Feature Requests ==<br />
<br />
* Dynamic array output. As it stands, you need to know the size of the array if you want the RCalcCoder to output properly.<br />
* Make it so the {$BASE} keyword can be replaced with code. Currently, RCalcCaller won't work with<br />
<code>{$OUT#A1}<-var(c(1,2,3,4))</code><br />
But having such code support would be extremely useful.<br />
* Make the actual syntax more intuitive and easier to use.<br />
* The getOutputs() function in the RCalcInterface is very inefficient and should be replaced (''note that this is a fairly substantial coding change'').<br />
* Make the coding window non-modal.<br />
* Allow for saving scripts in spreadsheets.<br />
* Make the "help()" function available through the add-on.<br />
* Communication between data.frames and spreadsheets in Calc.<br />
* Have the ability to update a persistent graphic. Here's the use case:<br />
<ol><br />
# User creates a graph (i.e. a histogram) from data.<br />
# Data changes. User wishes to update the existing graph rather than generating a new one (b/c of format changes, etc.)<br />
# This would be more useful if OpenOffice allowed dynamic linking of objects, which I don't think it does (so that updates to a linked object propagate to linked instances; something that MS Office does fairly well).<br />
</ol><br />
*Plotting:<br />
** OOo has no '''mosaic plot''' which is a good visualization of summary-results of the data-pilot output. [http://stat.ethz.ch/R-manual/R-patched/library/graphics/html/mosaicplot.html mosaicplot R function]<br />
** OOo has no '''fourfold plot''' [http://cran.r-project.org/src/contrib/Descriptions/vcd.html Visualizing Categorical Data] - also includes extended mosaic and much more<br />
* Add a way to loop from the coding window... Even a simple ''Loop:'' command would be useful.<br />
* Visualization.<br />
** 3D scatterplot doesn't work.<br />
** Unclear what a directed graph is.<br />
* Should have option to point to columns rather than contingency tables for Chi-square and Fisher exact tests.<br />
* Kaplan-Meier -- not sure how to enter the CI - I thought it would generate curves to demonstrate upper and lower bounds but not sure how to set it -- I entered the value "95" on the cell.<br />
* ANOVA command doesn't work at times.<br />
* Linear regression and GLM need confidence intervals as results. * ANOVA<br />
* Factor analysis interface is confusing.<br />
* ODE Solver -- what is the syntax for the initial condition?<br />
* Non-linear least squares -- what is the syntax for the start?<br />
<br />
=== Future ===<br />
Here is a List of Ideas. Requires more packages, GUI Interfaces and possibly some coding.<br />
* Have GUI interfaces for:<br />
** the [http://had.co.nz/ggplot2/ ggplot package]<br />
* just more plotting<br />
** '''spie chat''' this one implements pie charts with two parameters (radius and angle, with color codes). [http://addictedtor.free.fr/graphiques/RGraphGallery.php?graph=106 example + code]<br />
* evaluate [http://cran.r-project.org/src/contrib/Views/Finance.html Finance Packages ] for inclusion, with GUI Interface, programming helping functions, documentation, exampels:<br />
** [http://braverock.com/brian/R/PerformanceAnalytics/html/PerformanceAnalytics-package.html Econometric tools for performance and risk analysis]<br />
** [http://www.itp.phys.ethz.ch/econophysics/R/ Rmetrics collection] (also: [http://cran.r-project.org/src/contrib/Descriptions/Rmetrics.html link])<br />
* same for [http://cran.r-project.org/src/contrib/Views/SocialSciences.html Social Sciences]:<br />
** collection of functions in '''Zelig''' ([http://cran.r-project.org/src/contrib/Descriptions/Zelig.html package (look at the long list of vignettes!], [http://gking.harvard.edu/zelig website]) ''Zelig is an easy-to-use program that can estimate, and help interpret the results of, an enormous range of statistical models. It literally is "everyone's statistical software" because Zelig's simple unified framework incorporates everyone else's (R) code.'' - i think, working with a single framework is easier to implement.<br />
** [http://cran.r-project.org/src/contrib/Descriptions/eRm.html eRm: Rasch Model]<br />
** [http://cran.okada.jp.org/src/contrib/Descriptions/plink.html linking]<br />
* [http://cran.r-project.org/src/contrib/Views/ other interesting packages]<br />
* Have a look at the following wiki pages for other ideas to implement in the R way:<br />
** [http://wiki.services.openoffice.org/wiki/Calc/To-Dos/Statistical_Data_Analysis_Tool Calc/To-Dos/Statistical Data Analysis Tool]<br />
** [http://wiki.services.openoffice.org/wiki/Calc/To-Dos/Statistics/Miscellaneous_Data_Analysis Calc/To-Dos/Statistics/Miscellaneous Data Analysis]<br />
* Support for [http://cran.r-project.org/doc/packages/codetools.pdf codetools] for code testing.<br />
* In collaboration with biostats course.<br />
** biostats package<br />
** include videos showing how to use the software<br />
* It would be great to be able to start Rserve from the menu, or even automatically when the first command is activated.<br />
* Although it is nice to have the ability to point to which cells should contain results, it is easier to simply select the top right cell for the results and have the rest automatically populated - this would make things simpler is windows with as many parameter as, for example, the one for ANOVA. Maybe should have both options.<br />
<br />
== Implemented Requests ==<br />
<br />
* '''Fixed bug:''' The following code doesn't seem to work in the RCalcCoder on Windows XP SP2, R 2.5.1:<br />
:: <code>rnorm(1)</code><br />
:: <code>{$OUT#A1}<-{$BASE}</code><br />
* '''Fixed bug:''' The following code doesn't seem to work in the RCalcCoder on Windows XP SP2, R 2.5.1 (seems to be a one character input line problem):<br />
:: <code>3</code><br />
:: <code>{$OUT#A1}<-{$BASE}</code><br />
* '''Fixed bug:''' The *.txt files used for GUI scripting don't load properly on many computers. May have something to do with using "library", and "require" might be a better option.<br />
* '''Fixed bug:''' Passing the following code causes the RCalcCoder to crash:<br />
:: <code>3+3</code><br />
:: <code>{$OUT#C1}<-{$BASE}</code><br />
* '''Fixed bug:''' As it stands, RCalcCaller can't read values from matrices with equations. This code does not work <code>=RTestConnection()</code> with a value of 0 or 1, it will throw an error if we refer to this in code. For example, try the code below:<br />
:: <code>// First, type =RTestConnection() in cell A1.</code><br />
:: <code>a <- {$A1}</code><br />
:: <code>a*3</code><br />
* '''Fixed bug:''' RCalcCaller can't accept String inputs from cells.<br />
* '''Fixed bug:''' Need to implement missing values.<br />
* '''Implemented Feature:''' Need to implement error output -- right now, nothing happens in the coding window.<br />
* '''Fixed bug:''' Need to implement error checking for GUI input fields.<br />
* '''Fixed bug:''' Move the "About" window to the main menu, not the "Advanced" tab.<br />
<br />
[[Category: R and Calc]]</div>Wojciechhttps://wiki.openoffice.org/w/index.php?title=R_and_Calc&diff=70618R and Calc2008-03-19T06:25:29Z<p>Wojciech: </p>
<hr />
<div><blockquote style="background: white; border: 1px solid rgb(153, 153, 153); padding: 1em;">This page is meant as a general overview and installation guide for the software. Please see [[R and Calc Documentation]] for more information on functions, scripting, and general usage. Also feel free to submit bug reports in the [[R and Calc: Bugs and Feature Requests]] page, and provide feedback at the [http://extensions.services.openoffice.org/project/R4Calc extension page].</blockquote><br />
<br />
"R and Calc" is an [[OpenOffice.org]] (OO.o) [[Calc]] add-on that allows you to use [http://www.r-project.org/ R] methods and functions. The software is currently in early development, though a '''basic''' working version does exist, and is available for download.<br />
<br />
We welcome any and all comments and name suggestions. Please send them to [[User:Wojciech|Wojciech Gryc]].<br />
<br />
For those who come here often, here is the latest version:<br />
* '''Version:''' 0.1.12<br />
* '''Release Date:''' February 23, 2008 (5:20 am EST)<br />
* '''Link:''' http://www.11-55.org/rcalc/2008-02-23/RAddon.uno.pkg<br />
* '''Source Code:''' http://www.11-55.org/rcalc/2008-02-23/rcalc-0_1_12.zip<br />
* '''Manual:''' http://www.11-55.org/rcalc/2008-02-23/manual.pdf (a [http://researchonresearch.blogspot.com/2008/03/r4calc.html screencast] is also available)<br />
<br />
==Requirements==<br />
<br />
You need the following software to run this add-on. While older versions may suffice, they have not been tested yet.<br />
* OpenOffice.org 2.1<br />
* Java 5.0<br />
* RServe 0.4.7<br />
<br />
==Installing==<br />
<br />
The current version is a prototype and implements only one tool: RDUMP. This method is accessed through the actual Calc menu, and allows you to see the R object structure for various method calls. <br />
<br />
To use the add-on, you need to install R and [http://www.rforge.net/Rserve Rserve]. Instructions for installing R can be found at http://www.r-project.org/ Once installed, run R and type the following to install Rserve. Click "enter" at the end of each bullet point:<br />
<br />
* install.packages("Rserve")<br />
<br />
Rserve needs to be running to work, and can be launched with the following commands... Note that you only need to do this when you want to use the R Add-on for Calc.<br />
<br />
* library(Rserve)<br />
* Rserve()<br />
<br />
Now that you have the prerequisites installed, download the package RAddon.uno.pkg (linked above). Unzip the file, and let's call the directory you unzipped it in <RA_DIR>. Now let <OO_HOME> be your OpenOffice.org installation directory. Open the command prompt or terminal window and go to <OO_HOME>/program/ and type:<br />
<br />
* unopkg add <RA_DIR>/RAddon.uno.pkg<br />
<br />
If this is not your first time installing the add-in, you need to check if a previous version is also on the system. If it is, then you will not be able to install the new version. To do this, go to <OO HOME>/program and type:<br />
<br />
* unopkg list<br />
<br />
This will show you the list of packages already installed, and you should be able to check if the add-is is there. Remember to look for "RAddon.uno.pkg". You can also skip this step and try to uninstall RAddon.uno.pkg regardless -- this will not harm your OpenOffice.org installation in any way, even if RAddon.uno.pkg is abset. To do this, type:<br />
<br />
* unopkg remove RAddon.uno.pkg<br />
<br />
Finally, some operating systems require that you restart your OpenOffice.org installation (if you're not sure, restart your computer) to be able to see the cell functions that come with this package.<br />
<br />
==Using==<br />
<br />
Using the add-on is very simple at this stage. To see the tool at work, open Calc. In the menus, go to R Add-on > Rdump(). A new dialog window will pop up. Type in an R script -- here are some examples:<br />
<br />
* rnorm(10)<br />
* cor.test(c(1,2,3,4), c(1,2,2,3))<br />
<br />
Then click "Run". A new sheet should appear. Close the dialog with "Close" and check the new sheet -- you should see various pieces of information on the sheet.<br />
<br />
==Testing==<br />
<br />
So far, the software has been tested on the following.<br />
<br />
===Version 0.1.7===<br />
<br />
* 64-bit Gentoo Linux running JDK 1.5.0.12 (64-bit version), OpenOffice 2.2.1, and R 2.4.1<br />
<br />
===Version 0.1.6===<br />
<br />
* Ubuntu Feisty Fawn on Java 1.6.0 <br />
<br />
===Version 0.1.5===<br />
<br />
* Fedora Core 7 running native Java<br />
* Ubuntu Edgy Eft running SDK 1.5.0_08 and OpenOffice 2.1.<br />
* Windows XP SP2 running running JDK 1.6.0_02 and OpenOffice 2.2.<br />
<br />
===Version 0.1.0===<br />
<br />
* Fedora Core 6 running JDK 1.6.0_01 and OpenOffice 2.2.<br />
* Ubuntu Edgy Eft running SDK 1.5.0_08 and OpenOffice 2.1.<br />
* Windows XP running running JDK 1.6.0_01 and OpenOffice 2.2.<br />
<br />
==About==<br />
<br />
This add-on is the result of a Google [[Summer of Code 2007]] project. It was initially created by [[User:Wojciech|Wojciech Gryc]]. For information pertaining to the development of this add-on, see [http://www.11-55.org/ooblog/ Wojciech's Blog].<br />
<br />
==Older Versions==<br />
<br />
* '''0.1.11''' [http://www.11-55.org/rcalc/2007-10-08/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-10-08/rcalc-0_1_11.zip Source Code])<br />
* '''0.1.10''' [http://www.11-55.org/rcalc/2007-09-08/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-09-08/rcalc-0_1_10.zip Source Code])<br />
* '''0.1.9''' [http://www.11-55.org/rcalc/2007-09-04_2/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-09-04_2/rcalc-0_1_9.zip Source Code])<br />
* '''0.1.8''' [http://www.11-55.org/rcalc/2007-09-04/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-09-04/rcalc-0_1_8.zip Source Code])<br />
* '''0.1.7''' [http://www.11-55.org/rcalc/2007-08-23/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-08-23/rcalc-0_1_7.zip Source Code])<br />
* '''0.1.6''' [http://www.11-55.org/rcalc/2007-08-19/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-08-19/rcalc-0_1_6.zip Source Code])<br />
* '''0.1.5''': [http://www.11-55.org/rcalc/2007-08-16/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-08-16/rcalc-0_1_5.zip Source Code])<br />
* '''0.1.4''': [http://www.11-55.org/rcalc/2007-08-10/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-08-10/rcalc-0_1_4.zip Source Code])<br />
* '''0.1.3''': [http://www.11-55.org/rcalc/2007-08-02/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-08-02/rcalc-0_1_3.zip Source Code])<br />
* '''0.1.2''': [http://www.11-55.org/rcalc/2007-06-01/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-06-01/rcalc-0_1_2.zip Source Code])<br />
* '''0.1.1''': [http://www.11-55.org/rcalc/2007-05-25/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-05-25/rcalc-0_1_1.zip Source Code])<br />
* '''0.1.0''': [http://www.11-55.org/rcalc/2007-05-15/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-05-15/rcalc-0.1.0.zip Source Code])<br />
<br />
[[Category:Calc]]<br />
[[Category: R and Calc]]</div>Wojciechhttps://wiki.openoffice.org/w/index.php?title=R_and_Calc&diff=68927R and Calc2008-03-04T04:27:23Z<p>Wojciech: </p>
<hr />
<div><blockquote style="background: white; border: 1px solid rgb(153, 153, 153); padding: 1em;">This page is meant as a general overview and installation guide for the software. Please see [[R and Calc Documentation]] for more information on functions, scripting, and general usage. Also feel free to submit bug reports in the [[R and Calc: Bugs and Feature Requests]] page, and provide feedback at the [http://extensions.services.openoffice.org/project/R4Calc extension page].</blockquote><br />
<br />
"R and Calc" is an [[OpenOffice.org]] (OO.o) [[Calc]] add-on that allows you to use [http://www.r-project.org/ R] methods and functions. The software is currently in early development, though a '''basic''' working version does exist, and is available for download.<br />
<br />
We welcome any and all comments and name suggestions. Please send them to [[User:Wojciech|Wojciech Gryc]].<br />
<br />
For those who come here often, here is the latest version:<br />
* '''Version:''' 0.1.12<br />
* '''Release Date:''' February 23, 2008 (5:20 am EST)<br />
* '''Link:''' http://www.11-55.org/rcalc/2008-02-23/RAddon.uno.pkg<br />
* '''Source Code:''' http://www.11-55.org/rcalc/2008-02-23/rcalc-0_1_12.zip<br />
* '''Manual:''' http://www.11-55.org/rcalc/2008-02-23/manual.pdf<br />
<br />
==Requirements==<br />
<br />
You need the following software to run this add-on. While older versions may suffice, they have not been tested yet.<br />
* OpenOffice.org 2.1<br />
* Java 5.0<br />
* RServe 0.4.7<br />
<br />
==Installing==<br />
<br />
The current version is a prototype and implements only one tool: RDUMP. This method is accessed through the actual Calc menu, and allows you to see the R object structure for various method calls. <br />
<br />
To use the add-on, you need to install R and [http://www.rforge.net/Rserve Rserve]. Instructions for installing R can be found at http://www.r-project.org/ Once installed, run R and type the following to install Rserve. Click "enter" at the end of each bullet point:<br />
<br />
* install.packages("Rserve")<br />
<br />
Rserve needs to be running to work, and can be launched with the following commands... Note that you only need to do this when you want to use the R Add-on for Calc.<br />
<br />
* library(Rserve)<br />
* Rserve()<br />
<br />
Now that you have the prerequisites installed, download the package RAddon.uno.pkg (linked above). Unzip the file, and let's call the directory you unzipped it in <RA_DIR>. Now let <OO_HOME> be your OpenOffice.org installation directory. Open the command prompt or terminal window and go to <OO_HOME>/program/ and type:<br />
<br />
* unopkg add <RA_DIR>/RAddon.uno.pkg<br />
<br />
If this is not your first time installing the add-in, you need to check if a previous version is also on the system. If it is, then you will not be able to install the new version. To do this, go to <OO HOME>/program and type:<br />
<br />
* unopkg list<br />
<br />
This will show you the list of packages already installed, and you should be able to check if the add-is is there. Remember to look for "RAddon.uno.pkg". You can also skip this step and try to uninstall RAddon.uno.pkg regardless -- this will not harm your OpenOffice.org installation in any way, even if RAddon.uno.pkg is abset. To do this, type:<br />
<br />
* unopkg remove RAddon.uno.pkg<br />
<br />
Finally, some operating systems require that you restart your OpenOffice.org installation (if you're not sure, restart your computer) to be able to see the cell functions that come with this package.<br />
<br />
==Using==<br />
<br />
Using the add-on is very simple at this stage. To see the tool at work, open Calc. In the menus, go to R Add-on > Rdump(). A new dialog window will pop up. Type in an R script -- here are some examples:<br />
<br />
* rnorm(10)<br />
* cor.test(c(1,2,3,4), c(1,2,2,3))<br />
<br />
Then click "Run". A new sheet should appear. Close the dialog with "Close" and check the new sheet -- you should see various pieces of information on the sheet.<br />
<br />
==Testing==<br />
<br />
So far, the software has been tested on the following.<br />
<br />
===Version 0.1.7===<br />
<br />
* 64-bit Gentoo Linux running JDK 1.5.0.12 (64-bit version), OpenOffice 2.2.1, and R 2.4.1<br />
<br />
===Version 0.1.6===<br />
<br />
* Ubuntu Feisty Fawn on Java 1.6.0 <br />
<br />
===Version 0.1.5===<br />
<br />
* Fedora Core 7 running native Java<br />
* Ubuntu Edgy Eft running SDK 1.5.0_08 and OpenOffice 2.1.<br />
* Windows XP SP2 running running JDK 1.6.0_02 and OpenOffice 2.2.<br />
<br />
===Version 0.1.0===<br />
<br />
* Fedora Core 6 running JDK 1.6.0_01 and OpenOffice 2.2.<br />
* Ubuntu Edgy Eft running SDK 1.5.0_08 and OpenOffice 2.1.<br />
* Windows XP running running JDK 1.6.0_01 and OpenOffice 2.2.<br />
<br />
==About==<br />
<br />
This add-on is the result of a Google [[Summer of Code 2007]] project. It was initially created by [[User:Wojciech|Wojciech Gryc]]. For information pertaining to the development of this add-on, see [http://www.11-55.org/ooblog/ Wojciech's Blog].<br />
<br />
==Older Versions==<br />
<br />
* '''0.1.11''' [http://www.11-55.org/rcalc/2007-10-08/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-10-08/rcalc-0_1_11.zip Source Code])<br />
* '''0.1.10''' [http://www.11-55.org/rcalc/2007-09-08/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-09-08/rcalc-0_1_10.zip Source Code])<br />
* '''0.1.9''' [http://www.11-55.org/rcalc/2007-09-04_2/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-09-04_2/rcalc-0_1_9.zip Source Code])<br />
* '''0.1.8''' [http://www.11-55.org/rcalc/2007-09-04/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-09-04/rcalc-0_1_8.zip Source Code])<br />
* '''0.1.7''' [http://www.11-55.org/rcalc/2007-08-23/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-08-23/rcalc-0_1_7.zip Source Code])<br />
* '''0.1.6''' [http://www.11-55.org/rcalc/2007-08-19/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-08-19/rcalc-0_1_6.zip Source Code])<br />
* '''0.1.5''': [http://www.11-55.org/rcalc/2007-08-16/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-08-16/rcalc-0_1_5.zip Source Code])<br />
* '''0.1.4''': [http://www.11-55.org/rcalc/2007-08-10/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-08-10/rcalc-0_1_4.zip Source Code])<br />
* '''0.1.3''': [http://www.11-55.org/rcalc/2007-08-02/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-08-02/rcalc-0_1_3.zip Source Code])<br />
* '''0.1.2''': [http://www.11-55.org/rcalc/2007-06-01/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-06-01/rcalc-0_1_2.zip Source Code])<br />
* '''0.1.1''': [http://www.11-55.org/rcalc/2007-05-25/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-05-25/rcalc-0_1_1.zip Source Code])<br />
* '''0.1.0''': [http://www.11-55.org/rcalc/2007-05-15/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-05-15/rcalc-0.1.0.zip Source Code])<br />
<br />
[[Category:Calc]]<br />
[[Category: R and Calc]]</div>Wojciechhttps://wiki.openoffice.org/w/index.php?title=R_and_Calc&diff=67492R and Calc2008-02-23T10:21:12Z<p>Wojciech: </p>
<hr />
<div><blockquote style="background: white; border: 1px solid rgb(153, 153, 153); padding: 1em;">This page is meant as a general overview and installation guide for the software. Please see [[R and Calc Documentation]] for more information on functions, scripting, and general usage. Also feel free to submit bug reports in the [[R and Calc: Bugs and Feature Requests]] page.</blockquote><br />
<br />
"R and Calc" is an [[OpenOffice.org]] (OO.o) [[Calc]] add-on that allows you to use [http://www.r-project.org/ R] methods and functions. The software is currently in early development, though a '''basic''' working version does exist, and is available for download.<br />
<br />
We welcome any and all comments and name suggestions. Please send them to [[User:Wojciech|Wojciech Gryc]].<br />
<br />
For those who come here often, here is the latest version:<br />
* '''Version:''' 0.1.12<br />
* '''Release Date:''' February 23, 2008 (5:20 am EST)<br />
* '''Link:''' http://www.11-55.org/rcalc/2008-02-23/RAddon.uno.pkg<br />
* '''Source Code:''' http://www.11-55.org/rcalc/2008-02-23/rcalc-0_1_12.zip<br />
* '''Manual:''' http://www.11-55.org/rcalc/2008-02-23/manual.pdf<br />
<br />
==Requirements==<br />
<br />
You need the following software to run this add-on. While older versions may suffice, they have not been tested yet.<br />
* OpenOffice.org 2.1<br />
* Java 5.0<br />
* RServe 0.4.7<br />
<br />
==Installing==<br />
<br />
The current version is a prototype and implements only one tool: RDUMP. This method is accessed through the actual Calc menu, and allows you to see the R object structure for various method calls. <br />
<br />
To use the add-on, you need to install R and [http://www.rforge.net/Rserve Rserve]. Instructions for installing R can be found at http://www.r-project.org/ Once installed, run R and type the following to install Rserve. Click "enter" at the end of each bullet point:<br />
<br />
* install.packages("Rserve")<br />
<br />
Rserve needs to be running to work, and can be launched with the following commands... Note that you only need to do this when you want to use the R Add-on for Calc.<br />
<br />
* library(Rserve)<br />
* Rserve()<br />
<br />
Now that you have the prerequisites installed, download the package RAddon.uno.pkg (linked above). Unzip the file, and let's call the directory you unzipped it in <RA_DIR>. Now let <OO_HOME> be your OpenOffice.org installation directory. Open the command prompt or terminal window and go to <OO_HOME>/program/ and type:<br />
<br />
* unopkg add <RA_DIR>/RAddon.uno.pkg<br />
<br />
If this is not your first time installing the add-in, you need to check if a previous version is also on the system. If it is, then you will not be able to install the new version. To do this, go to <OO HOME>/program and type:<br />
<br />
* unopkg list<br />
<br />
This will show you the list of packages already installed, and you should be able to check if the add-is is there. Remember to look for "RAddon.uno.pkg". You can also skip this step and try to uninstall RAddon.uno.pkg regardless -- this will not harm your OpenOffice.org installation in any way, even if RAddon.uno.pkg is abset. To do this, type:<br />
<br />
* unopkg remove RAddon.uno.pkg<br />
<br />
Finally, some operating systems require that you restart your OpenOffice.org installation (if you're not sure, restart your computer) to be able to see the cell functions that come with this package.<br />
<br />
==Using==<br />
<br />
Using the add-on is very simple at this stage. To see the tool at work, open Calc. In the menus, go to R Add-on > Rdump(). A new dialog window will pop up. Type in an R script -- here are some examples:<br />
<br />
* rnorm(10)<br />
* cor.test(c(1,2,3,4), c(1,2,2,3))<br />
<br />
Then click "Run". A new sheet should appear. Close the dialog with "Close" and check the new sheet -- you should see various pieces of information on the sheet.<br />
<br />
==Testing==<br />
<br />
So far, the software has been tested on the following.<br />
<br />
===Version 0.1.7===<br />
<br />
* 64-bit Gentoo Linux running JDK 1.5.0.12 (64-bit version), OpenOffice 2.2.1, and R 2.4.1<br />
<br />
===Version 0.1.6===<br />
<br />
* Ubuntu Feisty Fawn on Java 1.6.0 <br />
<br />
===Version 0.1.5===<br />
<br />
* Fedora Core 7 running native Java<br />
* Ubuntu Edgy Eft running SDK 1.5.0_08 and OpenOffice 2.1.<br />
* Windows XP SP2 running running JDK 1.6.0_02 and OpenOffice 2.2.<br />
<br />
===Version 0.1.0===<br />
<br />
* Fedora Core 6 running JDK 1.6.0_01 and OpenOffice 2.2.<br />
* Ubuntu Edgy Eft running SDK 1.5.0_08 and OpenOffice 2.1.<br />
* Windows XP running running JDK 1.6.0_01 and OpenOffice 2.2.<br />
<br />
==About==<br />
<br />
This add-on is the result of a Google [[Summer of Code 2007]] project. It was initially created by [[User:Wojciech|Wojciech Gryc]]. For information pertaining to the development of this add-on, see [http://www.11-55.org/ooblog/ Wojciech's Blog].<br />
<br />
==Older Versions==<br />
<br />
* '''0.1.11''' [http://www.11-55.org/rcalc/2007-10-08/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-10-08/rcalc-0_1_11.zip Source Code])<br />
* '''0.1.10''' [http://www.11-55.org/rcalc/2007-09-08/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-09-08/rcalc-0_1_10.zip Source Code])<br />
* '''0.1.9''' [http://www.11-55.org/rcalc/2007-09-04_2/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-09-04_2/rcalc-0_1_9.zip Source Code])<br />
* '''0.1.8''' [http://www.11-55.org/rcalc/2007-09-04/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-09-04/rcalc-0_1_8.zip Source Code])<br />
* '''0.1.7''' [http://www.11-55.org/rcalc/2007-08-23/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-08-23/rcalc-0_1_7.zip Source Code])<br />
* '''0.1.6''' [http://www.11-55.org/rcalc/2007-08-19/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-08-19/rcalc-0_1_6.zip Source Code])<br />
* '''0.1.5''': [http://www.11-55.org/rcalc/2007-08-16/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-08-16/rcalc-0_1_5.zip Source Code])<br />
* '''0.1.4''': [http://www.11-55.org/rcalc/2007-08-10/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-08-10/rcalc-0_1_4.zip Source Code])<br />
* '''0.1.3''': [http://www.11-55.org/rcalc/2007-08-02/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-08-02/rcalc-0_1_3.zip Source Code])<br />
* '''0.1.2''': [http://www.11-55.org/rcalc/2007-06-01/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-06-01/rcalc-0_1_2.zip Source Code])<br />
* '''0.1.1''': [http://www.11-55.org/rcalc/2007-05-25/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-05-25/rcalc-0_1_1.zip Source Code])<br />
* '''0.1.0''': [http://www.11-55.org/rcalc/2007-05-15/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-05-15/rcalc-0.1.0.zip Source Code])<br />
<br />
[[Category:Calc]]<br />
[[Category: R and Calc]]</div>Wojciechhttps://wiki.openoffice.org/w/index.php?title=R_and_Calc:_Bugs_and_Feature_Requests&diff=61049R and Calc: Bugs and Feature Requests2008-01-21T04:31:23Z<p>Wojciech: </p>
<hr />
<div>This section is meant to keep track of the bugs plaguing the add-on, as well as any features people would like to see in upcoming versions. For now, there are three categories on this page:<br />
* '''Bugs: ''' things that need to be fixed urgently (ideally, in the next release).<br />
* '''Feature Requests: ''' things that need to be added at some point in the future, but are not necessary for the healthy functioning of the software.<br />
* '''Implemented Requests: ''' once anything in the categories above is implemented, it is moved here.<br />
<br />
== Bugs ==<br />
<br />
* Passing the following code to RCalcDump causes a NullPointerException:<br />
:: <code>nls(y ~ a*x + b, data = data.frame(cbind(x = c(1.1, 2.1, 3, 3.9), y = c(1, 2, 3, 4))), start=list(a = 1, b = 1))</code><br />
This is likely because the returned R object has embedded REXPs, functions, and environments.<br />
* Passing <code>a<-127</code> to RCalcDump will cause it to print the outputs of the previous statement rather than this one.<br />
* R optional packages must be installed in the default R location... Otherwise they cannot be loaded.<br />
* The add-on needs to be installed manually -- Tools > Extension Manager fails to install properly.<br />
* Very slow in extremely large sets of data (probably due to using TCP/IP to send information).<br />
* RCalcDump does not print matrices and frames properly, but prints columns instead.<br />
* Missing values -- need a good way to deal with missing values. We cannot use a test for non-numeric values because of Factors in R.<br />
* Installation with extension manager on us_en version of OOo OK, and works as desired, but on Hungarian version R Add-On menu item failed to show in the main menu.<br />
<br />
== Feature Requests ==<br />
<br />
* Dynamic array output. As it stands, you need to know the size of the array if you want the RCalcCoder to output properly.<br />
* Make it so the {$BASE} keyword can be replaced with code. Currently, RCalcCaller won't work with<br />
<code>{$OUT#A1}<-var(c(1,2,3,4))</code><br />
But having such code support would be extremely useful.<br />
* Make the actual syntax more intuitive and easier to use.<br />
* The getOutputs() function in the RCalcInterface is very inefficient and should be replaced (''note that this is a fairly substantial coding change'').<br />
* Make the coding window non-modal.<br />
* Allow for saving scripts in spreadsheets.<br />
* Make the "help()" function available through the add-on.<br />
* Communication between data.frames and spreadsheets in Calc.<br />
* Have the ability to update a persistent graphic. Here's the use case:<br />
<ol><br />
# User creates a graph (i.e. a histogram) from data.<br />
# Data changes. User wishes to update the existing graph rather than generating a new one (b/c of format changes, etc.)<br />
# This would be more useful if OpenOffice allowed dynamic linking of objects, which I don't think it does (so that updates to a linked object propagate to linked instances; something that MS Office does fairly well).<br />
</ol><br />
*Plotting:<br />
** OOo has no '''mosaic plot''' which is a good visualization of summary-results of the data-pilot output. [http://stat.ethz.ch/R-manual/R-patched/library/graphics/html/mosaicplot.html mosaicplot R function]<br />
** OOo has no '''fourfold plot''' [http://cran.r-project.org/src/contrib/Descriptions/vcd.html Visualizing Categorical Data] - also includes extended mosaic and much more<br />
* Add a way to loop from the coding window... Even a simple ''Loop:'' command would be useful.<br />
<br />
=== Future ===<br />
Here is a List of Ideas. Requires more packages, GUI Interfaces and possibly some coding.<br />
* Have GUI interfaces for:<br />
** the [http://had.co.nz/ggplot2/ ggplot package]<br />
* just more plotting<br />
** '''spie chat''' this one implements pie charts with two parameters (radius and angle, with color codes). [http://addictedtor.free.fr/graphiques/RGraphGallery.php?graph=106 example + code]<br />
* evaluate [http://cran.r-project.org/src/contrib/Views/Finance.html Finance Packages ] for inclusion, with GUI Interface, programming helping functions, documentation, exampels:<br />
** [http://braverock.com/brian/R/PerformanceAnalytics/html/PerformanceAnalytics-package.html Econometric tools for performance and risk analysis]<br />
** [http://www.itp.phys.ethz.ch/econophysics/R/ Rmetrics collection] (also: [http://cran.r-project.org/src/contrib/Descriptions/Rmetrics.html link])<br />
* same for [http://cran.r-project.org/src/contrib/Views/SocialSciences.html Social Sciences]:<br />
** collection of functions in '''Zelig''' ([http://cran.r-project.org/src/contrib/Descriptions/Zelig.html package (look at the long list of vignettes!], [http://gking.harvard.edu/zelig website]) ''Zelig is an easy-to-use program that can estimate, and help interpret the results of, an enormous range of statistical models. It literally is "everyone's statistical software" because Zelig's simple unified framework incorporates everyone else's (R) code.'' - i think, working with a single framework is easier to implement.<br />
** [http://cran.r-project.org/src/contrib/Descriptions/eRm.html eRm: Rasch Model]<br />
** [http://cran.okada.jp.org/src/contrib/Descriptions/plink.html linking]<br />
* [http://cran.r-project.org/src/contrib/Views/ other interesting packages]<br />
* Have a look at the following wiki pages for other ideas to implement in the R way:<br />
** [http://wiki.services.openoffice.org/wiki/Calc/To-Dos/Statistical_Data_Analysis_Tool Calc/To-Dos/Statistical Data Analysis Tool]<br />
** [http://wiki.services.openoffice.org/wiki/Calc/To-Dos/Statistics/Miscellaneous_Data_Analysis Calc/To-Dos/Statistics/Miscellaneous Data Analysis]<br />
* Support for [http://cran.r-project.org/doc/packages/codetools.pdf codetools] for code testing.<br />
<br />
== Implemented Requests ==<br />
<br />
* '''Fixed bug:''' The following code doesn't seem to work in the RCalcCoder on Windows XP SP2, R 2.5.1:<br />
:: <code>rnorm(1)</code><br />
:: <code>{$OUT#A1}<-{$BASE}</code><br />
* '''Fixed bug:''' The following code doesn't seem to work in the RCalcCoder on Windows XP SP2, R 2.5.1 (seems to be a one character input line problem):<br />
:: <code>3</code><br />
:: <code>{$OUT#A1}<-{$BASE}</code><br />
* '''Fixed bug:''' The *.txt files used for GUI scripting don't load properly on many computers. May have something to do with using "library", and "require" might be a better option.<br />
* '''Fixed bug:''' Passing the following code causes the RCalcCoder to crash:<br />
:: <code>3+3</code><br />
:: <code>{$OUT#C1}<-{$BASE}</code><br />
* '''Fixed bug:''' As it stands, RCalcCaller can't read values from matrices with equations. This code does not work <code>=RTestConnection()</code> with a value of 0 or 1, it will throw an error if we refer to this in code. For example, try the code below:<br />
:: <code>// First, type =RTestConnection() in cell A1.</code><br />
:: <code>a <- {$A1}</code><br />
:: <code>a*3</code><br />
* '''Fixed bug:''' RCalcCaller can't accept String inputs from cells.<br />
* '''Fixed bug:''' Need to implement missing values.<br />
* '''Implemented Feature:''' Need to implement error output -- right now, nothing happens in the coding window.<br />
* '''Fixed bug:''' Need to implement error checking for GUI input fields.<br />
* '''Fixed bug:''' Move the "About" window to the main menu, not the "Advanced" tab.<br />
<br />
[[Category: R and Calc]]</div>Wojciechhttps://wiki.openoffice.org/w/index.php?title=R_and_Calc:_Bugs_and_Feature_Requests&diff=52539R and Calc: Bugs and Feature Requests2007-11-07T07:04:08Z<p>Wojciech: </p>
<hr />
<div>This section is meant to keep track of the bugs plaguing the add-on, as well as any features people would like to see in upcoming versions. For now, there are three categories on this page:<br />
* '''Bugs: ''' things that need to be fixed urgently (ideally, in the next release).<br />
* '''Feature Requests: ''' things that need to be added at some point in the future, but are not necessary for the healthy functioning of the software.<br />
* '''Implemented Requests: ''' once anything in the categories above is implemented, it is moved here.<br />
<br />
== Bugs ==<br />
<br />
* Passing the following code to RCalcDump causes a NullPointerException:<br />
:: <code>nls(y ~ a*x + b, data = data.frame(cbind(x = c(1.1, 2.1, 3, 3.9), y = c(1, 2, 3, 4))), start=list(a = 1, b = 1))</code><br />
This is likely because the returned R object has embedded REXPs, functions, and environments.<br />
* Passing <code>a<-127</code> to RCalcDump will cause it to print the outputs of the previous statement rather than this one.<br />
* R optional packages must be installed in the default R location... Otherwise they cannot be loaded.<br />
* The add-on needs to be installed manually -- Tools > Extension Manager fails to install properly.<br />
* Very slow in extremely large sets of data (probably due to using TCP/IP to send information).<br />
* RCalcDump does not print matrices and frames properly, but prints columns instead.<br />
* Missing values -- need a good way to deal with missing values. We cannot use a test for non-numeric values because of Factors in R.<br />
* Installation with extension manager on us_en version of OOo OK, and works as desired, but on Hungarian version R Add-On menu item failed to show in the main menu.<br />
<br />
== Feature Requests ==<br />
<br />
* Dynamic array output. As it stands, you need to know the size of the array if you want the RCalcCoder to output properly.<br />
* Make it so the {$BASE} keyword can be replaced with code. Currently, RCalcCaller won't work with<br />
<code>{$OUT#A1}<-var(c(1,2,3,4))</code><br />
But having such code support would be extremely useful.<br />
* Make the actual syntax more intuitive and easier to use.<br />
* The getOutputs() function in the RCalcInterface is very inefficient and should be replaced (''note that this is a fairly substantial coding change'').<br />
* Make the coding window non-modal.<br />
* Allow for saving scripts in spreadsheets.<br />
* Make the "help()" function available through the add-on.<br />
* Communication between data.frames and spreadsheets in Calc.<br />
* Have the ability to update a persistent graphic. Here's the use case:<br />
<ol><br />
# User creates a graph (i.e. a histogram) from data.<br />
# Data changes. User wishes to update the existing graph rather than generating a new one (b/c of format changes, etc.)<br />
# This would be more useful if OpenOffice allowed dynamic linking of objects, which I don't think it does (so that updates to a linked object propagate to linked instances; something that MS Office does fairly well).<br />
</ol><br />
*Plotting:<br />
** OOo has no '''mosaic plot''' which is a good visualization of summary-results of the data-pilot output. [http://stat.ethz.ch/R-manual/R-patched/library/graphics/html/mosaicplot.html mosaicplot R function]<br />
** OOo has no '''fourfold plot''' [http://cran.r-project.org/src/contrib/Descriptions/vcd.html Visualizing Categorical Data] - also includes extended mosaic and much more<br />
* Add a way to loop from the coding window... Even a simple ''Loop:'' command would be useful.<br />
<br />
=== Future ===<br />
Here is a List of Ideas. Requires more packages, GUI Interfaces and possibly some coding.<br />
* Have GUI interfaces for:<br />
** the [http://had.co.nz/ggplot2/ ggplot package]<br />
* just more plotting<br />
** '''spie chat''' this one implements pie charts with two parameters (radius and angle, with color codes). [http://addictedtor.free.fr/graphiques/RGraphGallery.php?graph=106 example + code]<br />
* evaluate [http://cran.r-project.org/src/contrib/Views/Finance.html Finance Packages ] for inclusion, with GUI Interface, programming helping functions, documentation, exampels:<br />
** [http://braverock.com/brian/R/PerformanceAnalytics/html/PerformanceAnalytics-package.html Econometric tools for performance and risk analysis]<br />
** [http://www.itp.phys.ethz.ch/econophysics/R/ Rmetrics collection] (also: [http://cran.r-project.org/src/contrib/Descriptions/Rmetrics.html link])<br />
* same for [http://cran.r-project.org/src/contrib/Views/SocialSciences.html Social Sciences]:<br />
** collection of functions in '''Zelig''' ([http://cran.r-project.org/src/contrib/Descriptions/Zelig.html package (look at the long list of vignettes!], [http://gking.harvard.edu/zelig website]) ''Zelig is an easy-to-use program that can estimate, and help interpret the results of, an enormous range of statistical models. It literally is "everyone's statistical software" because Zelig's simple unified framework incorporates everyone else's (R) code.'' - i think, working with a single framework is easier to implement.<br />
** [http://cran.r-project.org/src/contrib/Descriptions/eRm.html eRm: Rasch Model]<br />
** [http://cran.okada.jp.org/src/contrib/Descriptions/plink.html linking]<br />
* [http://cran.r-project.org/src/contrib/Views/ other interesting packages]<br />
* Have a look at the following wiki pages for other ideas to implement in the R way:<br />
** [http://wiki.services.openoffice.org/wiki/Calc/To-Dos/Statistical_Data_Analysis_Tool Calc/To-Dos/Statistical Data Analysis Tool]<br />
** [http://wiki.services.openoffice.org/wiki/Calc/To-Dos/Statistics/Miscellaneous_Data_Analysis Calc/To-Dos/Statistics/Miscellaneous Data Analysis]<br />
<br />
== Implemented Requests ==<br />
<br />
* '''Fixed bug:''' The following code doesn't seem to work in the RCalcCoder on Windows XP SP2, R 2.5.1:<br />
:: <code>rnorm(1)</code><br />
:: <code>{$OUT#A1}<-{$BASE}</code><br />
* '''Fixed bug:''' The following code doesn't seem to work in the RCalcCoder on Windows XP SP2, R 2.5.1 (seems to be a one character input line problem):<br />
:: <code>3</code><br />
:: <code>{$OUT#A1}<-{$BASE}</code><br />
* '''Fixed bug:''' The *.txt files used for GUI scripting don't load properly on many computers. May have something to do with using "library", and "require" might be a better option.<br />
* '''Fixed bug:''' Passing the following code causes the RCalcCoder to crash:<br />
:: <code>3+3</code><br />
:: <code>{$OUT#C1}<-{$BASE}</code><br />
* '''Fixed bug:''' As it stands, RCalcCaller can't read values from matrices with equations. This code does not work <code>=RTestConnection()</code> with a value of 0 or 1, it will throw an error if we refer to this in code. For example, try the code below:<br />
:: <code>// First, type =RTestConnection() in cell A1.</code><br />
:: <code>a <- {$A1}</code><br />
:: <code>a*3</code><br />
* '''Fixed bug:''' RCalcCaller can't accept String inputs from cells.<br />
* '''Fixed bug:''' Need to implement missing values.<br />
* '''Implemented Feature:''' Need to implement error output -- right now, nothing happens in the coding window.<br />
* '''Fixed bug:''' Need to implement error checking for GUI input fields.<br />
* '''Fixed bug:''' Move the "About" window to the main menu, not the "Advanced" tab.<br />
<br />
[[Category: R and Calc]]</div>Wojciechhttps://wiki.openoffice.org/w/index.php?title=R_and_Calc&diff=49573R and Calc2007-10-08T04:51:16Z<p>Wojciech: </p>
<hr />
<div><blockquote style="background: white; border: 1px solid rgb(153, 153, 153); padding: 1em;">This page is meant as a general overview and installation guide for the software. Please see [[R and Calc Documentation]] for more information on functions, scripting, and general usage. Also feel free to submit bug reports in the [[R and Calc: Bugs and Feature Requests]] page.</blockquote><br />
<br />
"R and Calc" is an [[OpenOffice.org]] (OO.o) [[Calc]] add-on that allows you to use [http://www.r-project.org/ R] methods and functions. The software is currently in early development, though a '''basic''' working version does exist, and is available for download.<br />
<br />
We welcome any and all comments and name suggestions. Please send them to [[User:Wojciech|Wojciech Gryc]].<br />
<br />
For those who come here often, here is the latest version:<br />
* '''Version:''' 0.1.11<br />
* '''Release Date:''' October 8, 2007 (12:50 am EST)<br />
* '''Link:''' http://www.11-55.org/rcalc/2007-10-08/RAddon.uno.pkg<br />
* '''Source Code:''' http://www.11-55.org/rcalc/2007-10-08/rcalc-0_1_11.zip<br />
* '''Manual:''' http://www.11-55.org/rcalc/2007-10-08/manual.pdf<br />
<br />
==Requirements==<br />
<br />
You need the following software to run this add-on. While older versions may suffice, they have not been tested yet.<br />
* OpenOffice.org 2.1<br />
* Java 5.0<br />
* RServe 0.4.7<br />
<br />
==Installing==<br />
<br />
The current version is a prototype and implements only one tool: RDUMP. This method is accessed through the actual Calc menu, and allows you to see the R object structure for various method calls. <br />
<br />
To use the add-on, you need to install R and [http://www.rforge.net/Rserve Rserve]. Instructions for installing R can be found at http://www.r-project.org/ Once installed, run R and type the following to install Rserve. Click "enter" at the end of each bullet point:<br />
<br />
* install.packages("Rserve")<br />
<br />
Rserve needs to be running to work, and can be launched with the following commands... Note that you only need to do this when you want to use the R Add-on for Calc.<br />
<br />
* library(Rserve)<br />
* Rserve()<br />
<br />
Now that you have the prerequisites installed, download the package RAddon.uno.pkg (linked above). Unzip the file, and let's call the directory you unzipped it in <RA_DIR>. Now let <OO_HOME> be your OpenOffice.org installation directory. Open the command prompt or terminal window and go to <OO_HOME>/program/ and type:<br />
<br />
* unopkg add <RA_DIR>/RAddon.uno.pkg<br />
<br />
If this is not your first time installing the add-in, you need to check if a previous version is also on the system. If it is, then you will not be able to install the new version. To do this, go to <OO HOME>/program and type:<br />
<br />
* unopkg list<br />
<br />
This will show you the list of packages already installed, and you should be able to check if the add-is is there. Remember to look for "RAddon.uno.pkg". You can also skip this step and try to uninstall RAddon.uno.pkg regardless -- this will not harm your OpenOffice.org installation in any way, even if RAddon.uno.pkg is abset. To do this, type:<br />
<br />
* unopkg remove RAddon.uno.pkg<br />
<br />
Finally, some operating systems require that you restart your OpenOffice.org installation (if you're not sure, restart your computer) to be able to see the cell functions that come with this package.<br />
<br />
==Using==<br />
<br />
Using the add-on is very simple at this stage. To see the tool at work, open Calc. In the menus, go to R Add-on > Rdump(). A new dialog window will pop up. Type in an R script -- here are some examples:<br />
<br />
* rnorm(10)<br />
* cor.test(c(1,2,3,4), c(1,2,2,3))<br />
<br />
Then click "Run". A new sheet should appear. Close the dialog with "Close" and check the new sheet -- you should see various pieces of information on the sheet.<br />
<br />
==Testing==<br />
<br />
So far, the software has been tested on the following.<br />
<br />
===Version 0.1.7===<br />
<br />
* 64-bit Gentoo Linux running JDK 1.5.0.12 (64-bit version), OpenOffice 2.2.1, and R 2.4.1<br />
<br />
===Version 0.1.6===<br />
<br />
* Ubuntu Feisty Fawn on Java 1.6.0 <br />
<br />
===Version 0.1.5===<br />
<br />
* Fedora Core 7 running native Java<br />
* Ubuntu Edgy Eft running SDK 1.5.0_08 and OpenOffice 2.1.<br />
* Windows XP SP2 running running JDK 1.6.0_02 and OpenOffice 2.2.<br />
<br />
===Version 0.1.0===<br />
<br />
* Fedora Core 6 running JDK 1.6.0_01 and OpenOffice 2.2.<br />
* Ubuntu Edgy Eft running SDK 1.5.0_08 and OpenOffice 2.1.<br />
* Windows XP running running JDK 1.6.0_01 and OpenOffice 2.2.<br />
<br />
==About==<br />
<br />
This add-on is the result of a Google [[Summer of Code 2007]] project. It was initially created by [[User:Wojciech|Wojciech Gryc]]. For information pertaining to the development of this add-on, see [http://www.11-55.org/ooblog/ Wojciech's Blog].<br />
<br />
==Older Versions==<br />
<br />
* '''0.1.10''' [http://www.11-55.org/rcalc/2007-09-08/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-09-08/rcalc-0_1_10.zip Source Code])<br />
* '''0.1.9''' [http://www.11-55.org/rcalc/2007-09-04_2/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-09-04_2/rcalc-0_1_9.zip Source Code])<br />
* '''0.1.8''' [http://www.11-55.org/rcalc/2007-09-04/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-09-04/rcalc-0_1_8.zip Source Code])<br />
* '''0.1.7''' [http://www.11-55.org/rcalc/2007-08-23/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-08-23/rcalc-0_1_7.zip Source Code])<br />
* '''0.1.6''' [http://www.11-55.org/rcalc/2007-08-19/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-08-19/rcalc-0_1_6.zip Source Code])<br />
* '''0.1.5''': [http://www.11-55.org/rcalc/2007-08-16/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-08-16/rcalc-0_1_5.zip Source Code])<br />
* '''0.1.4''': [http://www.11-55.org/rcalc/2007-08-10/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-08-10/rcalc-0_1_4.zip Source Code])<br />
* '''0.1.3''': [http://www.11-55.org/rcalc/2007-08-02/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-08-02/rcalc-0_1_3.zip Source Code])<br />
* '''0.1.2''': [http://www.11-55.org/rcalc/2007-06-01/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-06-01/rcalc-0_1_2.zip Source Code])<br />
* '''0.1.1''': [http://www.11-55.org/rcalc/2007-05-25/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-05-25/rcalc-0_1_1.zip Source Code])<br />
* '''0.1.0''': [http://www.11-55.org/rcalc/2007-05-15/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-05-15/rcalc-0.1.0.zip Source Code])<br />
<br />
[[Category:Calc]]<br />
[[Category: R and Calc]]</div>Wojciechhttps://wiki.openoffice.org/w/index.php?title=R_and_Calc:_Bugs_and_Feature_Requests&diff=49572R and Calc: Bugs and Feature Requests2007-10-08T04:39:20Z<p>Wojciech: </p>
<hr />
<div>This section is meant to keep track of the bugs plaguing the add-on, as well as any features people would like to see in upcoming versions. For now, there are three categories on this page:<br />
* '''Bugs: ''' things that need to be fixed urgently (ideally, in the next release).<br />
* '''Feature Requests: ''' things that need to be added at some point in the future, but are not necessary for the healthy functioning of the software.<br />
* '''Implemented Requests: ''' once anything in the categories above is implemented, it is moved here.<br />
<br />
== Bugs ==<br />
<br />
* Passing the following code to RCalcDump causes a NullPointerException:<br />
:: <code>nls(y ~ a*x + b, data = data.frame(cbind(x = c(1.1, 2.1, 3, 3.9), y = c(1, 2, 3, 4))), start=list(a = 1, b = 1))</code><br />
This is likely because the returned R object has embedded REXPs, functions, and environments.<br />
* Passing <code>a<-127</code> to RCalcDump will cause it to print the outputs of the previous statement rather than this one.<br />
* R optional packages must be installed in the default R location... Otherwise they cannot be loaded.<br />
* The add-on needs to be installed manually -- Tools > Extension Manager fails to install properly.<br />
* Very slow in extremely large sets of data (probably due to using TCP/IP to send information).<br />
* RCalcDump does not print matrices and frames properly, but prints columns instead.<br />
* Missing values -- need a good way to deal with missing values. We cannot use a test for non-numeric values because of Factors in R.<br />
* Installation with extension manager on us_en version of OOo OK, and works as desired, but on Hungarian version R Add-On menu item failed to show in the main menu.<br />
<br />
== Feature Requests ==<br />
<br />
* Dynamic array output. As it stands, you need to know the size of the array if you want the RCalcCoder to output properly.<br />
* Make it so the {$BASE} keyword can be replaced with code. Currently, RCalcCaller won't work with<br />
<code>{$OUT#A1}<-var(c(1,2,3,4))</code><br />
But having such code support would be extremely useful.<br />
* Make the actual syntax more intuitive and easier to use.<br />
* The getOutputs() function in the RCalcInterface is very inefficient and should be replaced (''note that this is a fairly substantial coding change'').<br />
* Make the coding window non-modal.<br />
* Allow for saving scripts in spreadsheets.<br />
* Make the "help()" function available through the add-on.<br />
* Communication between data.frames and spreadsheets in Calc.<br />
* Have the ability to update a persistent graphic. Here's the use case:<br />
<ol><br />
# User creates a graph (i.e. a histogram) from data.<br />
# Data changes. User wishes to update the existing graph rather than generating a new one (b/c of format changes, etc.)<br />
# This would be more useful if OpenOffice allowed dynamic linking of objects, which I don't think it does (so that updates to a linked object propagate to linked instances; something that MS Office does fairly well).<br />
</ol><br />
*Plotting:<br />
** OOo has no '''mosaic plot''' which is a good visualization of summary-results of the data-pilot output. [http://stat.ethz.ch/R-manual/R-patched/library/graphics/html/mosaicplot.html mosaicplot R function]<br />
** OOo has no '''fourfold plot''' [http://cran.r-project.org/src/contrib/Descriptions/vcd.html Visualizing Categorical Data] - also includes extended mosaic and much more<br />
<br />
<br />
=== Future ===<br />
Here is a List of Ideas. Requires more packages, GUI Interfaces and possibly some coding.<br />
* Have GUI interfaces for:<br />
** the [http://had.co.nz/ggplot2/ ggplot package]<br />
* just more plotting<br />
** '''spie chat''' this one implements pie charts with two parameters (radius and angle, with color codes). [http://addictedtor.free.fr/graphiques/RGraphGallery.php?graph=106 example + code]<br />
* evaluate [http://cran.r-project.org/src/contrib/Views/Finance.html Finance Packages ] for inclusion, with GUI Interface, programming helping functions, documentation, exampels:<br />
** [http://braverock.com/brian/R/PerformanceAnalytics/html/PerformanceAnalytics-package.html Econometric tools for performance and risk analysis]<br />
** [http://www.itp.phys.ethz.ch/econophysics/R/ Rmetrics collection] (also: [http://cran.r-project.org/src/contrib/Descriptions/Rmetrics.html link])<br />
* same for [http://cran.r-project.org/src/contrib/Views/SocialSciences.html Social Sciences]:<br />
** collection of functions in '''Zelig''' ([http://cran.r-project.org/src/contrib/Descriptions/Zelig.html package (look at the long list of vignettes!], [http://gking.harvard.edu/zelig website]) ''Zelig is an easy-to-use program that can estimate, and help interpret the results of, an enormous range of statistical models. It literally is "everyone's statistical software" because Zelig's simple unified framework incorporates everyone else's (R) code.'' - i think, working with a single framework is easier to implement.<br />
** [http://cran.r-project.org/src/contrib/Descriptions/eRm.html eRm: Rasch Model]<br />
** [http://cran.okada.jp.org/src/contrib/Descriptions/plink.html linking]<br />
* [http://cran.r-project.org/src/contrib/Views/ other interesting packages]<br />
* Have a look at the following wiki pages for other ideas to implement in the R way:<br />
** [http://wiki.services.openoffice.org/wiki/Calc/To-Dos/Statistical_Data_Analysis_Tool Calc/To-Dos/Statistical Data Analysis Tool]<br />
** [http://wiki.services.openoffice.org/wiki/Calc/To-Dos/Statistics/Miscellaneous_Data_Analysis Calc/To-Dos/Statistics/Miscellaneous Data Analysis]<br />
<br />
== Implemented Requests ==<br />
<br />
* '''Fixed bug:''' The following code doesn't seem to work in the RCalcCoder on Windows XP SP2, R 2.5.1:<br />
:: <code>rnorm(1)</code><br />
:: <code>{$OUT#A1}<-{$BASE}</code><br />
* '''Fixed bug:''' The following code doesn't seem to work in the RCalcCoder on Windows XP SP2, R 2.5.1 (seems to be a one character input line problem):<br />
:: <code>3</code><br />
:: <code>{$OUT#A1}<-{$BASE}</code><br />
* '''Fixed bug:''' The *.txt files used for GUI scripting don't load properly on many computers. May have something to do with using "library", and "require" might be a better option.<br />
* '''Fixed bug:''' Passing the following code causes the RCalcCoder to crash:<br />
:: <code>3+3</code><br />
:: <code>{$OUT#C1}<-{$BASE}</code><br />
* '''Fixed bug:''' As it stands, RCalcCaller can't read values from matrices with equations. This code does not work <code>=RTestConnection()</code> with a value of 0 or 1, it will throw an error if we refer to this in code. For example, try the code below:<br />
:: <code>// First, type =RTestConnection() in cell A1.</code><br />
:: <code>a <- {$A1}</code><br />
:: <code>a*3</code><br />
* '''Fixed bug:''' RCalcCaller can't accept String inputs from cells.<br />
* '''Fixed bug:''' Need to implement missing values.<br />
* '''Implemented Feature:''' Need to implement error output -- right now, nothing happens in the coding window.<br />
* '''Fixed bug:''' Need to implement error checking for GUI input fields.<br />
* '''Fixed bug:''' Move the "About" window to the main menu, not the "Advanced" tab.<br />
<br />
[[Category: R and Calc]]</div>Wojciechhttps://wiki.openoffice.org/w/index.php?title=R_and_Calc:_Bugs_and_Feature_Requests&diff=45398R and Calc: Bugs and Feature Requests2007-09-08T20:42:09Z<p>Wojciech: </p>
<hr />
<div>This section is meant to keep track of the bugs plaguing the add-on, as well as any features people would like to see in upcoming versions. For now, there are three categories on this page:<br />
* '''Bugs: ''' things that need to be fixed urgently (ideally, in the next release).<br />
* '''Feature Requests: ''' things that need to be added at some point in the future, but are not necessary for the healthy functioning of the software.<br />
* '''Implemented Requests: ''' once anything in the categories above is implemented, it is moved here.<br />
<br />
== Bugs ==<br />
<br />
* Passing the following code to RCalcDump causes a NullPointerException:<br />
:: <code>nls(y ~ a*x + b, data = data.frame(cbind(x = c(1.1, 2.1, 3, 3.9), y = c(1, 2, 3, 4))), start=list(a = 1, b = 1))</code><br />
This is likely because the returned R object has embedded REXPs, functions, and environments.<br />
* Passing <code>a<-127</code> to RCalcDump will cause it to print the outputs of the previous statement rather than this one.<br />
* R optional packages must be installed in the default R location... Otherwise they cannot be loaded.<br />
* The add-on needs to be installed manually -- Tools > Extension Manager fails to install properly.<br />
* Very slow in extremely large sets of data (probably due to using TCP/IP to send information).<br />
* RCalcDump does not print matrices and frames properly, but prints columns instead.<br />
* Missing values -- need a good way to deal with missing values. We cannot use a test for non-numeric values because of Factors in R.<br />
* Move the "About" window to the main menu, not the "Advanced" tab.<br />
<br />
== Feature Requests ==<br />
<br />
* Dynamic array output. As it stands, you need to know the size of the array if you want the RCalcCoder to output properly.<br />
* Make it so the {$BASE} keyword can be replaced with code. Currently, RCalcCaller won't work with<br />
<code>{$OUT#A1}<-var(c(1,2,3,4))</code><br />
But having such code support would be extremely useful.<br />
* Make the actual syntax more intuitive and easier to use.<br />
* The getOutputs() function in the RCalcInterface is very inefficient and should be replaced (''note that this is a fairly substantial coding change'').<br />
* Make the coding window non-modal.<br />
* Allow for saving scripts in spreadsheets.<br />
* Make the "help()" function available through the add-on.<br />
* Communication between data.frames and spreadsheets in Calc.<br />
* Have the ability to update a persistent graphic. Here's the use case:<br />
** User creates a graph (i.e. a histogram) from data.<br />
** Data changes. User wishes to update the existing graph rather than generating a new one (b/c of format changes, etc.)<br />
** This would be more useful if OpenOffice allowed dynamic linking of objects, which I don't think it does (so that updates to a linked object propagate to linked instances; something that MS Office does fairly well).<br />
* Have GUI interfaces for the ggplot package (see http://had.co.nz/ggplot2/).<br />
<br />
== Implemented Requests ==<br />
<br />
* '''Fixed bug:''' The following code doesn't seem to work in the RCalcCoder on Windows XP SP2, R 2.5.1:<br />
:: <code>rnorm(1)</code><br />
:: <code>{$OUT#A1}<-{$BASE}</code><br />
* '''Fixed bug:''' The following code doesn't seem to work in the RCalcCoder on Windows XP SP2, R 2.5.1 (seems to be a one character input line problem):<br />
:: <code>3</code><br />
:: <code>{$OUT#A1}<-{$BASE}</code><br />
* '''Fixed bug:''' The *.txt files used for GUI scripting don't load properly on many computers. May have something to do with using "library", and "require" might be a better option.<br />
* '''Fixed bug:''' Passing the following code causes the RCalcCoder to crash:<br />
:: <code>3+3</code><br />
:: <code>{$OUT#C1}<-{$BASE}</code><br />
* '''Fixed bug:''' As it stands, RCalcCaller can't read values from matrices with equations. This code does not work <code>=RTestConnection()</code> with a value of 0 or 1, it will throw an error if we refer to this in code. For example, try the code below:<br />
:: <code>// First, type =RTestConnection() in cell A1.</code><br />
:: <code>a <- {$A1}</code><br />
:: <code>a*3</code><br />
* '''Fixed bug:''' RCalcCaller can't accept String inputs from cells.<br />
* '''Fixed bug:''' Need to implement missing values.<br />
* '''Implemented Feature:''' Need to implement error output -- right now, nothing happens in the coding window.<br />
* '''Fixed bug:''' Need to implement error checking for GUI input fields.<br />
<br />
[[Category: R and Calc]]</div>Wojciechhttps://wiki.openoffice.org/w/index.php?title=R_and_Calc:_Bugs_and_Feature_Requests&diff=45397R and Calc: Bugs and Feature Requests2007-09-08T20:30:09Z<p>Wojciech: </p>
<hr />
<div>This section is meant to keep track of the bugs plaguing the add-on, as well as any features people would like to see in upcoming versions. For now, there are three categories on this page:<br />
* '''Bugs: ''' things that need to be fixed urgently (ideally, in the next release).<br />
* '''Feature Requests: ''' things that need to be added at some point in the future, but are not necessary for the healthy functioning of the software.<br />
* '''Implemented Requests: ''' once anything in the categories above is implemented, it is moved here.<br />
<br />
== Bugs ==<br />
<br />
* Passing the following code to RCalcDump causes a NullPointerException:<br />
:: <code>nls(y ~ a*x + b, data = data.frame(cbind(x = c(1.1, 2.1, 3, 3.9), y = c(1, 2, 3, 4))), start=list(a = 1, b = 1))</code><br />
This is likely because the returned R object has embedded REXPs, functions, and environments.<br />
* Passing <code>a<-127</code> to RCalcDump will cause it to print the outputs of the previous statement rather than this one.<br />
* R optional packages must be installed in the default R location... Otherwise they cannot be loaded.<br />
* The add-on needs to be installed manually -- Tools > Extension Manager fails to install properly.<br />
* Very slow in extremely large sets of data (probably due to using TCP/IP to send information).<br />
* RCalcDump does not print matrices and frames properly, but prints columns instead.<br />
* Missing values -- need a good way to deal with missing values. We cannot use a test for non-numeric values because of Factors in R.<br />
* Move the "About" window to the main menu, not the "Advanced" tab.<br />
* Need to implement error checking for GUI input fields.<br />
<br />
== Feature Requests ==<br />
<br />
* Dynamic array output. As it stands, you need to know the size of the array if you want the RCalcCoder to output properly.<br />
* Make it so the {$BASE} keyword can be replaced with code. Currently, RCalcCaller won't work with<br />
<code>{$OUT#A1}<-var(c(1,2,3,4))</code><br />
But having such code support would be extremely useful.<br />
* Make the actual syntax more intuitive and easier to use.<br />
* The getOutputs() function in the RCalcInterface is very inefficient and should be replaced (''note that this is a fairly substantial coding change'').<br />
* Make the coding window non-modal.<br />
* Allow for saving scripts in spreadsheets.<br />
* Make the "help()" function available through the add-on.<br />
* Communication between data.frames and spreadsheets in Calc.<br />
* Have the ability to update a persistent graphic. Here's the use case:<br />
** User creates a graph (i.e. a histogram) from data.<br />
** Data changes. User wishes to update the existing graph rather than generating a new one (b/c of format changes, etc.)<br />
** This would be more useful if OpenOffice allowed dynamic linking of objects, which I don't think it does (so that updates to a linked object propagate to linked instances; something that MS Office does fairly well).<br />
* Have GUI interfaces for the ggplot package (see http://had.co.nz/ggplot2/).<br />
<br />
== Implemented Requests ==<br />
<br />
* '''Fixed bug:''' The following code doesn't seem to work in the RCalcCoder on Windows XP SP2, R 2.5.1:<br />
:: <code>rnorm(1)</code><br />
:: <code>{$OUT#A1}<-{$BASE}</code><br />
* '''Fixed bug:''' The following code doesn't seem to work in the RCalcCoder on Windows XP SP2, R 2.5.1 (seems to be a one character input line problem):<br />
:: <code>3</code><br />
:: <code>{$OUT#A1}<-{$BASE}</code><br />
* '''Fixed bug:''' The *.txt files used for GUI scripting don't load properly on many computers. May have something to do with using "library", and "require" might be a better option.<br />
* '''Fixed bug:''' Passing the following code causes the RCalcCoder to crash:<br />
:: <code>3+3</code><br />
:: <code>{$OUT#C1}<-{$BASE}</code><br />
* '''Fixed bug:''' As it stands, RCalcCaller can't read values from matrices with equations. This code does not work <code>=RTestConnection()</code> with a value of 0 or 1, it will throw an error if we refer to this in code. For example, try the code below:<br />
:: <code>// First, type =RTestConnection() in cell A1.</code><br />
:: <code>a <- {$A1}</code><br />
:: <code>a*3</code><br />
* '''Fixed bug:''' RCalcCaller can't accept String inputs from cells.<br />
* '''Fixed bug:''' Need to implement missing values.<br />
* '''Implemented Feature:''' Need to implement error output -- right now, nothing happens in the coding window.<br />
<br />
[[Category: R and Calc]]</div>Wojciechhttps://wiki.openoffice.org/w/index.php?title=R_and_Calc&diff=45313R and Calc2007-09-08T07:24:23Z<p>Wojciech: </p>
<hr />
<div><blockquote style="background: white; border: 1px solid rgb(153, 153, 153); padding: 1em;">This page is meant as a general overview and installation guide for the software. Please see [[R and Calc Documentation]] for more information on functions, scripting, and general usage. Also feel free to submit bug reports in the [[R and Calc: Bugs and Feature Requests]] page.</blockquote><br />
<br />
"R and Calc" is an [[OpenOffice.org]] (OO.o) [[Calc]] add-on that allows you to use [http://www.r-project.org/ R] methods and functions. The software is currently in early development, though a '''basic''' working version does exist, and is available for download.<br />
<br />
We welcome any and all comments and name suggestions. Please send them to [[User:Wojciech|Wojciech Gryc]].<br />
<br />
For those who come here often, here is the latest version:<br />
* '''Version:''' 0.1.10<br />
* '''Release Date:''' September 8, 2007 (3:23 am EST)<br />
* '''Link:''' http://www.11-55.org/rcalc/2007-09-08/RAddon.uno.pkg<br />
* '''Source Code:''' http://www.11-55.org/rcalc/2007-09-08/rcalc-0_1_10.zip<br />
* '''Manual:''' http://www.11-55.org/rcalc/2007-09-08/manual.pdf<br />
<br />
==Requirements==<br />
<br />
You need the following software to run this add-on. While older versions may suffice, they have not been tested yet.<br />
* OpenOffice.org 2.1<br />
* Java 5.0<br />
* RServe 0.4.7<br />
<br />
==Installing==<br />
<br />
The current version is a prototype and implements only one tool: RDUMP. This method is accessed through the actual Calc menu, and allows you to see the R object structure for various method calls. <br />
<br />
To use the add-on, you need to install R and [http://www.rforge.net/Rserve Rserve]. Instructions for installing R can be found at http://www.r-project.org/ Once installed, run R and type the following to install Rserve. Click "enter" at the end of each bullet point:<br />
<br />
* install.packages("Rserve")<br />
<br />
Rserve needs to be running to work, and can be launched with the following commands... Note that you only need to do this when you want to use the R Add-on for Calc.<br />
<br />
* library(Rserve)<br />
* Rserve()<br />
<br />
Now that you have the prerequisites installed, download the package RAddon.uno.pkg (linked above). Unzip the file, and let's call the directory you unzipped it in <RA_DIR>. Now let <OO_HOME> be your OpenOffice.org installation directory. Open the command prompt or terminal window and go to <OO_HOME>/program/ and type:<br />
<br />
* unopkg add <RA_DIR>/RAddon.uno.pkg<br />
<br />
If this is not your first time installing the add-in, you need to check if a previous version is also on the system. If it is, then you will not be able to install the new version. To do this, go to <OO HOME>/program and type:<br />
<br />
* unopkg list<br />
<br />
This will show you the list of packages already installed, and you should be able to check if the add-is is there. Remember to look for "RAddon.uno.pkg". You can also skip this step and try to uninstall RAddon.uno.pkg regardless -- this will not harm your OpenOffice.org installation in any way, even if RAddon.uno.pkg is abset. To do this, type:<br />
<br />
* unopkg remove RAddon.uno.pkg<br />
<br />
Finally, some operating systems require that you restart your OpenOffice.org installation (if you're not sure, restart your computer) to be able to see the cell functions that come with this package.<br />
<br />
==Using==<br />
<br />
Using the add-on is very simple at this stage. To see the tool at work, open Calc. In the menus, go to R Add-on > Rdump(). A new dialog window will pop up. Type in an R script -- here are some examples:<br />
<br />
* rnorm(10)<br />
* cor.test(c(1,2,3,4), c(1,2,2,3))<br />
<br />
Then click "Run". A new sheet should appear. Close the dialog with "Close" and check the new sheet -- you should see various pieces of information on the sheet.<br />
<br />
==Testing==<br />
<br />
So far, the software has been tested on the following.<br />
<br />
===Version 0.1.7===<br />
<br />
* 64-bit Gentoo Linux running JDK 1.5.0.12 (64-bit version), OpenOffice 2.2.1, and R 2.4.1<br />
<br />
===Version 0.1.6===<br />
<br />
* Ubuntu Feisty Fawn on Java 1.6.0 <br />
<br />
===Version 0.1.5===<br />
<br />
* Fedora Core 7 running native Java<br />
* Ubuntu Edgy Eft running SDK 1.5.0_08 and OpenOffice 2.1.<br />
* Windows XP SP2 running running JDK 1.6.0_02 and OpenOffice 2.2.<br />
<br />
===Version 0.1.0===<br />
<br />
* Fedora Core 6 running JDK 1.6.0_01 and OpenOffice 2.2.<br />
* Ubuntu Edgy Eft running SDK 1.5.0_08 and OpenOffice 2.1.<br />
* Windows XP running running JDK 1.6.0_01 and OpenOffice 2.2.<br />
<br />
==About==<br />
<br />
This add-on is the result of a Google [[Summer of Code 2007]] project. It was initially created by [[User:Wojciech|Wojciech Gryc]]. For information pertaining to the development of this add-on, see [http://www.11-55.org/ooblog/ Wojciech's Blog].<br />
<br />
==Older Versions==<br />
<br />
* '''0.1.9''' [http://www.11-55.org/rcalc/2007-09-04_2/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-09-04_2/rcalc-0_1_9.zip Source Code])<br />
* '''0.1.8''' [http://www.11-55.org/rcalc/2007-09-04/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-09-04/rcalc-0_1_8.zip Source Code])<br />
* '''0.1.7''' [http://www.11-55.org/rcalc/2007-08-23/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-08-23/rcalc-0_1_7.zip Source Code])<br />
* '''0.1.6''' [http://www.11-55.org/rcalc/2007-08-19/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-08-19/rcalc-0_1_6.zip Source Code])<br />
* '''0.1.5''': [http://www.11-55.org/rcalc/2007-08-16/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-08-16/rcalc-0_1_5.zip Source Code])<br />
* '''0.1.4''': [http://www.11-55.org/rcalc/2007-08-10/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-08-10/rcalc-0_1_4.zip Source Code])<br />
* '''0.1.3''': [http://www.11-55.org/rcalc/2007-08-02/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-08-02/rcalc-0_1_3.zip Source Code])<br />
* '''0.1.2''': [http://www.11-55.org/rcalc/2007-06-01/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-06-01/rcalc-0_1_2.zip Source Code])<br />
* '''0.1.1''': [http://www.11-55.org/rcalc/2007-05-25/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-05-25/rcalc-0_1_1.zip Source Code])<br />
* '''0.1.0''': [http://www.11-55.org/rcalc/2007-05-15/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-05-15/rcalc-0.1.0.zip Source Code])<br />
<br />
[[Category:Calc]]<br />
[[Category: R and Calc]]</div>Wojciechhttps://wiki.openoffice.org/w/index.php?title=R_and_Calc:_Bugs_and_Feature_Requests&diff=45312R and Calc: Bugs and Feature Requests2007-09-08T07:20:13Z<p>Wojciech: </p>
<hr />
<div>This section is meant to keep track of the bugs plaguing the add-on, as well as any features people would like to see in upcoming versions. For now, there are three categories on this page:<br />
* '''Bugs: ''' things that need to be fixed urgently (ideally, in the next release).<br />
* '''Feature Requests: ''' things that need to be added at some point in the future, but are not necessary for the healthy functioning of the software.<br />
* '''Implemented Requests: ''' once anything in the categories above is implemented, it is moved here.<br />
<br />
== Bugs ==<br />
<br />
* Passing the following code to RCalcDump causes a NullPointerException:<br />
:: <code>nls(y ~ a*x + b, data = data.frame(cbind(x = c(1.1, 2.1, 3, 3.9), y = c(1, 2, 3, 4))), start=list(a = 1, b = 1))</code><br />
This is likely because the returned R object has embedded REXPs, functions, and environments.<br />
* Passing <code>a<-127</code> to RCalcDump will cause it to print the outputs of the previous statement rather than this one.<br />
* R optional packages must be installed in the default R location... Otherwise they cannot be loaded.<br />
* The add-on needs to be installed manually -- Tools > Extension Manager fails to install properly.<br />
* Very slow in extremely large sets of data (probably due to using TCP/IP to send information).<br />
* RCalcDump does not print matrices and frames properly, but prints columns instead.<br />
* Missing values -- need a good way to deal with missing values. We cannot use a test for non-numeric values because of Factors in R.<br />
* Move the "About" window to the main menu, not the "Advanced" tab.<br />
<br />
== Feature Requests ==<br />
<br />
* Dynamic array output. As it stands, you need to know the size of the array if you want the RCalcCoder to output properly.<br />
* Need to implement error output -- right now, nothing happens. This applies to RCalcDump and RCalcCaller.<br />
* Make it so the {$BASE} keyword can be replaced with code. Currently, RCalcCaller won't work with<br />
<code>{$OUT#A1}<-var(c(1,2,3,4))</code><br />
But having such code support would be extremely useful.<br />
* Make the actual syntax more intuitive and easier to use.<br />
* The getOutputs() function in the RCalcInterface is very inefficient and should be replaced (''note that this is a fairly substantial coding change'').<br />
* Make the coding window non-modal.<br />
* Allow for saving scripts in spreadsheets.<br />
* Make the "help()" function available through the add-on.<br />
* Communication between data.frames and spreadsheets in Calc.<br />
* Have the ability to update a persistent graphic. Here's the use case:<br />
** User creates a graph (i.e. a histogram) from data.<br />
** Data changes. User wishes to update the existing graph rather than generating a new one (b/c of format changes, etc.)<br />
** This would be more useful if OpenOffice allowed dynamic linking of objects, which I don't think it does (so that updates to a linked object propagate to linked instances; something that MS Office does fairly well).<br />
* Have GUI interfaces for the ggplot package (see http://had.co.nz/ggplot2/).<br />
<br />
== Implemented Requests ==<br />
<br />
* '''Fixed bug:''' The following code doesn't seem to work in the RCalcCoder on Windows XP SP2, R 2.5.1:<br />
:: <code>rnorm(1)</code><br />
:: <code>{$OUT#A1}<-{$BASE}</code><br />
* '''Fixed bug:''' The following code doesn't seem to work in the RCalcCoder on Windows XP SP2, R 2.5.1 (seems to be a one character input line problem):<br />
:: <code>3</code><br />
:: <code>{$OUT#A1}<-{$BASE}</code><br />
* '''Fixed bug:''' The *.txt files used for GUI scripting don't load properly on many computers. May have something to do with using "library", and "require" might be a better option.<br />
* '''Fixed bug:''' Passing the following code causes the RCalcCoder to crash:<br />
:: <code>3+3</code><br />
:: <code>{$OUT#C1}<-{$BASE}</code><br />
* '''Fixed bug:''' As it stands, RCalcCaller can't read values from matrices with equations. This code does not work <code>=RTestConnection()</code> with a value of 0 or 1, it will throw an error if we refer to this in code. For example, try the code below:<br />
:: <code>// First, type =RTestConnection() in cell A1.</code><br />
:: <code>a <- {$A1}</code><br />
:: <code>a*3</code><br />
* '''Fixed bug:''' RCalcCaller can't accept String inputs from cells.<br />
* '''Fixed bug:''' Need to implement missing values.<br />
<br />
[[Category: R and Calc]]</div>Wojciechhttps://wiki.openoffice.org/w/index.php?title=R_and_Calc:_Bugs_and_Feature_Requests&diff=45301R and Calc: Bugs and Feature Requests2007-09-08T02:37:17Z<p>Wojciech: </p>
<hr />
<div>This section is meant to keep track of the bugs plaguing the add-on, as well as any features people would like to see in upcoming versions. For now, there are three categories on this page:<br />
* '''Bugs: ''' things that need to be fixed urgently (ideally, in the next release).<br />
* '''Feature Requests: ''' things that need to be added at some point in the future, but are not necessary for the healthy functioning of the software.<br />
* '''Implemented Requests: ''' once anything in the categories above is implemented, it is moved here.<br />
<br />
== Bugs ==<br />
<br />
* As it stands, RCalcCaller can't read values from matrices with equations. This code does not work <code>=RTestConnection()</code> with a value of 0 or 1, it will throw an error if we refer to this in code. For example, try the code below:<br />
:: <code>// First, type =RTestConnection() in cell A1.</code><br />
:: <code>a <- {$A1}</code><br />
:: <code>a*3</code><br />
* RCalcCaller can't accept String inputs from cells.<br />
* Need to implement missing values.<br />
* Passing the following code to RCalcDump causes a NullPointerException:<br />
:: <code>nls(y ~ a*x + b, data = data.frame(cbind(x = c(1.1, 2.1, 3, 3.9), y = c(1, 2, 3, 4))), start=list(a = 1, b = 1))</code><br />
This is likely because the returned R object has embedded REXPs, functions, and environments.<br />
* Passing <code>a<-127</code> to RCalcDump will cause it to print the outputs of the previous statement rather than this one.<br />
* R optional packages must be installed in the default R location... Otherwise they cannot be loaded.<br />
* The add-on needs to be installed manually -- Tools > Extension Manager fails to install properly.<br />
* Very slow in extremely large sets of data (probably due to using TCP/IP to send information).<br />
* RCalcDump does not print matrices and frames properly, but prints columns instead.<br />
* Missing values -- need a good way to deal with missing values. We cannot use a test for non-numeric values because of Factors in R.<br />
* Move the "About" window to the main menu, not the "Advanced" tab.<br />
<br />
== Feature Requests ==<br />
<br />
* Dynamic array output. As it stands, you need to know the size of the array if you want the RCalcCoder to output properly.<br />
* Need to implement error output -- right now, nothing happens. This applies to RCalcDump and RCalcCaller.<br />
* Make it so the {$BASE} keyword can be replaced with code. Currently, RCalcCaller won't work with<br />
<code>{$OUT#A1}<-var(c(1,2,3,4))</code><br />
But having such code support would be extremely useful.<br />
* Make the actual syntax more intuitive and easier to use.<br />
* The getOutputs() function in the RCalcInterface is very inefficient and should be replaced (''note that this is a fairly substantial coding change'').<br />
* Make the coding window non-modal.<br />
* Allow for saving scripts in spreadsheets.<br />
* Make the "help()" function available through the add-on.<br />
* Communication between data.frames and spreadsheets in Calc.<br />
* Have the ability to update a persistent graphic. Here's the use case:<br />
** User creates a graph (i.e. a histogram) from data.<br />
** Data changes. User wishes to update the existing graph rather than generating a new one (b/c of format changes, etc.)<br />
** This would be more useful if OpenOffice allowed dynamic linking of objects, which I don't think it does (so that updates to a linked object propagate to linked instances; something that MS Office does fairly well).<br />
* Have GUI interfaces for the ggplot package (see http://had.co.nz/ggplot2/).<br />
<br />
== Implemented Requests ==<br />
<br />
* '''Fixed bug:''' The following code doesn't seem to work in the RCalcCoder on Windows XP SP2, R 2.5.1:<br />
:: <code>rnorm(1)</code><br />
:: <code>{$OUT#A1}<-{$BASE}</code><br />
* '''Fixed bug:''' The following code doesn't seem to work in the RCalcCoder on Windows XP SP2, R 2.5.1 (seems to be a one character input line problem):<br />
:: <code>3</code><br />
:: <code>{$OUT#A1}<-{$BASE}</code><br />
* '''Fixed bug:''' The *.txt files used for GUI scripting don't load properly on many computers. May have something to do with using "library", and "require" might be a better option.<br />
* '''Fixed bug:''' Passing the following code causes the RCalcCoder to crash:<br />
:: <code>3+3</code><br />
:: <code>{$OUT#C1}<-{$BASE}</code><br />
<br />
[[Category: R and Calc]]</div>Wojciechhttps://wiki.openoffice.org/w/index.php?title=R_and_Calc:_Bugs_and_Feature_Requests&diff=45300R and Calc: Bugs and Feature Requests2007-09-08T02:33:07Z<p>Wojciech: </p>
<hr />
<div>This section is meant to keep track of the bugs plaguing the add-on, as well as any features people would like to see in upcoming versions. For now, there are three categories on this page:<br />
* '''Bugs: ''' things that need to be fixed urgently (ideally, in the next release).<br />
* '''Feature Requests: ''' things that need to be added at some point in the future, but are not necessary for the healthy functioning of the software.<br />
* '''Implemented Requests: ''' once anything in the categories above is implemented, it is moved here.<br />
<br />
== Bugs ==<br />
<br />
* As it stands, RCalcCaller can't read values from matrices with equations. This code does not work <code>=RTestConnection()</code> with a value of 0 or 1, it will throw an error if we refer to this in code. For example, try the code below:<br />
:: <code>// First, type =RTestConnection() in cell A1.</code><br />
:: <code>a <- {$A1}</code><br />
:: <code>a*3</code><br />
* RCalcCaller can't accept String inputs from cells.<br />
* Need to implement missing values.<br />
* Passing the following code to RCalcDump causes a NullPointerException:<br />
:: <code>nls(y ~ a*x + b, data = data.frame(cbind(x = c(1.1, 2.1, 3, 3.9), y = c(1, 2, 3, 4))), start=list(a = 1, b = 1))</code><br />
This is likely because the returned R object has embedded REXPs, functions, and environments.<br />
* Passing <code>a<-127</code> to RCalcDump will cause it to print the outputs of the previous statement rather than this one.<br />
* R optional packages must be installed in the default R location... Otherwise they cannot be loaded.<br />
* The add-on needs to be installed manually -- Tools > Extension Manager fails to install properly.<br />
* Very slow in extremely large sets of data (probably due to using TCP/IP to send information).<br />
* RCalcDump does not print matrices and frames properly, but prints columns instead.<br />
* Missing values -- need a good way to deal with missing values. We cannot use a test for non-numeric values because of Factors in R.<br />
<br />
== Feature Requests ==<br />
<br />
* Dynamic array output. As it stands, you need to know the size of the array if you want the RCalcCoder to output properly.<br />
* Need to implement error output -- right now, nothing happens. This applies to RCalcDump and RCalcCaller.<br />
* Make it so the {$BASE} keyword can be replaced with code. Currently, RCalcCaller won't work with<br />
<code>{$OUT#A1}<-var(c(1,2,3,4))</code><br />
But having such code support would be extremely useful.<br />
* Make the actual syntax more intuitive and easier to use.<br />
* The getOutputs() function in the RCalcInterface is very inefficient and should be replaced (''note that this is a fairly substantial coding change'').<br />
* Make the coding window non-modal.<br />
* Allow for saving scripts in spreadsheets.<br />
* Make the "help()" function available through the add-on.<br />
* Communication between data.frames and spreadsheets in Calc.<br />
* Have the ability to update a persistent graphic. Here's the use case:<br />
** User creates a graph (i.e. a histogram) from data.<br />
** Data changes. User wishes to update the existing graph rather than generating a new one (b/c of format changes, etc.)<br />
** This would be more useful if OpenOffice allowed dynamic linking of objects, which I don't think it does (so that updates to a linked object propagate to linked instances; something that MS Office does fairly well).<br />
* Have GUI interfaces for the ggplot package (see http://had.co.nz/ggplot2/).<br />
<br />
== Implemented Requests ==<br />
<br />
* '''Fixed bug:''' The following code doesn't seem to work in the RCalcCoder on Windows XP SP2, R 2.5.1:<br />
:: <code>rnorm(1)</code><br />
:: <code>{$OUT#A1}<-{$BASE}</code><br />
* '''Fixed bug:''' The following code doesn't seem to work in the RCalcCoder on Windows XP SP2, R 2.5.1 (seems to be a one character input line problem):<br />
:: <code>3</code><br />
:: <code>{$OUT#A1}<-{$BASE}</code><br />
* '''Fixed bug:''' The *.txt files used for GUI scripting don't load properly on many computers. May have something to do with using "library", and "require" might be a better option.<br />
* '''Fixed bug:''' Passing the following code causes the RCalcCoder to crash:<br />
:: <code>3+3</code><br />
:: <code>{$OUT#C1}<-{$BASE}</code><br />
<br />
[[Category: R and Calc]]</div>Wojciechhttps://wiki.openoffice.org/w/index.php?title=R_and_Calc&diff=45299R and Calc2007-09-08T02:31:30Z<p>Wojciech: </p>
<hr />
<div><blockquote style="background: white; border: 1px solid rgb(153, 153, 153); padding: 1em;">This page is meant as a general overview and installation guide for the software. Please see [[R and Calc Documentation]] for more information on functions, scripting, and general usage. Also feel free to submit bug reports in the [[R and Calc: Bugs and Feature Requests]] page.</blockquote><br />
<br />
"R and Calc" is an [[OpenOffice.org]] (OO.o) [[Calc]] add-on that allows you to use [http://www.r-project.org/ R] methods and functions. The software is currently in early development, though a '''basic''' working version does exist, and is available for download.<br />
<br />
We welcome any and all comments and name suggestions. Please send them to [[User:Wojciech|Wojciech Gryc]].<br />
<br />
For those who come here often, here is the latest version:<br />
* '''Version:''' 0.1.9<br />
* '''Release Date:''' September 4, 2007 (4:07 pm EST)<br />
* '''Link:''' http://www.11-55.org/rcalc/2007-09-04_2/RAddon.uno.pkg<br />
* '''Source Code:''' http://www.11-55.org/rcalc/2007-09-04_2/rcalc-0_1_9.zip<br />
* '''Manual:''' http://www.11-55.org/rcalc/2007-09-04_2/manual.pdf<br />
<br />
==Requirements==<br />
<br />
You need the following software to run this add-on. While older versions may suffice, they have not been tested yet.<br />
* OpenOffice.org 2.1<br />
* Java 5.0<br />
* RServe 0.4.7<br />
<br />
==Installing==<br />
<br />
The current version is a prototype and implements only one tool: RDUMP. This method is accessed through the actual Calc menu, and allows you to see the R object structure for various method calls. <br />
<br />
To use the add-on, you need to install R and [http://www.rforge.net/Rserve Rserve]. Instructions for installing R can be found at http://www.r-project.org/ Once installed, run R and type the following to install Rserve. Click "enter" at the end of each bullet point:<br />
<br />
* install.packages("Rserve")<br />
<br />
Rserve needs to be running to work, and can be launched with the following commands... Note that you only need to do this when you want to use the R Add-on for Calc.<br />
<br />
* library(Rserve)<br />
* Rserve()<br />
<br />
Now that you have the prerequisites installed, download the package RAddon.uno.pkg (linked above). Unzip the file, and let's call the directory you unzipped it in <RA_DIR>. Now let <OO_HOME> be your OpenOffice.org installation directory. Open the command prompt or terminal window and go to <OO_HOME>/program/ and type:<br />
<br />
* unopkg add <RA_DIR>/RAddon.uno.pkg<br />
<br />
If this is not your first time installing the add-in, you need to check if a previous version is also on the system. If it is, then you will not be able to install the new version. To do this, go to <OO HOME>/program and type:<br />
<br />
* unopkg list<br />
<br />
This will show you the list of packages already installed, and you should be able to check if the add-is is there. Remember to look for "RAddon.uno.pkg". You can also skip this step and try to uninstall RAddon.uno.pkg regardless -- this will not harm your OpenOffice.org installation in any way, even if RAddon.uno.pkg is abset. To do this, type:<br />
<br />
* unopkg remove RAddon.uno.pkg<br />
<br />
Finally, some operating systems require that you restart your OpenOffice.org installation (if you're not sure, restart your computer) to be able to see the cell functions that come with this package.<br />
<br />
==Using==<br />
<br />
Using the add-on is very simple at this stage. To see the tool at work, open Calc. In the menus, go to R Add-on > Rdump(). A new dialog window will pop up. Type in an R script -- here are some examples:<br />
<br />
* rnorm(10)<br />
* cor.test(c(1,2,3,4), c(1,2,2,3))<br />
<br />
Then click "Run". A new sheet should appear. Close the dialog with "Close" and check the new sheet -- you should see various pieces of information on the sheet.<br />
<br />
==Testing==<br />
<br />
So far, the software has been tested on the following.<br />
<br />
===Version 0.1.7===<br />
<br />
* 64-bit Gentoo Linux running JDK 1.5.0.12 (64-bit version), OpenOffice 2.2.1, and R 2.4.1<br />
<br />
===Version 0.1.6===<br />
<br />
* Ubuntu Feisty Fawn on Java 1.6.0 <br />
<br />
===Version 0.1.5===<br />
<br />
* Fedora Core 7 running native Java<br />
* Ubuntu Edgy Eft running SDK 1.5.0_08 and OpenOffice 2.1.<br />
* Windows XP SP2 running running JDK 1.6.0_02 and OpenOffice 2.2.<br />
<br />
===Version 0.1.0===<br />
<br />
* Fedora Core 6 running JDK 1.6.0_01 and OpenOffice 2.2.<br />
* Ubuntu Edgy Eft running SDK 1.5.0_08 and OpenOffice 2.1.<br />
* Windows XP running running JDK 1.6.0_01 and OpenOffice 2.2.<br />
<br />
==About==<br />
<br />
This add-on is the result of a Google [[Summer of Code 2007]] project. It was initially created by [[User:Wojciech|Wojciech Gryc]]. For information pertaining to the development of this add-on, see [http://www.11-55.org/ooblog/ Wojciech's Blog].<br />
<br />
==Older Versions==<br />
<br />
* '''0.1.8''' [http://www.11-55.org/rcalc/2007-09-04/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-09-04/rcalc-0_1_8.zip Source Code])<br />
* '''0.1.7''' [http://www.11-55.org/rcalc/2007-08-23/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-08-23/rcalc-0_1_7.zip Source Code])<br />
* '''0.1.6''' [http://www.11-55.org/rcalc/2007-08-19/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-08-19/rcalc-0_1_6.zip Source Code])<br />
* '''0.1.5''': [http://www.11-55.org/rcalc/2007-08-16/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-08-16/rcalc-0_1_5.zip Source Code])<br />
* '''0.1.4''': [http://www.11-55.org/rcalc/2007-08-10/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-08-10/rcalc-0_1_4.zip Source Code])<br />
* '''0.1.3''': [http://www.11-55.org/rcalc/2007-08-02/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-08-02/rcalc-0_1_3.zip Source Code])<br />
* '''0.1.2''': [http://www.11-55.org/rcalc/2007-06-01/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-06-01/rcalc-0_1_2.zip Source Code])<br />
* '''0.1.1''': [http://www.11-55.org/rcalc/2007-05-25/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-05-25/rcalc-0_1_1.zip Source Code])<br />
* '''0.1.0''': [http://www.11-55.org/rcalc/2007-05-15/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-05-15/rcalc-0.1.0.zip Source Code])<br />
<br />
[[Category:Calc]]<br />
[[Category: R and Calc]]</div>Wojciechhttps://wiki.openoffice.org/w/index.php?title=R_and_Calc:_Bugs_and_Feature_Requests&diff=44774R and Calc: Bugs and Feature Requests2007-09-04T21:22:26Z<p>Wojciech: </p>
<hr />
<div>This section is meant to keep track of the bugs plaguing the add-on, as well as any features people would like to see in upcoming versions. For now, there are three categories on this page:<br />
* '''Bugs: ''' things that need to be fixed urgently (ideally, in the next release).<br />
* '''Feature Requests: ''' things that need to be added at some point in the future, but are not necessary for the healthy functioning of the software.<br />
* '''Implemented Requests: ''' once anything in the categories above is implemented, it is moved here.<br />
<br />
== Bugs ==<br />
<br />
* As it stands, RCalcCaller can't read values from matrices with equations. This code does not work <code>=RTestConnection()</code> with a value of 0 or 1, it will throw an error if we refer to this in code. For example, try the code below:<br />
:: <code>// First, type =RTestConnection() in cell A1.</code><br />
:: <code>a <- {$A1}</code><br />
:: <code>a*3</code><br />
* RCalcCaller can't accept String inputs from cells.<br />
* Need to implement missing values.<br />
* Passing the following code to RCalcDump causes a NullPointerException:<br />
:: <code>nls(y ~ a*x + b, data = data.frame(cbind(x = c(1.1, 2.1, 3, 3.9), y = c(1, 2, 3, 4))), start=list(a = 1, b = 1))</code><br />
This is likely because the returned R object has embedded REXPs, functions, and environments.<br />
* Passing <code>a<-127</code> to RCalcDump will cause it to print the outputs of the previous statement rather than this one.<br />
* R optional packages must be installed in the default R location... Otherwise they cannot be loaded.<br />
* The add-on needs to be installed manually -- Tools > Extension Manager fails to install properly.<br />
* Very slow in extremely large sets of data (probably due to using TCP/IP to send information).<br />
* RCalcDump does not print matrices and frames properly, but prints columns instead.<br />
* Missing values -- need a good way to deal with missing values. We cannot use a test for non-numeric values because of Factors in R.<br />
<br />
== Feature Requests ==<br />
<br />
* Dynamic array output. As it stands, you need to know the size of the array if you want the RCalcCoder to output properly.<br />
* Need to implement error output -- right now, nothing happens. This applies to RCalcDump and RCalcCaller.<br />
* Make it so the {$BASE} keyword can be replaced with code. Currently, RCalcCaller won't work with<br />
<code>{$OUT#A1}<-var(c(1,2,3,4))</code><br />
But having such code support would be extremely useful.<br />
* Make the actual syntax more intuitive and easier to use.<br />
* The getOutputs() function in the RCalcInterface is very inefficient and should be replaced (''note that this is a fairly substantial coding change'').<br />
* Make the coding window non-modal.<br />
* Allow for saving scripts in spreadsheets.<br />
* Make the "help()" function available through the add-on.<br />
* Communication between data.frames and spreadsheets in Calc.<br />
<br />
== Implemented Requests ==<br />
<br />
* '''Fixed bug:''' The following code doesn't seem to work in the RCalcCoder on Windows XP SP2, R 2.5.1:<br />
:: <code>rnorm(1)</code><br />
:: <code>{$OUT#A1}<-{$BASE}</code><br />
* '''Fixed bug:''' The following code doesn't seem to work in the RCalcCoder on Windows XP SP2, R 2.5.1 (seems to be a one character input line problem):<br />
:: <code>3</code><br />
:: <code>{$OUT#A1}<-{$BASE}</code><br />
* '''Fixed bug:''' The *.txt files used for GUI scripting don't load properly on many computers. May have something to do with using "library", and "require" might be a better option.<br />
* '''Fixed bug:''' Passing the following code causes the RCalcCoder to crash:<br />
:: <code>3+3</code><br />
:: <code>{$OUT#C1}<-{$BASE}</code><br />
<br />
[[Category: R and Calc]]</div>Wojciechhttps://wiki.openoffice.org/w/index.php?title=R_and_Calc:_Bugs_and_Feature_Requests&diff=44773R and Calc: Bugs and Feature Requests2007-09-04T21:19:33Z<p>Wojciech: </p>
<hr />
<div>This section is meant to keep track of the bugs plaguing the add-on, as well as any features people would like to see in upcoming versions. For now, there are three categories on this page:<br />
* '''Bugs: ''' things that need to be fixed urgently (ideally, in the next release).<br />
* '''Feature Requests: ''' things that need to be added at some point in the future, but are not necessary for the healthy functioning of the software.<br />
* '''Implemented Requests: ''' once anything in the categories above is implemented, it is moved here.<br />
<br />
== Bugs ==<br />
<br />
* As it stands, RCalcCaller can't read values from matrices with equations. This code does not work <code>=RTestConnection()</code> with a value of 0 or 1, it will throw an error if we refer to this in code. For example, try the code below:<br />
:: <code>// First, type =RTestConnection() in cell A1.</code><br />
:: <code>a <- {$A1}</code><br />
:: <code>a*3</code><br />
* RCalcCaller can't accept String inputs from cells.<br />
* Need to implement missing values.<br />
* Passing the following code to RCalcDump causes a NullPointerException:<br />
:: <code>nls(y ~ a*x + b, data = data.frame(cbind(x = c(1.1, 2.1, 3, 3.9), y = c(1, 2, 3, 4))), start=list(a = 1, b = 1))</code><br />
This is likely because the returned R object has embedded REXPs, functions, and environments.<br />
* Passing <code>a<-127</code> to RCalcDump will cause it to print the outputs of the previous statement rather than this one.<br />
* Passing the following code causes the RCalcCoder to crash:<br />
:: <code>3+3</code><br />
:: <code>{$OUT#C1}<-{$BASE}</code><br />
* R optional packages must be installed in the default R location... Otherwise they cannot be loaded.<br />
* The add-on needs to be installed manually -- Tools > Extension Manager fails to install properly.<br />
* Very slow in extremely large sets of data (probably due to using TCP/IP to send information).<br />
* RCalcDump does not print matrices and frames properly, but prints columns instead.<br />
* Missing values -- need a good way to deal with missing values. We cannot use a test for non-numeric values because of Factors in R.<br />
<br />
== Feature Requests ==<br />
<br />
* Dynamic array output. As it stands, you need to know the size of the array if you want the RCalcCoder to output properly.<br />
* Need to implement error output -- right now, nothing happens. This applies to RCalcDump and RCalcCaller.<br />
* Make it so the {$BASE} keyword can be replaced with code. Currently, RCalcCaller won't work with<br />
<code>{$OUT#A1}<-var(c(1,2,3,4))</code><br />
But having such code support would be extremely useful.<br />
* Make the actual syntax more intuitive and easier to use.<br />
* The getOutputs() function in the RCalcInterface is very inefficient and should be replaced (''note that this is a fairly substantial coding change'').<br />
* Make the coding window non-modal.<br />
* Allow for saving scripts in spreadsheets.<br />
* Make the "help()" function available through the add-on.<br />
* Communication between data.frames and spreadsheets in Calc.<br />
<br />
== Implemented Requests ==<br />
<br />
* '''Fixed bug:''' The following code doesn't seem to work in the RCalcCoder on Windows XP SP2, R 2.5.1:<br />
:: <code>rnorm(1)</code><br />
:: <code>{$OUT#A1}<-{$BASE}</code><br />
* '''Fixed bug:''' The following code doesn't seem to work in the RCalcCoder on Windows XP SP2, R 2.5.1 (seems to be a one character input line problem):<br />
:: <code>3</code><br />
:: <code>{$OUT#A1}<-{$BASE}</code><br />
* '''Fixed bug:''' The *.txt files used for GUI scripting don't load properly on many computers. May have something to do with using "library", and "require" might be a better option.<br />
<br />
[[Category: R and Calc]]</div>Wojciechhttps://wiki.openoffice.org/w/index.php?title=R_and_Calc&diff=44772R and Calc2007-09-04T21:18:16Z<p>Wojciech: /* Older Versions */</p>
<hr />
<div><blockquote style="background: white; border: 1px solid rgb(153, 153, 153); padding: 1em;">This page is meant as a general overview and installation guide for the software. Please see [[R and Calc Documentation]] for more information on functions, scripting, and general usage. Also feel free to submit bug reports in the [[R and Calc: Bugs and Feature Requests]] page.</blockquote><br />
<br />
"R and Calc" is an [[OpenOffice.org]] (OO.o) [[Calc]] add-on that allows you to use [http://www.r-project.org/ R] methods and functions. The software is currently in early development, though a '''basic''' working version does exist, and is available for download.<br />
<br />
We welcome any and all comments and name suggestions. Please send them to [[User:Wojciech|Wojciech Gryc]].<br />
<br />
For those who come here often, here is the latest version:<br />
* '''Version:''' 0.1.9<br />
* '''Release Date:''' September 4, 2007 (4:07 pm EST)<br />
* '''Link:''' http://www.11-55.org/rcalc/2007-09-04_2/RAddon.uno.pkg<br />
* '''Source Code:''' http://www.11-55.org/rcalc/2007-09-04_2/rcalc-0_1_9.zip<br />
* '''Manual:''' http://www.11-55.org/rcalc/2007-09-04_2/manual.pdf<br />
<br />
==Requirements==<br />
<br />
You need the following software to run this add-on. While older versions may suffice, they have not been tested yet.<br />
* OpenOffice.org 2.1<br />
* Java 5.0<br />
* RServe 0.4.7<br />
<br />
==Installing==<br />
<br />
The current version is a prototype and implements only one tool: RDUMP. This method is accessed through the actual Calc menu, and allows you to see the R object structure for various method calls. <br />
<br />
To use the add-on, you need to install R and [http://www.rforge.net/Rserve Rserve]. Instructions for installing R can be found at http://www.r-project.org/ Once installed, run R and type the following to install Rserve. Click "enter" at the end of each bullet point:<br />
<br />
* install.packages("Rserve")<br />
<br />
Rserve needs to be running to work, and can be launched with the following commands... Note that you only need to do this when you want to use the R Add-on for Calc.<br />
<br />
* library(Rserve)<br />
* Rserve()<br />
<br />
Now that you have the prerequisites installed, download the package RAddon.uno.pkg (linked above). Unzip the file, and let's call the directory you unzipped it in <RA_DIR>. Now let <OO_HOME> be your OpenOffice.org installation directory. Open the command prompt or terminal window and go to <OO_HOME>/program/ and type:<br />
<br />
* unopkg add <RA_DIR>/RAddon.uno.pkg<br />
<br />
If this is not your first time installing the add-in, you need to check if a previous version is also on the system. If it is, then you will not be able to install the new version. To do this, go to <OO HOME>/program and type:<br />
<br />
* unopkg list<br />
<br />
This will show you the list of packages already installed, and you should be able to check if the add-is is there. Remember to look for "RAddon.uno.pkg". You can also skip this step and try to uninstall RAddon.uno.pkg regardless -- this will not harm your OpenOffice.org installation in any way, even if RAddon.uno.pkg is abset. To do this, type:<br />
<br />
* unopkg remove RAddon.uno.pkg<br />
<br />
Finally, some operating systems require that you restart your OpenOffice.org installation (if you're not sure, restart your computer) to be able to see the cell functions that come with this package.<br />
<br />
==Using==<br />
<br />
Using the add-on is very simple at this stage. To see the tool at work, open Calc. In the menus, go to R Add-on > Rdump(). A new dialog window will pop up. Type in an R script -- here are some examples:<br />
<br />
* rnorm(10)<br />
* cor.test(c(1,2,3,4), c(1,2,2,3))<br />
<br />
Then click "Run". A new sheet should appear. Close the dialog with "Close" and check the new sheet -- you should see various pieces of information on the sheet.<br />
<br />
==Testing==<br />
<br />
So far, the software has been tested on the following.<br />
<br />
===Version 0.1.7===<br />
<br />
* 64-bit Gentoo Linux running JDK 1.5.0.12 (64-bit version), OpenOffice 2.2.1, and R 2.4.1<br />
<br />
===Version 0.1.6===<br />
<br />
* Ubuntu Feisty Fawn on Java 1.6.0 <br />
<br />
===Version 0.1.5===<br />
<br />
* Fedora Core 7 running native Java<br />
* Ubuntu Edgy Eft running SDK 1.5.0_08 and OpenOffice 2.1.<br />
* Windows XP SP2 running running JDK 1.6.0_02 and OpenOffice 2.2.<br />
<br />
===Version 0.1.0===<br />
<br />
* Fedora Core 6 running JDK 1.6.0_01 and OpenOffice 2.2.<br />
* Ubuntu Edgy Eft running SDK 1.5.0_08 and OpenOffice 2.1.<br />
* Windows XP running running JDK 1.6.0_01 and OpenOffice 2.2.<br />
<br />
==Known Issues==<br />
<br />
Yes, we already have some known issues! That's OK, these are common issues and are not problematic with regards to the code:<br />
<br />
* '''Issue #1 (<font color="red">Fixed in 0.1.1</font>):''' Strings and characters, when part of the R object model, do not get published in Rdump().<br />
* '''Issue #2:''' RDUMP() does not print matrices and frames properly, but prints columns instead.<br />
* '''Issue #3:''' Missing values -- need a good way to deal with missing values. We cannot use a test for non-numeric values because of Factors in R.<br />
<br />
==About==<br />
<br />
This add-on is the result of a Google [[Summer of Code 2007]] project. It was initially created by [[User:Wojciech|Wojciech Gryc]]. For information pertaining to the development of this add-on, see [http://www.11-55.org/ooblog/ Wojciech's Blog].<br />
<br />
==Older Versions==<br />
<br />
* '''0.1.8''' [http://www.11-55.org/rcalc/2007-09-04/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-09-04/rcalc-0_1_8.zip Source Code])<br />
* '''0.1.7''' [http://www.11-55.org/rcalc/2007-08-23/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-08-23/rcalc-0_1_7.zip Source Code])<br />
* '''0.1.6''' [http://www.11-55.org/rcalc/2007-08-19/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-08-19/rcalc-0_1_6.zip Source Code])<br />
* '''0.1.5''': [http://www.11-55.org/rcalc/2007-08-16/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-08-16/rcalc-0_1_5.zip Source Code])<br />
* '''0.1.4''': [http://www.11-55.org/rcalc/2007-08-10/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-08-10/rcalc-0_1_4.zip Source Code])<br />
* '''0.1.3''': [http://www.11-55.org/rcalc/2007-08-02/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-08-02/rcalc-0_1_3.zip Source Code])<br />
* '''0.1.2''': [http://www.11-55.org/rcalc/2007-06-01/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-06-01/rcalc-0_1_2.zip Source Code])<br />
* '''0.1.1''': [http://www.11-55.org/rcalc/2007-05-25/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-05-25/rcalc-0_1_1.zip Source Code])<br />
* '''0.1.0''': [http://www.11-55.org/rcalc/2007-05-15/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-05-15/rcalc-0.1.0.zip Source Code])<br />
<br />
[[Category:Calc]]<br />
[[Category: R and Calc]]</div>Wojciechhttps://wiki.openoffice.org/w/index.php?title=R_and_Calc&diff=44761R and Calc2007-09-04T20:08:20Z<p>Wojciech: </p>
<hr />
<div><blockquote style="background: white; border: 1px solid rgb(153, 153, 153); padding: 1em;">This page is meant as a general overview and installation guide for the software. Please see [[R and Calc Documentation]] for more information on functions, scripting, and general usage. Also feel free to submit bug reports in the [[R and Calc: Bugs and Feature Requests]] page.</blockquote><br />
<br />
"R and Calc" is an [[OpenOffice.org]] (OO.o) [[Calc]] add-on that allows you to use [http://www.r-project.org/ R] methods and functions. The software is currently in early development, though a '''basic''' working version does exist, and is available for download.<br />
<br />
We welcome any and all comments and name suggestions. Please send them to [[User:Wojciech|Wojciech Gryc]].<br />
<br />
For those who come here often, here is the latest version:<br />
* '''Version:''' 0.1.9<br />
* '''Release Date:''' September 4, 2007 (4:07 pm EST)<br />
* '''Link:''' http://www.11-55.org/rcalc/2007-09-04_2/RAddon.uno.pkg<br />
* '''Source Code:''' http://www.11-55.org/rcalc/2007-09-04_2/rcalc-0_1_9.zip<br />
* '''Manual:''' http://www.11-55.org/rcalc/2007-09-04_2/manual.pdf<br />
<br />
==Requirements==<br />
<br />
You need the following software to run this add-on. While older versions may suffice, they have not been tested yet.<br />
* OpenOffice.org 2.1<br />
* Java 5.0<br />
* RServe 0.4.7<br />
<br />
==Installing==<br />
<br />
The current version is a prototype and implements only one tool: RDUMP. This method is accessed through the actual Calc menu, and allows you to see the R object structure for various method calls. <br />
<br />
To use the add-on, you need to install R and [http://www.rforge.net/Rserve Rserve]. Instructions for installing R can be found at http://www.r-project.org/ Once installed, run R and type the following to install Rserve. Click "enter" at the end of each bullet point:<br />
<br />
* install.packages("Rserve")<br />
<br />
Rserve needs to be running to work, and can be launched with the following commands... Note that you only need to do this when you want to use the R Add-on for Calc.<br />
<br />
* library(Rserve)<br />
* Rserve()<br />
<br />
Now that you have the prerequisites installed, download the package RAddon.uno.pkg (linked above). Unzip the file, and let's call the directory you unzipped it in <RA_DIR>. Now let <OO_HOME> be your OpenOffice.org installation directory. Open the command prompt or terminal window and go to <OO_HOME>/program/ and type:<br />
<br />
* unopkg add <RA_DIR>/RAddon.uno.pkg<br />
<br />
If this is not your first time installing the add-in, you need to check if a previous version is also on the system. If it is, then you will not be able to install the new version. To do this, go to <OO HOME>/program and type:<br />
<br />
* unopkg list<br />
<br />
This will show you the list of packages already installed, and you should be able to check if the add-is is there. Remember to look for "RAddon.uno.pkg". You can also skip this step and try to uninstall RAddon.uno.pkg regardless -- this will not harm your OpenOffice.org installation in any way, even if RAddon.uno.pkg is abset. To do this, type:<br />
<br />
* unopkg remove RAddon.uno.pkg<br />
<br />
Finally, some operating systems require that you restart your OpenOffice.org installation (if you're not sure, restart your computer) to be able to see the cell functions that come with this package.<br />
<br />
==Using==<br />
<br />
Using the add-on is very simple at this stage. To see the tool at work, open Calc. In the menus, go to R Add-on > Rdump(). A new dialog window will pop up. Type in an R script -- here are some examples:<br />
<br />
* rnorm(10)<br />
* cor.test(c(1,2,3,4), c(1,2,2,3))<br />
<br />
Then click "Run". A new sheet should appear. Close the dialog with "Close" and check the new sheet -- you should see various pieces of information on the sheet.<br />
<br />
==Testing==<br />
<br />
So far, the software has been tested on the following.<br />
<br />
===Version 0.1.7===<br />
<br />
* 64-bit Gentoo Linux running JDK 1.5.0.12 (64-bit version), OpenOffice 2.2.1, and R 2.4.1<br />
<br />
===Version 0.1.6===<br />
<br />
* Ubuntu Feisty Fawn on Java 1.6.0 <br />
<br />
===Version 0.1.5===<br />
<br />
* Fedora Core 7 running native Java<br />
* Ubuntu Edgy Eft running SDK 1.5.0_08 and OpenOffice 2.1.<br />
* Windows XP SP2 running running JDK 1.6.0_02 and OpenOffice 2.2.<br />
<br />
===Version 0.1.0===<br />
<br />
* Fedora Core 6 running JDK 1.6.0_01 and OpenOffice 2.2.<br />
* Ubuntu Edgy Eft running SDK 1.5.0_08 and OpenOffice 2.1.<br />
* Windows XP running running JDK 1.6.0_01 and OpenOffice 2.2.<br />
<br />
==Known Issues==<br />
<br />
Yes, we already have some known issues! That's OK, these are common issues and are not problematic with regards to the code:<br />
<br />
* '''Issue #1 (<font color="red">Fixed in 0.1.1</font>):''' Strings and characters, when part of the R object model, do not get published in Rdump().<br />
* '''Issue #2:''' RDUMP() does not print matrices and frames properly, but prints columns instead.<br />
* '''Issue #3:''' Missing values -- need a good way to deal with missing values. We cannot use a test for non-numeric values because of Factors in R.<br />
<br />
==About==<br />
<br />
This add-on is the result of a Google [[Summer of Code 2007]] project. It was initially created by [[User:Wojciech|Wojciech Gryc]]. For information pertaining to the development of this add-on, see [http://www.11-55.org/ooblog/ Wojciech's Blog].<br />
<br />
==Older Versions==<br />
<br />
* '''0.1.8''' [http://www.11-55.org/rcalc/2007-09-04/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-09-04/rcalc-0_1_8.zip Source Code])<br />
* '''0.1.7''' [http://www.11-55.org/rcalc/2007-08-23/RAddon.uno.pkg UNO Package]<br />
([http://www.11-55.org/rcalc/2007-08-23/rcalc-0_1_7.zip Source Code])<br />
* '''0.1.6''' [http://www.11-55.org/rcalc/2007-08-19/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-08-19/rcalc-0_1_6.zip Source Code])<br />
* '''0.1.5''': [http://www.11-55.org/rcalc/2007-08-16/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-08-16/rcalc-0_1_5.zip Source Code])<br />
* '''0.1.4''': [http://www.11-55.org/rcalc/2007-08-10/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-08-10/rcalc-0_1_4.zip Source Code])<br />
* '''0.1.3''': [http://www.11-55.org/rcalc/2007-08-02/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-08-02/rcalc-0_1_3.zip Source Code])<br />
* '''0.1.2''': [http://www.11-55.org/rcalc/2007-06-01/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-06-01/rcalc-0_1_2.zip Source Code])<br />
* '''0.1.1''': [http://www.11-55.org/rcalc/2007-05-25/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-05-25/rcalc-0_1_1.zip Source Code])<br />
* '''0.1.0''': [http://www.11-55.org/rcalc/2007-05-15/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-05-15/rcalc-0.1.0.zip Source Code])<br />
<br />
[[Category:Calc]]<br />
[[Category: R and Calc]]</div>Wojciechhttps://wiki.openoffice.org/w/index.php?title=R_and_Calc&diff=44493R and Calc2007-09-04T05:13:05Z<p>Wojciech: </p>
<hr />
<div><blockquote style="background: white; border: 1px solid rgb(153, 153, 153); padding: 1em;">This page is meant as a general overview and installation guide for the software. Please see [[R and Calc Documentation]] for more information on functions, scripting, and general usage. Also feel free to submit bug reports in the [[R and Calc: Bugs and Feature Requests]] page.</blockquote><br />
<br />
"R and Calc" is an [[OpenOffice.org]] (OO.o) [[Calc]] add-on that allows you to use [http://www.r-project.org/ R] methods and functions. The software is currently in early development, though a '''basic''' working version does exist, and is available for download.<br />
<br />
We welcome any and all comments and name suggestions. Please send them to [[User:Wojciech|Wojciech Gryc]].<br />
<br />
For those who come here often, here is the latest version:<br />
* '''Version:''' 0.1.8<br />
* '''Release Date:''' September 4, 2007 (1:12 am EST)<br />
* '''Link:''' http://www.11-55.org/rcalc/2007-09-04/RAddon.uno.pkg<br />
* '''Source Code:''' http://www.11-55.org/rcalc/2007-09-04/rcalc-0_1_8.zip<br />
* '''Manual:''' http://www.11-55.org/rcalc/2007-09-04/manual.pdf<br />
<br />
==Requirements==<br />
<br />
You need the following software to run this add-on. While older versions may suffice, they have not been tested yet.<br />
* OpenOffice.org 2.1<br />
* Java 5.0<br />
* RServe 0.4.7<br />
<br />
==Installing==<br />
<br />
The current version is a prototype and implements only one tool: RDUMP. This method is accessed through the actual Calc menu, and allows you to see the R object structure for various method calls. <br />
<br />
To use the add-on, you need to install R and [http://www.rforge.net/Rserve Rserve]. Instructions for installing R can be found at http://www.r-project.org/ Once installed, run R and type the following to install Rserve. Click "enter" at the end of each bullet point:<br />
<br />
* install.packages("Rserve")<br />
<br />
Rserve needs to be running to work, and can be launched with the following commands... Note that you only need to do this when you want to use the R Add-on for Calc.<br />
<br />
* library(Rserve)<br />
* Rserve()<br />
<br />
Now that you have the prerequisites installed, download the package RAddon.uno.pkg (linked above). Unzip the file, and let's call the directory you unzipped it in <RA_DIR>. Now let <OO_HOME> be your OpenOffice.org installation directory. Open the command prompt or terminal window and go to <OO_HOME>/program/ and type:<br />
<br />
* unopkg add <RA_DIR>/RAddon.uno.pkg<br />
<br />
If this is not your first time installing the add-in, you need to check if a previous version is also on the system. If it is, then you will not be able to install the new version. To do this, go to <OO HOME>/program and type:<br />
<br />
* unopkg list<br />
<br />
This will show you the list of packages already installed, and you should be able to check if the add-is is there. Remember to look for "RAddon.uno.pkg". You can also skip this step and try to uninstall RAddon.uno.pkg regardless -- this will not harm your OpenOffice.org installation in any way, even if RAddon.uno.pkg is abset. To do this, type:<br />
<br />
* unopkg remove RAddon.uno.pkg<br />
<br />
Finally, some operating systems require that you restart your OpenOffice.org installation (if you're not sure, restart your computer) to be able to see the cell functions that come with this package.<br />
<br />
==Using==<br />
<br />
Using the add-on is very simple at this stage. To see the tool at work, open Calc. In the menus, go to R Add-on > Rdump(). A new dialog window will pop up. Type in an R script -- here are some examples:<br />
<br />
* rnorm(10)<br />
* cor.test(c(1,2,3,4), c(1,2,2,3))<br />
<br />
Then click "Run". A new sheet should appear. Close the dialog with "Close" and check the new sheet -- you should see various pieces of information on the sheet.<br />
<br />
==Testing==<br />
<br />
So far, the software has been tested on the following.<br />
<br />
===Version 0.1.7===<br />
<br />
* 64-bit Gentoo Linux running JDK 1.5.0.12 (64-bit version), OpenOffice 2.2.1, and R 2.4.1<br />
<br />
===Version 0.1.6===<br />
<br />
* Ubuntu Feisty Fawn on Java 1.6.0 <br />
<br />
===Version 0.1.5===<br />
<br />
* Fedora Core 7 running native Java<br />
* Ubuntu Edgy Eft running SDK 1.5.0_08 and OpenOffice 2.1.<br />
* Windows XP SP2 running running JDK 1.6.0_02 and OpenOffice 2.2.<br />
<br />
===Version 0.1.0===<br />
<br />
* Fedora Core 6 running JDK 1.6.0_01 and OpenOffice 2.2.<br />
* Ubuntu Edgy Eft running SDK 1.5.0_08 and OpenOffice 2.1.<br />
* Windows XP running running JDK 1.6.0_01 and OpenOffice 2.2.<br />
<br />
==Known Issues==<br />
<br />
Yes, we already have some known issues! That's OK, these are common issues and are not problematic with regards to the code:<br />
<br />
* '''Issue #1 (<font color="red">Fixed in 0.1.1</font>):''' Strings and characters, when part of the R object model, do not get published in Rdump().<br />
* '''Issue #2:''' RDUMP() does not print matrices and frames properly, but prints columns instead.<br />
* '''Issue #3:''' Missing values -- need a good way to deal with missing values. We cannot use a test for non-numeric values because of Factors in R.<br />
<br />
==About==<br />
<br />
This add-on is the result of a Google [[Summer of Code 2007]] project. It was initially created by [[User:Wojciech|Wojciech Gryc]]. For information pertaining to the development of this add-on, see [http://www.11-55.org/ooblog/ Wojciech's Blog].<br />
<br />
==Older Versions==<br />
<br />
* '''0.1.7''' [http://www.11-55.org/rcalc/2007-08-23/RAddon.uno.pkg UNO Package]<br />
([http://www.11-55.org/rcalc/2007-08-23/rcalc-0_1_7.zip Source Code])<br />
* '''0.1.6''' [http://www.11-55.org/rcalc/2007-08-19/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-08-19/rcalc-0_1_6.zip Source Code])<br />
* '''0.1.5''': [http://www.11-55.org/rcalc/2007-08-16/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-08-16/rcalc-0_1_5.zip Source Code])<br />
* '''0.1.4''': [http://www.11-55.org/rcalc/2007-08-10/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-08-10/rcalc-0_1_4.zip Source Code])<br />
* '''0.1.3''': [http://www.11-55.org/rcalc/2007-08-02/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-08-02/rcalc-0_1_3.zip Source Code])<br />
* '''0.1.2''': [http://www.11-55.org/rcalc/2007-06-01/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-06-01/rcalc-0_1_2.zip Source Code])<br />
* '''0.1.1''': [http://www.11-55.org/rcalc/2007-05-25/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-05-25/rcalc-0_1_1.zip Source Code])<br />
* '''0.1.0''': [http://www.11-55.org/rcalc/2007-05-15/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-05-15/rcalc-0.1.0.zip Source Code])<br />
<br />
[[Category:Calc]]<br />
[[Category: R and Calc]]</div>Wojciechhttps://wiki.openoffice.org/w/index.php?title=R_and_Calc&diff=44492R and Calc2007-09-04T05:12:45Z<p>Wojciech: </p>
<hr />
<div><blockquote style="background: white; border: 1px solid rgb(153, 153, 153); padding: 1em;">This page is meant as a general overview and installation guide for the software. Please see [[R and Calc Documentation]] for more information on functions, scripting, and general usage. Also feel free to submit bug reports in the [[R and Calc: Bugs and Feature Requests]] page.</blockquote><br />
<br />
"R and Calc" is an [[OpenOffice.org]] (OO.o) [[Calc]] add-on that allows you to use [http://www.r-project.org/ R] methods and functions. The software is currently in early development, though a '''basic''' working version does exist, and is available for download.<br />
<br />
We welcome any and all comments and name suggestions. Please send them to [[User:Wojciech|Wojciech Gryc]].<br />
<br />
For those who come here often, here is the latest version:<br />
* '''Version:''' 0.1.8<br />
* '''Release Date:''' September 4, 2007 (1:12 am EST)<br />
* '''Link:''' http://www.11-55.org/rcalc/2007-09-04/RAddon.uno.pkg<br />
* '''Source Code:''' http://www.11-55.org/rcalc/2007-09-04/rcalc-0_1_7.zip<br />
* '''Manual:''' http://www.11-55.org/rcalc/2007-09-04/manual.pdf<br />
<br />
==Requirements==<br />
<br />
You need the following software to run this add-on. While older versions may suffice, they have not been tested yet.<br />
* OpenOffice.org 2.1<br />
* Java 5.0<br />
* RServe 0.4.7<br />
<br />
==Installing==<br />
<br />
The current version is a prototype and implements only one tool: RDUMP. This method is accessed through the actual Calc menu, and allows you to see the R object structure for various method calls. <br />
<br />
To use the add-on, you need to install R and [http://www.rforge.net/Rserve Rserve]. Instructions for installing R can be found at http://www.r-project.org/ Once installed, run R and type the following to install Rserve. Click "enter" at the end of each bullet point:<br />
<br />
* install.packages("Rserve")<br />
<br />
Rserve needs to be running to work, and can be launched with the following commands... Note that you only need to do this when you want to use the R Add-on for Calc.<br />
<br />
* library(Rserve)<br />
* Rserve()<br />
<br />
Now that you have the prerequisites installed, download the package RAddon.uno.pkg (linked above). Unzip the file, and let's call the directory you unzipped it in <RA_DIR>. Now let <OO_HOME> be your OpenOffice.org installation directory. Open the command prompt or terminal window and go to <OO_HOME>/program/ and type:<br />
<br />
* unopkg add <RA_DIR>/RAddon.uno.pkg<br />
<br />
If this is not your first time installing the add-in, you need to check if a previous version is also on the system. If it is, then you will not be able to install the new version. To do this, go to <OO HOME>/program and type:<br />
<br />
* unopkg list<br />
<br />
This will show you the list of packages already installed, and you should be able to check if the add-is is there. Remember to look for "RAddon.uno.pkg". You can also skip this step and try to uninstall RAddon.uno.pkg regardless -- this will not harm your OpenOffice.org installation in any way, even if RAddon.uno.pkg is abset. To do this, type:<br />
<br />
* unopkg remove RAddon.uno.pkg<br />
<br />
Finally, some operating systems require that you restart your OpenOffice.org installation (if you're not sure, restart your computer) to be able to see the cell functions that come with this package.<br />
<br />
==Using==<br />
<br />
Using the add-on is very simple at this stage. To see the tool at work, open Calc. In the menus, go to R Add-on > Rdump(). A new dialog window will pop up. Type in an R script -- here are some examples:<br />
<br />
* rnorm(10)<br />
* cor.test(c(1,2,3,4), c(1,2,2,3))<br />
<br />
Then click "Run". A new sheet should appear. Close the dialog with "Close" and check the new sheet -- you should see various pieces of information on the sheet.<br />
<br />
==Testing==<br />
<br />
So far, the software has been tested on the following.<br />
<br />
===Version 0.1.7===<br />
<br />
* 64-bit Gentoo Linux running JDK 1.5.0.12 (64-bit version), OpenOffice 2.2.1, and R 2.4.1<br />
<br />
===Version 0.1.6===<br />
<br />
* Ubuntu Feisty Fawn on Java 1.6.0 <br />
<br />
===Version 0.1.5===<br />
<br />
* Fedora Core 7 running native Java<br />
* Ubuntu Edgy Eft running SDK 1.5.0_08 and OpenOffice 2.1.<br />
* Windows XP SP2 running running JDK 1.6.0_02 and OpenOffice 2.2.<br />
<br />
===Version 0.1.0===<br />
<br />
* Fedora Core 6 running JDK 1.6.0_01 and OpenOffice 2.2.<br />
* Ubuntu Edgy Eft running SDK 1.5.0_08 and OpenOffice 2.1.<br />
* Windows XP running running JDK 1.6.0_01 and OpenOffice 2.2.<br />
<br />
==Known Issues==<br />
<br />
Yes, we already have some known issues! That's OK, these are common issues and are not problematic with regards to the code:<br />
<br />
* '''Issue #1 (<font color="red">Fixed in 0.1.1</font>):''' Strings and characters, when part of the R object model, do not get published in Rdump().<br />
* '''Issue #2:''' RDUMP() does not print matrices and frames properly, but prints columns instead.<br />
* '''Issue #3:''' Missing values -- need a good way to deal with missing values. We cannot use a test for non-numeric values because of Factors in R.<br />
<br />
==About==<br />
<br />
This add-on is the result of a Google [[Summer of Code 2007]] project. It was initially created by [[User:Wojciech|Wojciech Gryc]]. For information pertaining to the development of this add-on, see [http://www.11-55.org/ooblog/ Wojciech's Blog].<br />
<br />
==Older Versions==<br />
<br />
* '''0.1.7''' [http://www.11-55.org/rcalc/2007-08-23/RAddon.uno.pkg UNO Package]<br />
([http://www.11-55.org/rcalc/2007-08-23/rcalc-0_1_7.zip Source Code])<br />
* '''0.1.6''' [http://www.11-55.org/rcalc/2007-08-19/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-08-19/rcalc-0_1_6.zip Source Code])<br />
* '''0.1.5''': [http://www.11-55.org/rcalc/2007-08-16/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-08-16/rcalc-0_1_5.zip Source Code])<br />
* '''0.1.4''': [http://www.11-55.org/rcalc/2007-08-10/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-08-10/rcalc-0_1_4.zip Source Code])<br />
* '''0.1.3''': [http://www.11-55.org/rcalc/2007-08-02/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-08-02/rcalc-0_1_3.zip Source Code])<br />
* '''0.1.2''': [http://www.11-55.org/rcalc/2007-06-01/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-06-01/rcalc-0_1_2.zip Source Code])<br />
* '''0.1.1''': [http://www.11-55.org/rcalc/2007-05-25/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-05-25/rcalc-0_1_1.zip Source Code])<br />
* '''0.1.0''': [http://www.11-55.org/rcalc/2007-05-15/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-05-15/rcalc-0.1.0.zip Source Code])<br />
<br />
[[Category:Calc]]<br />
[[Category: R and Calc]]</div>Wojciechhttps://wiki.openoffice.org/w/index.php?title=R_and_Calc:_Bugs_and_Feature_Requests&diff=44442R and Calc: Bugs and Feature Requests2007-09-04T02:49:56Z<p>Wojciech: </p>
<hr />
<div>This section is meant to keep track of the bugs plaguing the add-on, as well as any features people would like to see in upcoming versions. For now, there are three categories on this page:<br />
* '''Bugs: ''' things that need to be fixed urgently (ideally, in the next release).<br />
* '''Feature Requests: ''' things that need to be added at some point in the future, but are not necessary for the healthy functioning of the software.<br />
* '''Implemented Requests: ''' once anything in the categories above is implemented, it is moved here.<br />
<br />
== Bugs ==<br />
<br />
* As it stands, RCalcCaller can't read values from matrices with equations. This code does not work <code>=RTestConnection()</code> with a value of 0 or 1, it will throw an error if we refer to this in code. For example, try the code below:<br />
:: <code>// First, type =RTestConnection() in cell A1.</code><br />
:: <code>a <- {$A1}</code><br />
:: <code>a*3</code><br />
* RCalcCaller can't accept String inputs from cells.<br />
* Need to implement missing values.<br />
* Passing the following code to RCalcDump causes a NullPointerException:<br />
:: <code>nls(y ~ a*x + b, data = data.frame(cbind(x = c(1.1, 2.1, 3, 3.9), y = c(1, 2, 3, 4))), start=list(a = 1, b = 1))</code><br />
This is likely because the returned R object has embedded REXPs, functions, and environments.<br />
* Passing <code>a<-127</code> to RCalcDump will cause it to print the outputs of the previous statement rather than this one.<br />
* Passing the following code causes the RCalcCoder to crash:<br />
:: <code>3+3</code><br />
:: <code>{$OUT#C1}<-{$BASE}</code><br />
* R optional packages must be installed in the default R location... Otherwise they cannot be loaded.<br />
* The add-on needs to be installed manually -- Tools > Extension Manager fails to install properly.<br />
* Very slow in extremely large sets of data (probably due to using TCP/IP to send information).<br />
* RCalcDump does not print matrices and frames properly, but prints columns instead.<br />
* Missing values -- need a good way to deal with missing values. We cannot use a test for non-numeric values because of Factors in R.<br />
* The *.txt files used for GUI scripting don't load properly on many computers. May have something to do with using "library", and "require" might be a better option.<br />
<br />
== Feature Requests ==<br />
<br />
* Dynamic array output. As it stands, you need to know the size of the array if you want the RCalcCoder to output properly.<br />
* Need to implement error output -- right now, nothing happens. This applies to RCalcDump and RCalcCaller.<br />
* Make it so the {$BASE} keyword can be replaced with code. Currently, RCalcCaller won't work with<br />
<code>{$OUT#A1}<-var(c(1,2,3,4))</code><br />
But having such code support would be extremely useful.<br />
* Make the actual syntax more intuitive and easier to use.<br />
* The getOutputs() function in the RCalcInterface is very inefficient and should be replaced (''note that this is a fairly substantial coding change'').<br />
* Make the coding window non-modal.<br />
* Allow for saving scripts in spreadsheets.<br />
* Make the "help()" function available through the add-on.<br />
* Communication between data.frames and spreadsheets in Calc.<br />
<br />
== Implemented Requests ==<br />
<br />
* '''Fixed bug:''' The following code doesn't seem to work in the RCalcCoder on Windows XP SP2, R 2.5.1:<br />
:: <code>rnorm(1)</code><br />
:: <code>{$OUT#A1}<-{$BASE}</code><br />
* '''Fixed bug:''' The following code doesn't seem to work in the RCalcCoder on Windows XP SP2, R 2.5.1 (seems to be a one character input line problem):<br />
:: <code>3</code><br />
:: <code>{$OUT#A1}<-{$BASE}</code><br />
<br />
[[Category: R and Calc]]</div>Wojciechhttps://wiki.openoffice.org/w/index.php?title=R_and_Calc:_Bugs_and_Feature_Requests&diff=44347R and Calc: Bugs and Feature Requests2007-09-03T15:48:05Z<p>Wojciech: </p>
<hr />
<div>This section is meant to keep track of the bugs plaguing the add-on, as well as any features people would like to see in upcoming versions. For now, there are three categories on this page:<br />
* '''Bugs: ''' things that need to be fixed urgently (ideally, in the next release).<br />
* '''Feature Requests: ''' things that need to be added at some point in the future, but are not necessary for the healthy functioning of the software.<br />
* '''Implemented Requests: ''' once anything in the categories above is implemented, it is moved here.<br />
<br />
== Bugs ==<br />
<br />
* As it stands, RCalcCaller can't read values from matrices with equations. This code does not work <code>=RTestConnection()</code> with a value of 0 or 1, it will throw an error if we refer to this in code. For example, try the code below:<br />
:: <code>// First, type =RTestConnection() in cell A1.</code><br />
:: <code>a <- {$A1}</code><br />
:: <code>a*3</code><br />
* RCalcCaller can't accept String inputs from cells.<br />
* Need to implement missing values.<br />
* The following code doesn't seem to work in the RCalcCoder on Windows XP SP2, R 2.5.1 (seems to be a one character input line problem):<br />
:: <code>3</code><br />
:: <code>{$OUT#A1}<-{$BASE}</code><br />
* Passing the following code to RCalcDump causes a NullPointerException:<br />
:: <code>nls(y ~ a*x + b, data = data.frame(cbind(x = c(1.1, 2.1, 3, 3.9), y = c(1, 2, 3, 4))), start=list(a = 1, b = 1))</code><br />
This is likely because the returned R object has embedded REXPs, functions, and environments.<br />
* Passing <code>a<-127</code> to RCalcDump will cause it to print the outputs of the previous statement rather than this one.<br />
* Passing the following code causes the RCalcCoder to crash:<br />
:: <code>3+3</code><br />
:: <code>{$OUT#C1}<-{$BASE}</code><br />
* R optional packages must be installed in the default R location... Otherwise they cannot be loaded.<br />
* The add-on needs to be installed manually -- Tools > Extension Manager fails to install properly.<br />
* Very slow in extremely large sets of data (probably due to using TCP/IP to send information).<br />
* RCalcDump does not print matrices and frames properly, but prints columns instead.<br />
* Missing values -- need a good way to deal with missing values. We cannot use a test for non-numeric values because of Factors in R.<br />
* The *.txt files used for GUI scripting don't load properly on many computers. May have something to do with using "library", and "require" might be a better option.<br />
<br />
== Feature Requests ==<br />
<br />
* Dynamic array output. As it stands, you need to know the size of the array if you want the RCalcCoder to output properly.<br />
* Need to implement error output -- right now, nothing happens. This applies to RCalcDump and RCalcCaller.<br />
* Make it so the {$BASE} keyword can be replaced with code. Currently, RCalcCaller won't work with<br />
<code>{$OUT#A1}<-var(c(1,2,3,4))</code><br />
But having such code support would be extremely useful.<br />
* Make the actual syntax more intuitive and easier to use.<br />
* The getOutputs() function in the RCalcInterface is very inefficient and should be replaced (''note that this is a fairly substantial coding change'').<br />
* Make the coding window non-modal.<br />
* Allow for saving scripts in spreadsheets.<br />
* Make the "help()" function available through the add-on.<br />
* Communication between data.frames and spreadsheets in Calc.<br />
<br />
== Implemented Requests ==<br />
<br />
* '''Fixed bug:''' The following code doesn't seem to work in the RCalcCoder on Windows XP SP2, R 2.5.1:<br />
:: <code>rnorm(1)</code><br />
:: <code>{$OUT#A1}<-{$BASE}</code><br />
<br />
[[Category: R and Calc]]</div>Wojciechhttps://wiki.openoffice.org/w/index.php?title=R_and_Calc:_Bugs_and_Feature_Requests&diff=44237R and Calc: Bugs and Feature Requests2007-09-03T05:12:29Z<p>Wojciech: </p>
<hr />
<div>This section is meant to keep track of the bugs plaguing the add-on, as well as any features people would like to see in upcoming versions. For now, there are three categories on this page:<br />
* '''Bugs: ''' things that need to be fixed urgently (ideally, in the next release).<br />
* '''Feature Requests: ''' things that need to be added at some point in the future, but are not necessary for the healthy functioning of the software.<br />
* '''Implemented Requests: ''' once anything in the categories above is implemented, it is moved here.<br />
<br />
== Bugs ==<br />
<br />
* As it stands, RCalcCaller can't read values from matrices with equations. This code does not work <code>=RTestConnection()</code> with a value of 0 or 1, it will throw an error if we refer to this in code. For example, try the code below:<br />
:: <code>// First, type =RTestConnection() in cell A1.</code><br />
:: <code>a <- {$A1}</code><br />
:: <code>a*3</code><br />
* RCalcCaller can't accept String inputs from cells.<br />
* Need to implement missing values.<br />
* The following code doesn't seem to work in the RCalcCoder on Windows XP SP2, R 2.5.1:<br />
:: <code>rnorm(1)</code><br />
:: <code>{$OUT#A1}<-{$BASE}</code><br />
* Passing the following code to RCalcDump causes a NullPointerException:<br />
:: <code>nls(y ~ a*x + b, data = data.frame(cbind(x = c(1.1, 2.1, 3, 3.9), y = c(1, 2, 3, 4))), start=list(a = 1, b = 1))</code><br />
This is likely because the returned R object has embedded REXPs, functions, and environments.<br />
* Passing <code>a<-127</code> to RCalcDump will cause it to print the outputs of the previous statement rather than this one.<br />
* Passing the following code causes the RCalcCoder to crash:<br />
:: <code>3+3</code><br />
:: <code>{$OUT#C1}<-{$BASE}</code><br />
* R optional packages must be installed in the default R location... Otherwise they cannot be loaded.<br />
* The add-on needs to be installed manually -- Tools > Extension Manager fails to install properly.<br />
* Very slow in extremely large sets of data (probably due to using TCP/IP to send information).<br />
* RCalcDump does not print matrices and frames properly, but prints columns instead.<br />
* Missing values -- need a good way to deal with missing values. We cannot use a test for non-numeric values because of Factors in R.<br />
* The *.txt files used for GUI scripting don't load properly on many computers. May have something to do with using "library", and "require" might be a better option.<br />
<br />
== Feature Requests ==<br />
<br />
* Dynamic array output. As it stands, you need to know the size of the array if you want the RCalcCoder to output properly.<br />
* Need to implement error output -- right now, nothing happens. This applies to RCalcDump and RCalcCaller.<br />
* Make it so the {$BASE} keyword can be replaced with code. Currently, RCalcCaller won't work with<br />
<code>{$OUT#A1}<-var(c(1,2,3,4))</code><br />
But having such code support would be extremely useful.<br />
* Make the actual syntax more intuitive and easier to use.<br />
* The getOutputs() function in the RCalcInterface is very inefficient and should be replaced (''note that this is a fairly substantial coding change'').<br />
* Make the coding window non-modal.<br />
* Allow for saving scripts in spreadsheets.<br />
* Make the "help()" function available through the add-on.<br />
* Communication between data.frames and spreadsheets in Calc.<br />
<br />
== Implemented Requests ==<br />
<br />
''None yet, this list was just put up.'' :)<br />
<br />
[[Category: R and Calc]]</div>Wojciechhttps://wiki.openoffice.org/w/index.php?title=R_and_Calc:_Bugs_and_Feature_Requests&diff=44236R and Calc: Bugs and Feature Requests2007-09-02T20:48:51Z<p>Wojciech: </p>
<hr />
<div>This section is meant to keep track of the bugs plaguing the add-on, as well as any features people would like to see in upcoming versions. For now, there are three categories on this page:<br />
* '''Bugs: ''' things that need to be fixed urgently (ideally, in the next release).<br />
* '''Feature Requests: ''' things that need to be added at some point in the future, but are not necessary for the healthy functioning of the software.<br />
* '''Implemented Requests: ''' once anything in the categories above is implemented, it is moved here.<br />
<br />
== Bugs ==<br />
<br />
* As it stands, RCalcCaller can't read values from matrices with equations. This code does not work <code>=RTestConnection()</code> with a value of 0 or 1, it will throw an error if we refer to this in code. For example, try the code below:<br />
:: <code>// First, type =RTestConnection() in cell A1.</code><br />
:: <code>a <- {$A1}</code><br />
:: <code>a*3</code><br />
* RCalcCaller can't accept String inputs from cells.<br />
* Need to implement missing values.<br />
* The following code doesn't seem to work in the RCalcCoder on Windows XP SP2, R 2.5.1:<br />
:: <code>rnorm(1)</code><br />
:: <code>{$OUT#A1}<-{$BASE}</code><br />
* Passing the following code to RCalcDump causes a NullPointerException:<br />
:: <code>nls(y ~ a*x + b, data = data.frame(cbind(x = c(1.1, 2.1, 3, 3.9), y = c(1, 2, 3, 4))), start=list(a = 1, b = 1))</code><br />
This is likely because the returned R object has embedded REXPs, functions, and environments.<br />
* Passing <code>a<-127</code> to RCalcDump will cause it to print the outputs of the previous statement rather than this one.<br />
* Passing the following code causes the RCalcCoder to crash:<br />
:: <code>3+3</code><br />
:: <code>{$OUT#C1}<-{$BASE}</code><br />
* R optional packages must be installed in the default R location... Otherwise they cannot be loaded.<br />
* The add-on needs to be installed manually -- Tools > Extension Manager fails to install properly.<br />
* Very slow in extremely large sets of data (probably due to using TCP/IP to send information).<br />
* RCalcDump does not print matrices and frames properly, but prints columns instead.<br />
* Missing values -- need a good way to deal with missing values. We cannot use a test for non-numeric values because of Factors in R.<br />
<br />
== Feature Requests ==<br />
<br />
* Dynamic array output. As it stands, you need to know the size of the array if you want the RCalcCoder to output properly.<br />
* Need to implement error output -- right now, nothing happens. This applies to RCalcDump and RCalcCaller.<br />
* Make it so the {$BASE} keyword can be replaced with code. Currently, RCalcCaller won't work with<br />
<code>{$OUT#A1}<-var(c(1,2,3,4))</code><br />
But having such code support would be extremely useful.<br />
* Make the actual syntax more intuitive and easier to use.<br />
* The getOutputs() function in the RCalcInterface is very inefficient and should be replaced (''note that this is a fairly substantial coding change'').<br />
* Make the coding window non-modal.<br />
* Allow for saving scripts in spreadsheets.<br />
* Make the "help()" function available through the add-on.<br />
<br />
== Implemented Requests ==<br />
<br />
''None yet, this list was just put up.'' :)<br />
<br />
[[Category: R and Calc]]</div>Wojciechhttps://wiki.openoffice.org/w/index.php?title=R_and_Calc:_Bugs_and_Feature_Requests&diff=43826R and Calc: Bugs and Feature Requests2007-08-29T20:30:48Z<p>Wojciech: /* Bugs */</p>
<hr />
<div>This section is meant to keep track of the bugs plaguing the add-on, as well as any features people would like to see in upcoming versions. For now, there are three categories on this page:<br />
* '''Bugs: ''' things that need to be fixed urgently (ideally, in the next release).<br />
* '''Feature Requests: ''' things that need to be added at some point in the future, but are not necessary for the healthy functioning of the software.<br />
* '''Implemented Requests: ''' once anything in the categories above is implemented, it is moved here.<br />
<br />
== Bugs ==<br />
<br />
* As it stands, RCalcCaller can't read values from matrices with equations. This code does not work <code>=RTestConnection()</code> with a value of 0 or 1, it will throw an error if we refer to this in code. For example, try the code below:<br />
:: <code>// First, type =RTestConnection() in cell A1.</code><br />
:: <code>a <- {$A1}</code><br />
:: <code>a*3</code><br />
* RCalcCaller can't accept String inputs from cells.<br />
* Need to implement missing values.<br />
* The following code doesn't seem to work in the RCalcCoder on Windows XP SP2, R 2.5.1:<br />
:: <code>rnorm(1)</code><br />
:: <code>{$OUT#A1}<-{$BASE}</code><br />
* Passing the following code to RCalcDump causes a NullPointerException:<br />
:: <code>nls(y ~ a*x + b, data = data.frame(cbind(x = c(1.1, 2.1, 3, 3.9), y = c(1, 2, 3, 4))), start=list(a = 1, b = 1))</code><br />
This is likely because the returned R object has embedded REXPs, functions, and environments.<br />
* Passing <code>a<-127</code> to RCalcDump will cause it to print the outputs of the previous statement rather than this one.<br />
* Passing the following code causes the RCalcCoder to crash:<br />
:: <code>3+3</code><br />
:: <code>{$OUT#C1}<-{$BASE}</code><br />
* R optional packages must be installed in the default R location... Otherwise they cannot be loaded.<br />
* The add-on needs to be installed manually -- Tools > Extension Manager fails to install properly.<br />
* Very slow in extremely large sets of data (probably due to using TCP/IP to send information).<br />
* RCalcDump does not print matrices and frames properly, but prints columns instead.<br />
* Missing values -- need a good way to deal with missing values. We cannot use a test for non-numeric values because of Factors in R.<br />
<br />
== Feature Requests ==<br />
<br />
* Dynamic array output. As it stands, you need to know the size of the array if you want the RCalcCoder to output properly.<br />
* Need to implement error output -- right now, nothing happens. This applies to RCalcDump and RCalcCaller.<br />
* Make it so the {$BASE} keyword can be replaced with code. Currently, RCalcCaller won't work with<br />
<code>{$OUT#A1}<-var(c(1,2,3,4))</code><br />
But having such code support would be extremely useful.<br />
* Make the actual syntax more intuitive and easier to use.<br />
* The getOutputs() function in the RCalcInterface is very inefficient and should be replaced (''note that this is a fairly substantial coding change'').<br />
<br />
== Implemented Requests ==<br />
<br />
''None yet, this list was just put up.'' :)<br />
<br />
[[Category: R and Calc]]</div>Wojciechhttps://wiki.openoffice.org/w/index.php?title=R_and_Calc&diff=43825R and Calc2007-08-29T20:29:46Z<p>Wojciech: /* Testing */</p>
<hr />
<div><blockquote style="background: white; border: 1px solid rgb(153, 153, 153); padding: 1em;">This page is meant as a general overview and installation guide for the software. Please see [[R and Calc Documentation]] for more information on functions, scripting, and general usage. Also feel free to submit bug reports in the [[R and Calc: Bugs and Feature Requests]] page.</blockquote><br />
<br />
"R and Calc" is an [[OpenOffice.org]] (OO.o) [[Calc]] add-on that allows you to use [http://www.r-project.org/ R] methods and functions. The software is currently in early development, though a '''basic''' working version does exist, and is available for download.<br />
<br />
We welcome any and all comments and name suggestions. Please send them to [[User:Wojciech|Wojciech Gryc]].<br />
<br />
For those who come here often, here is the latest version:<br />
* '''Version:''' 0.1.7<br />
* '''Release Date:''' August 23, 2007 (10:39 pm EST)<br />
* '''Link:''' http://www.11-55.org/rcalc/2007-08-23/RAddon.uno.pkg<br />
* '''Source Code:''' http://www.11-55.org/rcalc/2007-08-23/rcalc-0_1_7.zip<br />
* '''Manual:''' http://www.11-55.org/rcalc/2007-08-23/manual.pdf<br />
<br />
==Requirements==<br />
<br />
You need the following software to run this add-on. While older versions may suffice, they have not been tested yet.<br />
* OpenOffice.org 2.1<br />
* Java 5.0<br />
* RServe 0.4.7<br />
<br />
==Installing==<br />
<br />
The current version is a prototype and implements only one tool: RDUMP. This method is accessed through the actual Calc menu, and allows you to see the R object structure for various method calls. <br />
<br />
To use the add-on, you need to install R and [http://www.rforge.net/Rserve Rserve]. Instructions for installing R can be found at http://www.r-project.org/ Once installed, run R and type the following to install Rserve. Click "enter" at the end of each bullet point:<br />
<br />
* install.packages("Rserve")<br />
<br />
Rserve needs to be running to work, and can be launched with the following commands... Note that you only need to do this when you want to use the R Add-on for Calc.<br />
<br />
* library(Rserve)<br />
* Rserve()<br />
<br />
Now that you have the prerequisites installed, download the package RAddon.uno.pkg (linked above). Unzip the file, and let's call the directory you unzipped it in <RA_DIR>. Now let <OO_HOME> be your OpenOffice.org installation directory. Open the command prompt or terminal window and go to <OO_HOME>/program/ and type:<br />
<br />
* unopkg add <RA_DIR>/RAddon.uno.pkg<br />
<br />
If this is not your first time installing the add-in, you need to check if a previous version is also on the system. If it is, then you will not be able to install the new version. To do this, go to <OO HOME>/program and type:<br />
<br />
* unopkg list<br />
<br />
This will show you the list of packages already installed, and you should be able to check if the add-is is there. Remember to look for "RAddon.uno.pkg". You can also skip this step and try to uninstall RAddon.uno.pkg regardless -- this will not harm your OpenOffice.org installation in any way, even if RAddon.uno.pkg is abset. To do this, type:<br />
<br />
* unopkg remove RAddon.uno.pkg<br />
<br />
Finally, some operating systems require that you restart your OpenOffice.org installation (if you're not sure, restart your computer) to be able to see the cell functions that come with this package.<br />
<br />
==Using==<br />
<br />
Using the add-on is very simple at this stage. To see the tool at work, open Calc. In the menus, go to R Add-on > Rdump(). A new dialog window will pop up. Type in an R script -- here are some examples:<br />
<br />
* rnorm(10)<br />
* cor.test(c(1,2,3,4), c(1,2,2,3))<br />
<br />
Then click "Run". A new sheet should appear. Close the dialog with "Close" and check the new sheet -- you should see various pieces of information on the sheet.<br />
<br />
==Testing==<br />
<br />
So far, the software has been tested on the following.<br />
<br />
===Version 0.1.7===<br />
<br />
* 64-bit Gentoo Linux running JDK 1.5.0.12 (64-bit version), OpenOffice 2.2.1, and R 2.4.1<br />
<br />
===Version 0.1.6===<br />
<br />
* Ubuntu Feisty Fawn on Java 1.6.0 <br />
<br />
===Version 0.1.5===<br />
<br />
* Fedora Core 7 running native Java<br />
* Ubuntu Edgy Eft running SDK 1.5.0_08 and OpenOffice 2.1.<br />
* Windows XP SP2 running running JDK 1.6.0_02 and OpenOffice 2.2.<br />
<br />
===Version 0.1.0===<br />
<br />
* Fedora Core 6 running JDK 1.6.0_01 and OpenOffice 2.2.<br />
* Ubuntu Edgy Eft running SDK 1.5.0_08 and OpenOffice 2.1.<br />
* Windows XP running running JDK 1.6.0_01 and OpenOffice 2.2.<br />
<br />
==Known Issues==<br />
<br />
Yes, we already have some known issues! That's OK, these are common issues and are not problematic with regards to the code:<br />
<br />
* '''Issue #1 (<font color="red">Fixed in 0.1.1</font>):''' Strings and characters, when part of the R object model, do not get published in Rdump().<br />
* '''Issue #2:''' RDUMP() does not print matrices and frames properly, but prints columns instead.<br />
* '''Issue #3:''' Missing values -- need a good way to deal with missing values. We cannot use a test for non-numeric values because of Factors in R.<br />
<br />
==About==<br />
<br />
This add-on is the result of a Google [[Summer of Code 2007]] project. It was initially created by [[User:Wojciech|Wojciech Gryc]]. For information pertaining to the development of this add-on, see [http://www.11-55.org/ooblog/ Wojciech's Blog].<br />
<br />
==Older Versions==<br />
<br />
* '''0.1.6''' [http://www.11-55.org/rcalc/2007-08-19/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-08-19/rcalc-0_1_6.zip Source Code])<br />
* '''0.1.5''': [http://www.11-55.org/rcalc/2007-08-16/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-08-16/rcalc-0_1_5.zip Source Code])<br />
* '''0.1.4''': [http://www.11-55.org/rcalc/2007-08-10/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-08-10/rcalc-0_1_4.zip Source Code])<br />
* '''0.1.3''': [http://www.11-55.org/rcalc/2007-08-02/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-08-02/rcalc-0_1_3.zip Source Code])<br />
* '''0.1.2''': [http://www.11-55.org/rcalc/2007-06-01/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-06-01/rcalc-0_1_2.zip Source Code])<br />
* '''0.1.1''': [http://www.11-55.org/rcalc/2007-05-25/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-05-25/rcalc-0_1_1.zip Source Code])<br />
* '''0.1.0''': [http://www.11-55.org/rcalc/2007-05-15/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-05-15/rcalc-0.1.0.zip Source Code])<br />
<br />
[[Category:Calc]]<br />
[[Category: R and Calc]]</div>Wojciechhttps://wiki.openoffice.org/w/index.php?title=R_and_Calc:_Bugs_and_Feature_Requests&diff=43824R and Calc: Bugs and Feature Requests2007-08-29T20:28:03Z<p>Wojciech: </p>
<hr />
<div>This section is meant to keep track of the bugs plaguing the add-on, as well as any features people would like to see in upcoming versions. For now, there are three categories on this page:<br />
* '''Bugs: ''' things that need to be fixed urgently (ideally, in the next release).<br />
* '''Feature Requests: ''' things that need to be added at some point in the future, but are not necessary for the healthy functioning of the software.<br />
* '''Implemented Requests: ''' once anything in the categories above is implemented, it is moved here.<br />
<br />
== Bugs ==<br />
<br />
* As it stands, RCalcCaller can't read values from matrices with equations. This code does not work <code>=RTestConnection()</code> with a value of 0 or 1, it will throw an error if we refer to this in code. For example, try the code below:<br />
:: <code>// First, type =RTestConnection() in cell A1.</code><br />
:: <code>a <- {$A1}</code><br />
:: <code>a*3</code><br />
* RCalcCaller can't accept String inputs from cells.<br />
* Need to implement missing values.<br />
* The following code doesn't seem to work in the RCalcCoder on Windows XP SP2, R 2.5.1:<br />
:: <code>rnorm(1)</code><br />
:: <code>{$OUT#A1}<-{$BASE}</code><br />
* Passing the following code to RCalcDump causes a NullPointerException:<br />
:: <code>nls(y ~ a*x + b, data = data.frame(cbind(x = c(1.1, 2.1, 3, 3.9), y = c(1, 2, 3, 4))), start=list(a = 1, b = 1))</code><br />
This is likely because the returned R object has embedded REXPs, functions, and environments.<br />
* Passing <code>a<-127</code> to RCalcDump will cause it to print the outputs of the previous statement rather than this one.<br />
* Passing the following code causes the RCalcCoder to crash:<br />
:: <code>3+3</code><br />
:: <code>{$OUT#C1}<-{$BASE}</code><br />
* R optional packages must be installed in the default R location... Otherwise they cannot be loaded.<br />
* The add-on needs to be installed manually -- Tools > Extension Manager fails to install properly.<br />
* Very slow in extremely large sets of data (probably due to using TCP/IP to send information).<br />
<br />
== Feature Requests ==<br />
<br />
* Dynamic array output. As it stands, you need to know the size of the array if you want the RCalcCoder to output properly.<br />
* Need to implement error output -- right now, nothing happens. This applies to RCalcDump and RCalcCaller.<br />
* Make it so the {$BASE} keyword can be replaced with code. Currently, RCalcCaller won't work with<br />
<code>{$OUT#A1}<-var(c(1,2,3,4))</code><br />
But having such code support would be extremely useful.<br />
* Make the actual syntax more intuitive and easier to use.<br />
* The getOutputs() function in the RCalcInterface is very inefficient and should be replaced (''note that this is a fairly substantial coding change'').<br />
<br />
== Implemented Requests ==<br />
<br />
''None yet, this list was just put up.'' :)<br />
<br />
[[Category: R and Calc]]</div>Wojciechhttps://wiki.openoffice.org/w/index.php?title=R_and_Calc:_Bugs_and_Feature_Requests&diff=43823R and Calc: Bugs and Feature Requests2007-08-29T20:26:54Z<p>Wojciech: </p>
<hr />
<div>This section is meant to keep track of the bugs plaguing the add-on, as well as any features people would like to see in upcoming versions. For now, there are three categories on this page:<br />
* '''Bugs: ''' things that need to be fixed urgently (ideally, in the next release).<br />
* '''Feature Requests: ''' things that need to be added at some point in the future, but are not necessary for the healthy functioning of the software.<br />
* '''Implemented Requests: ''' once anything in the categories above is implemented, it is moved here.<br />
<br />
== Bugs ==<br />
<br />
* As it stands, RCalcCaller can't read values from matrices with equations. This code does not work <code>=RTestConnection()</code> with a value of 0 or 1, it will throw an error if we refer to this in code. For example, try the code below:<br />
:: <code>// First, type =RTestConnection() in cell A1.</code><br />
:: <code>a <- {$A1}</code><br />
:: <code>a*3</code><br />
* RCalcCaller can't accept String inputs from cells.<br />
* Need to implement missing values.<br />
* The following code doesn't seem to work in the RCalcCoder on Windows XP SP2, R 2.5.1:<br />
:: <code>rnorm(1)</code><br />
:: <code>{$OUT#A1}<-{$BASE}</code><br />
* Passing the following code to RCalcDump causes a NullPointerException:<br />
:: <code>nls(y ~ a*x + b, data = data.frame(cbind(x = c(1.1, 2.1, 3, 3.9), y = c(1, 2, 3, 4))), start=list(a = 1, b = 1))</code><br />
This is likely because the returned R object has embedded REXPs, functions, and environments.<br />
* Passing <code>a<-127</code> to RCalcDump will cause it to print the outputs of the previous statement rather than this one.<br />
* Passing the following code causes the RCalcCoder to crash:<br />
:: <code>3+3</code><br />
:: <code>{$OUT#C1}<-{$BASE}</code><br />
* R optional packages must be installed in the default R location... Otherwise they cannot be loaded.<br />
<br />
== Feature Requests ==<br />
<br />
* Dynamic array output. As it stands, you need to know the size of the array if you want the RCalcCoder to output properly.<br />
* Need to implement error output -- right now, nothing happens. This applies to RCalcDump and RCalcCaller.<br />
* Make it so the {$BASE} keyword can be replaced with code. Currently, RCalcCaller won't work with<br />
<code>{$OUT#A1}<-var(c(1,2,3,4))</code><br />
But having such code support would be extremely useful.<br />
* Make the actual syntax more intuitive and easier to use.<br />
* The getOutputs() function in the RCalcInterface is very inefficient and should be replaced (''note that this is a fairly substantial coding change'').<br />
<br />
== Implemented Requests ==<br />
<br />
''None yet, this list was just put up.'' :)<br />
<br />
[[Category: R and Calc]]</div>Wojciechhttps://wiki.openoffice.org/w/index.php?title=R_and_Calc:_Bugs_and_Feature_Requests&diff=43665R and Calc: Bugs and Feature Requests2007-08-28T04:14:19Z<p>Wojciech: </p>
<hr />
<div>This section is meant to keep track of the bugs plaguing the add-on, as well as any features people would like to see in upcoming versions. For now, there are three categories on this page:<br />
* '''Bugs: ''' things that need to be fixed urgently (ideally, in the next release).<br />
* '''Feature Requests: ''' things that need to be added at some point in the future, but are not necessary for the healthy functioning of the software.<br />
* '''Implemented Requests: ''' once anything in the categories above is implemented, it is moved here.<br />
<br />
== Bugs ==<br />
<br />
* As it stands, RCalcCaller can't read values from matrices with equations. This code does not work <code>=RTestConnection()</code> with a value of 0 or 1, it will throw an error if we refer to this in code. For example, try the code below:<br />
:: <code>// First, type =RTestConnection() in cell A1.</code><br />
:: <code>a <- {$A1}</code><br />
:: <code>a*3</code><br />
* RCalcCaller can't accept String inputs from cells.<br />
* Need to implement missing values.<br />
* The following code doesn't seem to work in the RCalcCoder on Windows XP SP2, R 2.5.1:<br />
:: <code>rnorm(1)</code><br />
:: <code>{$OUT#A1}<-{$BASE}</code><br />
* Passing the following code to RCalcDump causes a NullPointerException:<br />
:: <code>nls(y ~ a*x + b, data = data.frame(cbind(x = c(1.1, 2.1, 3, 3.9), y = c(1, 2, 3, 4))), start=list(a = 1, b = 1))</code><br />
This is likely because the returned R object has embedded REXPs, functions, and environments.<br />
* Passing <code>a<-127</code> to RCalcDump will cause it to print the outputs of the previous statement rather than this one.<br />
* Passing the following code causes the RCalcCoder to crash:<br />
:: <code>3+3</code><br />
:: <code>{$OUT#C1}<-{$BASE}</code><br />
<br />
== Feature Requests ==<br />
<br />
* Dynamic array output. As it stands, you need to know the size of the array if you want the RCalcCoder to output properly.<br />
* Need to implement error output -- right now, nothing happens. This applies to RCalcDump and RCalcCaller.<br />
* Make it so the {$BASE} keyword can be replaced with code. Currently, RCalcCaller won't work with<br />
<code>{$OUT#A1}<-var(c(1,2,3,4))</code><br />
But having such code support would be extremely useful.<br />
* Make the actual syntax more intuitive and easier to use.<br />
* The getOutputs() function in the RCalcInterface is very inefficient and should be replaced (''note that this is a fairly substantial coding change'').<br />
<br />
== Implemented Requests ==<br />
<br />
''None yet, this list was just put up.'' :)<br />
<br />
[[Category: R and Calc]]</div>Wojciechhttps://wiki.openoffice.org/w/index.php?title=R_and_Calc&diff=43664R and Calc2007-08-28T04:13:46Z<p>Wojciech: </p>
<hr />
<div><blockquote style="background: white; border: 1px solid rgb(153, 153, 153); padding: 1em;">This page is meant as a general overview and installation guide for the software. Please see [[R and Calc Documentation]] for more information on functions, scripting, and general usage. Also feel free to submit bug reports in the [[R and Calc: Bugs and Feature Requests]] page.</blockquote><br />
<br />
"R and Calc" is an [[OpenOffice.org]] (OO.o) [[Calc]] add-on that allows you to use [http://www.r-project.org/ R] methods and functions. The software is currently in early development, though a '''basic''' working version does exist, and is available for download.<br />
<br />
We welcome any and all comments and name suggestions. Please send them to [[User:Wojciech|Wojciech Gryc]].<br />
<br />
For those who come here often, here is the latest version:<br />
* '''Version:''' 0.1.7<br />
* '''Release Date:''' August 23, 2007 (10:39 pm EST)<br />
* '''Link:''' http://www.11-55.org/rcalc/2007-08-23/RAddon.uno.pkg<br />
* '''Source Code:''' http://www.11-55.org/rcalc/2007-08-23/rcalc-0_1_7.zip<br />
* '''Manual:''' http://www.11-55.org/rcalc/2007-08-23/manual.pdf<br />
<br />
==Requirements==<br />
<br />
You need the following software to run this add-on. While older versions may suffice, they have not been tested yet.<br />
* OpenOffice.org 2.1<br />
* Java 5.0<br />
* RServe 0.4.7<br />
<br />
==Installing==<br />
<br />
The current version is a prototype and implements only one tool: RDUMP. This method is accessed through the actual Calc menu, and allows you to see the R object structure for various method calls. <br />
<br />
To use the add-on, you need to install R and [http://www.rforge.net/Rserve Rserve]. Instructions for installing R can be found at http://www.r-project.org/ Once installed, run R and type the following to install Rserve. Click "enter" at the end of each bullet point:<br />
<br />
* install.packages("Rserve")<br />
<br />
Rserve needs to be running to work, and can be launched with the following commands... Note that you only need to do this when you want to use the R Add-on for Calc.<br />
<br />
* library(Rserve)<br />
* Rserve()<br />
<br />
Now that you have the prerequisites installed, download the package RAddon.uno.pkg (linked above). Unzip the file, and let's call the directory you unzipped it in <RA_DIR>. Now let <OO_HOME> be your OpenOffice.org installation directory. Open the command prompt or terminal window and go to <OO_HOME>/program/ and type:<br />
<br />
* unopkg add <RA_DIR>/RAddon.uno.pkg<br />
<br />
If this is not your first time installing the add-in, you need to check if a previous version is also on the system. If it is, then you will not be able to install the new version. To do this, go to <OO HOME>/program and type:<br />
<br />
* unopkg list<br />
<br />
This will show you the list of packages already installed, and you should be able to check if the add-is is there. Remember to look for "RAddon.uno.pkg". You can also skip this step and try to uninstall RAddon.uno.pkg regardless -- this will not harm your OpenOffice.org installation in any way, even if RAddon.uno.pkg is abset. To do this, type:<br />
<br />
* unopkg remove RAddon.uno.pkg<br />
<br />
Finally, some operating systems require that you restart your OpenOffice.org installation (if you're not sure, restart your computer) to be able to see the cell functions that come with this package.<br />
<br />
==Using==<br />
<br />
Using the add-on is very simple at this stage. To see the tool at work, open Calc. In the menus, go to R Add-on > Rdump(). A new dialog window will pop up. Type in an R script -- here are some examples:<br />
<br />
* rnorm(10)<br />
* cor.test(c(1,2,3,4), c(1,2,2,3))<br />
<br />
Then click "Run". A new sheet should appear. Close the dialog with "Close" and check the new sheet -- you should see various pieces of information on the sheet.<br />
<br />
==Testing==<br />
<br />
So far, the software has been tested on the following.<br />
<br />
===Version 0.1.6===<br />
<br />
* Ubuntu Feisty Fawn on Java 1.6.0 <br />
<br />
===Version 0.1.5===<br />
<br />
* Fedora Core 7 running native Java<br />
* Ubuntu Edgy Eft running SDK 1.5.0_08 and OpenOffice 2.1.<br />
* Windows XP SP2 running running JDK 1.6.0_02 and OpenOffice 2.2.<br />
<br />
===Version 0.1.0===<br />
<br />
* Fedora Core 6 running JDK 1.6.0_01 and OpenOffice 2.2.<br />
* Ubuntu Edgy Eft running SDK 1.5.0_08 and OpenOffice 2.1.<br />
* Windows XP running running JDK 1.6.0_01 and OpenOffice 2.2.<br />
<br />
==Known Issues==<br />
<br />
Yes, we already have some known issues! That's OK, these are common issues and are not problematic with regards to the code:<br />
<br />
* '''Issue #1 (<font color="red">Fixed in 0.1.1</font>):''' Strings and characters, when part of the R object model, do not get published in Rdump().<br />
* '''Issue #2:''' RDUMP() does not print matrices and frames properly, but prints columns instead.<br />
* '''Issue #3:''' Missing values -- need a good way to deal with missing values. We cannot use a test for non-numeric values because of Factors in R.<br />
<br />
==About==<br />
<br />
This add-on is the result of a Google [[Summer of Code 2007]] project. It was initially created by [[User:Wojciech|Wojciech Gryc]]. For information pertaining to the development of this add-on, see [http://www.11-55.org/ooblog/ Wojciech's Blog].<br />
<br />
==Older Versions==<br />
<br />
* '''0.1.6''' [http://www.11-55.org/rcalc/2007-08-19/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-08-19/rcalc-0_1_6.zip Source Code])<br />
* '''0.1.5''': [http://www.11-55.org/rcalc/2007-08-16/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-08-16/rcalc-0_1_5.zip Source Code])<br />
* '''0.1.4''': [http://www.11-55.org/rcalc/2007-08-10/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-08-10/rcalc-0_1_4.zip Source Code])<br />
* '''0.1.3''': [http://www.11-55.org/rcalc/2007-08-02/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-08-02/rcalc-0_1_3.zip Source Code])<br />
* '''0.1.2''': [http://www.11-55.org/rcalc/2007-06-01/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-06-01/rcalc-0_1_2.zip Source Code])<br />
* '''0.1.1''': [http://www.11-55.org/rcalc/2007-05-25/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-05-25/rcalc-0_1_1.zip Source Code])<br />
* '''0.1.0''': [http://www.11-55.org/rcalc/2007-05-15/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-05-15/rcalc-0.1.0.zip Source Code])<br />
<br />
[[Category:Calc]]<br />
[[Category: R and Calc]]</div>Wojciechhttps://wiki.openoffice.org/w/index.php?title=R_and_Calc:_Bugs_and_Feature_Requests&diff=43663R and Calc: Bugs and Feature Requests2007-08-28T04:12:54Z<p>Wojciech: </p>
<hr />
<div>This section is meant to keep track of the bugs plaguing the add-on, as well as any features people would like to see in upcoming versions. For now, there are three categories on this page:<br />
* '''Bugs: ''' things that need to be fixed urgently (ideally, in the next release).<br />
* '''Feature Requests: ''' things that need to be added at some point in the future, but are not necessary for the healthy functioning of the software.<br />
* '''Implemented Requests: ''' once anything in the categories above is implemented, it is moved here.<br />
<br />
== Bugs ==<br />
<br />
* As it stands, RCalcCaller can't read values from matrices with equations. This code does not work <code>=RTestConnection()</code> with a value of 0 or 1, it will throw an error if we refer to this in code. For example, try the code below:<br />
:: <code>// First, type =RTestConnection() in cell A1.</code><br />
:: <code>a <- {$A1}</code><br />
:: <code>a*3</code><br />
* RCalcCaller can't accept String inputs from cells.<br />
* Need to implement missing values.<br />
* The following code doesn't seem to work in the RCalcCoder on Windows XP SP2, R 2.5.1:<br />
:: <code>rnorm(1)</code><br />
:: <code>{$OUT#A1}<-{$BASE}</code><br />
* Passing the following code to RCalcDump causes a NullPointerException:<br />
:: <code>nls(y ~ a*x + b, data = data.frame(cbind(x = c(1.1, 2.1, 3, 3.9), y = c(1, 2, 3, 4))), start=list(a = 1, b = 1))</code><br />
This is likely because the returned R object has embedded REXPs, functions, and environments.<br />
* Passing <code>a<-127</code> to RCalcDump will cause it to print the outputs of the previous statement rather than this one.<br />
* Passing the following code causes the RCalcCoder to crash:<br />
:: <code>3+3</code><br />
:: <code>{$OUT#C1}<-{$BASE}</code><br />
<br />
== Feature Requests ==<br />
<br />
* Dynamic array output. As it stands, you need to know the size of the array if you want the RCalcCoder to output properly.<br />
* Need to implement error output -- right now, nothing happens. This applies to RCalcDump and RCalcCaller.<br />
* Make it so the {$BASE} keyword can be replaced with code. Currently, RCalcCaller won't work with<br />
<code>{$OUT#A1}<-var(c(1,2,3,4))</code><br />
But having such code support would be extremely useful.<br />
* Make the actual syntax more intuitive and easier to use.<br />
* The getOutputs() function in the RCalcInterface is very inefficient and should be replaced (''note that this is a fairly substantial coding change'').<br />
<br />
== Implemented Requests ==<br />
<br />
''None yet, this list was just put up.'' :)</div>Wojciechhttps://wiki.openoffice.org/w/index.php?title=R_and_Calc_Documentation&diff=43636R and Calc Documentation2007-08-27T17:15:45Z<p>Wojciech: </p>
<hr />
<div>Please note that this documentation is for Version 0.1.1. See the main [[R and Calc]] page for information on installation and setup.<br />
<br />
==Cell Functions==<br />
<br />
Note that the function names may change in future versions... I'm not really concerned about properly naming everything for users yet, but making things simpler for development.<br />
<br />
* '''RNDBLMAT( <command> , <matrix> , <matrix>)''': passes a command and two matrices. For example, RNDBLMAT("cov";A1:A100;B1:B100).<br />
* '''RNMAT( <command> , <matrix> )''': passes a command and matrix as a parameter. For example, RNNUM("var";A1:A100).<br />
* '''RNNUM( <command> , <number> )''': passes a command and a numeric parameter. For example, RNNUM("rnorm"; 1).<br />
* '''RNUMPROP( <command> , <property> )''': passes a command to R and prints a specific property from the output. This is useful if the values returned from R aren't numeric but contain a variety of information. For example, RNUMPROP("cor.test(c(1,2,3,4), c(1,2,2,3))"; "p.value").<br />
* '''RSIMPLENUM( <command> )''': passes a command to R, prints a number if one is returned.<br />
* '''RTESTCONNECTION()''': tests R connection (for RServe).<br />
<br />
==R Add-On Menu==<br />
<br />
* '''Correlation:''' an advanced correlation tool that allows you to see p values and 95% confidence intervals. Also allows you to change the type of correlation.<br />
* '''Linear Regression:''' a simple tool that prints the slope and intercept of a line of best fit. It's a good example to start from if you plan on making your own scripts (the code is in ''<base dir>/RAddon/rcall_linreg.txt'').<br />
* '''General Linear Model:''' fits a general linear model (GLM) to your data and allows you to see the p value for the model.<br />
<br />
===ANOVA Submenu===<br />
<br />
* '''One-Way ANOVA'''<br />
* '''Two-Way ANOVA'''<br />
<br />
===Advanced Submenu===<br />
<br />
* '''Load External Script:''' allows you to load an external GUI script for custom R commands.<br />
* '''Dump R Output: ''' creates a new spreadsheet with the object structure returned by a specific R script.<br />
<br />
== Advanced ==<br />
<br />
=== Coding Window ===<br />
<br />
==== Intro ====<br />
<br />
The coding window allows performing more complex operations in R. The user is able to:<br />
* read data from the spreadsheet (cells and cell-ranges) and import the data into R<br />
* issue R-commands<br />
* export the results back into Calc<br />
<br />
==== Command Description ====<br />
There are generally 4 types of commands:<br />
* data input commands<br />
* data output commands<br />
* specific R-commands<br />
* and specific escape commands<br />
<br />
'''Data Input'''<br />
To read a data-range in R from the spreadsheet, one uses:<br />
''new_variable_name'' <- '''{#''range_start_cell'':''range_end_cell''}'''<br />
where the data is read from the cell range ''range_start_cell'':''range_end_cell''<br />
and stored in the variable ''new_variable_name''<br />
Implementation Detail: the resulting R-variable is of type ''matrix''<br />
my.variable.class <- class(''new_variable_name'')<br />
{$OUT#C1} <- {$BASE}<br />
<br />
'''OUTPUT:''' ''matrix''<br />
<br />
To store the variable as a list or as a data.frame, use:<br />
''my.list'' <- list( {#''cell_begin:cell_end''} )<br />
''my.data.frame'' <- data.frame( {#''cell_begin:cell_end''} )<br />
<br />
'''Data Output'''<br />
Similarly, to write the output back to a Calc cell, one uses:<br />
'''{$OUT#''results_cell''}'''<-''name_of_variable''<br />
Alternatively, when the returned object has just one value:<br />
'''{$OUT#''results_cell''}'''<-''{$BASE}''<br />
: where ''name_of_variable'' is one of the variable names from the ''returned object'' (aka one of the returned strings from names(variable), respectively the ''name_of_variable'' in the R object: ''variable$name_of_variable'')<br />
: {$BASE} is the returned value, when there is just one value<br />
<br />
'''NOTE for v0.1.6:''' Any space before the '''_space_''{$OUT:...}' will prevent the code from returning any output. Hope this gets fixed.<br />
<br />
==== Examples ====<br />
<br />
Some examples may explain better the concept. Lets consider that the user data is in the cells A1:A20 and B1:B20. The scripts look then as follows:<br />
<br />
'''Wilcoxon test:'''<br />
wilcox.test({#A1:A20},{#B1:B20})<br />
{$OUT#A22} <- p.value<br />
<br />
'''Correlation'''<br />
cor.test({#A1:A20},{#B1:B20})<br />
{$OUT#B22} <- p.value<br />
<br />
Lets say cells C1, C2, D1 and D2 containing count data forming a contingency table. The Fisher-exact test for count data can be computed as follows: ('''ATTENTION: computing the Fisher-exact test with large data values may take some time!''')<br />
'''Fisher-exact test:'''<br />
fisher.test({#C1:D2})<br />
{$OUT#C22} <- p.value<br />
<br />
'''Chi-Square Test'''<br />
chisq.test({#C1:D2})<br />
{$OUT#D22} <- p.value<br />
<br />
==== Complex Examples ====<br />
<br />
The following script will perform a '''Multivariate Linear Regression''' (least-squares-fitting). Suppose the user data is in cells ''A1:C100'', while ''D1:D100'' contains the dependent variable. We will perform a multivariate regression of the form D = I + x1* A + x2 * B + x3 * C, where:<br />
'''I''' is the Intercept<br />
'''x1-x3''' are the corresponding regression coefficients<br />
<br />
<br />
'''Multivariate Linear Regression''' <br><br />
''considering the variable names are stored in A1:D1 (in the column headers)''<br />
<pre><br />
my.data <- data.frame({#A2:D100})<br />
l<-length(my.data[1,])<br />
// will be used in a future version instead of hardcoding INDEXes<br />
<br />
linear.model<-lm(my.data[,4]~my.data[,1]+my.data[,2]+my.data[,3])<br />
sx<-summary(linear.model)[[4]]<br />
<br />
// ANNOTATION<br />
my.labels<-c("pm"="Parameter","Intercept"="Intercept",c({#A1:C1}))<br />
// STRING IMPORT IS BROKEN<br />
//{$OUT#F1:5}<-{$BASE} // DOES NOT FUNCTION<br />
{$OUT#F1}<-pm<br />
{$OUT#F2}<-Intercept<br />
<br />
s<-list("b"="beta-coeff", "bIntercept"=sx[[1]], "b1"=sx[[2]], "b2"=sx[[3]], "b3"=sx[[4]] )<br />
s<-c(s,"p"="p-value", "pIntercept"=sx[[13]], "p1"=sx[[14]], "p2"=sx[[15]], "p3"=sx[[16]])<br />
// beta-COEFFICIENTS<br />
{$OUT#G1}<-b<br />
{$OUT#G2}<-bIntercept<br />
{$OUT#G3}<-b1<br />
{$OUT#G4}<-b2<br />
{$OUT#G5}<-b3<br />
<br />
// p-VALUES<br />
{$OUT#H1}<-p<br />
{$OUT#H2}<-pIntercept<br />
{$OUT#H3}<-p1<br />
{$OUT#H4}<-p2<br />
{$OUT#H5}<-p3<br />
</pre><br />
<br />
Finally, to test the validity of the regression model, one has to run an ANOVA-test (Analysis of Variance) on the model. We will do this using the '''R''' ''aov''-function:<br />
<br />
'''Testing the model'''<br />
<pre><br />
my.aov<-summary(aov(linear.model))[[1]]<br />
mx<-my.aov[[5]]<br />
s<-list("m"="ANOVA","m1"=mx[[1]],"m2"=mx[[2]],"m3"=mx[[3]])<br />
{$OUT#I1}<-m<br />
{$OUT#I3}<-m1<br />
{$OUT#I4}<-m2<br />
{$OUT#I5}<-m3<br />
</pre><br />
<br />
That's it.<br />
<br />
==Tips & Tricks==<br />
<br />
===Running External Libraries===<br />
<br />
At this time, it's not possible to load libraries ahead of time using Rserve. However, you can load a library through a function cell. The example below loads a library called [http://erzuli.ss.uci.edu/R.stuff/ sna] and calls a function, passing a matrix as a parameter. Note that the library needs to be installed prior to using it.<br />
<br />
<code>RNMAT("library(sna);gden"; A1:D4)</code><br />
<br />
===summary() Hack for Complex R Objects===<br />
<br />
There are times when the R object structure you are dealing with is very complex, to the point that it's difficult to find specific values. One such example is the nonlinear least squares function (used for curve fitting, for example). You use this function by calling nls() and one of the most useful things it gives is values for coefficients in an equation. The only problem is the object returned by nls() is organized in a way that makes it difficult to find values for these coefficients.<br />
<br />
One workaround is to call nls() with summary()... This will allow you to see some of the variables (such as coefficient values) and makes it much easier to extract information using the R/Calc interface.<br />
<br />
See the example implementation with one variable: http://www.11-55.org/rcalc/2007-06-01/rcall_nls.txt<br />
<br />
===Random Numbers===<br />
<br />
If you try to generate random numbers with a cell function like <code>rsimplenum("rnorm(1)")</code> and try to expand it to multiple cells by dragging, you'll notice the numbers are all the same (at least in Linux!). This occurs because R is using the same seed number for every cell, causing all the numbers to be the same. There are a number of ways to fix this.<br />
<br />
If you just need a list of random numbers, the easiest way to get one is to go to ''R Add-On > Advanced > Dump R Output'' and type your function here. For example, if you want 100 normally distributed numbers, type <code>rnorm(100)</code> and click ''Run''. This will create a new spreadsheet with your numbers.<br />
<br />
A second, harder way is setting the R seed with each cell call. Pick a cell and write <code>rsimplenum("set.seed(543);rnorm(1)")</code> you will first set the random number generator's seed to 543, and then get a random number. In this way, however, the random number will not change if you refresh the function because the seed does not change. Unfortunately, the only way to change the seed in this method is manually for every cell.<br />
<br />
==Creating Your Own Dialogs and Scripts==<br />
<br />
Using a basic text file, it is possible to create your own scripts and functions that will then call R and provide output. A basic [http://www.11-55.org/ooblog/wp-content/uploads/2007/05/correl-may-21.txt correlation example] is provided, and an outline of the tile structure is given below.<br />
<br />
First and foremost, there are four sections to a file:<br />
* '''__ETC:''' ignored -- a set of comments.<br />
* '''__GUI:''' for user interface objects.<br />
* '''__CALL:''' allows you to define the R function call based on GUI inputs.<br />
* '''__OUTPUT:''' allows you to set where the output will go.<br />
<br />
===Using __GUI:===<br />
<br />
Currently, the following GUI objects can be defined in the file:<br />
* '''TextField:''' for text-based arguments.<br />
* '''NumberField:''' for numeric arguments -- either actual numbers or a reference to a sheet cell.<br />
* '''ArrayField:''' refers to data in the spreadsheet (current active sheet).<br />
* '''Label:''' a basic label.<br />
* '''RunButton:''' runs the code and prints output.<br />
* '''CancelButton:''' closes the dialog.<br />
* '''Dialog:''' allows you to define the size and location of the dialog.<br />
* '''OutputField:''' allows for the user to input information for outputs.<br />
* '''ComboBox:''' creates a combo box. Rather than passing ''label_text'', pass a list of options with ";" as the delimiter. For example, "a;b;c;d" will have the combo box show four options: a, b, c, and d.<br />
<br />
The format for the above is as follows, with ''italic'' fields representing variables and parameters: ''Object_Name''<-Label( ''x position'' , '' y position '', ''width'' , ''height'', ''label_text'' ). If you want to use special symbols in labels or other parts of the GUI, the following characters need to be replaced with the corresponding variables:<br />
* '''(''' {$BL}<br />
* ''')''' {$BR}<br />
* '''=''' {$EQ}<br />
<br />
===Using __CALL:===<br />
<br />
In this case, simply write your call text, with variables being represented as {$''variable-name''} where the name itself corresponds to the names you gave the GUI objects above. This only works with TextField, NumberField, and ArrayField. You can have multiple lines of R scripts here, but can only use the output of the final line of code in this section.<br />
<br />
===Using __OUTPUT:===<br />
<br />
In this case, you write every line like so: ''Cell-Address''<-''Value'' where ''Value'' is either the name of a specific property in the R object structure (e.g. ''p.value'' or ''estimate'') or a general piece of text. The software will always test to see if your text is a property, and if it is not, the text itself will be printed.<br />
<br />
[[Category:Calc]]<br />
[[Category:Add-Ins]]<br />
[[Category: R and Calc]]</div>Wojciechhttps://wiki.openoffice.org/w/index.php?title=Category:R_and_Calc&diff=43635Category:R and Calc2007-08-27T17:15:07Z<p>Wojciech: </p>
<hr />
<div>This category specifically relates to pages dealing with the R and Calc integration project. Those interested in learning about the add-on should see the main page, [[R_and_Calc]]. To contact someone with regards to the add-on, please see [[User:Wojciech | Wojciech Gryc]].</div>Wojciechhttps://wiki.openoffice.org/w/index.php?title=R_and_Calc&diff=43634R and Calc2007-08-27T17:13:38Z<p>Wojciech: </p>
<hr />
<div><blockquote style="background: white; border: 1px solid rgb(153, 153, 153); padding: 1em;">This page is meant as a general overview and installation guide for the software. Please see [[R and Calc Documentation]] for more information on functions, scripting, and general usage.</blockquote><br />
<br />
"R and Calc" is an [[OpenOffice.org]] (OO.o) [[Calc]] add-on that allows you to use [http://www.r-project.org/ R] methods and functions. The software is currently in early development, though a '''basic''' working version does exist, and is available for download.<br />
<br />
We welcome any and all comments and name suggestions. Please send them to [[User:Wojciech|Wojciech Gryc]].<br />
<br />
For those who come here often, here is the latest version:<br />
* '''Version:''' 0.1.7<br />
* '''Release Date:''' August 23, 2007 (10:39 pm EST)<br />
* '''Link:''' http://www.11-55.org/rcalc/2007-08-23/RAddon.uno.pkg<br />
* '''Source Code:''' http://www.11-55.org/rcalc/2007-08-23/rcalc-0_1_7.zip<br />
* '''Manual:''' http://www.11-55.org/rcalc/2007-08-23/manual.pdf<br />
<br />
==Requirements==<br />
<br />
You need the following software to run this add-on. While older versions may suffice, they have not been tested yet.<br />
* OpenOffice.org 2.1<br />
* Java 5.0<br />
* RServe 0.4.7<br />
<br />
==Installing==<br />
<br />
The current version is a prototype and implements only one tool: RDUMP. This method is accessed through the actual Calc menu, and allows you to see the R object structure for various method calls. <br />
<br />
To use the add-on, you need to install R and [http://www.rforge.net/Rserve Rserve]. Instructions for installing R can be found at http://www.r-project.org/ Once installed, run R and type the following to install Rserve. Click "enter" at the end of each bullet point:<br />
<br />
* install.packages("Rserve")<br />
<br />
Rserve needs to be running to work, and can be launched with the following commands... Note that you only need to do this when you want to use the R Add-on for Calc.<br />
<br />
* library(Rserve)<br />
* Rserve()<br />
<br />
Now that you have the prerequisites installed, download the package RAddon.uno.pkg (linked above). Unzip the file, and let's call the directory you unzipped it in <RA_DIR>. Now let <OO_HOME> be your OpenOffice.org installation directory. Open the command prompt or terminal window and go to <OO_HOME>/program/ and type:<br />
<br />
* unopkg add <RA_DIR>/RAddon.uno.pkg<br />
<br />
If this is not your first time installing the add-in, you need to check if a previous version is also on the system. If it is, then you will not be able to install the new version. To do this, go to <OO HOME>/program and type:<br />
<br />
* unopkg list<br />
<br />
This will show you the list of packages already installed, and you should be able to check if the add-is is there. Remember to look for "RAddon.uno.pkg". You can also skip this step and try to uninstall RAddon.uno.pkg regardless -- this will not harm your OpenOffice.org installation in any way, even if RAddon.uno.pkg is abset. To do this, type:<br />
<br />
* unopkg remove RAddon.uno.pkg<br />
<br />
Finally, some operating systems require that you restart your OpenOffice.org installation (if you're not sure, restart your computer) to be able to see the cell functions that come with this package.<br />
<br />
==Using==<br />
<br />
Using the add-on is very simple at this stage. To see the tool at work, open Calc. In the menus, go to R Add-on > Rdump(). A new dialog window will pop up. Type in an R script -- here are some examples:<br />
<br />
* rnorm(10)<br />
* cor.test(c(1,2,3,4), c(1,2,2,3))<br />
<br />
Then click "Run". A new sheet should appear. Close the dialog with "Close" and check the new sheet -- you should see various pieces of information on the sheet.<br />
<br />
==Testing==<br />
<br />
So far, the software has been tested on the following.<br />
<br />
===Version 0.1.6===<br />
<br />
* Ubuntu Feisty Fawn on Java 1.6.0 <br />
<br />
===Version 0.1.5===<br />
<br />
* Fedora Core 7 running native Java<br />
* Ubuntu Edgy Eft running SDK 1.5.0_08 and OpenOffice 2.1.<br />
* Windows XP SP2 running running JDK 1.6.0_02 and OpenOffice 2.2.<br />
<br />
===Version 0.1.0===<br />
<br />
* Fedora Core 6 running JDK 1.6.0_01 and OpenOffice 2.2.<br />
* Ubuntu Edgy Eft running SDK 1.5.0_08 and OpenOffice 2.1.<br />
* Windows XP running running JDK 1.6.0_01 and OpenOffice 2.2.<br />
<br />
==Known Issues==<br />
<br />
Yes, we already have some known issues! That's OK, these are common issues and are not problematic with regards to the code:<br />
<br />
* '''Issue #1 (<font color="red">Fixed in 0.1.1</font>):''' Strings and characters, when part of the R object model, do not get published in Rdump().<br />
* '''Issue #2:''' RDUMP() does not print matrices and frames properly, but prints columns instead.<br />
* '''Issue #3:''' Missing values -- need a good way to deal with missing values. We cannot use a test for non-numeric values because of Factors in R.<br />
<br />
==About==<br />
<br />
This add-on is the result of a Google [[Summer of Code 2007]] project. It was initially created by [[User:Wojciech|Wojciech Gryc]]. For information pertaining to the development of this add-on, see [http://www.11-55.org/ooblog/ Wojciech's Blog].<br />
<br />
==Older Versions==<br />
<br />
* '''0.1.6''' [http://www.11-55.org/rcalc/2007-08-19/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-08-19/rcalc-0_1_6.zip Source Code])<br />
* '''0.1.5''': [http://www.11-55.org/rcalc/2007-08-16/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-08-16/rcalc-0_1_5.zip Source Code])<br />
* '''0.1.4''': [http://www.11-55.org/rcalc/2007-08-10/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-08-10/rcalc-0_1_4.zip Source Code])<br />
* '''0.1.3''': [http://www.11-55.org/rcalc/2007-08-02/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-08-02/rcalc-0_1_3.zip Source Code])<br />
* '''0.1.2''': [http://www.11-55.org/rcalc/2007-06-01/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-06-01/rcalc-0_1_2.zip Source Code])<br />
* '''0.1.1''': [http://www.11-55.org/rcalc/2007-05-25/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-05-25/rcalc-0_1_1.zip Source Code])<br />
* '''0.1.0''': [http://www.11-55.org/rcalc/2007-05-15/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-05-15/rcalc-0.1.0.zip Source Code])<br />
<br />
[[Category:Calc]]<br />
[[Category: R and Calc]]</div>Wojciechhttps://wiki.openoffice.org/w/index.php?title=R_and_Calc&diff=43380R and Calc2007-08-24T03:40:22Z<p>Wojciech: /* Testing */</p>
<hr />
<div><blockquote style="background: white; border: 1px solid rgb(153, 153, 153); padding: 1em;">This page is meant as a general overview and installation guide for the software. Please see [[R and Calc Documentation]] for more information on functions, scripting, and general usage.</blockquote><br />
<br />
"R and Calc" is an [[OpenOffice.org]] (OO.o) [[Calc]] add-on that allows you to use [http://www.r-project.org/ R] methods and functions. The software is currently in early development, though a '''basic''' working version does exist, and is available for download.<br />
<br />
We welcome any and all comments and name suggestions. Please send them to [[User:Wojciech|Wojciech Gryc]].<br />
<br />
For those who come here often, here is the latest version:<br />
* '''Version:''' 0.1.7<br />
* '''Release Date:''' August 23, 2007 (10:39 pm EST)<br />
* '''Link:''' http://www.11-55.org/rcalc/2007-08-23/RAddon.uno.pkg<br />
* '''Source Code:''' http://www.11-55.org/rcalc/2007-08-23/rcalc-0_1_7.zip<br />
* '''Manual:''' http://www.11-55.org/rcalc/2007-08-23/manual.pdf<br />
<br />
==Requirements==<br />
<br />
You need the following software to run this add-on. While older versions may suffice, they have not been tested yet.<br />
* OpenOffice.org 2.1<br />
* Java 5.0<br />
* RServe 0.4.7<br />
<br />
==Installing==<br />
<br />
The current version is a prototype and implements only one tool: RDUMP. This method is accessed through the actual Calc menu, and allows you to see the R object structure for various method calls. <br />
<br />
To use the add-on, you need to install R and [http://www.rforge.net/Rserve Rserve]. Instructions for installing R can be found at http://www.r-project.org/ Once installed, run R and type the following to install Rserve. Click "enter" at the end of each bullet point:<br />
<br />
* install.packages("Rserve")<br />
<br />
Rserve needs to be running to work, and can be launched with the following commands... Note that you only need to do this when you want to use the R Add-on for Calc.<br />
<br />
* library(Rserve)<br />
* Rserve()<br />
<br />
Now that you have the prerequisites installed, download the package RAddon.uno.pkg (linked above). Unzip the file, and let's call the directory you unzipped it in <RA_DIR>. Now let <OO_HOME> be your OpenOffice.org installation directory. Open the command prompt or terminal window and go to <OO_HOME>/program/ and type:<br />
<br />
* unopkg add <RA_DIR>/RAddon.uno.pkg<br />
<br />
If this is not your first time installing the add-in, you need to check if a previous version is also on the system. If it is, then you will not be able to install the new version. To do this, go to <OO HOME>/program and type:<br />
<br />
* unopkg list<br />
<br />
This will show you the list of packages already installed, and you should be able to check if the add-is is there. Remember to look for "RAddon.uno.pkg". You can also skip this step and try to uninstall RAddon.uno.pkg regardless -- this will not harm your OpenOffice.org installation in any way, even if RAddon.uno.pkg is abset. To do this, type:<br />
<br />
* unopkg remove RAddon.uno.pkg<br />
<br />
Finally, some operating systems require that you restart your OpenOffice.org installation (if you're not sure, restart your computer) to be able to see the cell functions that come with this package.<br />
<br />
==Using==<br />
<br />
Using the add-on is very simple at this stage. To see the tool at work, open Calc. In the menus, go to R Add-on > Rdump(). A new dialog window will pop up. Type in an R script -- here are some examples:<br />
<br />
* rnorm(10)<br />
* cor.test(c(1,2,3,4), c(1,2,2,3))<br />
<br />
Then click "Run". A new sheet should appear. Close the dialog with "Close" and check the new sheet -- you should see various pieces of information on the sheet.<br />
<br />
==Testing==<br />
<br />
So far, the software has been tested on the following.<br />
<br />
===Version 0.1.6===<br />
<br />
* Ubuntu Feisty Fawn on Java 1.6.0 <br />
<br />
===Version 0.1.5===<br />
<br />
* Fedora Core 7 running native Java<br />
* Ubuntu Edgy Eft running SDK 1.5.0_08 and OpenOffice 2.1.<br />
* Windows XP SP2 running running JDK 1.6.0_02 and OpenOffice 2.2.<br />
<br />
===Version 0.1.0===<br />
<br />
* Fedora Core 6 running JDK 1.6.0_01 and OpenOffice 2.2.<br />
* Ubuntu Edgy Eft running SDK 1.5.0_08 and OpenOffice 2.1.<br />
* Windows XP running running JDK 1.6.0_01 and OpenOffice 2.2.<br />
<br />
==Known Issues==<br />
<br />
Yes, we already have some known issues! That's OK, these are common issues and are not problematic with regards to the code:<br />
<br />
* '''Issue #1 (<font color="red">Fixed in 0.1.1</font>):''' Strings and characters, when part of the R object model, do not get published in Rdump().<br />
* '''Issue #2:''' RDUMP() does not print matrices and frames properly, but prints columns instead.<br />
* '''Issue #3:''' Missing values -- need a good way to deal with missing values. We cannot use a test for non-numeric values because of Factors in R.<br />
<br />
==About==<br />
<br />
This add-on is the result of a Google [[Summer of Code 2007]] project. It was initially created by [[User:Wojciech|Wojciech Gryc]]. For information pertaining to the development of this add-on, see [http://www.11-55.org/ooblog/ Wojciech's Blog].<br />
<br />
==Older Versions==<br />
<br />
* '''0.1.6''' [http://www.11-55.org/rcalc/2007-08-19/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-08-19/rcalc-0_1_6.zip Source Code])<br />
* '''0.1.5''': [http://www.11-55.org/rcalc/2007-08-16/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-08-16/rcalc-0_1_5.zip Source Code])<br />
* '''0.1.4''': [http://www.11-55.org/rcalc/2007-08-10/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-08-10/rcalc-0_1_4.zip Source Code])<br />
* '''0.1.3''': [http://www.11-55.org/rcalc/2007-08-02/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-08-02/rcalc-0_1_3.zip Source Code])<br />
* '''0.1.2''': [http://www.11-55.org/rcalc/2007-06-01/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-06-01/rcalc-0_1_2.zip Source Code])<br />
* '''0.1.1''': [http://www.11-55.org/rcalc/2007-05-25/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-05-25/rcalc-0_1_1.zip Source Code])<br />
* '''0.1.0''': [http://www.11-55.org/rcalc/2007-05-15/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-05-15/rcalc-0.1.0.zip Source Code])<br />
<br />
[[Category:Calc]]</div>Wojciechhttps://wiki.openoffice.org/w/index.php?title=R_and_Calc&diff=43379R and Calc2007-08-24T03:39:44Z<p>Wojciech: /* Older Versions */</p>
<hr />
<div><blockquote style="background: white; border: 1px solid rgb(153, 153, 153); padding: 1em;">This page is meant as a general overview and installation guide for the software. Please see [[R and Calc Documentation]] for more information on functions, scripting, and general usage.</blockquote><br />
<br />
"R and Calc" is an [[OpenOffice.org]] (OO.o) [[Calc]] add-on that allows you to use [http://www.r-project.org/ R] methods and functions. The software is currently in early development, though a '''basic''' working version does exist, and is available for download.<br />
<br />
We welcome any and all comments and name suggestions. Please send them to [[User:Wojciech|Wojciech Gryc]].<br />
<br />
For those who come here often, here is the latest version:<br />
* '''Version:''' 0.1.7<br />
* '''Release Date:''' August 23, 2007 (10:39 pm EST)<br />
* '''Link:''' http://www.11-55.org/rcalc/2007-08-23/RAddon.uno.pkg<br />
* '''Source Code:''' http://www.11-55.org/rcalc/2007-08-23/rcalc-0_1_7.zip<br />
* '''Manual:''' http://www.11-55.org/rcalc/2007-08-23/manual.pdf<br />
<br />
==Requirements==<br />
<br />
You need the following software to run this add-on. While older versions may suffice, they have not been tested yet.<br />
* OpenOffice.org 2.1<br />
* Java 5.0<br />
* RServe 0.4.7<br />
<br />
==Installing==<br />
<br />
The current version is a prototype and implements only one tool: RDUMP. This method is accessed through the actual Calc menu, and allows you to see the R object structure for various method calls. <br />
<br />
To use the add-on, you need to install R and [http://www.rforge.net/Rserve Rserve]. Instructions for installing R can be found at http://www.r-project.org/ Once installed, run R and type the following to install Rserve. Click "enter" at the end of each bullet point:<br />
<br />
* install.packages("Rserve")<br />
<br />
Rserve needs to be running to work, and can be launched with the following commands... Note that you only need to do this when you want to use the R Add-on for Calc.<br />
<br />
* library(Rserve)<br />
* Rserve()<br />
<br />
Now that you have the prerequisites installed, download the package RAddon.uno.pkg (linked above). Unzip the file, and let's call the directory you unzipped it in <RA_DIR>. Now let <OO_HOME> be your OpenOffice.org installation directory. Open the command prompt or terminal window and go to <OO_HOME>/program/ and type:<br />
<br />
* unopkg add <RA_DIR>/RAddon.uno.pkg<br />
<br />
If this is not your first time installing the add-in, you need to check if a previous version is also on the system. If it is, then you will not be able to install the new version. To do this, go to <OO HOME>/program and type:<br />
<br />
* unopkg list<br />
<br />
This will show you the list of packages already installed, and you should be able to check if the add-is is there. Remember to look for "RAddon.uno.pkg". You can also skip this step and try to uninstall RAddon.uno.pkg regardless -- this will not harm your OpenOffice.org installation in any way, even if RAddon.uno.pkg is abset. To do this, type:<br />
<br />
* unopkg remove RAddon.uno.pkg<br />
<br />
Finally, some operating systems require that you restart your OpenOffice.org installation (if you're not sure, restart your computer) to be able to see the cell functions that come with this package.<br />
<br />
==Using==<br />
<br />
Using the add-on is very simple at this stage. To see the tool at work, open Calc. In the menus, go to R Add-on > Rdump(). A new dialog window will pop up. Type in an R script -- here are some examples:<br />
<br />
* rnorm(10)<br />
* cor.test(c(1,2,3,4), c(1,2,2,3))<br />
<br />
Then click "Run". A new sheet should appear. Close the dialog with "Close" and check the new sheet -- you should see various pieces of information on the sheet.<br />
<br />
==Testing==<br />
<br />
So far, the software has been tested on the following.<br />
<br />
===Version 0.1.5===<br />
<br />
* Fedora Core 7 running native Java<br />
* Ubuntu Edgy Eft running SDK 1.5.0_08 and OpenOffice 2.1.<br />
* Windows XP SP2 running running JDK 1.6.0_02 and OpenOffice 2.2.<br />
<br />
===Version 0.1.0===<br />
<br />
* Fedora Core 6 running JDK 1.6.0_01 and OpenOffice 2.2.<br />
* Ubuntu Edgy Eft running SDK 1.5.0_08 and OpenOffice 2.1.<br />
* Windows XP running running JDK 1.6.0_01 and OpenOffice 2.2.<br />
<br />
==Known Issues==<br />
<br />
Yes, we already have some known issues! That's OK, these are common issues and are not problematic with regards to the code:<br />
<br />
* '''Issue #1 (<font color="red">Fixed in 0.1.1</font>):''' Strings and characters, when part of the R object model, do not get published in Rdump().<br />
* '''Issue #2:''' RDUMP() does not print matrices and frames properly, but prints columns instead.<br />
* '''Issue #3:''' Missing values -- need a good way to deal with missing values. We cannot use a test for non-numeric values because of Factors in R.<br />
<br />
==About==<br />
<br />
This add-on is the result of a Google [[Summer of Code 2007]] project. It was initially created by [[User:Wojciech|Wojciech Gryc]]. For information pertaining to the development of this add-on, see [http://www.11-55.org/ooblog/ Wojciech's Blog].<br />
<br />
==Older Versions==<br />
<br />
* '''0.1.6''' [http://www.11-55.org/rcalc/2007-08-19/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-08-19/rcalc-0_1_6.zip Source Code])<br />
* '''0.1.5''': [http://www.11-55.org/rcalc/2007-08-16/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-08-16/rcalc-0_1_5.zip Source Code])<br />
* '''0.1.4''': [http://www.11-55.org/rcalc/2007-08-10/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-08-10/rcalc-0_1_4.zip Source Code])<br />
* '''0.1.3''': [http://www.11-55.org/rcalc/2007-08-02/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-08-02/rcalc-0_1_3.zip Source Code])<br />
* '''0.1.2''': [http://www.11-55.org/rcalc/2007-06-01/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-06-01/rcalc-0_1_2.zip Source Code])<br />
* '''0.1.1''': [http://www.11-55.org/rcalc/2007-05-25/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-05-25/rcalc-0_1_1.zip Source Code])<br />
* '''0.1.0''': [http://www.11-55.org/rcalc/2007-05-15/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-05-15/rcalc-0.1.0.zip Source Code])<br />
<br />
[[Category:Calc]]</div>Wojciechhttps://wiki.openoffice.org/w/index.php?title=R_and_Calc&diff=43378R and Calc2007-08-24T02:39:30Z<p>Wojciech: </p>
<hr />
<div><blockquote style="background: white; border: 1px solid rgb(153, 153, 153); padding: 1em;">This page is meant as a general overview and installation guide for the software. Please see [[R and Calc Documentation]] for more information on functions, scripting, and general usage.</blockquote><br />
<br />
"R and Calc" is an [[OpenOffice.org]] (OO.o) [[Calc]] add-on that allows you to use [http://www.r-project.org/ R] methods and functions. The software is currently in early development, though a '''basic''' working version does exist, and is available for download.<br />
<br />
We welcome any and all comments and name suggestions. Please send them to [[User:Wojciech|Wojciech Gryc]].<br />
<br />
For those who come here often, here is the latest version:<br />
* '''Version:''' 0.1.7<br />
* '''Release Date:''' August 23, 2007 (10:39 pm EST)<br />
* '''Link:''' http://www.11-55.org/rcalc/2007-08-23/RAddon.uno.pkg<br />
* '''Source Code:''' http://www.11-55.org/rcalc/2007-08-23/rcalc-0_1_7.zip<br />
* '''Manual:''' http://www.11-55.org/rcalc/2007-08-23/manual.pdf<br />
<br />
==Requirements==<br />
<br />
You need the following software to run this add-on. While older versions may suffice, they have not been tested yet.<br />
* OpenOffice.org 2.1<br />
* Java 5.0<br />
* RServe 0.4.7<br />
<br />
==Installing==<br />
<br />
The current version is a prototype and implements only one tool: RDUMP. This method is accessed through the actual Calc menu, and allows you to see the R object structure for various method calls. <br />
<br />
To use the add-on, you need to install R and [http://www.rforge.net/Rserve Rserve]. Instructions for installing R can be found at http://www.r-project.org/ Once installed, run R and type the following to install Rserve. Click "enter" at the end of each bullet point:<br />
<br />
* install.packages("Rserve")<br />
<br />
Rserve needs to be running to work, and can be launched with the following commands... Note that you only need to do this when you want to use the R Add-on for Calc.<br />
<br />
* library(Rserve)<br />
* Rserve()<br />
<br />
Now that you have the prerequisites installed, download the package RAddon.uno.pkg (linked above). Unzip the file, and let's call the directory you unzipped it in <RA_DIR>. Now let <OO_HOME> be your OpenOffice.org installation directory. Open the command prompt or terminal window and go to <OO_HOME>/program/ and type:<br />
<br />
* unopkg add <RA_DIR>/RAddon.uno.pkg<br />
<br />
If this is not your first time installing the add-in, you need to check if a previous version is also on the system. If it is, then you will not be able to install the new version. To do this, go to <OO HOME>/program and type:<br />
<br />
* unopkg list<br />
<br />
This will show you the list of packages already installed, and you should be able to check if the add-is is there. Remember to look for "RAddon.uno.pkg". You can also skip this step and try to uninstall RAddon.uno.pkg regardless -- this will not harm your OpenOffice.org installation in any way, even if RAddon.uno.pkg is abset. To do this, type:<br />
<br />
* unopkg remove RAddon.uno.pkg<br />
<br />
Finally, some operating systems require that you restart your OpenOffice.org installation (if you're not sure, restart your computer) to be able to see the cell functions that come with this package.<br />
<br />
==Using==<br />
<br />
Using the add-on is very simple at this stage. To see the tool at work, open Calc. In the menus, go to R Add-on > Rdump(). A new dialog window will pop up. Type in an R script -- here are some examples:<br />
<br />
* rnorm(10)<br />
* cor.test(c(1,2,3,4), c(1,2,2,3))<br />
<br />
Then click "Run". A new sheet should appear. Close the dialog with "Close" and check the new sheet -- you should see various pieces of information on the sheet.<br />
<br />
==Testing==<br />
<br />
So far, the software has been tested on the following.<br />
<br />
===Version 0.1.5===<br />
<br />
* Fedora Core 7 running native Java<br />
* Ubuntu Edgy Eft running SDK 1.5.0_08 and OpenOffice 2.1.<br />
* Windows XP SP2 running running JDK 1.6.0_02 and OpenOffice 2.2.<br />
<br />
===Version 0.1.0===<br />
<br />
* Fedora Core 6 running JDK 1.6.0_01 and OpenOffice 2.2.<br />
* Ubuntu Edgy Eft running SDK 1.5.0_08 and OpenOffice 2.1.<br />
* Windows XP running running JDK 1.6.0_01 and OpenOffice 2.2.<br />
<br />
==Known Issues==<br />
<br />
Yes, we already have some known issues! That's OK, these are common issues and are not problematic with regards to the code:<br />
<br />
* '''Issue #1 (<font color="red">Fixed in 0.1.1</font>):''' Strings and characters, when part of the R object model, do not get published in Rdump().<br />
* '''Issue #2:''' RDUMP() does not print matrices and frames properly, but prints columns instead.<br />
* '''Issue #3:''' Missing values -- need a good way to deal with missing values. We cannot use a test for non-numeric values because of Factors in R.<br />
<br />
==About==<br />
<br />
This add-on is the result of a Google [[Summer of Code 2007]] project. It was initially created by [[User:Wojciech|Wojciech Gryc]]. For information pertaining to the development of this add-on, see [http://www.11-55.org/ooblog/ Wojciech's Blog].<br />
<br />
==Older Versions==<br />
<br />
* '''0.1.6'' [http://www.11-55.org/rcalc/2007-08-19/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-08-19/rcalc-0_1_6.zip Source Code])<br />
* '''0.1.5''': [http://www.11-55.org/rcalc/2007-08-16/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-08-16/rcalc-0_1_5.zip Source Code])<br />
* '''0.1.4''': [http://www.11-55.org/rcalc/2007-08-10/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-08-10/rcalc-0_1_4.zip Source Code])<br />
* '''0.1.3''': [http://www.11-55.org/rcalc/2007-08-02/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-08-02/rcalc-0_1_3.zip Source Code])<br />
* '''0.1.2''': [http://www.11-55.org/rcalc/2007-06-01/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-06-01/rcalc-0_1_2.zip Source Code])<br />
* '''0.1.1''': [http://www.11-55.org/rcalc/2007-05-25/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-05-25/rcalc-0_1_1.zip Source Code])<br />
* '''0.1.0''': [http://www.11-55.org/rcalc/2007-05-15/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-05-15/rcalc-0.1.0.zip Source Code])<br />
<br />
[[Category:Calc]]</div>Wojciechhttps://wiki.openoffice.org/w/index.php?title=R_and_Calc&diff=43377R and Calc2007-08-24T02:39:19Z<p>Wojciech: </p>
<hr />
<div><blockquote style="background: white; border: 1px solid rgb(153, 153, 153); padding: 1em;">This page is meant as a general overview and installation guide for the software. Please see [[R and Calc Documentation]] for more information on functions, scripting, and general usage.</blockquote><br />
<br />
"R and Calc" is an [[OpenOffice.org]] (OO.o) [[Calc]] add-on that allows you to use [http://www.r-project.org/ R] methods and functions. The software is currently in early development, though a '''basic''' working version does exist, and is available for download.<br />
<br />
We welcome any and all comments and name suggestions. Please send them to [[User:Wojciech|Wojciech Gryc]].<br />
<br />
For those who come here often, here is the latest version:<br />
* '''Version:''' 0.1.6<br />
* '''Release Date:''' August 23, 2007 (10:39 pm EST)<br />
* '''Link:''' http://www.11-55.org/rcalc/2007-08-23/RAddon.uno.pkg<br />
* '''Source Code:''' http://www.11-55.org/rcalc/2007-08-23/rcalc-0_1_7.zip<br />
* '''Manual:''' http://www.11-55.org/rcalc/2007-08-23/manual.pdf<br />
<br />
==Requirements==<br />
<br />
You need the following software to run this add-on. While older versions may suffice, they have not been tested yet.<br />
* OpenOffice.org 2.1<br />
* Java 5.0<br />
* RServe 0.4.7<br />
<br />
==Installing==<br />
<br />
The current version is a prototype and implements only one tool: RDUMP. This method is accessed through the actual Calc menu, and allows you to see the R object structure for various method calls. <br />
<br />
To use the add-on, you need to install R and [http://www.rforge.net/Rserve Rserve]. Instructions for installing R can be found at http://www.r-project.org/ Once installed, run R and type the following to install Rserve. Click "enter" at the end of each bullet point:<br />
<br />
* install.packages("Rserve")<br />
<br />
Rserve needs to be running to work, and can be launched with the following commands... Note that you only need to do this when you want to use the R Add-on for Calc.<br />
<br />
* library(Rserve)<br />
* Rserve()<br />
<br />
Now that you have the prerequisites installed, download the package RAddon.uno.pkg (linked above). Unzip the file, and let's call the directory you unzipped it in <RA_DIR>. Now let <OO_HOME> be your OpenOffice.org installation directory. Open the command prompt or terminal window and go to <OO_HOME>/program/ and type:<br />
<br />
* unopkg add <RA_DIR>/RAddon.uno.pkg<br />
<br />
If this is not your first time installing the add-in, you need to check if a previous version is also on the system. If it is, then you will not be able to install the new version. To do this, go to <OO HOME>/program and type:<br />
<br />
* unopkg list<br />
<br />
This will show you the list of packages already installed, and you should be able to check if the add-is is there. Remember to look for "RAddon.uno.pkg". You can also skip this step and try to uninstall RAddon.uno.pkg regardless -- this will not harm your OpenOffice.org installation in any way, even if RAddon.uno.pkg is abset. To do this, type:<br />
<br />
* unopkg remove RAddon.uno.pkg<br />
<br />
Finally, some operating systems require that you restart your OpenOffice.org installation (if you're not sure, restart your computer) to be able to see the cell functions that come with this package.<br />
<br />
==Using==<br />
<br />
Using the add-on is very simple at this stage. To see the tool at work, open Calc. In the menus, go to R Add-on > Rdump(). A new dialog window will pop up. Type in an R script -- here are some examples:<br />
<br />
* rnorm(10)<br />
* cor.test(c(1,2,3,4), c(1,2,2,3))<br />
<br />
Then click "Run". A new sheet should appear. Close the dialog with "Close" and check the new sheet -- you should see various pieces of information on the sheet.<br />
<br />
==Testing==<br />
<br />
So far, the software has been tested on the following.<br />
<br />
===Version 0.1.5===<br />
<br />
* Fedora Core 7 running native Java<br />
* Ubuntu Edgy Eft running SDK 1.5.0_08 and OpenOffice 2.1.<br />
* Windows XP SP2 running running JDK 1.6.0_02 and OpenOffice 2.2.<br />
<br />
===Version 0.1.0===<br />
<br />
* Fedora Core 6 running JDK 1.6.0_01 and OpenOffice 2.2.<br />
* Ubuntu Edgy Eft running SDK 1.5.0_08 and OpenOffice 2.1.<br />
* Windows XP running running JDK 1.6.0_01 and OpenOffice 2.2.<br />
<br />
==Known Issues==<br />
<br />
Yes, we already have some known issues! That's OK, these are common issues and are not problematic with regards to the code:<br />
<br />
* '''Issue #1 (<font color="red">Fixed in 0.1.1</font>):''' Strings and characters, when part of the R object model, do not get published in Rdump().<br />
* '''Issue #2:''' RDUMP() does not print matrices and frames properly, but prints columns instead.<br />
* '''Issue #3:''' Missing values -- need a good way to deal with missing values. We cannot use a test for non-numeric values because of Factors in R.<br />
<br />
==About==<br />
<br />
This add-on is the result of a Google [[Summer of Code 2007]] project. It was initially created by [[User:Wojciech|Wojciech Gryc]]. For information pertaining to the development of this add-on, see [http://www.11-55.org/ooblog/ Wojciech's Blog].<br />
<br />
==Older Versions==<br />
<br />
* '''0.1.6'' [http://www.11-55.org/rcalc/2007-08-19/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-08-19/rcalc-0_1_6.zip Source Code])<br />
* '''0.1.5''': [http://www.11-55.org/rcalc/2007-08-16/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-08-16/rcalc-0_1_5.zip Source Code])<br />
* '''0.1.4''': [http://www.11-55.org/rcalc/2007-08-10/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-08-10/rcalc-0_1_4.zip Source Code])<br />
* '''0.1.3''': [http://www.11-55.org/rcalc/2007-08-02/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-08-02/rcalc-0_1_3.zip Source Code])<br />
* '''0.1.2''': [http://www.11-55.org/rcalc/2007-06-01/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-06-01/rcalc-0_1_2.zip Source Code])<br />
* '''0.1.1''': [http://www.11-55.org/rcalc/2007-05-25/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-05-25/rcalc-0_1_1.zip Source Code])<br />
* '''0.1.0''': [http://www.11-55.org/rcalc/2007-05-15/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-05-15/rcalc-0.1.0.zip Source Code])<br />
<br />
[[Category:Calc]]</div>Wojciechhttps://wiki.openoffice.org/w/index.php?title=R_and_Calc&diff=43037R and Calc2007-08-20T05:43:38Z<p>Wojciech: /* Older Versions */</p>
<hr />
<div><blockquote style="background: white; border: 1px solid rgb(153, 153, 153); padding: 1em;">This page is meant as a general overview and installation guide for the software. Please see [[R and Calc Documentation]] for more information on functions, scripting, and general usage.</blockquote><br />
<br />
"R and Calc" is an [[OpenOffice.org]] (OO.o) [[Calc]] add-on that allows you to use [http://www.r-project.org/ R] methods and functions. The software is currently in early development, though a '''basic''' working version does exist, and is available for download.<br />
<br />
We welcome any and all comments and name suggestions. Please send them to [[User:Wojciech|Wojciech Gryc]].<br />
<br />
For those who come here often, here is the latest version:<br />
* '''Version:''' 0.1.6<br />
* '''Release Date:''' August 20, 2007 (1:38 am EST)<br />
* '''Link:''' http://www.11-55.org/rcalc/2007-08-19/RAddon.uno.pkg<br />
* '''Source Code:''' http://www.11-55.org/rcalc/2007-08-19/rcalc-0_1_6.zip<br />
* '''Manual:''' http://www.11-55.org/rcalc/2007-08-19/manual.pdf<br />
<br />
==Requirements==<br />
<br />
You need the following software to run this add-on. While older versions may suffice, they have not been tested yet.<br />
* OpenOffice.org 2.1<br />
* Java 5.0<br />
* RServe 0.4.7<br />
<br />
==Installing==<br />
<br />
The current version is a prototype and implements only one tool: RDUMP. This method is accessed through the actual Calc menu, and allows you to see the R object structure for various method calls. <br />
<br />
To use the add-on, you need to install R and [http://www.rforge.net/Rserve Rserve]. Instructions for installing R can be found at http://www.r-project.org/ Once installed, run R and type the following to install Rserve. Click "enter" at the end of each bullet point:<br />
<br />
* install.packages("Rserve")<br />
<br />
Rserve needs to be running to work, and can be launched with the following commands... Note that you only need to do this when you want to use the R Add-on for Calc.<br />
<br />
* library(Rserve)<br />
* Rserve()<br />
<br />
Now that you have the prerequisites installed, download the package RAddon.uno.pkg (linked above). Unzip the file, and let's call the directory you unzipped it in <RA_DIR>. Now let <OO_HOME> be your OpenOffice.org installation directory. Open the command prompt or terminal window and go to <OO_HOME>/program/ and type:<br />
<br />
* unopkg add <RA_DIR>/RAddon.uno.pkg<br />
<br />
If this is not your first time installing the add-in, you need to check if a previous version is also on the system. If it is, then you will not be able to install the new version. To do this, go to <OO HOME>/program and type:<br />
<br />
* unopkg list<br />
<br />
This will show you the list of packages already installed, and you should be able to check if the add-is is there. Remember to look for "RAddon.uno.pkg". You can also skip this step and try to uninstall RAddon.uno.pkg regardless -- this will not harm your OpenOffice.org installation in any way, even if RAddon.uno.pkg is abset. To do this, type:<br />
<br />
* unopkg remove RAddon.uno.pkg<br />
<br />
Finally, some operating systems require that you restart your OpenOffice.org installation (if you're not sure, restart your computer) to be able to see the cell functions that come with this package.<br />
<br />
==Using==<br />
<br />
Using the add-on is very simple at this stage. To see the tool at work, open Calc. In the menus, go to R Add-on > Rdump(). A new dialog window will pop up. Type in an R script -- here are some examples:<br />
<br />
* rnorm(10)<br />
* cor.test(c(1,2,3,4), c(1,2,2,3))<br />
<br />
Then click "Run". A new sheet should appear. Close the dialog with "Close" and check the new sheet -- you should see various pieces of information on the sheet.<br />
<br />
==Testing==<br />
<br />
So far, the software has been tested on the following.<br />
<br />
===Version 0.1.5===<br />
<br />
* Fedora Core 7 running native Java<br />
* Ubuntu Edgy Eft running SDK 1.5.0_08 and OpenOffice 2.1.<br />
* Windows XP SP2 running running JDK 1.6.0_02 and OpenOffice 2.2.<br />
<br />
===Version 0.1.0===<br />
<br />
* Fedora Core 6 running JDK 1.6.0_01 and OpenOffice 2.2.<br />
* Ubuntu Edgy Eft running SDK 1.5.0_08 and OpenOffice 2.1.<br />
* Windows XP running running JDK 1.6.0_01 and OpenOffice 2.2.<br />
<br />
==Known Issues==<br />
<br />
Yes, we already have some known issues! That's OK, these are common issues and are not problematic with regards to the code:<br />
<br />
* '''Issue #1 (<font color="red">Fixed in 0.1.1</font>):''' Strings and characters, when part of the R object model, do not get published in Rdump().<br />
* '''Issue #2:''' RDUMP() does not print matrices and frames properly, but prints columns instead.<br />
* '''Issue #3:''' Missing values -- need a good way to deal with missing values. We cannot use a test for non-numeric values because of Factors in R.<br />
<br />
==About==<br />
<br />
This add-on is the result of a Google [[Summer of Code 2007]] project. It was initially created by [[User:Wojciech|Wojciech Gryc]]. For information pertaining to the development of this add-on, see [http://www.11-55.org/ooblog/ Wojciech's Blog].<br />
<br />
==Older Versions==<br />
<br />
* '''0.1.5''': [http://www.11-55.org/rcalc/2007-08-16/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-08-16/rcalc-0_1_5.zip Source Code])<br />
* '''0.1.4''': [http://www.11-55.org/rcalc/2007-08-10/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-08-10/rcalc-0_1_4.zip Source Code])<br />
* '''0.1.3''': [http://www.11-55.org/rcalc/2007-08-02/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-08-02/rcalc-0_1_3.zip Source Code])<br />
* '''0.1.2''': [http://www.11-55.org/rcalc/2007-06-01/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-06-01/rcalc-0_1_2.zip Source Code])<br />
* '''0.1.1''': [http://www.11-55.org/rcalc/2007-05-25/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-05-25/rcalc-0_1_1.zip Source Code])<br />
* '''0.1.0''': [http://www.11-55.org/rcalc/2007-05-15/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-05-15/rcalc-0.1.0.zip Source Code])<br />
<br />
[[Category:Calc]]</div>Wojciechhttps://wiki.openoffice.org/w/index.php?title=R_and_Calc&diff=43036R and Calc2007-08-20T05:40:05Z<p>Wojciech: </p>
<hr />
<div><blockquote style="background: white; border: 1px solid rgb(153, 153, 153); padding: 1em;">This page is meant as a general overview and installation guide for the software. Please see [[R and Calc Documentation]] for more information on functions, scripting, and general usage.</blockquote><br />
<br />
"R and Calc" is an [[OpenOffice.org]] (OO.o) [[Calc]] add-on that allows you to use [http://www.r-project.org/ R] methods and functions. The software is currently in early development, though a '''basic''' working version does exist, and is available for download.<br />
<br />
We welcome any and all comments and name suggestions. Please send them to [[User:Wojciech|Wojciech Gryc]].<br />
<br />
For those who come here often, here is the latest version:<br />
* '''Version:''' 0.1.6<br />
* '''Release Date:''' August 20, 2007 (1:38 am EST)<br />
* '''Link:''' http://www.11-55.org/rcalc/2007-08-19/RAddon.uno.pkg<br />
* '''Source Code:''' http://www.11-55.org/rcalc/2007-08-19/rcalc-0_1_6.zip<br />
* '''Manual:''' http://www.11-55.org/rcalc/2007-08-19/manual.pdf<br />
<br />
==Requirements==<br />
<br />
You need the following software to run this add-on. While older versions may suffice, they have not been tested yet.<br />
* OpenOffice.org 2.1<br />
* Java 5.0<br />
* RServe 0.4.7<br />
<br />
==Installing==<br />
<br />
The current version is a prototype and implements only one tool: RDUMP. This method is accessed through the actual Calc menu, and allows you to see the R object structure for various method calls. <br />
<br />
To use the add-on, you need to install R and [http://www.rforge.net/Rserve Rserve]. Instructions for installing R can be found at http://www.r-project.org/ Once installed, run R and type the following to install Rserve. Click "enter" at the end of each bullet point:<br />
<br />
* install.packages("Rserve")<br />
<br />
Rserve needs to be running to work, and can be launched with the following commands... Note that you only need to do this when you want to use the R Add-on for Calc.<br />
<br />
* library(Rserve)<br />
* Rserve()<br />
<br />
Now that you have the prerequisites installed, download the package RAddon.uno.pkg (linked above). Unzip the file, and let's call the directory you unzipped it in <RA_DIR>. Now let <OO_HOME> be your OpenOffice.org installation directory. Open the command prompt or terminal window and go to <OO_HOME>/program/ and type:<br />
<br />
* unopkg add <RA_DIR>/RAddon.uno.pkg<br />
<br />
If this is not your first time installing the add-in, you need to check if a previous version is also on the system. If it is, then you will not be able to install the new version. To do this, go to <OO HOME>/program and type:<br />
<br />
* unopkg list<br />
<br />
This will show you the list of packages already installed, and you should be able to check if the add-is is there. Remember to look for "RAddon.uno.pkg". You can also skip this step and try to uninstall RAddon.uno.pkg regardless -- this will not harm your OpenOffice.org installation in any way, even if RAddon.uno.pkg is abset. To do this, type:<br />
<br />
* unopkg remove RAddon.uno.pkg<br />
<br />
Finally, some operating systems require that you restart your OpenOffice.org installation (if you're not sure, restart your computer) to be able to see the cell functions that come with this package.<br />
<br />
==Using==<br />
<br />
Using the add-on is very simple at this stage. To see the tool at work, open Calc. In the menus, go to R Add-on > Rdump(). A new dialog window will pop up. Type in an R script -- here are some examples:<br />
<br />
* rnorm(10)<br />
* cor.test(c(1,2,3,4), c(1,2,2,3))<br />
<br />
Then click "Run". A new sheet should appear. Close the dialog with "Close" and check the new sheet -- you should see various pieces of information on the sheet.<br />
<br />
==Testing==<br />
<br />
So far, the software has been tested on the following.<br />
<br />
===Version 0.1.5===<br />
<br />
* Fedora Core 7 running native Java<br />
* Ubuntu Edgy Eft running SDK 1.5.0_08 and OpenOffice 2.1.<br />
* Windows XP SP2 running running JDK 1.6.0_02 and OpenOffice 2.2.<br />
<br />
===Version 0.1.0===<br />
<br />
* Fedora Core 6 running JDK 1.6.0_01 and OpenOffice 2.2.<br />
* Ubuntu Edgy Eft running SDK 1.5.0_08 and OpenOffice 2.1.<br />
* Windows XP running running JDK 1.6.0_01 and OpenOffice 2.2.<br />
<br />
==Known Issues==<br />
<br />
Yes, we already have some known issues! That's OK, these are common issues and are not problematic with regards to the code:<br />
<br />
* '''Issue #1 (<font color="red">Fixed in 0.1.1</font>):''' Strings and characters, when part of the R object model, do not get published in Rdump().<br />
* '''Issue #2:''' RDUMP() does not print matrices and frames properly, but prints columns instead.<br />
* '''Issue #3:''' Missing values -- need a good way to deal with missing values. We cannot use a test for non-numeric values because of Factors in R.<br />
<br />
==About==<br />
<br />
This add-on is the result of a Google [[Summer of Code 2007]] project. It was initially created by [[User:Wojciech|Wojciech Gryc]]. For information pertaining to the development of this add-on, see [http://www.11-55.org/ooblog/ Wojciech's Blog].<br />
<br />
==Older Versions==<br />
<br />
* '''0.1.5''': [http://www.11-55.org/rcalc/2007-08-16/RAddon.uno.pkg UNO Package ([http://www.11-55.org/rcalc/2007-08-16/rcalc-0_1_5.zip Source Code])<br />
* '''0.1.4''': [http://www.11-55.org/rcalc/2007-08-10/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-08-10/rcalc-0_1_4.zip Source Code])<br />
* '''0.1.3''': [http://www.11-55.org/rcalc/2007-08-02/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-08-02/rcalc-0_1_3.zip Source Code])<br />
* '''0.1.2''': [http://www.11-55.org/rcalc/2007-06-01/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-06-01/rcalc-0_1_2.zip Source Code])<br />
* '''0.1.1''': [http://www.11-55.org/rcalc/2007-05-25/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-05-25/rcalc-0_1_1.zip Source Code])<br />
* '''0.1.0''': [http://www.11-55.org/rcalc/2007-05-15/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-05-15/rcalc-0.1.0.zip Source Code])<br />
<br />
[[Category:Calc]]</div>Wojciechhttps://wiki.openoffice.org/w/index.php?title=R_and_Calc&diff=42995R and Calc2007-08-19T01:37:22Z<p>Wojciech: /* Testing */</p>
<hr />
<div><blockquote style="background: white; border: 1px solid rgb(153, 153, 153); padding: 1em;">This page is meant as a general overview and installation guide for the software. Please see [[R and Calc Documentation]] for more information on functions, scripting, and general usage.</blockquote><br />
<br />
"R and Calc" is an [[OpenOffice.org]] (OO.o) [[Calc]] add-on that allows you to use [http://www.r-project.org/ R] methods and functions. The software is currently in early development, though a '''basic''' working version does exist, and is available for download.<br />
<br />
We welcome any and all comments and name suggestions. Please send them to [[User:Wojciech|Wojciech Gryc]].<br />
<br />
For those who come here often, here is the latest version:<br />
* '''Version:''' 0.1.5<br />
* '''Release Date:''' August 16, 2007 (10:51 pm EST)<br />
* '''Link:''' http://www.11-55.org/rcalc/2007-08-16/RAddon.uno.pkg<br />
* '''Source Code:''' http://www.11-55.org/rcalc/2007-08-16/rcalc-0_1_5.zip<br />
* '''Manual:''' http://www.11-55.org/rcalc/2007-08-16/manual.pdf<br />
<br />
==Requirements==<br />
<br />
You need the following software to run this add-on. While older versions may suffice, they have not been tested yet.<br />
* OpenOffice.org 2.1<br />
* Java 5.0<br />
* RServe 0.4.7<br />
<br />
==Installing==<br />
<br />
The current version is a prototype and implements only one tool: RDUMP. This method is accessed through the actual Calc menu, and allows you to see the R object structure for various method calls. <br />
<br />
To use the add-on, you need to install R and [http://www.rforge.net/Rserve Rserve]. Instructions for installing R can be found at http://www.r-project.org/ Once installed, run R and type the following to install Rserve. Click "enter" at the end of each bullet point:<br />
<br />
* install.packages("Rserve")<br />
<br />
Rserve needs to be running to work, and can be launched with the following commands... Note that you only need to do this when you want to use the R Add-on for Calc.<br />
<br />
* library(Rserve)<br />
* Rserve()<br />
<br />
Now that you have the prerequisites installed, download the package RAddon.uno.pkg (linked above). Unzip the file, and let's call the directory you unzipped it in <RA_DIR>. Now let <OO_HOME> be your OpenOffice.org installation directory. Open the command prompt or terminal window and go to <OO_HOME>/program/ and type:<br />
<br />
* unopkg add <RA_DIR>/RAddon.uno.pkg<br />
<br />
If this is not your first time installing the add-in, you need to check if a previous version is also on the system. If it is, then you will not be able to install the new version. To do this, go to <OO HOME>/program and type:<br />
<br />
* unopkg list<br />
<br />
This will show you the list of packages already installed, and you should be able to check if the add-is is there. Remember to look for "RAddon.uno.pkg". You can also skip this step and try to uninstall RAddon.uno.pkg regardless -- this will not harm your OpenOffice.org installation in any way, even if RAddon.uno.pkg is abset. To do this, type:<br />
<br />
* unopkg remove RAddon.uno.pkg<br />
<br />
Finally, some operating systems require that you restart your OpenOffice.org installation (if you're not sure, restart your computer) to be able to see the cell functions that come with this package.<br />
<br />
==Using==<br />
<br />
Using the add-on is very simple at this stage. To see the tool at work, open Calc. In the menus, go to R Add-on > Rdump(). A new dialog window will pop up. Type in an R script -- here are some examples:<br />
<br />
* rnorm(10)<br />
* cor.test(c(1,2,3,4), c(1,2,2,3))<br />
<br />
Then click "Run". A new sheet should appear. Close the dialog with "Close" and check the new sheet -- you should see various pieces of information on the sheet.<br />
<br />
==Testing==<br />
<br />
So far, the software has been tested on the following.<br />
<br />
===Version 0.1.5===<br />
<br />
* Fedora Core 7 running native Java<br />
* Ubuntu Edgy Eft running SDK 1.5.0_08 and OpenOffice 2.1.<br />
* Windows XP SP2 running running JDK 1.6.0_02 and OpenOffice 2.2.<br />
<br />
===Version 0.1.0===<br />
<br />
* Fedora Core 6 running JDK 1.6.0_01 and OpenOffice 2.2.<br />
* Ubuntu Edgy Eft running SDK 1.5.0_08 and OpenOffice 2.1.<br />
* Windows XP running running JDK 1.6.0_01 and OpenOffice 2.2.<br />
<br />
==Known Issues==<br />
<br />
Yes, we already have some known issues! That's OK, these are common issues and are not problematic with regards to the code:<br />
<br />
* '''Issue #1 (<font color="red">Fixed in 0.1.1</font>):''' Strings and characters, when part of the R object model, do not get published in Rdump().<br />
* '''Issue #2:''' RDUMP() does not print matrices and frames properly, but prints columns instead.<br />
* '''Issue #3:''' Missing values -- need a good way to deal with missing values. We cannot use a test for non-numeric values because of Factors in R.<br />
<br />
==About==<br />
<br />
This add-on is the result of a Google [[Summer of Code 2007]] project. It was initially created by [[User:Wojciech|Wojciech Gryc]]. For information pertaining to the development of this add-on, see [http://www.11-55.org/ooblog/ Wojciech's Blog].<br />
<br />
==Older Versions==<br />
<br />
* '''0.1.4''': [http://www.11-55.org/rcalc/2007-08-10/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-08-10/rcalc-0_1_4.zip Source Code])<br />
* '''0.1.3''': [http://www.11-55.org/rcalc/2007-08-02/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-08-02/rcalc-0_1_3.zip Source Code])<br />
* '''0.1.2''': [http://www.11-55.org/rcalc/2007-06-01/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-06-01/rcalc-0_1_2.zip Source Code])<br />
* '''0.1.1''': [http://www.11-55.org/rcalc/2007-05-25/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-05-25/rcalc-0_1_1.zip Source Code])<br />
* '''0.1.0''': [http://www.11-55.org/rcalc/2007-05-15/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-05-15/rcalc-0.1.0.zip Source Code])<br />
<br />
[[Category:Calc]]</div>Wojciechhttps://wiki.openoffice.org/w/index.php?title=R_and_Calc&diff=42720R and Calc2007-08-17T02:52:54Z<p>Wojciech: </p>
<hr />
<div><blockquote style="background: white; border: 1px solid rgb(153, 153, 153); padding: 1em;">This page is meant as a general overview and installation guide for the software. Please see [[R and Calc Documentation]] for more information on functions, scripting, and general usage.</blockquote><br />
<br />
"R and Calc" is an [[OpenOffice.org]] (OO.o) [[Calc]] add-on that allows you to use [http://www.r-project.org/ R] methods and functions. The software is currently in early development, though a '''basic''' working version does exist, and is available for download.<br />
<br />
We welcome any and all comments and name suggestions. Please send them to [[User:Wojciech|Wojciech Gryc]].<br />
<br />
For those who come here often, here is the latest version:<br />
* '''Version:''' 0.1.5<br />
* '''Release Date:''' August 16, 2007 (10:51 pm EST)<br />
* '''Link:''' http://www.11-55.org/rcalc/2007-08-16/RAddon.uno.pkg<br />
* '''Source Code:''' http://www.11-55.org/rcalc/2007-08-16/rcalc-0_1_5.zip<br />
* '''Manual:''' http://www.11-55.org/rcalc/2007-08-16/manual.pdf<br />
<br />
==Requirements==<br />
<br />
You need the following software to run this add-on. While older versions may suffice, they have not been tested yet.<br />
* OpenOffice.org 2.1<br />
* Java 5.0<br />
* RServe 0.4.7<br />
<br />
==Installing==<br />
<br />
The current version is a prototype and implements only one tool: RDUMP. This method is accessed through the actual Calc menu, and allows you to see the R object structure for various method calls. <br />
<br />
To use the add-on, you need to install R and [http://www.rforge.net/Rserve Rserve]. Instructions for installing R can be found at http://www.r-project.org/ Once installed, run R and type the following to install Rserve. Click "enter" at the end of each bullet point:<br />
<br />
* install.packages("Rserve")<br />
<br />
Rserve needs to be running to work, and can be launched with the following commands... Note that you only need to do this when you want to use the R Add-on for Calc.<br />
<br />
* library(Rserve)<br />
* Rserve()<br />
<br />
Now that you have the prerequisites installed, download the package RAddon.uno.pkg (linked above). Unzip the file, and let's call the directory you unzipped it in <RA_DIR>. Now let <OO_HOME> be your OpenOffice.org installation directory. Open the command prompt or terminal window and go to <OO_HOME>/program/ and type:<br />
<br />
* unopkg add <RA_DIR>/RAddon.uno.pkg<br />
<br />
If this is not your first time installing the add-in, you need to check if a previous version is also on the system. If it is, then you will not be able to install the new version. To do this, go to <OO HOME>/program and type:<br />
<br />
* unopkg list<br />
<br />
This will show you the list of packages already installed, and you should be able to check if the add-is is there. Remember to look for "RAddon.uno.pkg". You can also skip this step and try to uninstall RAddon.uno.pkg regardless -- this will not harm your OpenOffice.org installation in any way, even if RAddon.uno.pkg is abset. To do this, type:<br />
<br />
* unopkg remove RAddon.uno.pkg<br />
<br />
Finally, some operating systems require that you restart your OpenOffice.org installation (if you're not sure, restart your computer) to be able to see the cell functions that come with this package.<br />
<br />
==Using==<br />
<br />
Using the add-on is very simple at this stage. To see the tool at work, open Calc. In the menus, go to R Add-on > Rdump(). A new dialog window will pop up. Type in an R script -- here are some examples:<br />
<br />
* rnorm(10)<br />
* cor.test(c(1,2,3,4), c(1,2,2,3))<br />
<br />
Then click "Run". A new sheet should appear. Close the dialog with "Close" and check the new sheet -- you should see various pieces of information on the sheet.<br />
<br />
==Testing==<br />
<br />
So far, the software has been tested on the following.<br />
<br />
===Version 0.1.0===<br />
<br />
* Fedora Core 6 running JDK 1.6.0_01 and OpenOffice 2.2.<br />
* Ubuntu Edgy Eft running SDK 1.5.0_08 and OpenOffice 2.1.<br />
* Windows XP running running JDK 1.6.0_01 and OpenOffice 2.2.<br />
<br />
==Known Issues==<br />
<br />
Yes, we already have some known issues! That's OK, these are common issues and are not problematic with regards to the code:<br />
<br />
* '''Issue #1 (<font color="red">Fixed in 0.1.1</font>):''' Strings and characters, when part of the R object model, do not get published in Rdump().<br />
* '''Issue #2:''' RDUMP() does not print matrices and frames properly, but prints columns instead.<br />
* '''Issue #3:''' Missing values -- need a good way to deal with missing values. We cannot use a test for non-numeric values because of Factors in R.<br />
<br />
==About==<br />
<br />
This add-on is the result of a Google [[Summer of Code 2007]] project. It was initially created by [[User:Wojciech|Wojciech Gryc]]. For information pertaining to the development of this add-on, see [http://www.11-55.org/ooblog/ Wojciech's Blog].<br />
<br />
==Older Versions==<br />
<br />
* '''0.1.4''': [http://www.11-55.org/rcalc/2007-08-10/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-08-10/rcalc-0_1_4.zip Source Code])<br />
* '''0.1.3''': [http://www.11-55.org/rcalc/2007-08-02/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-08-02/rcalc-0_1_3.zip Source Code])<br />
* '''0.1.2''': [http://www.11-55.org/rcalc/2007-06-01/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-06-01/rcalc-0_1_2.zip Source Code])<br />
* '''0.1.1''': [http://www.11-55.org/rcalc/2007-05-25/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-05-25/rcalc-0_1_1.zip Source Code])<br />
* '''0.1.0''': [http://www.11-55.org/rcalc/2007-05-15/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-05-15/rcalc-0.1.0.zip Source Code])<br />
<br />
[[Category:Calc]]</div>Wojciechhttps://wiki.openoffice.org/w/index.php?title=R_and_Calc&diff=42719R and Calc2007-08-17T02:51:59Z<p>Wojciech: </p>
<hr />
<div><blockquote style="background: white; border: 1px solid rgb(153, 153, 153); padding: 1em;">This page is meant as a general overview and installation guide for the software. Please see [[R and Calc Documentation]] for more information on functions, scripting, and general usage.</blockquote><br />
<br />
"R and Calc" is an [[OpenOffice.org]] (OO.o) [[Calc]] add-on that allows you to use [http://www.r-project.org/ R] methods and functions. The software is currently in early development, though a '''basic''' working version does exist, and is available for download.<br />
<br />
We welcome any and all comments and name suggestions. Please send them to [[User:Wojciech|Wojciech Gryc]].<br />
<br />
For those who come here often, here is the latest version:<br />
* '''Version:''' 0.1.5<br />
* '''Release Date:''' August 16, 2007 (10:51 pm EST)<br />
* '''Link:''' http://www.11-55.org/rcalc/2007-08-16/RAddon.uno.pkg<br />
* '''Source Code:''' http://www.11-55.org/rcalc/2007-08-16/rcalc-0_1_4.zip<br />
* '''Manual:''' http://www.11-55.org/rcalc/2007-08-16/manual.pdf<br />
<br />
==Requirements==<br />
<br />
You need the following software to run this add-on. While older versions may suffice, they have not been tested yet.<br />
* OpenOffice.org 2.1<br />
* Java 5.0<br />
* RServe 0.4.7<br />
<br />
==Installing==<br />
<br />
The current version is a prototype and implements only one tool: RDUMP. This method is accessed through the actual Calc menu, and allows you to see the R object structure for various method calls. <br />
<br />
To use the add-on, you need to install R and [http://www.rforge.net/Rserve Rserve]. Instructions for installing R can be found at http://www.r-project.org/ Once installed, run R and type the following to install Rserve. Click "enter" at the end of each bullet point:<br />
<br />
* install.packages("Rserve")<br />
<br />
Rserve needs to be running to work, and can be launched with the following commands... Note that you only need to do this when you want to use the R Add-on for Calc.<br />
<br />
* library(Rserve)<br />
* Rserve()<br />
<br />
Now that you have the prerequisites installed, download the package RAddon.uno.pkg (linked above). Unzip the file, and let's call the directory you unzipped it in <RA_DIR>. Now let <OO_HOME> be your OpenOffice.org installation directory. Open the command prompt or terminal window and go to <OO_HOME>/program/ and type:<br />
<br />
* unopkg add <RA_DIR>/RAddon.uno.pkg<br />
<br />
If this is not your first time installing the add-in, you need to check if a previous version is also on the system. If it is, then you will not be able to install the new version. To do this, go to <OO HOME>/program and type:<br />
<br />
* unopkg list<br />
<br />
This will show you the list of packages already installed, and you should be able to check if the add-is is there. Remember to look for "RAddon.uno.pkg". You can also skip this step and try to uninstall RAddon.uno.pkg regardless -- this will not harm your OpenOffice.org installation in any way, even if RAddon.uno.pkg is abset. To do this, type:<br />
<br />
* unopkg remove RAddon.uno.pkg<br />
<br />
Finally, some operating systems require that you restart your OpenOffice.org installation (if you're not sure, restart your computer) to be able to see the cell functions that come with this package.<br />
<br />
==Using==<br />
<br />
Using the add-on is very simple at this stage. To see the tool at work, open Calc. In the menus, go to R Add-on > Rdump(). A new dialog window will pop up. Type in an R script -- here are some examples:<br />
<br />
* rnorm(10)<br />
* cor.test(c(1,2,3,4), c(1,2,2,3))<br />
<br />
Then click "Run". A new sheet should appear. Close the dialog with "Close" and check the new sheet -- you should see various pieces of information on the sheet.<br />
<br />
==Testing==<br />
<br />
So far, the software has been tested on the following.<br />
<br />
===Version 0.1.0===<br />
<br />
* Fedora Core 6 running JDK 1.6.0_01 and OpenOffice 2.2.<br />
* Ubuntu Edgy Eft running SDK 1.5.0_08 and OpenOffice 2.1.<br />
* Windows XP running running JDK 1.6.0_01 and OpenOffice 2.2.<br />
<br />
==Known Issues==<br />
<br />
Yes, we already have some known issues! That's OK, these are common issues and are not problematic with regards to the code:<br />
<br />
* '''Issue #1 (<font color="red">Fixed in 0.1.1</font>):''' Strings and characters, when part of the R object model, do not get published in Rdump().<br />
* '''Issue #2:''' RDUMP() does not print matrices and frames properly, but prints columns instead.<br />
* '''Issue #3:''' Missing values -- need a good way to deal with missing values. We cannot use a test for non-numeric values because of Factors in R.<br />
<br />
==About==<br />
<br />
This add-on is the result of a Google [[Summer of Code 2007]] project. It was initially created by [[User:Wojciech|Wojciech Gryc]]. For information pertaining to the development of this add-on, see [http://www.11-55.org/ooblog/ Wojciech's Blog].<br />
<br />
==Older Versions==<br />
<br />
* '''0.1.4''': [http://www.11-55.org/rcalc/2007-08-10/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-08-10/rcalc-0_1_4.zip Source Code])<br />
* '''0.1.3''': [http://www.11-55.org/rcalc/2007-08-02/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-08-02/rcalc-0_1_3.zip Source Code])<br />
* '''0.1.2''': [http://www.11-55.org/rcalc/2007-06-01/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-06-01/rcalc-0_1_2.zip Source Code])<br />
* '''0.1.1''': [http://www.11-55.org/rcalc/2007-05-25/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-05-25/rcalc-0_1_1.zip Source Code])<br />
* '''0.1.0''': [http://www.11-55.org/rcalc/2007-05-15/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-05-15/rcalc-0.1.0.zip Source Code])<br />
<br />
[[Category:Calc]]</div>Wojciechhttps://wiki.openoffice.org/w/index.php?title=Calc/API/Programming&diff=42531Calc/API/Programming2007-08-16T03:13:02Z<p>Wojciech: /* Embedding Images */</p>
<hr />
<div>==Introduction==<br />
To avoid to search in the previous code where we insert the new listings given in this chapter, we first give it again (only the main() part) :<br />
<code>[cpp]<br />
//Listing 1 Again our starting main Code<br />
int main( ) {<br />
//retrieve an instance of the remote service manager<br />
Reference< XMultiServiceFactory > rOfficeServiceManager;<br />
rOfficeServiceManager = ooConnect();<br />
if( rOfficeServiceManager.is() ){<br />
printf( "Connected sucessfully to the office\n" );<br />
}<br />
<br />
//get the desktop service using createInstance returns an XInterface type<br />
Reference< XInterface > Desktop = rOfficeServiceManager->createInstance(<br />
OUString::createFromAscii( "com.sun.star.frame.Desktop" ));<br />
<br />
//query for the XComponentLoader interface<br />
Reference< XComponentLoader > rComponentLoader (Desktop, UNO_QUERY);<br />
if( rComponentLoader.is() ){<br />
printf( "XComponentloader successfully instanciated\n" );<br />
}<br />
<br />
//get an instance of the spreadsheet<br />
Reference< XComponent > xcomponent = rComponentLoader->loadComponentFromURL(<br />
OUString::createFromAscii("private:factory/scalc"),<br />
OUString::createFromAscii("_blank"),<br />
0,<br />
Sequence < ::com::sun::star::beans::PropertyValue >());<br />
// add code here<br />
return 0;<br />
}<br />
</code><br />
Remember each time you query for an interface you have to add code lines (if they don't exist) in the source code and a line in the makefile. I will generally add comments to prevent omissions. You can find more explanations [[IDL_Files_and_Cpp#IDL__and_C.2B.2B|here]] (if you are not a beginner).<br />
<br />
=To find the Sheet=<br />
The most important interface for this chapter is XspreadsheetDocument. This interface supply the getSheets() method. This interface is inherited from XInterface which provide queries for a new interface to an existing UNO object : queryInterface.<br />
<br />
==An existing Sheet==<br />
If you know the sheet's name use the getByName method :<br />
<code>[cpp]<br />
//Listing 2 How to find a Sheet in a Spreadsheet<br />
//C++<br />
// Don't forget to add : using namespace com::sun::star::sheet;<br />
// Don't forget to add : #include <com/sun/star/sheet/XSpreadsheetDocument.hpp><br />
// Don't forget to add "com.sun.star.sheet.XSpreadsheetDocument \" in the makefile<br />
//query for a XSpreadsheetDocument interface <br />
Reference< XSpreadsheetDocument > rSheetDoc (xcomponent, UNO_QUERY); <br />
<br />
//use it to get the XSpreadsheets interface <br />
Reference< XSpreadsheets > rSheets = rSheetDoc->getSheets(); <br />
<br />
//use getByName to get a reference (type Any) <br />
Any rSheet = rSheets->getByName( OUString::createFromAscii("Sheet2"));<br />
</code> <br />
If we have a look at getByName method, we can see it can manage an “no such element” exception. The the previous code would be better written with a try and catch statement. <br />
<code>[cpp]<br />
Listing 3 Finding a Sheet and managing Exception<br />
//C++<br />
// Don't forget to add : using namespace com::sun::star::sheet;<br />
// Don't forget to add : #include <com/sun/star/sheet/XSpreadsheetDocument.hpp><br />
// Don't forget to add "com.sun.star.sheet.XSpreadsheetDocument \" in the makefile<br />
//query for a XSpreadsheetDocument interface <br />
Reference< XSpreadsheetDocument > rSheetDoc (xcomponent, UNO_QUERY); <br />
<br />
//use it to get the XSpreadsheets interface <br />
Reference< XSpreadsheets > rSheets = rSheetDoc->getSheets(); <br />
<br />
//use getByName to get a reference (type Any)<br />
try { <br />
Any rSheet = rSheets->getByName( OUString::createFromAscii("Sheet2")); <br />
}<br />
catch( Exception &e ){<br />
OString o = OUStringToOString( e.Message, RTL_TEXTENCODING_ASCII_US );<br />
printf( "Error: No such element ;%s\n", o.pData->buffer );<br />
}<br />
</code><br />
For sake of simplicity we will only use this exception managing only at the end of this document, when “helpers” will be tackled in ([[Constructing_Helpers|Constructing Helpers]]). <br />
If you only know the sheet's number you can retrieve the sheet using this way :<br />
<code>[cpp]<br />
//Listing 4 Finding a Sheet with an Index<br />
//C++<br />
// Don't forget to add : using namespace com::sun::star::sheet;<br />
// Don't forget to add : #include <com/sun/star/sheet/XSpreadsheetDocument.hpp><br />
// Don't forget to add "com.sun.star.sheet.XSpreadsheetDocument \" in the makefile<br />
// Don't forget to add : using namespace com::sun::star::container;<br />
// Don't forget to add : #include <com/sun/star/container/XIndexAccess.hpp><br />
// Don't forget to add "com.sun.star.container.XIndexAccess \" in the makefile<br />
//query for a XSpreadsheetDocument interface <br />
Reference< XSpreadsheetDocument > rSheetDoc (xcomponent, UNO_QUERY); <br />
<br />
//use it to get the XSpreadsheets interface <br />
Reference< XSpreadsheets > rSheets = rSheetDoc->getSheets();<br />
<br />
// query for the ::com::sun::star::container::XIndexAccess service<br />
Reference< XIndexAccess > rSheetsByIndex (rSheets, UNO_QUERY); <br />
<br />
//use getByName to get a reference (type Any) <br />
Any rSheet = rSheetsByIndex->getByIndex( (short)1 ); <br />
</code><br />
As you can see we have to query a new service XIndexAccess. This means adding two lines in the code and one in the makefile as seen in C++ comments.<br />
Take care : UNO considers the sheet numbering, starting from 0, and then 1 is the second sheet.<br />
<br />
==Create, rename, copy and delete a Sheet==<br />
To create a sheet the method insertNewByName is used :<br />
<code>[cpp]<br />
//Listing 5 Create a Sheet<br />
//C++<br />
// Don't forget to add : using namespace com::sun::star::sheet;<br />
// Don't forget to add : #include <com/sun/star/sheet/XSpreadsheetDocument.hpp><br />
// Don't forget to add "com.sun.star.sheet.XSpreadsheetDocument \" in the makefile<br />
//query for a XSpreadsheetDocument interface <br />
Reference< XSpreadsheetDocument > rSheetDoc (xcomponent, UNO_QUERY); <br />
<br />
//use it to get the XSpreadsheets interface <br />
Reference< XSpreadsheets > rSheets = rSheetDoc->getSheets(); <br />
<br />
//use it to create a new sheet called MySheet <br />
rSheets->insertNewByName(OUString::createFromAscii("MySheet"), (short)0);<br />
</code><br />
(short)0 is the index of position where the new sheet is inserted. Here “MySheet” will be the first sheet.<br />
<br />
How to move a sheet when its name is known:<br />
<code>[cpp]<br />
//Listing 6 Moving a Sheet<br />
//C++<br />
// Don't forget to add : using namespace com::sun::star::sheet;<br />
// Don't forget to add : #include <com/sun/star/sheet/XSpreadsheetDocument.hpp><br />
// Don't forget to add "com.sun.star.sheet.XSpreadsheetDocument \" in the makefile<br />
//query for a XSpreadsheetDocument interface <br />
Reference< XSpreadsheetDocument > rSheetDoc (xcomponent, UNO_QUERY); <br />
<br />
//use it to get the XSpreadsheets interface <br />
Reference< XSpreadsheets > rSheets = rSheetDoc->getSheets(); <br />
<br />
//use it to move a sheet called MySheet in third(back)/second(forward) position <br />
rSheets->moveByName(OUString::createFromAscii("MySheet"), (short)2);<br />
</code><br />
How to copy a sheet <br />
<code>[cpp]<br />
//Listing 7 Copying a Sheet<br />
//C++<br />
// Don't forget to add : using namespace com::sun::star::sheet;<br />
// Don't forget to add : #include <com/sun/star/sheet/XSpreadsheetDocument.hpp><br />
// Don't forget to add "com.sun.star.sheet.XSpreadsheetDocument \" in the makefile<br />
//query for a XSpreadsheetDocument interface <br />
Reference< XSpreadsheetDocument > rSheetDoc (xcomponent, UNO_QUERY); <br />
<br />
//use it to get the XSpreadsheets interface <br />
Reference< XSpreadsheets > rSheets = rSheetDoc->getSheets(); <br />
<br />
//use it to copy a sheet called MySheet in second position with the name "MySheet2" <br />
rSheets->copyByName(OUString::createFromAscii("MySheet"),<br />
OUString::createFromAscii("MySheet2"), (short)1);<br />
</code><br />
MySheet2 is an exact copy of "MySheet" inserted as a second sheet.<br />
How to rename a sheet : <br />
<code>[cpp]<br />
//Listing 8 Renaming a Sheet<br />
//C++ <br />
// Don't forget to add : using namespace com::sun::star::sheet;<br />
// Don't forget to add : #include <com/sun/star/sheet/XSpreadsheetDocument.hpp><br />
// Don't forget to add "com.sun.star.sheet.XSpreadsheetDocument \" in the makefile<br />
// Don't forget to add : using namespace com::sun::star::container;<br />
// Don't forget to add : #include <com/sun/star/container/XNamed.hpp><br />
// Don't forget to add "com.sun.star.container.XNamed \" in the makefile<br />
<br />
//query for a XSpreadsheetDocument interface <br />
Reference< XSpreadsheetDocument > rSheetDoc (xcomponent, UNO_QUERY); <br />
<br />
//use it to get the XSpreadsheets interface <br />
Reference< XSpreadsheets > rSheets = rSheetDoc->getSheets(); <br />
<br />
//use getByName to get a reference (type Any) <br />
Any rSheet = rSheets->getByName( OUString::createFromAscii("Sheet2")); <br />
<br />
// query for XNamed Interface<br />
Reference< XNamed > rname (rSheet, UNO_QUERY);<br />
<br />
// rename<br />
rname->setName(OUString::createFromAscii("MySheet")); <br />
</code><br />
<br />
How to remove a sheet :<br />
<code>[cpp]<br />
//Listing 9 Removing a Sheet<br />
// C++<br />
rSheets->removeByName(OUString::createFromAscii("Sheet1")); <br />
</code><br />
works properly. You can use also the XnameContainer interface like :<br />
<code>[cpp]<br />
//Listing 10 Removing a Sheet (an other way)<br />
// C++<br />
// Don't forget to add : using namespace com::sun::star::container;<br />
// Don't forget to add : #include <com/sun/star/container/XNameContainer.hpp><br />
// Don't forget to add "com.sun.star.container.xNameContainer \" in the makefile<br />
Reference<XNameContainer> xNameContainer (rSheets, UNO_QUERY);<br />
<br />
xNameContainer->removeByName(OUString::createFromAscii("Sheet1")); //OK<br />
</code><br />
<br />
==Retrieve or change the currently focused Sheet==<br />
<br />
How to set a known-named sheet as currently focused sheet :<br />
<code>[cpp]<br />
//Listing 11 Focus and C++ programming<br />
//C++ <br />
// Don't forget to add : using namespace com::sun::star::sheet;<br />
// Don't forget to add : #include <com/sun/star/sheet/XSpreadsheetDocument.hpp><br />
// Don't forget to add "com.sun.star.sheet.XSpreadsheetDocument \" in the makefile<br />
// Don't forget to add : using namespace com::sun::star::frame;<br />
// Don't forget to add : #include <com/sun/star/frame/XModel.hpp><br />
// Don't forget to add "com.sun.star.frame.XModel \" in the makefile<br />
<br />
// Don't forget to add : #include <com/sun/star/sheet/XSpreadsheetView.hpp><br />
// Don't forget to add "com.sun.star.sheet.XSpreadsheetView \" in the makefile<br />
<br />
// Don't forget to add : #include <com/sun/star/sheet/XSpreadsheet.hpp><br />
// Don't forget to add "com.sun.star.sheet.XSpreadsheet \" in the makefile<br />
<br />
//query for a XSpreadsheetDocument interface <br />
Reference< XSpreadsheetDocument > rSheetDoc (xcomponent, UNO_QUERY); <br />
Reference< XSpreadsheets > rSheets = rSheetDoc->getSheets(); <br />
<br />
//use getByName to get a reference (type Any) <br />
Any rSheet = rSheets->getByName( OUString::createFromAscii("Sheet2")); <br />
// we want to make our new sheet the current sheet, so we need to ask the model <br />
// for the controller: first query the XModel interface from our spreadsheet component <br />
<br />
//query for the XSpreadsheet interface<br />
Reference< XSpreadsheet > rSpSheet (rSheet, UNO_QUERY);<br />
<br />
Reference< XModel > rSpreadsheetModel (rSheetDoc, UNO_QUERY); <br />
<br />
// then get the current controller from the model <br />
Reference< XController > rSpreadsheetController = rSpreadsheetModel->getCurrentController(); <br />
<br />
// get the XSpreadsheetView interface from the controller, we want to call its method <br />
// setActiveSheet <br />
Reference< XSpreadsheetView > rSpreadsheetView (rSpreadsheetController, UNO_QUERY); <br />
<br />
// make our newly inserted sheet the active sheet using setActiveSheet <br />
rSpreadsheetView->setActiveSheet(rSpSheet); <br />
</code><br />
How to retrieve the currently focused sheet ? This problem is in fact a little variation of the previous one but the test is not so straightforward. If a new spreadsheet is created as previously we have no chance to choose ourself a sheet with focus because the program take always the same default sheet when just created. Then before resolving this problem we have to modify the loadComponentFromURL as previously done (<br />
[[ UNO_automation_with_a_binary_%28executable%29#The_default_opened_Document|default opened document]])<br />
Here is a piece of code which retrieves the sheet under focus. <br />
<code>[cpp]<br />
//Listing 12 Retrieve the Sheet under Focus<br />
//C++<br />
int main( ) {<br />
//retrieve an instance of the remote service manager<br />
Reference< XMultiServiceFactory > rOfficeServiceManager;<br />
rOfficeServiceManager = ooConnect();<br />
if( rOfficeServiceManager.is() ){<br />
printf( "Connected sucessfully to the office\n" );<br />
}<br />
<br />
//get the desktop service using createInstance returns an XInterface type<br />
Reference< XInterface > Desktop = rOfficeServiceManager->createInstance(<br />
OUString::createFromAscii( "com.sun.star.frame.Desktop" ));<br />
// Don't forget the #include <com/sun/star/frame/XDesktop.hpp><br />
// Don't forget to add com.sun.star.frame.XDesktop \ in the makefile<br />
//query the XDesktop Interface<br />
Reference< XDesktop > xDesktop (Desktop, UNO_QUERY);<br />
<br />
Reference< XComponent > xcomponent = xDesktop->getCurrentComponent();<br />
<br />
// Don't forget to add : using namespace com::sun::star::sheet;<br />
// Don't forget to add : #include <com/sun/star/sheet/XSpreadsheetDocument.hpp><br />
// Don't forget to add "com.sun.star.sheet.XSpreadsheetDocument \" in the makefile<br />
//query for a XSpreadsheetDocument interface<br />
Reference< XSpreadsheetDocument > rSheetDoc (xcomponent, UNO_QUERY);<br />
<br />
// Don't forget to add : using namespace com::sun::star::frame;<br />
// Don't forget to add : #include <com/sun/star/frame/XModel.hpp><br />
// Don't forget to add "com.sun.star.frame.XModel \" in the makefile<br />
Reference< XModel > rSpreadsheetModel (rSheetDoc, UNO_QUERY);<br />
<br />
// then get the current controller from the model<br />
Reference< XController > rSpreadsheetController = <br />
rSpreadsheetModel->getCurrentController();<br />
<br />
// Don't forget to add : #include <com/sun/star/sheet/XSpreadsheetView.hpp><br />
// Don't forget to add "com.sun.star.sheet.XSpreadsheetView \" in the makefile<br />
// get the XSpreadsheetView interface from the controller, we want to call its method<br />
// getActiveSheet<br />
Reference< XSpreadsheetView > rSpreadsheetView (rSpreadsheetController, UNO_QUERY);<br />
Reference< XSpreadsheet> rSheet=rSpreadsheetView->getActiveSheet();<br />
// for a test<br />
Reference< XCell > rCell = rSheet->getCellByPosition(0, 0);<br />
rCell->setFormula(OUString::createFromAscii("Hello"));<br />
<br />
return 0;<br />
}<br />
</code><br />
<br />
The way to obtain a cell is explained above, then don't read the two last lines before the return : they only allow me to test the code.<br />
<br />
=How to obtain the Cell=<br />
When you have your sheet, obtain a particular cell is easy :<br />
<code>[cpp]<br />
//Listing 13 Obtaining a Cell<br />
//C++<br />
// Don't forget to add : using namespace com::sun::star::sheet;<br />
// Don't forget to add : #include <com/sun/star/sheet/XSpreadsheetDocument.hpp><br />
// Don't forget to add "com.sun.star.sheet.XSpreadsheetDocument \" in the makefile<br />
// Don't forget to add : using namespace com::sun::star::table; (for XCell)<br />
// Don't forget to add : #include <com/sun/star/sheet/XSpreadsheet.hpp><br />
// Don't forget to add "com.sun.star.sheet.XSpreadsheet \" in the makefile<br />
//query for a XSpreadsheetDocument interface<br />
Reference< XSpreadsheetDocument > rSheetDoc (xcomponent, UNO_QUERY);<br />
<br />
//use it to get the XSpreadsheets interface<br />
Reference< XSpreadsheets > rSheets = rSheetDoc->getSheets();<br />
<br />
//use getByName to get a reference (type Any)<br />
Any rSheet = rSheets->getByName( OUString::createFromAscii("Sheet1"));<br />
<br />
//query for the XSpreadsheet interface<br />
Reference< XSpreadsheet > rSpSheet (rSheet, UNO_QUERY);<br />
<br />
Reference< XCell > rCell = rSpSheet->getCellByPosition(0, 0);<br />
</code><br />
The first parameter is the column number, and the second is the row number, both starting from 0. See above the example where we access to the top left cell called A1.<br />
<br />
=What can be done with a Cell ?=<br />
The XCell interface provide six methods :<br />
<br />
getFormula returns the formula string of a cell. <br />
setFormula sets a formula into the cell. <br />
getValue returns the floating point value of the cell. <br />
setValue sets a floating point value into the cell. <br />
getType returns the type of the cell. <br />
getError returns the error value of the cell. <br />
<br />
==Numerical Value in a Cell==<br />
To put a numerical value in a cell is easy :<br />
<code>[cpp]<br />
//Listing 14 Putting a numerical Value in a Cell<br />
//C++<br />
// Don't forget to add : using namespace com::sun::star::sheet;<br />
// Don't forget to add : #include <com/sun/star/sheet/XSpreadsheetDocument.hpp><br />
// Don't forget to add "com.sun.star.sheet.XSpreadsheetDocument \" in the makefile<br />
// Don't forget to add : using namespace com::sun::star::table; (for XCell)<br />
// Don't forget to add : #include <com/sun/star/sheet/XSpreadsheet.hpp><br />
// Don't forget to add "com.sun.star.sheet.XSpreadsheet \" in the makefile<br />
//query for a XSpreadsheetDocument interface<br />
Reference< XSpreadsheetDocument > rSheetDoc (xcomponent, UNO_QUERY);<br />
<br />
//use it to get the XSpreadsheets interface<br />
Reference< XSpreadsheets > rSheets = rSheetDoc->getSheets();<br />
<br />
//use getByName to get a reference (type Any)<br />
Any rSheet = rSheets->getByName( OUString::createFromAscii("Sheet1"));<br />
<br />
//query the reference of type Any for the XSpreadsheet interface<br />
Reference< XSpreadsheet > rSpSheet (rSheet, UNO_QUERY);<br />
<br />
Reference< XCell > rCell = rSpSheet->getCellByPosition(0, 0);<br />
<br />
//set the cell value then get another cell etc..<br />
rCell->setValue(219);<br />
rCell = rSpSheet->getCellByPosition(0, 1);<br />
rCell->setValue(25);<br />
</code><br />
==Formula in a Cell==<br />
To put a formula in a cell is straightforward : replace the previous setValue by setFormula. This gives us :<br />
<code>[cpp]<br />
//Listing 15 Putting a Formula in a Cell<br />
//C++<br />
Reference< XCell > rCell = rSpSheet->getCellByPosition(0, 0);<br />
rCell->setValue(21);<br />
rCell = rSpSheet->getCellByPosition(0, 1);<br />
rCell->setValue(23);<br />
rCell = rSpSheet->getCellByPosition(0, 2);<br />
rCell->setFormula(OUString::createFromAscii("=sum(A1:A2)"));<br />
</code><br />
which puts in fact the value 44 in A3.<br />
==String in a Cell==<br />
We use a similar principle as in previous example :<br />
<code>[cpp]<br />
//Listing 16 Putting a String (OUString) in a Cell<br />
//C++ <br />
//set a string in the cell <br />
rCell->setFormula(OUString::createFromAscii("Hello"));<br />
</code><br />
It is possible to change the textual content of a cell with a Cursor (XTextCursor interface). The code below allows us this change :<br />
<code>[cpp]<br />
//Listing 17 Change the String Content of a Cell<br />
//C++<br />
// Don't forget to add : using namespace com::sun::star::text;<br />
// Don't forget to add : #include <com/sun/star/text/XText.hpp><br />
// Don't forget to add "com.sun.star.text.XText \" in the makefile<br />
<br />
// query first the XText interface<br />
Reference< XText > rText (rCell, UNO_QUERY); <br />
<br />
//query for the XTextCursor interface <br />
//Reference< XTextCursor > rTextCurs (rText, UNO_QUERY); <br />
Reference< XTextCursor > rTextCurs = rText -> createTextCursor(); <br />
rTextCurs -> gotoEnd(false);<br />
rTextCurs -> setString(OUString::createFromAscii(" Bye"));<br />
</code><br />
Adding the code gives us “Hello Bye” in a cell.<br />
==What is the Content Type of a Cell ?==<br />
We naturally use a getType method of the XCell interface. It returns one of the four possibilities : EMPTY, VALUE, TEXT or FORMULA (::com::sun::star::table) How do we see the values in C++ ? We give here the partial content of CellContentType.idl :<br />
<br />
<pre><br />
// IDL<br />
namespace com<br />
{<br />
namespace sun<br />
{<br />
namespace star<br />
{<br />
namespace table<br />
{<br />
enum CellContentType<br />
{<br />
CellContentType_EMPTY = 0,<br />
CellContentType_VALUE = 1,<br />
CellContentType_TEXT = 2,<br />
CellContentType_FORMULA = 3,<br />
CellContentType_MAKE_FIXED_SIZE = SAL_MAX_ENUM<br />
};<br />
<br />
} // table<br />
} // star<br />
} // sun<br />
} // com<br />
</pre><br />
<br />
which shows us a “using namespace com::sun::star::table” allows us to write in C++ something like : CellContentType_EMPTY if we have added the following statement :<br />
<pre><br />
#include <com/sun/star/table/CellContentType.hpp><br />
</pre><br />
The code below is an example : <br />
<code>[cpp]<br />
Listing 18 Retrieve the Cell Content Type<br />
//C++<br />
// Don't forget to add : using namespace com::sun::star::sheet;<br />
// Don't forget to add : #include <com/sun/star/sheet/XSpreadsheetDocument.hpp><br />
// Don't forget to add "com.sun.star.sheet.XSpreadsheetDocument \" in the makefile<br />
// Don't forget to add : #include <com/sun/star/sheet/XSpreadsheet.hpp><br />
// Don't forget to add "com.sun.star.sheet.XSpreadsheet \" in the makefile<br />
<br />
// Don't forget to add #include <com/sun/star/table/CellContentType.hpp><br />
// Don't forget to add "com.sun.star.table.CellContentType \" in the makefile<br />
<br />
//query for a XSpreadsheetDocument interface<br />
Reference< XSpreadsheetDocument > rSheetDoc (xcomponent, UNO_QUERY);<br />
Reference< XSpreadsheets > rSheets = rSheetDoc->getSheets();<br />
<br />
Any rSheet = rSheets->getByName( OUString::createFromAscii("Sheet1"));<br />
//query the reference of type Any for the XSpreadsheet interface<br />
Reference< XSpreadsheet > rSpSheet (rSheet, UNO_QUERY);<br />
<br />
Reference< XCell > rCell = rSpSheet->getCellByPosition(0, 0);<br />
rCell->setValue(43);<br />
switch (rCell->getType()){<br />
case CellContentType_EMPTY : printf("Empty\n");break;<br />
case CellContentType_VALUE : printf("Numerical Value\n");break;<br />
case CellContentType_TEXT : printf("Text\n");break;<br />
case CellContentType_FORMULA : printf("Formula\n");break;<br />
}<br />
</code><br />
which writes out “Numerical Value”.<br />
<br />
==Computing the Formula==<br />
Two methods calculate() and calculateAll() are available from the XCalculaTable interface. You can query this interface from a XSreadsheetDocument.<br />
<br />
==Formating a Cell== <br />
The straight forwarder way to format a cell is to use an already defined-style in the spreadsheet. The predefined style's names are in English even they appear in other languages in Object Bar. They are : Result, Result2, Default, Heading, Heading1 ...<br />
<code>[cpp]<br />
//Listing 19 Formating a Cell<br />
//C++<br />
// Don't forget to add : using namespace com::sun::star::beans;<br />
// Don't forget to add : #include <com/sun/star/beans/XPropertySet.hpp><br />
// Don't forget to add "com.sun.star.beans.XPropertySet \" in the makefile<br />
<br />
//query for the cell property interface <br />
Reference< XPropertySet > rCellProps (rCell, UNO_QUERY); <br />
<br />
//create an Any to hold our property value <br />
Any mPropVal; <br />
mPropVal <<= OUString::createFromAscii("Result"); <br />
<br />
//set some properties <br />
rCellProps->setPropertyValue(OUString::createFromAscii("CellStyle"), mPropVal); <br />
</code><br />
==Cell Annotations==<br />
The following example inserts an annotation and make it permanently visible.<br />
<code>[cpp]<br />
//Listing 20 Putting and retrieve Cell Annotations<br />
//C++<br />
// Don't forget to add : using namespace com::sun::star::sheet;<br />
// Don't forget to add : #include <com/sun/star/sheet/XSpreadsheetDocument.hpp><br />
// Don't forget to add "com.sun.star.sheet.XSpreadsheetDocument \" in the makefile<br />
<br />
// Don't forget to add : #include <com/sun/star/sheet/XSpreadsheet.hpp><br />
// Don't forget to add "com.sun.star.sheet.XSpreadsheet \" in the makefile<br />
<br />
// Don't forget to add : #include <com/sun/star/sheet/XCellAddressable.hpp><br />
// Don't forget to add "com.sun.star.sheet.XCellAddressable \" in the makefile<br />
<br />
// Don't forget to add : #include <com/sun/star/sheet/XSheetAnnotationsSupplier.hpp><br />
// Don't forget to add "com.sun.star.sheet.XSheetAnnotationsSupplier \" in the makefile<br />
<br />
// Don't forget to add : #include <com/sun/star/sheet/XSheetAnnotationAnchor.hpp><br />
// Don't forget to add "com.sun.star.sheet.XSheetAnnotationAnchor \" in the makefile<br />
<br />
//query for a XSpreadsheetDocument interface<br />
Reference< XSpreadsheetDocument > rSheetDoc (xcomponent, UNO_QUERY);<br />
Reference< XSpreadsheets > rSheets = rSheetDoc->getSheets();<br />
<br />
Any rSheet = rSheets->getByName( OUString::createFromAscii("Sheet1"));<br />
<br />
//query the reference of type Any for the XSpreadsheet interface<br />
Reference< XSpreadsheet > rSpSheet (rSheet, UNO_QUERY);<br />
<br />
//query for XCell Interface<br />
Reference< XCell > rCell = rSpSheet->getCellByPosition(0, 0);<br />
<br />
//query for the XcellAddressable Interface<br />
Reference< XCellAddressable > rCellAddr (rCell, UNO_QUERY);<br />
CellAddress rAddress = rCellAddr -> getCellAddress();<br />
<br />
//query for XSheetAnnotationsSupplier Interface <br />
Reference< XSheetAnnotationsSupplier > rAnnotationSupp (rSheet, UNO_QUERY);<br />
Reference< XSheetAnnotations > rAnnotations = rAnnotationSupp -> getAnnotations();<br />
rAnnotations -> insertNew(rAddress,OUString::createFromAscii("This is an annotation"));<br />
<br />
// make the annotation visible<br />
<br />
//query the XSheetAnnotationAnchor<br />
Reference< XSheetAnnotationAnchor > rAnnotAnchor (rCell, UNO_QUERY);<br />
Reference< XSheetAnnotation > rAnnotation = rAnnotAnchor -> getAnnotation();<br />
rAnnotation->setIsVisible(true);<br />
</code><br />
If you want an annotation not always visible you only remove the three last lines. Very interesting to put an annotation, but how do you get it if it already exist ? You add for test into the previous code :<br />
<code>[cpp]<br />
//Listing 21 Code for Test of previous Listing<br />
// C++<br />
// Don't forget to add : using namespace com::sun::star::text;<br />
// Don't forget to add : #include <com/sun/star/text/XSimpleText.hpp><br />
// Don't forget to add "com.sun.star.sheet.XSimpleText \" in the makefile<br />
<br />
// query the XSimpleTextInterface<br />
Reference< XSimpleText > rSimpleText (rAnnotation, UNO_QUERY);<br />
<br />
printf("Annotation : %s\n",<br />
OUStringToOString(rSimpleText->getString(),RTL_TEXTENCODING_ASCII_US).getStr());<br />
// or if you want to put the text in the cell :<br />
// rCell->setFormula(rSimpleText->getString());<br />
</code><br />
which writes out the string literal :“Annotation : This is an annotation”.<br />
<br />
=Cell Range=<br />
The way to obtain a cell range is not so easy as in OooBasic. You have first to obtain the Xinterface to have access to the getcellRangeByName method :<br />
<code>[cpp]<br />
//Listing 22 Cell Range Manipulation<br />
//C++<br />
// Don't forget to add : using namespace com::sun::star::table;<br />
// Don't forget to add : #include <com/sun/star/table/XCellRange.hpp><br />
// Don't forget to add "com.sun.star.table.XCellRange \" in the makefile<br />
<br />
//query for a XSpreadsheetDocument interface <br />
Reference< XSpreadsheetDocument > rSheetDoc (xcomponent, UNO_QUERY); <br />
Reference< XSpreadsheets > rSheets = rSheetDoc->getSheets(); <br />
<br />
//use getByName to get a reference (type Any) <br />
Any rSheet = rSheets->getByName( OUString::createFromAscii("Sheet1")); <br />
<br />
// query for the XCellRange interface<br />
Reference< XCellRange > rSheetCellRange (rSheet, UNO_QUERY);<br />
<br />
// query the cell range<br />
Reference< XCellRange> rCellRange = <br />
rSheetCellRange->getCellRangeByName(OUString::createFromAscii("B2:F5"));<br />
</code> <br />
With the XCellRange interface you can also access the range with getCellRangeByPosition method.<br />
To query one cell in the cell range, add to the previous code :<br />
<code>[cpp]<br />
//Listing 23 Finding one Cell in the Range<br />
//C++<br />
Reference< XCell > rCell = rCellRange->getCellByPosition(0, 0);<br />
rCell->setFormula(OUString::createFromAscii("it works"));<br />
</code> <br />
The X and Y position are then relative to the cell Range.<br />
<br />
==Retrieve the absolute X and Y Positions of a Cell ==<br />
This subject has been already tackled in a previous section but embedded in other code. We need first a CellAddress type described in <OpenOffice.org1.1_SDK>/idl/com/sun/star/text/CellAddress.idl :<br />
<pre><br />
// IDL<br />
module com { module sun { module star { module table {<br />
struct CellAddress<br />
{<br />
short Sheet;<br />
long Column;<br />
long Row;<br />
};<br />
}; }; }; };<br />
</pre><br />
Starting from the previous listing and adding :<br />
<code>[cpp]<br />
//Listing 24 Absolute Position of a Cell<br />
// C++<br />
// Don't forget to add : #include <com/sun/star/sheet/XCellAddressable.hpp><br />
// Don't forget to add "com.sun.star.sheet.XCellAddressable \" in the makefile<br />
<br />
// Don't forget to add : #include <com/sun/star/table/CellAddress.hpp><br />
// Don't forget to add "com.sun.star.table.CellAddress \" in the makefile<br />
<br />
//query for the XcellAddressable Interface<br />
Reference< XCellAddressable > rCellAddr (rCell, UNO_QUERY);<br />
CellAddress rAddress = rCellAddr -> getCellAddress();<br />
printf("sheet : %d, column : %d row: %d \n",<br />
rAddress.Sheet,rAddress.Column,rAddress.Row);<br />
</code><br />
gives us a program which writes out the absolute X and Y position of a cell.<br />
<br />
==Retrieve the absolute Address of the Cell Range==<br />
We need first a CellRangeAddress type described in <OpenOffice.org1.1_SDK>/idl/com/sun/star/table/CellRangeAddress.idl :<br />
<pre><br />
// IDL<br />
module com { module sun { module star { module table {<br />
<br />
struct CellRangeAddress<br />
{<br />
short Sheet;<br />
long StartColumn;<br />
long StartRow;<br />
long EndColumn;<br />
long EndRow;<br />
};<br />
}; }; }; };<br />
</pre><br />
and a XCellRangeAdressable interface. Starting from the cell range program, we add :<br />
<code>[cpp]<br />
//Listing 25 Using XCellRangeAddressable Interface<br />
// C++<br />
// Don't forget to add : #include <com/sun/star/sheet/XCellRangeAddressable.hpp><br />
// Don't forget to add "com.sun.star.sheet.XCellRangeAddressable \" in the makefile<br />
<br />
// Don't forget to add : #include <com/sun/star/sheet/CellRangeAddress.hpp><br />
// Don't forget to add "com.sun.star.sheet.CellRangeAddress \" in the makefile<br />
<br />
//query for the XCellRangeAddressable interface<br />
Reference< XCellRangeAddressable > rCellRangeAddr (rCellRange, UNO_QUERY);<br />
CellRangeAddress rRangeAddress = rCellRangeAddr -> getRangeAddress();<br />
printf("sheet : %d, start column : %d start row: %d ...\n",<br />
rRangeAddress.Sheet,rRangeAddress.StartColumn,rRangeAddress.StartRow);<br />
</code><br />
This program only writes out three of the five cell range attribute.<br />
==Getting a Cell range with a Selection==<br />
We have tackled a similar problem in section (<br />
[[OpenOffice_Calc#Retrieve_or_change_the_currently_focused_Sheet|Retrieve or change the currently focused Sheet]]) The way is to also start from a XModel interface, and query with getCurrentSelection an XInterface and then query an XCellRange interface. <br />
<code>[cpp]<br />
//Listing 26 Cell Range under Focus<br />
// C++<br />
Reference< XInterface > rInterface = rSpreadsheetModel->getCurrentSelection();<br />
<br />
// Don't forget to add : #include <com/sun/star/table/XCellRange.hpp><br />
// Don't forget to add "com.sun.star.table.XCellRange \" in the makefile<br />
Reference< XCellRange > rCellRange(rInterface,UNO_QUERY);<br />
rCell = rCellRange ->getCellByPosition(0, 0);<br />
rCell->setFormula(OUString::createFromAscii("Hello !!!"));<br />
</code><br />
This code writes out “Hello !!!” in the top left corner of the selected range.<br />
<br />
=Ready to translate the Developpers Guide into C++=<br />
When you want to go further, the Developers Guide is a good start. But examples are given in Java code. You have then to learn how to translate it into C++. At first glance you can find this translation as a complicate task but I have experimented it as a Java complete novice when writing the chapter on annotation and encounter no difficulties. But I was lucky, I present now examples which give me more difficulties. <br />
<br />
==The Compute Function Example==<br />
Let's start with Compute Function SDK's example :<br />
<code>[java]<br />
//Listing 27 Java first Example (from SDK)<br />
// Java<br />
// --- Sheet operation. --- <br />
// Compute a function <br />
com.sun.star.sheet.XSheetOperation xSheetOp = <br />
(com.sun.star.sheet.XSheetOperation) UnoRuntime.queryInterface<br />
(com.sun.star.sheet.XSheetOperation.class, xCellRange);<br />
double fResult = xSheetOp.computeFunction(com.sun.star.sheet.GeneralFunction.AVERAGE); System.out.println("Average value of the data table A10:C30: " + fResult); <br />
// Clear cell contents<br />
xSheetOp.clearContents( com.sun.star.sheet.CellFlags.ANNOTATION |<br />
com.sun.star.sheet.CellFlags.OBJECTS);<br />
</code><br />
<br />
The C++ translation gives (keeping the same variables names as in Java code) :<br />
<code>[cpp]<br />
//Listing 28 C++ Translation : calling a buildin Function<br />
// C++<br />
// Don't forget to add : #include <com/sun/star/sheet/XSheetOperation.hpp><br />
// Don't forget to add "com.sun.star.sheet.XSheetOperation \" in the makefile<br />
<br />
// Don't forget to add : #include <com/sun/star/sheet/GeneralFunction.hpp><br />
// and see in GeneralFunction.hdl how AVERAGE is generated : here GeneralFunction_AVERAGE<br />
// Don't forget to add "com.sun.star.sheet.GeneralFunction \" in the makefile<br />
<br />
// Don't forget to add : #include <com/sun/star/sheet/CellFlags.hpp><br />
// and see in CellFlags.hdl how ANNOTATION and OBJECT are generated : here ANNOTATION, OBJECT<br />
// in the namespace CellFlags donc :<br />
// Don't forget to add : using namespace com::sun::star::sheet::CellFlags;<br />
// Don't forget to add "com.sun.star.sheet.CellFlags \" in the makefile<br />
<br />
// --- Sheet operation. ---<br />
// Compute a function<br />
Reference< XSheetOperation > xSheetOp( xCellRange,UNO_QUERY);<br />
double fResult= xSheetOp->computeFunction(GeneralFunction_AVERAGE);<br />
printf("Average value of the data table B2:C4: %f", fResult);<br />
// Clear cell contents<br />
xSheetOp->clearContents( ANNOTATION | OBJECTS);<br />
</code><br />
We can see the UNO calls are simpler in C++ than in Java. I have added comments to explain how constants are managed. We are lucky with this piece of code : we can see two different kind of constant :<br />
* one with a specific name : GeneralFunction_AVERAGE instead of AVERAGE in Java. This problem of enumeration has already been tackled [[SDKCppLanguage#To_go_further_:_the_Enumeration_Type_Problem|here]].<br />
* one with the same name as in IDL and Java files but in a namespace which requires the classical “using namespace”.<br />
<br />
To find information requires to generate hdl and hpp files from IDL files and to read not the hpp but hdl files. This job is let for novices, others can see all in IDL files : see the difference between :<br />
<pre><br />
// IDL<br />
// extracted from CellFlags.idl<br />
constants CellFlags<br />
{<br />
const long VALUE = 1;<br />
const long DATETIME = 2;<br />
const long STRING = 4;<br />
const long ANNOTATION = 8;<br />
const long FORMULA = 16;<br />
const long HARDATTR = 32;<br />
const long OBJECTS = 128;<br />
const long EDITATTR = 256;<br />
};<br />
</pre><br />
and<br />
<pre><br />
// IDL<br />
// extracted from GeneralFunction.idl<br />
enum GeneralFunction<br />
{<br />
NONE,<br />
AUTO,<br />
SUM,<br />
COUNT,<br />
AVERAGE,<br />
MAX,<br />
MIN,<br />
PRODUCT,<br />
COUNTNUMS,<br />
STDEV,<br />
STDEVP,<br />
VAR,<br />
VARP<br />
};<br />
</pre><br />
and the consequences on the constants use. You can deduce tips isn't it ?<br />
<br />
==A second Example : adding a Name to a Cell (or Cell Range)==<br />
We give first the Java code still found in SDK :<br />
<code>[java]<br />
//Listing 29 Second Java Example<br />
// Java<br />
// insert a named range <br />
com.sun.star.beans.XPropertySet xDocProp = (com.sun.star.beans.XPropertySet)<br />
UnoRuntime.queryInterface(com.sun.star.beans.XPropertySet.class, xDocument);<br />
Object aRangesObj = xDocProp.getPropertyValue("NamedRanges");<br />
com.sun.star.sheet.XNamedRanges xNamedRanges = (com.sun.star.sheet.XNamedRanges) UnoRuntime.queryInterface(com.sun.star.sheet.XNamedRanges.class, aRangesObj);<br />
com.sun.star.table.CellAddress aRefPos = new com.sun.star.table.CellAddress(); aRefPos.Sheet = 0; <br />
aRefPos.Column = 6; <br />
aRefPos.Row = 44; <br />
xNamedRanges.addNewByName("ExampleName", "SUM(G43:G44)", aRefPos, 0);<br />
// use the named range in formulas <br />
xSheet.getCellByPosition(6, 44).setFormula("=ExampleName"); <br />
xSheet.getCellByPosition(7, 44).setFormula("=ExampleName");<br />
</code><br />
The same code in C++ :<br />
<code>[cpp]<br />
//Listing 30 naming a Cell (Range)<br />
// C++<br />
// Don't forget to add : #include <com/sun/star/beans/XPropertySet.hpp><br />
// Don't forget to add "com.sun.star.beans.XPropertySet \" in the makefile<br />
<br />
// Don't forget to add : #include <com/sun/star/sheet/XNamedRanges.hpp><br />
// Don't forget to add "com.sun.star.sheet.XNamedRanges \" in the makefile<br />
<br />
// Don't forget to add : #include <com/sun/star/table/CellAddress.hpp><br />
// Don't forget to add "com.sun.star.table.CellAddress \" in the makefile<br />
<br />
// insert a named range <br />
// !!! rSheetDoc instead xDocument in our previous code !!!<br />
Reference< XPropertySet > xDocProp(xDocument, UNO_QUERY); <br />
Any aRangesObj = xDocProp->getPropertyValue(OUString::createFromAscii("NamedRanges"));<br />
Reference< XNamedRanges > xNamedRanges(aRangesObj,UNO_QUERY);<br />
CellAddress aRefPos;<br />
aRefPos.Sheet = 0;<br />
aRefPos.Column = 6;<br />
aRefPos.Row = 44;<br />
xNamedRanges->addNewByName(OUString::createFromAscii("ExampleName"),<br />
OUString::createFromAscii("SUM(G43:G44)"), aRefPos, 0);<br />
// use the named range in formulas<br />
// !!! rSpSheet instead xSheet in our previous code !!!<br />
xSheet->getCellByPosition(6, 44)->setFormula(OUString::createFromAscii("=ExampleName"));<br />
xSheet->getCellByPosition(7, 44)->setFormula(OUString::createFromAscii("=ExampleName"));<br />
</code><br />
We can see Object is translated by Any. You have to add “OUString::createFromAscii “ before all strings. This program names a cell “ExampleName” and gives a value associated with this name : "SUM(G43:G44)". When you use this name it is replaced by its value.<br />
<br />
==A third Example==<br />
Here is an other example :<br />
<code>[java]<br />
//Listing 31 Java third Example<br />
// Java<br />
// --- Cell range data --- <br />
com.sun.star.sheet.XCellRangeData xData = (com.sun.star.sheet.XCellRangeData)<br />
UnoRuntime.queryInterface(com.sun.star.sheet.XCellRangeData.class, xCellRange); <br />
Object[][] aValues = { {new Double(1.1), new Integer(10)}, <br />
{new Double(2.2), new String("")},<br />
{new Double(3.3), new String("Text")} }; <br />
xData.setDataArray(aValues);<br />
</code><br />
This very interesting example takes values from an array and put them in a cell range.<br />
The code is given below :<br />
<code>[cpp]<br />
//Listing 32 Putting Cell Range Values in an Array<br />
//C++<br />
// Don't forget to add : using namespace com::sun::star::sheet;<br />
// Don't forget to add : #include <com/sun/star/sheet/XSpreadsheetDocument.hpp><br />
// Don't forget to add "com.sun.star.sheet.XSpreadsheetDocument \" in the makefile<br />
//query for a XSpreadsheetDocument interface<br />
Reference< XSpreadsheetDocument > rSheetDoc (xcomponent, UNO_QUERY);<br />
<br />
//use it to get the XSpreadsheets interface<br />
// Reference< XSpreadsheets > rSheets = rSheetDoc->getSheets();<br />
<br />
// Don't forget to add : using namespace com::sun::star::frame;<br />
// Don't forget to add : #include <com/sun/star/frame/XModel.hpp><br />
// Don't forget to add "com.sun.star.frame.XModel \" in the makefile<br />
Reference< XModel > rSpreadsheetModel (rSheetDoc, UNO_QUERY);<br />
<br />
// then get the current controller from the model<br />
Reference< XController > rSpreadsheetController = <br />
rSpreadsheetModel->getCurrentController();<br />
<br />
// Don't forget to add : #include <com/sun/star/sheet/XSpreadsheetView.hpp><br />
// Don't forget to add "com.sun.star.sheet.XSpreadsheetView \" in the makefile<br />
// get the XSpreadsheetView interface from the controller, we want to call its method<br />
// setActiveSheet<br />
Reference< XSpreadsheetView > rSpreadsheetView (rSpreadsheetController, UNO_QUERY);<br />
Reference< XSpreadsheet> rSheet=rSpreadsheetView->getActiveSheet();<br />
<br />
Reference< XInterface > rInterface = rSpreadsheetModel->getCurrentSelection();<br />
<br />
// Don't forget to add : #include <com/sun/star/table/XCellRange.hpp><br />
// Don't forget to add "com.sun.star.table.XCellRange \" in the makefile<br />
Reference< XCellRange > rCellRange(rInterface,UNO_QUERY);<br />
<br />
// Don't forget to add : #include <com/sun/star/sheet/XCellRangeData.hpp><br />
// Don't forget to add "com.sun.star.sheet.XCellRangeData \" in the makefile<br />
Reference< XCellRangeData> xData(rCellRange, UNO_QUERY);<br />
<br />
// Java translation begins here .........<br />
Sequence< Sequence< Any > > aValues(3); // or aValues(1)(2); ?????<br />
Sequence< Any > aValues2(2);<br />
aValues2[0] <<= (double) 1.1; aValues2[1] <<= (sal_Int32)10;<br />
aValues[0] = aValues2;<br />
aValues2[0] <<= (double)2.2; aValues2[1] <<= OUString::createFromAscii("");<br />
aValues[1] = aValues2;<br />
aValues2[0] <<= (double)3.3; aValues2[1] <<= OUString::createFromAscii("Text");<br />
aValues[2] = aValues2;<br />
xData -> setDataArray(aValues);<br />
</code><br />
can be compiled and works if we have an opened OOoCalc document with focus on a cell range of two rows and three lines. This is important : the cell range size must be the same as the sequence sequence of any !<br />
<br />
<br />
==An Example from OooForum: opening a Password protected Document==<br />
Kscape posts :<br />
“There is some example java code for opening a passworded file which will prompt the user for the password at [http://codesnippets.services.openoffice.org/Office/Office.openPwdProtectedFile.snip|OOo snippets] <br />
but there is no example C++ code, and I cannot seem to get the services and queries around the right way. <br />
Any chance someone can translate that snippet or provide a full example C++ program which will open a passworded document? <br />
<br />
Thanks in advance. “<br />
<br />
Here is the corresponding Java code :<br />
<code>[java]<br />
//Listing 33 Java starting Code<br />
// Java<br />
XInteractionHandler xHandler = (XInteractionHandler)UnoRuntime.queryInterface( XInteractionHandler.class, xSMGR.createInstance("com.sun.star.task.InteractionHandler"));<br />
<br />
PropertyValue[] lArgs = new PropertyValue[1];<br />
lArgs[0] = new PropertyValue();<br />
lArgs[0].Name = "InteractionHandler";<br />
lArgs[0].Value = xHandler;<br />
<br />
xDoc = xDesktop.loadComponentFromURL(sURL, sTarget, nSearchFlags, lArgs);<br />
</code><br />
Here is the C++ translation :<br />
<code>[cpp]<br />
//Listing 34 The correspnding C++ Code<br />
// C++ <br />
// Don't forget to add : #include <com/sun/star/task/XInteractionHandler.hpp> <br />
// Don't forget to add "com.sun.star.task.XInteractionHandler \" in the makefile <br />
// Don't forget to add : using namespace com::sun::star::task; <br />
<br />
Reference <XInteractionHandler> xHandler = <br />
Reference<XInteractionHandler>( rOfficeServiceManager->createInstance( <br />
OUString( RTL_CONSTASCII_USTRINGPARAM( <br />
"com.sun.star.task.InteractionHandler" ))), UNO_QUERY ); <br />
if (xHandler.is()) printf("xHandler OK...\n"); else printf("Error xHandler ... \n"); <br />
<br />
Sequence <PropertyValue > largs(1); <br />
largs[0].Name = OUString::createFromAscii("InteractionHandler"); <br />
largs[0].Value = makeAny(xHandler); <br />
<br />
//get an instance of the OOoDraw document <br />
Reference< XComponent > xcomponent = rComponentLoader->loadComponentFromURL( <br />
OUString::createFromAscii("private:factory/sdraw"), <br />
OUString::createFromAscii("_blank"), <br />
0, <br />
largs); <br />
</code><br />
=Event Listener=<br />
==First Event Listener==<br />
Event listener in C++ are not documented in the Developer's Guide. To find a way to resolve this problem I first read Java Code. I deduce if you want to implement an event listener you have to construct a class which inherit from a known class and then install it. My first try hang completely OOo (without a message...) After I decided to read OOo' source code and hope to find an example. It was the case in the file : OOo_1.1.3_src/basic/source/basmgr/basmgr.cxx<br />
If you want to do that you have to use an helper to create the class :<br />
<code>[cpp]<br />
//Listing 35 First Event Listener<br />
// C++<br />
// Don't forget the #include<com/sun/star/view/XSelectionChangeListener.hpp><br />
// Don't forget to add com.sun.star.view.XSelectionChangeListener \ in the makefile<br />
<br />
// Don't forget the #include <cppuhelper/implbase1.hxx><br />
<br />
typedef ::cppu::WeakImplHelper1< ::com::sun::star::view::XSelectionChangeListener > <br />
SelectionChangeListenerHelper;<br />
<br />
class SelectionChangeListener : public SelectionChangeListenerHelper<br />
{<br />
public:<br />
SelectionChangeListener()<br />
{printf("EventListener installed\n");fflush(stdout);}<br />
<br />
~SelectionChangeListener()<br />
{printf("EventListener released\n");fflush(stdout);}<br />
<br />
virtual void SAL_CALL selectionChanged(const com::sun::star::lang::EventObject& aEvent)<br />
throw ( RuntimeException)<br />
{<br />
printf("Selection changed \n");fflush(stdout);<br />
}<br />
<br />
virtual void SAL_CALL disposing ( const com::sun::star::lang::EventObject& aEventObj )<br />
throw(::com::sun::star::uno::RuntimeException)<br />
{ printf("object listened to will be disposed\n"); }<br />
}; <br />
</code><br />
The selectionChanged will be called when a selection changes : it only prints out a message. The fflush(stdout) is important if you want see the printf when the event occurs (thanks to [[CppSDKAuthors|Emmanuel GUY]]).<br />
Now we want to install this event listener : <br />
<code>[cpp]<br />
//Listing 36 Installing an Event Listener<br />
// C++<br />
// event listener<br />
// Don't forget the #include <com/sun/star/view/XSelectionSupplier.hpp><br />
// Don't forget to add com.sun.star.view.XSelectionSupplier \ in the makefile<br />
<br />
Reference< XSelectionSupplier > aSelSupp(rSpreadsheetController,UNO_QUERY);<br />
<br />
SelectionChangeListener *xListener = new SelectionChangeListener();<br />
<br />
Reference< XSelectionChangeListener > xSelChListener = <br />
static_cast< XSelectionChangeListener* > ( xListener );<br />
<br />
aSelSupp->addSelectionChangeListener(xSelChListener);<br />
<br />
getchar();<br />
aSelSupp->removeSelectionChangeListener(xSelChListener);<br />
</code><br />
We first instantiate our class as usual with a new, but we use after a static_cast before to install it with an appropriate method. For us this method is a addSelectionchangeListener(). It is important now that the program doesn't terminate without removing the listener. We use the C getchar() function for that but with real program this important part has to change.<br />
To test this code you have to provide a rSpreadsheetController interface. A way is to use the previous [[OpenOffice_Calc#A_third_Example|code]], removing the Java translation part. You then launch a OOocalc and select a cell range. You select an other cell range and see the message in the shell windows.<br />
MichaelJ1980 in oooforum indicates he has to write<br />
<code>[cpp]<br />
// C++<br />
SelectionChangeListener *xListener = ::new SelectionChangeListener();<br />
</code><br />
instead<br />
<code>[cpp]<br />
// C++<br />
SelectionChangeListener *xListener = new SelectionChangeListener();<br />
</code><br />
<br />
==A second Event Listener==<br />
Emmanuel GUY has posted an other example in OOoForum :<br />
[http://www.oooforum.org/forum/viewtopic.phtml?t=14697|Use events (XEventListener, XWindowListener, ...) in C++]<br />
<br />
=Graphics=<br />
<br />
==Embedding Images==<br />
<br />
Adding external images to a spreadsheet is possible, and this is different from linking to images. [http://codesnippets.services.openoffice.org/Calc/Calc.InsertImage.snip Linking to images] requires a user to have an external file that is always in the same location relative to the spreadsheet file, while embedding an image deals with including the image in the ODS file itself.<br />
<br />
First, suppose we have a model implementing the XModel interface, and is related to a spreadsheet. We can get the spreadsheet and current (active) sheet using the code below:<br />
<br />
<code>[java]<br />
XSpreadsheetDocument xDoc = (XSpreadsheetDocument)UnoRuntime.queryInterface(<br />
XSpreadsheetDocument.class, xDocModel);<br />
XSpreadsheetView xsv = (XSpreadsheetView)UnoRuntime.queryInterface(<br />
XSpreadsheetView.class, m_xFrame.getController());<br />
XSpreadsheet curSheet = xsv.getActiveSheet();<br />
</code><br />
<br />
Next, we need to create a XMultiServiceFactory object so we can create components in the actual file. We'll create a BitmapTable, which will be tricked into storing the image internally (([http://codesnippets.services.openoffice.org/Writer/Writer.EmbedAGraphicIntoATextdocument.snip source for Writer]).<br />
<br />
<code>[java]<br />
XMultiServiceFactory xmsf = (XMultiServiceFactory)UnoRuntime.queryInterface(<br />
XMultiServiceFactory.class, xDocModel);<br />
XNameContainer xBitmapContainer = (XNameContainer) UnoRuntime.queryInterface(<br />
XNameContainer.class, xmsf.createInstance("com.sun.star.drawing.BitmapTable"));<br />
</code><br />
<br />
The file itself is added to the container as a link, similar to how URLs are represented online. Thus, a path to an image in a user's home directory on Linux would be ''file:///home/username/image.png''. We add this link to the container, and then use the ''AnyConverter'' class to get a URL to the container itself, called the ''internalURL''. This ''internalURL'' will be used as the new link to the (now internal) image.<br />
<br />
<code>[java]<br />
String sPath = "file:///home/wojciech/Desktop/img.png"; <br />
xBitmapContainer.insertByName("someID", sPath);<br />
String internalURL = AnyConverter.toString(xBitmapContainer.getByName("someID"));<br />
</code><br />
<br />
The image itself is stored as an XShape object, which is created below.<br />
<br />
<code>[java]<br />
Object imgTemp = xmsf.createInstance("com.sun.star.drawing.GraphicObjectShape");<br />
XShape xImage = (XShape)UnoRuntime.queryInterface(XShape.class, imgTemp);<br />
</code><br />
<br />
Now we set the properties of the actual shape (and image):<br />
<br />
<code>[java]<br />
XPropertySet xpi = ( XPropertySet )UnoRuntime.queryInterface(XPropertySet.class, xImage );<br />
xpi.setPropertyValue("GraphicURL", internalURL);<br />
Size imgSize = new Size(2500, 5000);<br />
xImage.setSize(imgSize);<br />
</code><br />
<br />
And finally, we get the necessary objects to draw in the spreadsheet itself, and we draw the image. The last line of code simply removes the image entry from the temporary container.<br />
<br />
<code>[java]<br />
XDrawPageSupplier oDPS = (XDrawPageSupplier) UnoRuntime.queryInterface(<br />
XDrawPageSupplier.class, curSheet);<br />
XDrawPage xDrawPage = oDPS.getDrawPage(); <br />
xDrawPage.add(xImage);<br />
xBitmapContainer.removeByName("someID");<br />
</code><br />
<br />
{{Template:Home_Page}}<br />
<br />
= See also=<br />
<br />
* [http://perso.wanadoo.fr/moutou/MyUNODoc_HTML/UNOCppAPI5.html OpenOffice Calc] (Chapter 5 from UNO/C++ document) <br />
* Writing a Program to Control OpenOffice.org, by Franco Pingiori — [http://www.linuxjournal.com/article/8550 Part 1] and [http://www.linuxjournal.com/article/8608 Part 2], Linux Journal<br />
<br />
[[Category:Calc|API]]<br />
[[Category:API]]<br />
[[Category:Development]]<br />
[[Category:Cpp]]<br />
[[Category:Uno]]</div>Wojciechhttps://wiki.openoffice.org/w/index.php?title=Calc/API/Programming&diff=42530Calc/API/Programming2007-08-16T03:12:15Z<p>Wojciech: /* Embedding Images */</p>
<hr />
<div>==Introduction==<br />
To avoid to search in the previous code where we insert the new listings given in this chapter, we first give it again (only the main() part) :<br />
<code>[cpp]<br />
//Listing 1 Again our starting main Code<br />
int main( ) {<br />
//retrieve an instance of the remote service manager<br />
Reference< XMultiServiceFactory > rOfficeServiceManager;<br />
rOfficeServiceManager = ooConnect();<br />
if( rOfficeServiceManager.is() ){<br />
printf( "Connected sucessfully to the office\n" );<br />
}<br />
<br />
//get the desktop service using createInstance returns an XInterface type<br />
Reference< XInterface > Desktop = rOfficeServiceManager->createInstance(<br />
OUString::createFromAscii( "com.sun.star.frame.Desktop" ));<br />
<br />
//query for the XComponentLoader interface<br />
Reference< XComponentLoader > rComponentLoader (Desktop, UNO_QUERY);<br />
if( rComponentLoader.is() ){<br />
printf( "XComponentloader successfully instanciated\n" );<br />
}<br />
<br />
//get an instance of the spreadsheet<br />
Reference< XComponent > xcomponent = rComponentLoader->loadComponentFromURL(<br />
OUString::createFromAscii("private:factory/scalc"),<br />
OUString::createFromAscii("_blank"),<br />
0,<br />
Sequence < ::com::sun::star::beans::PropertyValue >());<br />
// add code here<br />
return 0;<br />
}<br />
</code><br />
Remember each time you query for an interface you have to add code lines (if they don't exist) in the source code and a line in the makefile. I will generally add comments to prevent omissions. You can find more explanations [[IDL_Files_and_Cpp#IDL__and_C.2B.2B|here]] (if you are not a beginner).<br />
<br />
=To find the Sheet=<br />
The most important interface for this chapter is XspreadsheetDocument. This interface supply the getSheets() method. This interface is inherited from XInterface which provide queries for a new interface to an existing UNO object : queryInterface.<br />
<br />
==An existing Sheet==<br />
If you know the sheet's name use the getByName method :<br />
<code>[cpp]<br />
//Listing 2 How to find a Sheet in a Spreadsheet<br />
//C++<br />
// Don't forget to add : using namespace com::sun::star::sheet;<br />
// Don't forget to add : #include <com/sun/star/sheet/XSpreadsheetDocument.hpp><br />
// Don't forget to add "com.sun.star.sheet.XSpreadsheetDocument \" in the makefile<br />
//query for a XSpreadsheetDocument interface <br />
Reference< XSpreadsheetDocument > rSheetDoc (xcomponent, UNO_QUERY); <br />
<br />
//use it to get the XSpreadsheets interface <br />
Reference< XSpreadsheets > rSheets = rSheetDoc->getSheets(); <br />
<br />
//use getByName to get a reference (type Any) <br />
Any rSheet = rSheets->getByName( OUString::createFromAscii("Sheet2"));<br />
</code> <br />
If we have a look at getByName method, we can see it can manage an “no such element” exception. The the previous code would be better written with a try and catch statement. <br />
<code>[cpp]<br />
Listing 3 Finding a Sheet and managing Exception<br />
//C++<br />
// Don't forget to add : using namespace com::sun::star::sheet;<br />
// Don't forget to add : #include <com/sun/star/sheet/XSpreadsheetDocument.hpp><br />
// Don't forget to add "com.sun.star.sheet.XSpreadsheetDocument \" in the makefile<br />
//query for a XSpreadsheetDocument interface <br />
Reference< XSpreadsheetDocument > rSheetDoc (xcomponent, UNO_QUERY); <br />
<br />
//use it to get the XSpreadsheets interface <br />
Reference< XSpreadsheets > rSheets = rSheetDoc->getSheets(); <br />
<br />
//use getByName to get a reference (type Any)<br />
try { <br />
Any rSheet = rSheets->getByName( OUString::createFromAscii("Sheet2")); <br />
}<br />
catch( Exception &e ){<br />
OString o = OUStringToOString( e.Message, RTL_TEXTENCODING_ASCII_US );<br />
printf( "Error: No such element ;%s\n", o.pData->buffer );<br />
}<br />
</code><br />
For sake of simplicity we will only use this exception managing only at the end of this document, when “helpers” will be tackled in ([[Constructing_Helpers|Constructing Helpers]]). <br />
If you only know the sheet's number you can retrieve the sheet using this way :<br />
<code>[cpp]<br />
//Listing 4 Finding a Sheet with an Index<br />
//C++<br />
// Don't forget to add : using namespace com::sun::star::sheet;<br />
// Don't forget to add : #include <com/sun/star/sheet/XSpreadsheetDocument.hpp><br />
// Don't forget to add "com.sun.star.sheet.XSpreadsheetDocument \" in the makefile<br />
// Don't forget to add : using namespace com::sun::star::container;<br />
// Don't forget to add : #include <com/sun/star/container/XIndexAccess.hpp><br />
// Don't forget to add "com.sun.star.container.XIndexAccess \" in the makefile<br />
//query for a XSpreadsheetDocument interface <br />
Reference< XSpreadsheetDocument > rSheetDoc (xcomponent, UNO_QUERY); <br />
<br />
//use it to get the XSpreadsheets interface <br />
Reference< XSpreadsheets > rSheets = rSheetDoc->getSheets();<br />
<br />
// query for the ::com::sun::star::container::XIndexAccess service<br />
Reference< XIndexAccess > rSheetsByIndex (rSheets, UNO_QUERY); <br />
<br />
//use getByName to get a reference (type Any) <br />
Any rSheet = rSheetsByIndex->getByIndex( (short)1 ); <br />
</code><br />
As you can see we have to query a new service XIndexAccess. This means adding two lines in the code and one in the makefile as seen in C++ comments.<br />
Take care : UNO considers the sheet numbering, starting from 0, and then 1 is the second sheet.<br />
<br />
==Create, rename, copy and delete a Sheet==<br />
To create a sheet the method insertNewByName is used :<br />
<code>[cpp]<br />
//Listing 5 Create a Sheet<br />
//C++<br />
// Don't forget to add : using namespace com::sun::star::sheet;<br />
// Don't forget to add : #include <com/sun/star/sheet/XSpreadsheetDocument.hpp><br />
// Don't forget to add "com.sun.star.sheet.XSpreadsheetDocument \" in the makefile<br />
//query for a XSpreadsheetDocument interface <br />
Reference< XSpreadsheetDocument > rSheetDoc (xcomponent, UNO_QUERY); <br />
<br />
//use it to get the XSpreadsheets interface <br />
Reference< XSpreadsheets > rSheets = rSheetDoc->getSheets(); <br />
<br />
//use it to create a new sheet called MySheet <br />
rSheets->insertNewByName(OUString::createFromAscii("MySheet"), (short)0);<br />
</code><br />
(short)0 is the index of position where the new sheet is inserted. Here “MySheet” will be the first sheet.<br />
<br />
How to move a sheet when its name is known:<br />
<code>[cpp]<br />
//Listing 6 Moving a Sheet<br />
//C++<br />
// Don't forget to add : using namespace com::sun::star::sheet;<br />
// Don't forget to add : #include <com/sun/star/sheet/XSpreadsheetDocument.hpp><br />
// Don't forget to add "com.sun.star.sheet.XSpreadsheetDocument \" in the makefile<br />
//query for a XSpreadsheetDocument interface <br />
Reference< XSpreadsheetDocument > rSheetDoc (xcomponent, UNO_QUERY); <br />
<br />
//use it to get the XSpreadsheets interface <br />
Reference< XSpreadsheets > rSheets = rSheetDoc->getSheets(); <br />
<br />
//use it to move a sheet called MySheet in third(back)/second(forward) position <br />
rSheets->moveByName(OUString::createFromAscii("MySheet"), (short)2);<br />
</code><br />
How to copy a sheet <br />
<code>[cpp]<br />
//Listing 7 Copying a Sheet<br />
//C++<br />
// Don't forget to add : using namespace com::sun::star::sheet;<br />
// Don't forget to add : #include <com/sun/star/sheet/XSpreadsheetDocument.hpp><br />
// Don't forget to add "com.sun.star.sheet.XSpreadsheetDocument \" in the makefile<br />
//query for a XSpreadsheetDocument interface <br />
Reference< XSpreadsheetDocument > rSheetDoc (xcomponent, UNO_QUERY); <br />
<br />
//use it to get the XSpreadsheets interface <br />
Reference< XSpreadsheets > rSheets = rSheetDoc->getSheets(); <br />
<br />
//use it to copy a sheet called MySheet in second position with the name "MySheet2" <br />
rSheets->copyByName(OUString::createFromAscii("MySheet"),<br />
OUString::createFromAscii("MySheet2"), (short)1);<br />
</code><br />
MySheet2 is an exact copy of "MySheet" inserted as a second sheet.<br />
How to rename a sheet : <br />
<code>[cpp]<br />
//Listing 8 Renaming a Sheet<br />
//C++ <br />
// Don't forget to add : using namespace com::sun::star::sheet;<br />
// Don't forget to add : #include <com/sun/star/sheet/XSpreadsheetDocument.hpp><br />
// Don't forget to add "com.sun.star.sheet.XSpreadsheetDocument \" in the makefile<br />
// Don't forget to add : using namespace com::sun::star::container;<br />
// Don't forget to add : #include <com/sun/star/container/XNamed.hpp><br />
// Don't forget to add "com.sun.star.container.XNamed \" in the makefile<br />
<br />
//query for a XSpreadsheetDocument interface <br />
Reference< XSpreadsheetDocument > rSheetDoc (xcomponent, UNO_QUERY); <br />
<br />
//use it to get the XSpreadsheets interface <br />
Reference< XSpreadsheets > rSheets = rSheetDoc->getSheets(); <br />
<br />
//use getByName to get a reference (type Any) <br />
Any rSheet = rSheets->getByName( OUString::createFromAscii("Sheet2")); <br />
<br />
// query for XNamed Interface<br />
Reference< XNamed > rname (rSheet, UNO_QUERY);<br />
<br />
// rename<br />
rname->setName(OUString::createFromAscii("MySheet")); <br />
</code><br />
<br />
How to remove a sheet :<br />
<code>[cpp]<br />
//Listing 9 Removing a Sheet<br />
// C++<br />
rSheets->removeByName(OUString::createFromAscii("Sheet1")); <br />
</code><br />
works properly. You can use also the XnameContainer interface like :<br />
<code>[cpp]<br />
//Listing 10 Removing a Sheet (an other way)<br />
// C++<br />
// Don't forget to add : using namespace com::sun::star::container;<br />
// Don't forget to add : #include <com/sun/star/container/XNameContainer.hpp><br />
// Don't forget to add "com.sun.star.container.xNameContainer \" in the makefile<br />
Reference<XNameContainer> xNameContainer (rSheets, UNO_QUERY);<br />
<br />
xNameContainer->removeByName(OUString::createFromAscii("Sheet1")); //OK<br />
</code><br />
<br />
==Retrieve or change the currently focused Sheet==<br />
<br />
How to set a known-named sheet as currently focused sheet :<br />
<code>[cpp]<br />
//Listing 11 Focus and C++ programming<br />
//C++ <br />
// Don't forget to add : using namespace com::sun::star::sheet;<br />
// Don't forget to add : #include <com/sun/star/sheet/XSpreadsheetDocument.hpp><br />
// Don't forget to add "com.sun.star.sheet.XSpreadsheetDocument \" in the makefile<br />
// Don't forget to add : using namespace com::sun::star::frame;<br />
// Don't forget to add : #include <com/sun/star/frame/XModel.hpp><br />
// Don't forget to add "com.sun.star.frame.XModel \" in the makefile<br />
<br />
// Don't forget to add : #include <com/sun/star/sheet/XSpreadsheetView.hpp><br />
// Don't forget to add "com.sun.star.sheet.XSpreadsheetView \" in the makefile<br />
<br />
// Don't forget to add : #include <com/sun/star/sheet/XSpreadsheet.hpp><br />
// Don't forget to add "com.sun.star.sheet.XSpreadsheet \" in the makefile<br />
<br />
//query for a XSpreadsheetDocument interface <br />
Reference< XSpreadsheetDocument > rSheetDoc (xcomponent, UNO_QUERY); <br />
Reference< XSpreadsheets > rSheets = rSheetDoc->getSheets(); <br />
<br />
//use getByName to get a reference (type Any) <br />
Any rSheet = rSheets->getByName( OUString::createFromAscii("Sheet2")); <br />
// we want to make our new sheet the current sheet, so we need to ask the model <br />
// for the controller: first query the XModel interface from our spreadsheet component <br />
<br />
//query for the XSpreadsheet interface<br />
Reference< XSpreadsheet > rSpSheet (rSheet, UNO_QUERY);<br />
<br />
Reference< XModel > rSpreadsheetModel (rSheetDoc, UNO_QUERY); <br />
<br />
// then get the current controller from the model <br />
Reference< XController > rSpreadsheetController = rSpreadsheetModel->getCurrentController(); <br />
<br />
// get the XSpreadsheetView interface from the controller, we want to call its method <br />
// setActiveSheet <br />
Reference< XSpreadsheetView > rSpreadsheetView (rSpreadsheetController, UNO_QUERY); <br />
<br />
// make our newly inserted sheet the active sheet using setActiveSheet <br />
rSpreadsheetView->setActiveSheet(rSpSheet); <br />
</code><br />
How to retrieve the currently focused sheet ? This problem is in fact a little variation of the previous one but the test is not so straightforward. If a new spreadsheet is created as previously we have no chance to choose ourself a sheet with focus because the program take always the same default sheet when just created. Then before resolving this problem we have to modify the loadComponentFromURL as previously done (<br />
[[ UNO_automation_with_a_binary_%28executable%29#The_default_opened_Document|default opened document]])<br />
Here is a piece of code which retrieves the sheet under focus. <br />
<code>[cpp]<br />
//Listing 12 Retrieve the Sheet under Focus<br />
//C++<br />
int main( ) {<br />
//retrieve an instance of the remote service manager<br />
Reference< XMultiServiceFactory > rOfficeServiceManager;<br />
rOfficeServiceManager = ooConnect();<br />
if( rOfficeServiceManager.is() ){<br />
printf( "Connected sucessfully to the office\n" );<br />
}<br />
<br />
//get the desktop service using createInstance returns an XInterface type<br />
Reference< XInterface > Desktop = rOfficeServiceManager->createInstance(<br />
OUString::createFromAscii( "com.sun.star.frame.Desktop" ));<br />
// Don't forget the #include <com/sun/star/frame/XDesktop.hpp><br />
// Don't forget to add com.sun.star.frame.XDesktop \ in the makefile<br />
//query the XDesktop Interface<br />
Reference< XDesktop > xDesktop (Desktop, UNO_QUERY);<br />
<br />
Reference< XComponent > xcomponent = xDesktop->getCurrentComponent();<br />
<br />
// Don't forget to add : using namespace com::sun::star::sheet;<br />
// Don't forget to add : #include <com/sun/star/sheet/XSpreadsheetDocument.hpp><br />
// Don't forget to add "com.sun.star.sheet.XSpreadsheetDocument \" in the makefile<br />
//query for a XSpreadsheetDocument interface<br />
Reference< XSpreadsheetDocument > rSheetDoc (xcomponent, UNO_QUERY);<br />
<br />
// Don't forget to add : using namespace com::sun::star::frame;<br />
// Don't forget to add : #include <com/sun/star/frame/XModel.hpp><br />
// Don't forget to add "com.sun.star.frame.XModel \" in the makefile<br />
Reference< XModel > rSpreadsheetModel (rSheetDoc, UNO_QUERY);<br />
<br />
// then get the current controller from the model<br />
Reference< XController > rSpreadsheetController = <br />
rSpreadsheetModel->getCurrentController();<br />
<br />
// Don't forget to add : #include <com/sun/star/sheet/XSpreadsheetView.hpp><br />
// Don't forget to add "com.sun.star.sheet.XSpreadsheetView \" in the makefile<br />
// get the XSpreadsheetView interface from the controller, we want to call its method<br />
// getActiveSheet<br />
Reference< XSpreadsheetView > rSpreadsheetView (rSpreadsheetController, UNO_QUERY);<br />
Reference< XSpreadsheet> rSheet=rSpreadsheetView->getActiveSheet();<br />
// for a test<br />
Reference< XCell > rCell = rSheet->getCellByPosition(0, 0);<br />
rCell->setFormula(OUString::createFromAscii("Hello"));<br />
<br />
return 0;<br />
}<br />
</code><br />
<br />
The way to obtain a cell is explained above, then don't read the two last lines before the return : they only allow me to test the code.<br />
<br />
=How to obtain the Cell=<br />
When you have your sheet, obtain a particular cell is easy :<br />
<code>[cpp]<br />
//Listing 13 Obtaining a Cell<br />
//C++<br />
// Don't forget to add : using namespace com::sun::star::sheet;<br />
// Don't forget to add : #include <com/sun/star/sheet/XSpreadsheetDocument.hpp><br />
// Don't forget to add "com.sun.star.sheet.XSpreadsheetDocument \" in the makefile<br />
// Don't forget to add : using namespace com::sun::star::table; (for XCell)<br />
// Don't forget to add : #include <com/sun/star/sheet/XSpreadsheet.hpp><br />
// Don't forget to add "com.sun.star.sheet.XSpreadsheet \" in the makefile<br />
//query for a XSpreadsheetDocument interface<br />
Reference< XSpreadsheetDocument > rSheetDoc (xcomponent, UNO_QUERY);<br />
<br />
//use it to get the XSpreadsheets interface<br />
Reference< XSpreadsheets > rSheets = rSheetDoc->getSheets();<br />
<br />
//use getByName to get a reference (type Any)<br />
Any rSheet = rSheets->getByName( OUString::createFromAscii("Sheet1"));<br />
<br />
//query for the XSpreadsheet interface<br />
Reference< XSpreadsheet > rSpSheet (rSheet, UNO_QUERY);<br />
<br />
Reference< XCell > rCell = rSpSheet->getCellByPosition(0, 0);<br />
</code><br />
The first parameter is the column number, and the second is the row number, both starting from 0. See above the example where we access to the top left cell called A1.<br />
<br />
=What can be done with a Cell ?=<br />
The XCell interface provide six methods :<br />
<br />
getFormula returns the formula string of a cell. <br />
setFormula sets a formula into the cell. <br />
getValue returns the floating point value of the cell. <br />
setValue sets a floating point value into the cell. <br />
getType returns the type of the cell. <br />
getError returns the error value of the cell. <br />
<br />
==Numerical Value in a Cell==<br />
To put a numerical value in a cell is easy :<br />
<code>[cpp]<br />
//Listing 14 Putting a numerical Value in a Cell<br />
//C++<br />
// Don't forget to add : using namespace com::sun::star::sheet;<br />
// Don't forget to add : #include <com/sun/star/sheet/XSpreadsheetDocument.hpp><br />
// Don't forget to add "com.sun.star.sheet.XSpreadsheetDocument \" in the makefile<br />
// Don't forget to add : using namespace com::sun::star::table; (for XCell)<br />
// Don't forget to add : #include <com/sun/star/sheet/XSpreadsheet.hpp><br />
// Don't forget to add "com.sun.star.sheet.XSpreadsheet \" in the makefile<br />
//query for a XSpreadsheetDocument interface<br />
Reference< XSpreadsheetDocument > rSheetDoc (xcomponent, UNO_QUERY);<br />
<br />
//use it to get the XSpreadsheets interface<br />
Reference< XSpreadsheets > rSheets = rSheetDoc->getSheets();<br />
<br />
//use getByName to get a reference (type Any)<br />
Any rSheet = rSheets->getByName( OUString::createFromAscii("Sheet1"));<br />
<br />
//query the reference of type Any for the XSpreadsheet interface<br />
Reference< XSpreadsheet > rSpSheet (rSheet, UNO_QUERY);<br />
<br />
Reference< XCell > rCell = rSpSheet->getCellByPosition(0, 0);<br />
<br />
//set the cell value then get another cell etc..<br />
rCell->setValue(219);<br />
rCell = rSpSheet->getCellByPosition(0, 1);<br />
rCell->setValue(25);<br />
</code><br />
==Formula in a Cell==<br />
To put a formula in a cell is straightforward : replace the previous setValue by setFormula. This gives us :<br />
<code>[cpp]<br />
//Listing 15 Putting a Formula in a Cell<br />
//C++<br />
Reference< XCell > rCell = rSpSheet->getCellByPosition(0, 0);<br />
rCell->setValue(21);<br />
rCell = rSpSheet->getCellByPosition(0, 1);<br />
rCell->setValue(23);<br />
rCell = rSpSheet->getCellByPosition(0, 2);<br />
rCell->setFormula(OUString::createFromAscii("=sum(A1:A2)"));<br />
</code><br />
which puts in fact the value 44 in A3.<br />
==String in a Cell==<br />
We use a similar principle as in previous example :<br />
<code>[cpp]<br />
//Listing 16 Putting a String (OUString) in a Cell<br />
//C++ <br />
//set a string in the cell <br />
rCell->setFormula(OUString::createFromAscii("Hello"));<br />
</code><br />
It is possible to change the textual content of a cell with a Cursor (XTextCursor interface). The code below allows us this change :<br />
<code>[cpp]<br />
//Listing 17 Change the String Content of a Cell<br />
//C++<br />
// Don't forget to add : using namespace com::sun::star::text;<br />
// Don't forget to add : #include <com/sun/star/text/XText.hpp><br />
// Don't forget to add "com.sun.star.text.XText \" in the makefile<br />
<br />
// query first the XText interface<br />
Reference< XText > rText (rCell, UNO_QUERY); <br />
<br />
//query for the XTextCursor interface <br />
//Reference< XTextCursor > rTextCurs (rText, UNO_QUERY); <br />
Reference< XTextCursor > rTextCurs = rText -> createTextCursor(); <br />
rTextCurs -> gotoEnd(false);<br />
rTextCurs -> setString(OUString::createFromAscii(" Bye"));<br />
</code><br />
Adding the code gives us “Hello Bye” in a cell.<br />
==What is the Content Type of a Cell ?==<br />
We naturally use a getType method of the XCell interface. It returns one of the four possibilities : EMPTY, VALUE, TEXT or FORMULA (::com::sun::star::table) How do we see the values in C++ ? We give here the partial content of CellContentType.idl :<br />
<br />
<pre><br />
// IDL<br />
namespace com<br />
{<br />
namespace sun<br />
{<br />
namespace star<br />
{<br />
namespace table<br />
{<br />
enum CellContentType<br />
{<br />
CellContentType_EMPTY = 0,<br />
CellContentType_VALUE = 1,<br />
CellContentType_TEXT = 2,<br />
CellContentType_FORMULA = 3,<br />
CellContentType_MAKE_FIXED_SIZE = SAL_MAX_ENUM<br />
};<br />
<br />
} // table<br />
} // star<br />
} // sun<br />
} // com<br />
</pre><br />
<br />
which shows us a “using namespace com::sun::star::table” allows us to write in C++ something like : CellContentType_EMPTY if we have added the following statement :<br />
<pre><br />
#include <com/sun/star/table/CellContentType.hpp><br />
</pre><br />
The code below is an example : <br />
<code>[cpp]<br />
Listing 18 Retrieve the Cell Content Type<br />
//C++<br />
// Don't forget to add : using namespace com::sun::star::sheet;<br />
// Don't forget to add : #include <com/sun/star/sheet/XSpreadsheetDocument.hpp><br />
// Don't forget to add "com.sun.star.sheet.XSpreadsheetDocument \" in the makefile<br />
// Don't forget to add : #include <com/sun/star/sheet/XSpreadsheet.hpp><br />
// Don't forget to add "com.sun.star.sheet.XSpreadsheet \" in the makefile<br />
<br />
// Don't forget to add #include <com/sun/star/table/CellContentType.hpp><br />
// Don't forget to add "com.sun.star.table.CellContentType \" in the makefile<br />
<br />
//query for a XSpreadsheetDocument interface<br />
Reference< XSpreadsheetDocument > rSheetDoc (xcomponent, UNO_QUERY);<br />
Reference< XSpreadsheets > rSheets = rSheetDoc->getSheets();<br />
<br />
Any rSheet = rSheets->getByName( OUString::createFromAscii("Sheet1"));<br />
//query the reference of type Any for the XSpreadsheet interface<br />
Reference< XSpreadsheet > rSpSheet (rSheet, UNO_QUERY);<br />
<br />
Reference< XCell > rCell = rSpSheet->getCellByPosition(0, 0);<br />
rCell->setValue(43);<br />
switch (rCell->getType()){<br />
case CellContentType_EMPTY : printf("Empty\n");break;<br />
case CellContentType_VALUE : printf("Numerical Value\n");break;<br />
case CellContentType_TEXT : printf("Text\n");break;<br />
case CellContentType_FORMULA : printf("Formula\n");break;<br />
}<br />
</code><br />
which writes out “Numerical Value”.<br />
<br />
==Computing the Formula==<br />
Two methods calculate() and calculateAll() are available from the XCalculaTable interface. You can query this interface from a XSreadsheetDocument.<br />
<br />
==Formating a Cell== <br />
The straight forwarder way to format a cell is to use an already defined-style in the spreadsheet. The predefined style's names are in English even they appear in other languages in Object Bar. They are : Result, Result2, Default, Heading, Heading1 ...<br />
<code>[cpp]<br />
//Listing 19 Formating a Cell<br />
//C++<br />
// Don't forget to add : using namespace com::sun::star::beans;<br />
// Don't forget to add : #include <com/sun/star/beans/XPropertySet.hpp><br />
// Don't forget to add "com.sun.star.beans.XPropertySet \" in the makefile<br />
<br />
//query for the cell property interface <br />
Reference< XPropertySet > rCellProps (rCell, UNO_QUERY); <br />
<br />
//create an Any to hold our property value <br />
Any mPropVal; <br />
mPropVal <<= OUString::createFromAscii("Result"); <br />
<br />
//set some properties <br />
rCellProps->setPropertyValue(OUString::createFromAscii("CellStyle"), mPropVal); <br />
</code><br />
==Cell Annotations==<br />
The following example inserts an annotation and make it permanently visible.<br />
<code>[cpp]<br />
//Listing 20 Putting and retrieve Cell Annotations<br />
//C++<br />
// Don't forget to add : using namespace com::sun::star::sheet;<br />
// Don't forget to add : #include <com/sun/star/sheet/XSpreadsheetDocument.hpp><br />
// Don't forget to add "com.sun.star.sheet.XSpreadsheetDocument \" in the makefile<br />
<br />
// Don't forget to add : #include <com/sun/star/sheet/XSpreadsheet.hpp><br />
// Don't forget to add "com.sun.star.sheet.XSpreadsheet \" in the makefile<br />
<br />
// Don't forget to add : #include <com/sun/star/sheet/XCellAddressable.hpp><br />
// Don't forget to add "com.sun.star.sheet.XCellAddressable \" in the makefile<br />
<br />
// Don't forget to add : #include <com/sun/star/sheet/XSheetAnnotationsSupplier.hpp><br />
// Don't forget to add "com.sun.star.sheet.XSheetAnnotationsSupplier \" in the makefile<br />
<br />
// Don't forget to add : #include <com/sun/star/sheet/XSheetAnnotationAnchor.hpp><br />
// Don't forget to add "com.sun.star.sheet.XSheetAnnotationAnchor \" in the makefile<br />
<br />
//query for a XSpreadsheetDocument interface<br />
Reference< XSpreadsheetDocument > rSheetDoc (xcomponent, UNO_QUERY);<br />
Reference< XSpreadsheets > rSheets = rSheetDoc->getSheets();<br />
<br />
Any rSheet = rSheets->getByName( OUString::createFromAscii("Sheet1"));<br />
<br />
//query the reference of type Any for the XSpreadsheet interface<br />
Reference< XSpreadsheet > rSpSheet (rSheet, UNO_QUERY);<br />
<br />
//query for XCell Interface<br />
Reference< XCell > rCell = rSpSheet->getCellByPosition(0, 0);<br />
<br />
//query for the XcellAddressable Interface<br />
Reference< XCellAddressable > rCellAddr (rCell, UNO_QUERY);<br />
CellAddress rAddress = rCellAddr -> getCellAddress();<br />
<br />
//query for XSheetAnnotationsSupplier Interface <br />
Reference< XSheetAnnotationsSupplier > rAnnotationSupp (rSheet, UNO_QUERY);<br />
Reference< XSheetAnnotations > rAnnotations = rAnnotationSupp -> getAnnotations();<br />
rAnnotations -> insertNew(rAddress,OUString::createFromAscii("This is an annotation"));<br />
<br />
// make the annotation visible<br />
<br />
//query the XSheetAnnotationAnchor<br />
Reference< XSheetAnnotationAnchor > rAnnotAnchor (rCell, UNO_QUERY);<br />
Reference< XSheetAnnotation > rAnnotation = rAnnotAnchor -> getAnnotation();<br />
rAnnotation->setIsVisible(true);<br />
</code><br />
If you want an annotation not always visible you only remove the three last lines. Very interesting to put an annotation, but how do you get it if it already exist ? You add for test into the previous code :<br />
<code>[cpp]<br />
//Listing 21 Code for Test of previous Listing<br />
// C++<br />
// Don't forget to add : using namespace com::sun::star::text;<br />
// Don't forget to add : #include <com/sun/star/text/XSimpleText.hpp><br />
// Don't forget to add "com.sun.star.sheet.XSimpleText \" in the makefile<br />
<br />
// query the XSimpleTextInterface<br />
Reference< XSimpleText > rSimpleText (rAnnotation, UNO_QUERY);<br />
<br />
printf("Annotation : %s\n",<br />
OUStringToOString(rSimpleText->getString(),RTL_TEXTENCODING_ASCII_US).getStr());<br />
// or if you want to put the text in the cell :<br />
// rCell->setFormula(rSimpleText->getString());<br />
</code><br />
which writes out the string literal :“Annotation : This is an annotation”.<br />
<br />
=Cell Range=<br />
The way to obtain a cell range is not so easy as in OooBasic. You have first to obtain the Xinterface to have access to the getcellRangeByName method :<br />
<code>[cpp]<br />
//Listing 22 Cell Range Manipulation<br />
//C++<br />
// Don't forget to add : using namespace com::sun::star::table;<br />
// Don't forget to add : #include <com/sun/star/table/XCellRange.hpp><br />
// Don't forget to add "com.sun.star.table.XCellRange \" in the makefile<br />
<br />
//query for a XSpreadsheetDocument interface <br />
Reference< XSpreadsheetDocument > rSheetDoc (xcomponent, UNO_QUERY); <br />
Reference< XSpreadsheets > rSheets = rSheetDoc->getSheets(); <br />
<br />
//use getByName to get a reference (type Any) <br />
Any rSheet = rSheets->getByName( OUString::createFromAscii("Sheet1")); <br />
<br />
// query for the XCellRange interface<br />
Reference< XCellRange > rSheetCellRange (rSheet, UNO_QUERY);<br />
<br />
// query the cell range<br />
Reference< XCellRange> rCellRange = <br />
rSheetCellRange->getCellRangeByName(OUString::createFromAscii("B2:F5"));<br />
</code> <br />
With the XCellRange interface you can also access the range with getCellRangeByPosition method.<br />
To query one cell in the cell range, add to the previous code :<br />
<code>[cpp]<br />
//Listing 23 Finding one Cell in the Range<br />
//C++<br />
Reference< XCell > rCell = rCellRange->getCellByPosition(0, 0);<br />
rCell->setFormula(OUString::createFromAscii("it works"));<br />
</code> <br />
The X and Y position are then relative to the cell Range.<br />
<br />
==Retrieve the absolute X and Y Positions of a Cell ==<br />
This subject has been already tackled in a previous section but embedded in other code. We need first a CellAddress type described in <OpenOffice.org1.1_SDK>/idl/com/sun/star/text/CellAddress.idl :<br />
<pre><br />
// IDL<br />
module com { module sun { module star { module table {<br />
struct CellAddress<br />
{<br />
short Sheet;<br />
long Column;<br />
long Row;<br />
};<br />
}; }; }; };<br />
</pre><br />
Starting from the previous listing and adding :<br />
<code>[cpp]<br />
//Listing 24 Absolute Position of a Cell<br />
// C++<br />
// Don't forget to add : #include <com/sun/star/sheet/XCellAddressable.hpp><br />
// Don't forget to add "com.sun.star.sheet.XCellAddressable \" in the makefile<br />
<br />
// Don't forget to add : #include <com/sun/star/table/CellAddress.hpp><br />
// Don't forget to add "com.sun.star.table.CellAddress \" in the makefile<br />
<br />
//query for the XcellAddressable Interface<br />
Reference< XCellAddressable > rCellAddr (rCell, UNO_QUERY);<br />
CellAddress rAddress = rCellAddr -> getCellAddress();<br />
printf("sheet : %d, column : %d row: %d \n",<br />
rAddress.Sheet,rAddress.Column,rAddress.Row);<br />
</code><br />
gives us a program which writes out the absolute X and Y position of a cell.<br />
<br />
==Retrieve the absolute Address of the Cell Range==<br />
We need first a CellRangeAddress type described in <OpenOffice.org1.1_SDK>/idl/com/sun/star/table/CellRangeAddress.idl :<br />
<pre><br />
// IDL<br />
module com { module sun { module star { module table {<br />
<br />
struct CellRangeAddress<br />
{<br />
short Sheet;<br />
long StartColumn;<br />
long StartRow;<br />
long EndColumn;<br />
long EndRow;<br />
};<br />
}; }; }; };<br />
</pre><br />
and a XCellRangeAdressable interface. Starting from the cell range program, we add :<br />
<code>[cpp]<br />
//Listing 25 Using XCellRangeAddressable Interface<br />
// C++<br />
// Don't forget to add : #include <com/sun/star/sheet/XCellRangeAddressable.hpp><br />
// Don't forget to add "com.sun.star.sheet.XCellRangeAddressable \" in the makefile<br />
<br />
// Don't forget to add : #include <com/sun/star/sheet/CellRangeAddress.hpp><br />
// Don't forget to add "com.sun.star.sheet.CellRangeAddress \" in the makefile<br />
<br />
//query for the XCellRangeAddressable interface<br />
Reference< XCellRangeAddressable > rCellRangeAddr (rCellRange, UNO_QUERY);<br />
CellRangeAddress rRangeAddress = rCellRangeAddr -> getRangeAddress();<br />
printf("sheet : %d, start column : %d start row: %d ...\n",<br />
rRangeAddress.Sheet,rRangeAddress.StartColumn,rRangeAddress.StartRow);<br />
</code><br />
This program only writes out three of the five cell range attribute.<br />
==Getting a Cell range with a Selection==<br />
We have tackled a similar problem in section (<br />
[[OpenOffice_Calc#Retrieve_or_change_the_currently_focused_Sheet|Retrieve or change the currently focused Sheet]]) The way is to also start from a XModel interface, and query with getCurrentSelection an XInterface and then query an XCellRange interface. <br />
<code>[cpp]<br />
//Listing 26 Cell Range under Focus<br />
// C++<br />
Reference< XInterface > rInterface = rSpreadsheetModel->getCurrentSelection();<br />
<br />
// Don't forget to add : #include <com/sun/star/table/XCellRange.hpp><br />
// Don't forget to add "com.sun.star.table.XCellRange \" in the makefile<br />
Reference< XCellRange > rCellRange(rInterface,UNO_QUERY);<br />
rCell = rCellRange ->getCellByPosition(0, 0);<br />
rCell->setFormula(OUString::createFromAscii("Hello !!!"));<br />
</code><br />
This code writes out “Hello !!!” in the top left corner of the selected range.<br />
<br />
=Ready to translate the Developpers Guide into C++=<br />
When you want to go further, the Developers Guide is a good start. But examples are given in Java code. You have then to learn how to translate it into C++. At first glance you can find this translation as a complicate task but I have experimented it as a Java complete novice when writing the chapter on annotation and encounter no difficulties. But I was lucky, I present now examples which give me more difficulties. <br />
<br />
==The Compute Function Example==<br />
Let's start with Compute Function SDK's example :<br />
<code>[java]<br />
//Listing 27 Java first Example (from SDK)<br />
// Java<br />
// --- Sheet operation. --- <br />
// Compute a function <br />
com.sun.star.sheet.XSheetOperation xSheetOp = <br />
(com.sun.star.sheet.XSheetOperation) UnoRuntime.queryInterface<br />
(com.sun.star.sheet.XSheetOperation.class, xCellRange);<br />
double fResult = xSheetOp.computeFunction(com.sun.star.sheet.GeneralFunction.AVERAGE); System.out.println("Average value of the data table A10:C30: " + fResult); <br />
// Clear cell contents<br />
xSheetOp.clearContents( com.sun.star.sheet.CellFlags.ANNOTATION |<br />
com.sun.star.sheet.CellFlags.OBJECTS);<br />
</code><br />
<br />
The C++ translation gives (keeping the same variables names as in Java code) :<br />
<code>[cpp]<br />
//Listing 28 C++ Translation : calling a buildin Function<br />
// C++<br />
// Don't forget to add : #include <com/sun/star/sheet/XSheetOperation.hpp><br />
// Don't forget to add "com.sun.star.sheet.XSheetOperation \" in the makefile<br />
<br />
// Don't forget to add : #include <com/sun/star/sheet/GeneralFunction.hpp><br />
// and see in GeneralFunction.hdl how AVERAGE is generated : here GeneralFunction_AVERAGE<br />
// Don't forget to add "com.sun.star.sheet.GeneralFunction \" in the makefile<br />
<br />
// Don't forget to add : #include <com/sun/star/sheet/CellFlags.hpp><br />
// and see in CellFlags.hdl how ANNOTATION and OBJECT are generated : here ANNOTATION, OBJECT<br />
// in the namespace CellFlags donc :<br />
// Don't forget to add : using namespace com::sun::star::sheet::CellFlags;<br />
// Don't forget to add "com.sun.star.sheet.CellFlags \" in the makefile<br />
<br />
// --- Sheet operation. ---<br />
// Compute a function<br />
Reference< XSheetOperation > xSheetOp( xCellRange,UNO_QUERY);<br />
double fResult= xSheetOp->computeFunction(GeneralFunction_AVERAGE);<br />
printf("Average value of the data table B2:C4: %f", fResult);<br />
// Clear cell contents<br />
xSheetOp->clearContents( ANNOTATION | OBJECTS);<br />
</code><br />
We can see the UNO calls are simpler in C++ than in Java. I have added comments to explain how constants are managed. We are lucky with this piece of code : we can see two different kind of constant :<br />
* one with a specific name : GeneralFunction_AVERAGE instead of AVERAGE in Java. This problem of enumeration has already been tackled [[SDKCppLanguage#To_go_further_:_the_Enumeration_Type_Problem|here]].<br />
* one with the same name as in IDL and Java files but in a namespace which requires the classical “using namespace”.<br />
<br />
To find information requires to generate hdl and hpp files from IDL files and to read not the hpp but hdl files. This job is let for novices, others can see all in IDL files : see the difference between :<br />
<pre><br />
// IDL<br />
// extracted from CellFlags.idl<br />
constants CellFlags<br />
{<br />
const long VALUE = 1;<br />
const long DATETIME = 2;<br />
const long STRING = 4;<br />
const long ANNOTATION = 8;<br />
const long FORMULA = 16;<br />
const long HARDATTR = 32;<br />
const long OBJECTS = 128;<br />
const long EDITATTR = 256;<br />
};<br />
</pre><br />
and<br />
<pre><br />
// IDL<br />
// extracted from GeneralFunction.idl<br />
enum GeneralFunction<br />
{<br />
NONE,<br />
AUTO,<br />
SUM,<br />
COUNT,<br />
AVERAGE,<br />
MAX,<br />
MIN,<br />
PRODUCT,<br />
COUNTNUMS,<br />
STDEV,<br />
STDEVP,<br />
VAR,<br />
VARP<br />
};<br />
</pre><br />
and the consequences on the constants use. You can deduce tips isn't it ?<br />
<br />
==A second Example : adding a Name to a Cell (or Cell Range)==<br />
We give first the Java code still found in SDK :<br />
<code>[java]<br />
//Listing 29 Second Java Example<br />
// Java<br />
// insert a named range <br />
com.sun.star.beans.XPropertySet xDocProp = (com.sun.star.beans.XPropertySet)<br />
UnoRuntime.queryInterface(com.sun.star.beans.XPropertySet.class, xDocument);<br />
Object aRangesObj = xDocProp.getPropertyValue("NamedRanges");<br />
com.sun.star.sheet.XNamedRanges xNamedRanges = (com.sun.star.sheet.XNamedRanges) UnoRuntime.queryInterface(com.sun.star.sheet.XNamedRanges.class, aRangesObj);<br />
com.sun.star.table.CellAddress aRefPos = new com.sun.star.table.CellAddress(); aRefPos.Sheet = 0; <br />
aRefPos.Column = 6; <br />
aRefPos.Row = 44; <br />
xNamedRanges.addNewByName("ExampleName", "SUM(G43:G44)", aRefPos, 0);<br />
// use the named range in formulas <br />
xSheet.getCellByPosition(6, 44).setFormula("=ExampleName"); <br />
xSheet.getCellByPosition(7, 44).setFormula("=ExampleName");<br />
</code><br />
The same code in C++ :<br />
<code>[cpp]<br />
//Listing 30 naming a Cell (Range)<br />
// C++<br />
// Don't forget to add : #include <com/sun/star/beans/XPropertySet.hpp><br />
// Don't forget to add "com.sun.star.beans.XPropertySet \" in the makefile<br />
<br />
// Don't forget to add : #include <com/sun/star/sheet/XNamedRanges.hpp><br />
// Don't forget to add "com.sun.star.sheet.XNamedRanges \" in the makefile<br />
<br />
// Don't forget to add : #include <com/sun/star/table/CellAddress.hpp><br />
// Don't forget to add "com.sun.star.table.CellAddress \" in the makefile<br />
<br />
// insert a named range <br />
// !!! rSheetDoc instead xDocument in our previous code !!!<br />
Reference< XPropertySet > xDocProp(xDocument, UNO_QUERY); <br />
Any aRangesObj = xDocProp->getPropertyValue(OUString::createFromAscii("NamedRanges"));<br />
Reference< XNamedRanges > xNamedRanges(aRangesObj,UNO_QUERY);<br />
CellAddress aRefPos;<br />
aRefPos.Sheet = 0;<br />
aRefPos.Column = 6;<br />
aRefPos.Row = 44;<br />
xNamedRanges->addNewByName(OUString::createFromAscii("ExampleName"),<br />
OUString::createFromAscii("SUM(G43:G44)"), aRefPos, 0);<br />
// use the named range in formulas<br />
// !!! rSpSheet instead xSheet in our previous code !!!<br />
xSheet->getCellByPosition(6, 44)->setFormula(OUString::createFromAscii("=ExampleName"));<br />
xSheet->getCellByPosition(7, 44)->setFormula(OUString::createFromAscii("=ExampleName"));<br />
</code><br />
We can see Object is translated by Any. You have to add “OUString::createFromAscii “ before all strings. This program names a cell “ExampleName” and gives a value associated with this name : "SUM(G43:G44)". When you use this name it is replaced by its value.<br />
<br />
==A third Example==<br />
Here is an other example :<br />
<code>[java]<br />
//Listing 31 Java third Example<br />
// Java<br />
// --- Cell range data --- <br />
com.sun.star.sheet.XCellRangeData xData = (com.sun.star.sheet.XCellRangeData)<br />
UnoRuntime.queryInterface(com.sun.star.sheet.XCellRangeData.class, xCellRange); <br />
Object[][] aValues = { {new Double(1.1), new Integer(10)}, <br />
{new Double(2.2), new String("")},<br />
{new Double(3.3), new String("Text")} }; <br />
xData.setDataArray(aValues);<br />
</code><br />
This very interesting example takes values from an array and put them in a cell range.<br />
The code is given below :<br />
<code>[cpp]<br />
//Listing 32 Putting Cell Range Values in an Array<br />
//C++<br />
// Don't forget to add : using namespace com::sun::star::sheet;<br />
// Don't forget to add : #include <com/sun/star/sheet/XSpreadsheetDocument.hpp><br />
// Don't forget to add "com.sun.star.sheet.XSpreadsheetDocument \" in the makefile<br />
//query for a XSpreadsheetDocument interface<br />
Reference< XSpreadsheetDocument > rSheetDoc (xcomponent, UNO_QUERY);<br />
<br />
//use it to get the XSpreadsheets interface<br />
// Reference< XSpreadsheets > rSheets = rSheetDoc->getSheets();<br />
<br />
// Don't forget to add : using namespace com::sun::star::frame;<br />
// Don't forget to add : #include <com/sun/star/frame/XModel.hpp><br />
// Don't forget to add "com.sun.star.frame.XModel \" in the makefile<br />
Reference< XModel > rSpreadsheetModel (rSheetDoc, UNO_QUERY);<br />
<br />
// then get the current controller from the model<br />
Reference< XController > rSpreadsheetController = <br />
rSpreadsheetModel->getCurrentController();<br />
<br />
// Don't forget to add : #include <com/sun/star/sheet/XSpreadsheetView.hpp><br />
// Don't forget to add "com.sun.star.sheet.XSpreadsheetView \" in the makefile<br />
// get the XSpreadsheetView interface from the controller, we want to call its method<br />
// setActiveSheet<br />
Reference< XSpreadsheetView > rSpreadsheetView (rSpreadsheetController, UNO_QUERY);<br />
Reference< XSpreadsheet> rSheet=rSpreadsheetView->getActiveSheet();<br />
<br />
Reference< XInterface > rInterface = rSpreadsheetModel->getCurrentSelection();<br />
<br />
// Don't forget to add : #include <com/sun/star/table/XCellRange.hpp><br />
// Don't forget to add "com.sun.star.table.XCellRange \" in the makefile<br />
Reference< XCellRange > rCellRange(rInterface,UNO_QUERY);<br />
<br />
// Don't forget to add : #include <com/sun/star/sheet/XCellRangeData.hpp><br />
// Don't forget to add "com.sun.star.sheet.XCellRangeData \" in the makefile<br />
Reference< XCellRangeData> xData(rCellRange, UNO_QUERY);<br />
<br />
// Java translation begins here .........<br />
Sequence< Sequence< Any > > aValues(3); // or aValues(1)(2); ?????<br />
Sequence< Any > aValues2(2);<br />
aValues2[0] <<= (double) 1.1; aValues2[1] <<= (sal_Int32)10;<br />
aValues[0] = aValues2;<br />
aValues2[0] <<= (double)2.2; aValues2[1] <<= OUString::createFromAscii("");<br />
aValues[1] = aValues2;<br />
aValues2[0] <<= (double)3.3; aValues2[1] <<= OUString::createFromAscii("Text");<br />
aValues[2] = aValues2;<br />
xData -> setDataArray(aValues);<br />
</code><br />
can be compiled and works if we have an opened OOoCalc document with focus on a cell range of two rows and three lines. This is important : the cell range size must be the same as the sequence sequence of any !<br />
<br />
<br />
==An Example from OooForum: opening a Password protected Document==<br />
Kscape posts :<br />
“There is some example java code for opening a passworded file which will prompt the user for the password at [http://codesnippets.services.openoffice.org/Office/Office.openPwdProtectedFile.snip|OOo snippets] <br />
but there is no example C++ code, and I cannot seem to get the services and queries around the right way. <br />
Any chance someone can translate that snippet or provide a full example C++ program which will open a passworded document? <br />
<br />
Thanks in advance. “<br />
<br />
Here is the corresponding Java code :<br />
<code>[java]<br />
//Listing 33 Java starting Code<br />
// Java<br />
XInteractionHandler xHandler = (XInteractionHandler)UnoRuntime.queryInterface( XInteractionHandler.class, xSMGR.createInstance("com.sun.star.task.InteractionHandler"));<br />
<br />
PropertyValue[] lArgs = new PropertyValue[1];<br />
lArgs[0] = new PropertyValue();<br />
lArgs[0].Name = "InteractionHandler";<br />
lArgs[0].Value = xHandler;<br />
<br />
xDoc = xDesktop.loadComponentFromURL(sURL, sTarget, nSearchFlags, lArgs);<br />
</code><br />
Here is the C++ translation :<br />
<code>[cpp]<br />
//Listing 34 The correspnding C++ Code<br />
// C++ <br />
// Don't forget to add : #include <com/sun/star/task/XInteractionHandler.hpp> <br />
// Don't forget to add "com.sun.star.task.XInteractionHandler \" in the makefile <br />
// Don't forget to add : using namespace com::sun::star::task; <br />
<br />
Reference <XInteractionHandler> xHandler = <br />
Reference<XInteractionHandler>( rOfficeServiceManager->createInstance( <br />
OUString( RTL_CONSTASCII_USTRINGPARAM( <br />
"com.sun.star.task.InteractionHandler" ))), UNO_QUERY ); <br />
if (xHandler.is()) printf("xHandler OK...\n"); else printf("Error xHandler ... \n"); <br />
<br />
Sequence <PropertyValue > largs(1); <br />
largs[0].Name = OUString::createFromAscii("InteractionHandler"); <br />
largs[0].Value = makeAny(xHandler); <br />
<br />
//get an instance of the OOoDraw document <br />
Reference< XComponent > xcomponent = rComponentLoader->loadComponentFromURL( <br />
OUString::createFromAscii("private:factory/sdraw"), <br />
OUString::createFromAscii("_blank"), <br />
0, <br />
largs); <br />
</code><br />
=Event Listener=<br />
==First Event Listener==<br />
Event listener in C++ are not documented in the Developer's Guide. To find a way to resolve this problem I first read Java Code. I deduce if you want to implement an event listener you have to construct a class which inherit from a known class and then install it. My first try hang completely OOo (without a message...) After I decided to read OOo' source code and hope to find an example. It was the case in the file : OOo_1.1.3_src/basic/source/basmgr/basmgr.cxx<br />
If you want to do that you have to use an helper to create the class :<br />
<code>[cpp]<br />
//Listing 35 First Event Listener<br />
// C++<br />
// Don't forget the #include<com/sun/star/view/XSelectionChangeListener.hpp><br />
// Don't forget to add com.sun.star.view.XSelectionChangeListener \ in the makefile<br />
<br />
// Don't forget the #include <cppuhelper/implbase1.hxx><br />
<br />
typedef ::cppu::WeakImplHelper1< ::com::sun::star::view::XSelectionChangeListener > <br />
SelectionChangeListenerHelper;<br />
<br />
class SelectionChangeListener : public SelectionChangeListenerHelper<br />
{<br />
public:<br />
SelectionChangeListener()<br />
{printf("EventListener installed\n");fflush(stdout);}<br />
<br />
~SelectionChangeListener()<br />
{printf("EventListener released\n");fflush(stdout);}<br />
<br />
virtual void SAL_CALL selectionChanged(const com::sun::star::lang::EventObject& aEvent)<br />
throw ( RuntimeException)<br />
{<br />
printf("Selection changed \n");fflush(stdout);<br />
}<br />
<br />
virtual void SAL_CALL disposing ( const com::sun::star::lang::EventObject& aEventObj )<br />
throw(::com::sun::star::uno::RuntimeException)<br />
{ printf("object listened to will be disposed\n"); }<br />
}; <br />
</code><br />
The selectionChanged will be called when a selection changes : it only prints out a message. The fflush(stdout) is important if you want see the printf when the event occurs (thanks to [[CppSDKAuthors|Emmanuel GUY]]).<br />
Now we want to install this event listener : <br />
<code>[cpp]<br />
//Listing 36 Installing an Event Listener<br />
// C++<br />
// event listener<br />
// Don't forget the #include <com/sun/star/view/XSelectionSupplier.hpp><br />
// Don't forget to add com.sun.star.view.XSelectionSupplier \ in the makefile<br />
<br />
Reference< XSelectionSupplier > aSelSupp(rSpreadsheetController,UNO_QUERY);<br />
<br />
SelectionChangeListener *xListener = new SelectionChangeListener();<br />
<br />
Reference< XSelectionChangeListener > xSelChListener = <br />
static_cast< XSelectionChangeListener* > ( xListener );<br />
<br />
aSelSupp->addSelectionChangeListener(xSelChListener);<br />
<br />
getchar();<br />
aSelSupp->removeSelectionChangeListener(xSelChListener);<br />
</code><br />
We first instantiate our class as usual with a new, but we use after a static_cast before to install it with an appropriate method. For us this method is a addSelectionchangeListener(). It is important now that the program doesn't terminate without removing the listener. We use the C getchar() function for that but with real program this important part has to change.<br />
To test this code you have to provide a rSpreadsheetController interface. A way is to use the previous [[OpenOffice_Calc#A_third_Example|code]], removing the Java translation part. You then launch a OOocalc and select a cell range. You select an other cell range and see the message in the shell windows.<br />
MichaelJ1980 in oooforum indicates he has to write<br />
<code>[cpp]<br />
// C++<br />
SelectionChangeListener *xListener = ::new SelectionChangeListener();<br />
</code><br />
instead<br />
<code>[cpp]<br />
// C++<br />
SelectionChangeListener *xListener = new SelectionChangeListener();<br />
</code><br />
<br />
==A second Event Listener==<br />
Emmanuel GUY has posted an other example in OOoForum :<br />
[http://www.oooforum.org/forum/viewtopic.phtml?t=14697|Use events (XEventListener, XWindowListener, ...) in C++]<br />
<br />
=Graphics=<br />
<br />
==Embedding Images==<br />
<br />
Adding external images to a spreadsheet is possible, and this is different from linking to images. [http://codesnippets.services.openoffice.org/Calc/Calc.InsertImage.snip Linking to images] requires a user to have an external file that is always in the same location relative to the spreadsheet file, while embedding an image deals with including the image in the ODS file itself.<br />
<br />
First, suppose we have a model implementing the XModel interface, and is related to a spreadsheet. We can get the spreadsheet and current (active) sheet using the code below:<br />
<br />
<code>[java]<br />
XSpreadsheetDocument xDoc = (XSpreadsheetDocument)UnoRuntime.queryInterface(<br />
XSpreadsheetDocument.class, xDocModel);<br />
XSpreadsheetView xsv = (XSpreadsheetView)UnoRuntime.queryInterface(<br />
XSpreadsheetView.class, m_xFrame.getController());<br />
XSpreadsheet curSheet = xsv.getActiveSheet();<br />
</code><br />
<br />
Next, we need to create a XMultiServiceFactory object so we can create components in the actual file. We'll create a BitmapTable, which will be tricked into storing the image internally (([http://codesnippets.services.openoffice.org/Writer/Writer.EmbedAGraphicIntoATextdocument.snip source for Writer]).<br />
<br />
<code>[java]<br />
XMultiServiceFactory xmsf = (XMultiServiceFactory)UnoRuntime.queryInterface(XMultiServiceFactory.class, xDocModel);<br />
XNameContainer xBitmapContainer = (XNameContainer) UnoRuntime.queryInterface(<br />
XNameContainer.class, xmsf.createInstance("com.sun.star.drawing.BitmapTable"));<br />
</code><br />
<br />
The file itself is added to the container as a link, similar to how URLs are represented online. Thus, a path to an image in a user's home directory on Linux would be ''file:///home/username/image.png''. We add this link to the container, and then use the ''AnyConverter'' class to get a URL to the container itself, called the ''internalURL''. This ''internalURL'' will be used as the new link to the (now internal) image.<br />
<br />
<code>[java]<br />
String sPath = "file:///home/wojciech/Desktop/img.png"; <br />
xBitmapContainer.insertByName("someID", sPath);<br />
String internalURL = AnyConverter.toString(xBitmapContainer.getByName("someID"));<br />
</code><br />
<br />
The image itself is stored as an XShape object, which is created below.<br />
<br />
<code>[java]<br />
Object imgTemp = xmsf.createInstance("com.sun.star.drawing.GraphicObjectShape");<br />
XShape xImage = (XShape)UnoRuntime.queryInterface(XShape.class, imgTemp);<br />
</code><br />
<br />
Now we set the properties of the actual shape (and image):<br />
<br />
<code>[java]<br />
XPropertySet xpi = ( XPropertySet )UnoRuntime.queryInterface(XPropertySet.class, xImage );<br />
xpi.setPropertyValue("GraphicURL", internalURL);<br />
Size imgSize = new Size(2500, 5000);<br />
xImage.setSize(imgSize);<br />
</code><br />
<br />
And finally, we get the necessary objects to draw in the spreadsheet itself, and we draw the image. The last line of code simply removes the image entry from the temporary container.<br />
<br />
<code>[java]<br />
XDrawPageSupplier oDPS = (XDrawPageSupplier) UnoRuntime.queryInterface(<br />
XDrawPageSupplier.class, curSheet);<br />
XDrawPage xDrawPage = oDPS.getDrawPage(); <br />
xDrawPage.add(xImage);<br />
xBitmapContainer.removeByName("someID");<br />
</code><br />
<br />
{{Template:Home_Page}}<br />
<br />
= See also=<br />
<br />
* [http://perso.wanadoo.fr/moutou/MyUNODoc_HTML/UNOCppAPI5.html OpenOffice Calc] (Chapter 5 from UNO/C++ document) <br />
* Writing a Program to Control OpenOffice.org, by Franco Pingiori — [http://www.linuxjournal.com/article/8550 Part 1] and [http://www.linuxjournal.com/article/8608 Part 2], Linux Journal<br />
<br />
[[Category:Calc|API]]<br />
[[Category:API]]<br />
[[Category:Development]]<br />
[[Category:Cpp]]<br />
[[Category:Uno]]</div>Wojciechhttps://wiki.openoffice.org/w/index.php?title=Calc/API/Programming&diff=42529Calc/API/Programming2007-08-16T03:10:59Z<p>Wojciech: </p>
<hr />
<div>==Introduction==<br />
To avoid to search in the previous code where we insert the new listings given in this chapter, we first give it again (only the main() part) :<br />
<code>[cpp]<br />
//Listing 1 Again our starting main Code<br />
int main( ) {<br />
//retrieve an instance of the remote service manager<br />
Reference< XMultiServiceFactory > rOfficeServiceManager;<br />
rOfficeServiceManager = ooConnect();<br />
if( rOfficeServiceManager.is() ){<br />
printf( "Connected sucessfully to the office\n" );<br />
}<br />
<br />
//get the desktop service using createInstance returns an XInterface type<br />
Reference< XInterface > Desktop = rOfficeServiceManager->createInstance(<br />
OUString::createFromAscii( "com.sun.star.frame.Desktop" ));<br />
<br />
//query for the XComponentLoader interface<br />
Reference< XComponentLoader > rComponentLoader (Desktop, UNO_QUERY);<br />
if( rComponentLoader.is() ){<br />
printf( "XComponentloader successfully instanciated\n" );<br />
}<br />
<br />
//get an instance of the spreadsheet<br />
Reference< XComponent > xcomponent = rComponentLoader->loadComponentFromURL(<br />
OUString::createFromAscii("private:factory/scalc"),<br />
OUString::createFromAscii("_blank"),<br />
0,<br />
Sequence < ::com::sun::star::beans::PropertyValue >());<br />
// add code here<br />
return 0;<br />
}<br />
</code><br />
Remember each time you query for an interface you have to add code lines (if they don't exist) in the source code and a line in the makefile. I will generally add comments to prevent omissions. You can find more explanations [[IDL_Files_and_Cpp#IDL__and_C.2B.2B|here]] (if you are not a beginner).<br />
<br />
=To find the Sheet=<br />
The most important interface for this chapter is XspreadsheetDocument. This interface supply the getSheets() method. This interface is inherited from XInterface which provide queries for a new interface to an existing UNO object : queryInterface.<br />
<br />
==An existing Sheet==<br />
If you know the sheet's name use the getByName method :<br />
<code>[cpp]<br />
//Listing 2 How to find a Sheet in a Spreadsheet<br />
//C++<br />
// Don't forget to add : using namespace com::sun::star::sheet;<br />
// Don't forget to add : #include <com/sun/star/sheet/XSpreadsheetDocument.hpp><br />
// Don't forget to add "com.sun.star.sheet.XSpreadsheetDocument \" in the makefile<br />
//query for a XSpreadsheetDocument interface <br />
Reference< XSpreadsheetDocument > rSheetDoc (xcomponent, UNO_QUERY); <br />
<br />
//use it to get the XSpreadsheets interface <br />
Reference< XSpreadsheets > rSheets = rSheetDoc->getSheets(); <br />
<br />
//use getByName to get a reference (type Any) <br />
Any rSheet = rSheets->getByName( OUString::createFromAscii("Sheet2"));<br />
</code> <br />
If we have a look at getByName method, we can see it can manage an “no such element” exception. The the previous code would be better written with a try and catch statement. <br />
<code>[cpp]<br />
Listing 3 Finding a Sheet and managing Exception<br />
//C++<br />
// Don't forget to add : using namespace com::sun::star::sheet;<br />
// Don't forget to add : #include <com/sun/star/sheet/XSpreadsheetDocument.hpp><br />
// Don't forget to add "com.sun.star.sheet.XSpreadsheetDocument \" in the makefile<br />
//query for a XSpreadsheetDocument interface <br />
Reference< XSpreadsheetDocument > rSheetDoc (xcomponent, UNO_QUERY); <br />
<br />
//use it to get the XSpreadsheets interface <br />
Reference< XSpreadsheets > rSheets = rSheetDoc->getSheets(); <br />
<br />
//use getByName to get a reference (type Any)<br />
try { <br />
Any rSheet = rSheets->getByName( OUString::createFromAscii("Sheet2")); <br />
}<br />
catch( Exception &e ){<br />
OString o = OUStringToOString( e.Message, RTL_TEXTENCODING_ASCII_US );<br />
printf( "Error: No such element ;%s\n", o.pData->buffer );<br />
}<br />
</code><br />
For sake of simplicity we will only use this exception managing only at the end of this document, when “helpers” will be tackled in ([[Constructing_Helpers|Constructing Helpers]]). <br />
If you only know the sheet's number you can retrieve the sheet using this way :<br />
<code>[cpp]<br />
//Listing 4 Finding a Sheet with an Index<br />
//C++<br />
// Don't forget to add : using namespace com::sun::star::sheet;<br />
// Don't forget to add : #include <com/sun/star/sheet/XSpreadsheetDocument.hpp><br />
// Don't forget to add "com.sun.star.sheet.XSpreadsheetDocument \" in the makefile<br />
// Don't forget to add : using namespace com::sun::star::container;<br />
// Don't forget to add : #include <com/sun/star/container/XIndexAccess.hpp><br />
// Don't forget to add "com.sun.star.container.XIndexAccess \" in the makefile<br />
//query for a XSpreadsheetDocument interface <br />
Reference< XSpreadsheetDocument > rSheetDoc (xcomponent, UNO_QUERY); <br />
<br />
//use it to get the XSpreadsheets interface <br />
Reference< XSpreadsheets > rSheets = rSheetDoc->getSheets();<br />
<br />
// query for the ::com::sun::star::container::XIndexAccess service<br />
Reference< XIndexAccess > rSheetsByIndex (rSheets, UNO_QUERY); <br />
<br />
//use getByName to get a reference (type Any) <br />
Any rSheet = rSheetsByIndex->getByIndex( (short)1 ); <br />
</code><br />
As you can see we have to query a new service XIndexAccess. This means adding two lines in the code and one in the makefile as seen in C++ comments.<br />
Take care : UNO considers the sheet numbering, starting from 0, and then 1 is the second sheet.<br />
<br />
==Create, rename, copy and delete a Sheet==<br />
To create a sheet the method insertNewByName is used :<br />
<code>[cpp]<br />
//Listing 5 Create a Sheet<br />
//C++<br />
// Don't forget to add : using namespace com::sun::star::sheet;<br />
// Don't forget to add : #include <com/sun/star/sheet/XSpreadsheetDocument.hpp><br />
// Don't forget to add "com.sun.star.sheet.XSpreadsheetDocument \" in the makefile<br />
//query for a XSpreadsheetDocument interface <br />
Reference< XSpreadsheetDocument > rSheetDoc (xcomponent, UNO_QUERY); <br />
<br />
//use it to get the XSpreadsheets interface <br />
Reference< XSpreadsheets > rSheets = rSheetDoc->getSheets(); <br />
<br />
//use it to create a new sheet called MySheet <br />
rSheets->insertNewByName(OUString::createFromAscii("MySheet"), (short)0);<br />
</code><br />
(short)0 is the index of position where the new sheet is inserted. Here “MySheet” will be the first sheet.<br />
<br />
How to move a sheet when its name is known:<br />
<code>[cpp]<br />
//Listing 6 Moving a Sheet<br />
//C++<br />
// Don't forget to add : using namespace com::sun::star::sheet;<br />
// Don't forget to add : #include <com/sun/star/sheet/XSpreadsheetDocument.hpp><br />
// Don't forget to add "com.sun.star.sheet.XSpreadsheetDocument \" in the makefile<br />
//query for a XSpreadsheetDocument interface <br />
Reference< XSpreadsheetDocument > rSheetDoc (xcomponent, UNO_QUERY); <br />
<br />
//use it to get the XSpreadsheets interface <br />
Reference< XSpreadsheets > rSheets = rSheetDoc->getSheets(); <br />
<br />
//use it to move a sheet called MySheet in third(back)/second(forward) position <br />
rSheets->moveByName(OUString::createFromAscii("MySheet"), (short)2);<br />
</code><br />
How to copy a sheet <br />
<code>[cpp]<br />
//Listing 7 Copying a Sheet<br />
//C++<br />
// Don't forget to add : using namespace com::sun::star::sheet;<br />
// Don't forget to add : #include <com/sun/star/sheet/XSpreadsheetDocument.hpp><br />
// Don't forget to add "com.sun.star.sheet.XSpreadsheetDocument \" in the makefile<br />
//query for a XSpreadsheetDocument interface <br />
Reference< XSpreadsheetDocument > rSheetDoc (xcomponent, UNO_QUERY); <br />
<br />
//use it to get the XSpreadsheets interface <br />
Reference< XSpreadsheets > rSheets = rSheetDoc->getSheets(); <br />
<br />
//use it to copy a sheet called MySheet in second position with the name "MySheet2" <br />
rSheets->copyByName(OUString::createFromAscii("MySheet"),<br />
OUString::createFromAscii("MySheet2"), (short)1);<br />
</code><br />
MySheet2 is an exact copy of "MySheet" inserted as a second sheet.<br />
How to rename a sheet : <br />
<code>[cpp]<br />
//Listing 8 Renaming a Sheet<br />
//C++ <br />
// Don't forget to add : using namespace com::sun::star::sheet;<br />
// Don't forget to add : #include <com/sun/star/sheet/XSpreadsheetDocument.hpp><br />
// Don't forget to add "com.sun.star.sheet.XSpreadsheetDocument \" in the makefile<br />
// Don't forget to add : using namespace com::sun::star::container;<br />
// Don't forget to add : #include <com/sun/star/container/XNamed.hpp><br />
// Don't forget to add "com.sun.star.container.XNamed \" in the makefile<br />
<br />
//query for a XSpreadsheetDocument interface <br />
Reference< XSpreadsheetDocument > rSheetDoc (xcomponent, UNO_QUERY); <br />
<br />
//use it to get the XSpreadsheets interface <br />
Reference< XSpreadsheets > rSheets = rSheetDoc->getSheets(); <br />
<br />
//use getByName to get a reference (type Any) <br />
Any rSheet = rSheets->getByName( OUString::createFromAscii("Sheet2")); <br />
<br />
// query for XNamed Interface<br />
Reference< XNamed > rname (rSheet, UNO_QUERY);<br />
<br />
// rename<br />
rname->setName(OUString::createFromAscii("MySheet")); <br />
</code><br />
<br />
How to remove a sheet :<br />
<code>[cpp]<br />
//Listing 9 Removing a Sheet<br />
// C++<br />
rSheets->removeByName(OUString::createFromAscii("Sheet1")); <br />
</code><br />
works properly. You can use also the XnameContainer interface like :<br />
<code>[cpp]<br />
//Listing 10 Removing a Sheet (an other way)<br />
// C++<br />
// Don't forget to add : using namespace com::sun::star::container;<br />
// Don't forget to add : #include <com/sun/star/container/XNameContainer.hpp><br />
// Don't forget to add "com.sun.star.container.xNameContainer \" in the makefile<br />
Reference<XNameContainer> xNameContainer (rSheets, UNO_QUERY);<br />
<br />
xNameContainer->removeByName(OUString::createFromAscii("Sheet1")); //OK<br />
</code><br />
<br />
==Retrieve or change the currently focused Sheet==<br />
<br />
How to set a known-named sheet as currently focused sheet :<br />
<code>[cpp]<br />
//Listing 11 Focus and C++ programming<br />
//C++ <br />
// Don't forget to add : using namespace com::sun::star::sheet;<br />
// Don't forget to add : #include <com/sun/star/sheet/XSpreadsheetDocument.hpp><br />
// Don't forget to add "com.sun.star.sheet.XSpreadsheetDocument \" in the makefile<br />
// Don't forget to add : using namespace com::sun::star::frame;<br />
// Don't forget to add : #include <com/sun/star/frame/XModel.hpp><br />
// Don't forget to add "com.sun.star.frame.XModel \" in the makefile<br />
<br />
// Don't forget to add : #include <com/sun/star/sheet/XSpreadsheetView.hpp><br />
// Don't forget to add "com.sun.star.sheet.XSpreadsheetView \" in the makefile<br />
<br />
// Don't forget to add : #include <com/sun/star/sheet/XSpreadsheet.hpp><br />
// Don't forget to add "com.sun.star.sheet.XSpreadsheet \" in the makefile<br />
<br />
//query for a XSpreadsheetDocument interface <br />
Reference< XSpreadsheetDocument > rSheetDoc (xcomponent, UNO_QUERY); <br />
Reference< XSpreadsheets > rSheets = rSheetDoc->getSheets(); <br />
<br />
//use getByName to get a reference (type Any) <br />
Any rSheet = rSheets->getByName( OUString::createFromAscii("Sheet2")); <br />
// we want to make our new sheet the current sheet, so we need to ask the model <br />
// for the controller: first query the XModel interface from our spreadsheet component <br />
<br />
//query for the XSpreadsheet interface<br />
Reference< XSpreadsheet > rSpSheet (rSheet, UNO_QUERY);<br />
<br />
Reference< XModel > rSpreadsheetModel (rSheetDoc, UNO_QUERY); <br />
<br />
// then get the current controller from the model <br />
Reference< XController > rSpreadsheetController = rSpreadsheetModel->getCurrentController(); <br />
<br />
// get the XSpreadsheetView interface from the controller, we want to call its method <br />
// setActiveSheet <br />
Reference< XSpreadsheetView > rSpreadsheetView (rSpreadsheetController, UNO_QUERY); <br />
<br />
// make our newly inserted sheet the active sheet using setActiveSheet <br />
rSpreadsheetView->setActiveSheet(rSpSheet); <br />
</code><br />
How to retrieve the currently focused sheet ? This problem is in fact a little variation of the previous one but the test is not so straightforward. If a new spreadsheet is created as previously we have no chance to choose ourself a sheet with focus because the program take always the same default sheet when just created. Then before resolving this problem we have to modify the loadComponentFromURL as previously done (<br />
[[ UNO_automation_with_a_binary_%28executable%29#The_default_opened_Document|default opened document]])<br />
Here is a piece of code which retrieves the sheet under focus. <br />
<code>[cpp]<br />
//Listing 12 Retrieve the Sheet under Focus<br />
//C++<br />
int main( ) {<br />
//retrieve an instance of the remote service manager<br />
Reference< XMultiServiceFactory > rOfficeServiceManager;<br />
rOfficeServiceManager = ooConnect();<br />
if( rOfficeServiceManager.is() ){<br />
printf( "Connected sucessfully to the office\n" );<br />
}<br />
<br />
//get the desktop service using createInstance returns an XInterface type<br />
Reference< XInterface > Desktop = rOfficeServiceManager->createInstance(<br />
OUString::createFromAscii( "com.sun.star.frame.Desktop" ));<br />
// Don't forget the #include <com/sun/star/frame/XDesktop.hpp><br />
// Don't forget to add com.sun.star.frame.XDesktop \ in the makefile<br />
//query the XDesktop Interface<br />
Reference< XDesktop > xDesktop (Desktop, UNO_QUERY);<br />
<br />
Reference< XComponent > xcomponent = xDesktop->getCurrentComponent();<br />
<br />
// Don't forget to add : using namespace com::sun::star::sheet;<br />
// Don't forget to add : #include <com/sun/star/sheet/XSpreadsheetDocument.hpp><br />
// Don't forget to add "com.sun.star.sheet.XSpreadsheetDocument \" in the makefile<br />
//query for a XSpreadsheetDocument interface<br />
Reference< XSpreadsheetDocument > rSheetDoc (xcomponent, UNO_QUERY);<br />
<br />
// Don't forget to add : using namespace com::sun::star::frame;<br />
// Don't forget to add : #include <com/sun/star/frame/XModel.hpp><br />
// Don't forget to add "com.sun.star.frame.XModel \" in the makefile<br />
Reference< XModel > rSpreadsheetModel (rSheetDoc, UNO_QUERY);<br />
<br />
// then get the current controller from the model<br />
Reference< XController > rSpreadsheetController = <br />
rSpreadsheetModel->getCurrentController();<br />
<br />
// Don't forget to add : #include <com/sun/star/sheet/XSpreadsheetView.hpp><br />
// Don't forget to add "com.sun.star.sheet.XSpreadsheetView \" in the makefile<br />
// get the XSpreadsheetView interface from the controller, we want to call its method<br />
// getActiveSheet<br />
Reference< XSpreadsheetView > rSpreadsheetView (rSpreadsheetController, UNO_QUERY);<br />
Reference< XSpreadsheet> rSheet=rSpreadsheetView->getActiveSheet();<br />
// for a test<br />
Reference< XCell > rCell = rSheet->getCellByPosition(0, 0);<br />
rCell->setFormula(OUString::createFromAscii("Hello"));<br />
<br />
return 0;<br />
}<br />
</code><br />
<br />
The way to obtain a cell is explained above, then don't read the two last lines before the return : they only allow me to test the code.<br />
<br />
=How to obtain the Cell=<br />
When you have your sheet, obtain a particular cell is easy :<br />
<code>[cpp]<br />
//Listing 13 Obtaining a Cell<br />
//C++<br />
// Don't forget to add : using namespace com::sun::star::sheet;<br />
// Don't forget to add : #include <com/sun/star/sheet/XSpreadsheetDocument.hpp><br />
// Don't forget to add "com.sun.star.sheet.XSpreadsheetDocument \" in the makefile<br />
// Don't forget to add : using namespace com::sun::star::table; (for XCell)<br />
// Don't forget to add : #include <com/sun/star/sheet/XSpreadsheet.hpp><br />
// Don't forget to add "com.sun.star.sheet.XSpreadsheet \" in the makefile<br />
//query for a XSpreadsheetDocument interface<br />
Reference< XSpreadsheetDocument > rSheetDoc (xcomponent, UNO_QUERY);<br />
<br />
//use it to get the XSpreadsheets interface<br />
Reference< XSpreadsheets > rSheets = rSheetDoc->getSheets();<br />
<br />
//use getByName to get a reference (type Any)<br />
Any rSheet = rSheets->getByName( OUString::createFromAscii("Sheet1"));<br />
<br />
//query for the XSpreadsheet interface<br />
Reference< XSpreadsheet > rSpSheet (rSheet, UNO_QUERY);<br />
<br />
Reference< XCell > rCell = rSpSheet->getCellByPosition(0, 0);<br />
</code><br />
The first parameter is the column number, and the second is the row number, both starting from 0. See above the example where we access to the top left cell called A1.<br />
<br />
=What can be done with a Cell ?=<br />
The XCell interface provide six methods :<br />
<br />
getFormula returns the formula string of a cell. <br />
setFormula sets a formula into the cell. <br />
getValue returns the floating point value of the cell. <br />
setValue sets a floating point value into the cell. <br />
getType returns the type of the cell. <br />
getError returns the error value of the cell. <br />
<br />
==Numerical Value in a Cell==<br />
To put a numerical value in a cell is easy :<br />
<code>[cpp]<br />
//Listing 14 Putting a numerical Value in a Cell<br />
//C++<br />
// Don't forget to add : using namespace com::sun::star::sheet;<br />
// Don't forget to add : #include <com/sun/star/sheet/XSpreadsheetDocument.hpp><br />
// Don't forget to add "com.sun.star.sheet.XSpreadsheetDocument \" in the makefile<br />
// Don't forget to add : using namespace com::sun::star::table; (for XCell)<br />
// Don't forget to add : #include <com/sun/star/sheet/XSpreadsheet.hpp><br />
// Don't forget to add "com.sun.star.sheet.XSpreadsheet \" in the makefile<br />
//query for a XSpreadsheetDocument interface<br />
Reference< XSpreadsheetDocument > rSheetDoc (xcomponent, UNO_QUERY);<br />
<br />
//use it to get the XSpreadsheets interface<br />
Reference< XSpreadsheets > rSheets = rSheetDoc->getSheets();<br />
<br />
//use getByName to get a reference (type Any)<br />
Any rSheet = rSheets->getByName( OUString::createFromAscii("Sheet1"));<br />
<br />
//query the reference of type Any for the XSpreadsheet interface<br />
Reference< XSpreadsheet > rSpSheet (rSheet, UNO_QUERY);<br />
<br />
Reference< XCell > rCell = rSpSheet->getCellByPosition(0, 0);<br />
<br />
//set the cell value then get another cell etc..<br />
rCell->setValue(219);<br />
rCell = rSpSheet->getCellByPosition(0, 1);<br />
rCell->setValue(25);<br />
</code><br />
==Formula in a Cell==<br />
To put a formula in a cell is straightforward : replace the previous setValue by setFormula. This gives us :<br />
<code>[cpp]<br />
//Listing 15 Putting a Formula in a Cell<br />
//C++<br />
Reference< XCell > rCell = rSpSheet->getCellByPosition(0, 0);<br />
rCell->setValue(21);<br />
rCell = rSpSheet->getCellByPosition(0, 1);<br />
rCell->setValue(23);<br />
rCell = rSpSheet->getCellByPosition(0, 2);<br />
rCell->setFormula(OUString::createFromAscii("=sum(A1:A2)"));<br />
</code><br />
which puts in fact the value 44 in A3.<br />
==String in a Cell==<br />
We use a similar principle as in previous example :<br />
<code>[cpp]<br />
//Listing 16 Putting a String (OUString) in a Cell<br />
//C++ <br />
//set a string in the cell <br />
rCell->setFormula(OUString::createFromAscii("Hello"));<br />
</code><br />
It is possible to change the textual content of a cell with a Cursor (XTextCursor interface). The code below allows us this change :<br />
<code>[cpp]<br />
//Listing 17 Change the String Content of a Cell<br />
//C++<br />
// Don't forget to add : using namespace com::sun::star::text;<br />
// Don't forget to add : #include <com/sun/star/text/XText.hpp><br />
// Don't forget to add "com.sun.star.text.XText \" in the makefile<br />
<br />
// query first the XText interface<br />
Reference< XText > rText (rCell, UNO_QUERY); <br />
<br />
//query for the XTextCursor interface <br />
//Reference< XTextCursor > rTextCurs (rText, UNO_QUERY); <br />
Reference< XTextCursor > rTextCurs = rText -> createTextCursor(); <br />
rTextCurs -> gotoEnd(false);<br />
rTextCurs -> setString(OUString::createFromAscii(" Bye"));<br />
</code><br />
Adding the code gives us “Hello Bye” in a cell.<br />
==What is the Content Type of a Cell ?==<br />
We naturally use a getType method of the XCell interface. It returns one of the four possibilities : EMPTY, VALUE, TEXT or FORMULA (::com::sun::star::table) How do we see the values in C++ ? We give here the partial content of CellContentType.idl :<br />
<br />
<pre><br />
// IDL<br />
namespace com<br />
{<br />
namespace sun<br />
{<br />
namespace star<br />
{<br />
namespace table<br />
{<br />
enum CellContentType<br />
{<br />
CellContentType_EMPTY = 0,<br />
CellContentType_VALUE = 1,<br />
CellContentType_TEXT = 2,<br />
CellContentType_FORMULA = 3,<br />
CellContentType_MAKE_FIXED_SIZE = SAL_MAX_ENUM<br />
};<br />
<br />
} // table<br />
} // star<br />
} // sun<br />
} // com<br />
</pre><br />
<br />
which shows us a “using namespace com::sun::star::table” allows us to write in C++ something like : CellContentType_EMPTY if we have added the following statement :<br />
<pre><br />
#include <com/sun/star/table/CellContentType.hpp><br />
</pre><br />
The code below is an example : <br />
<code>[cpp]<br />
Listing 18 Retrieve the Cell Content Type<br />
//C++<br />
// Don't forget to add : using namespace com::sun::star::sheet;<br />
// Don't forget to add : #include <com/sun/star/sheet/XSpreadsheetDocument.hpp><br />
// Don't forget to add "com.sun.star.sheet.XSpreadsheetDocument \" in the makefile<br />
// Don't forget to add : #include <com/sun/star/sheet/XSpreadsheet.hpp><br />
// Don't forget to add "com.sun.star.sheet.XSpreadsheet \" in the makefile<br />
<br />
// Don't forget to add #include <com/sun/star/table/CellContentType.hpp><br />
// Don't forget to add "com.sun.star.table.CellContentType \" in the makefile<br />
<br />
//query for a XSpreadsheetDocument interface<br />
Reference< XSpreadsheetDocument > rSheetDoc (xcomponent, UNO_QUERY);<br />
Reference< XSpreadsheets > rSheets = rSheetDoc->getSheets();<br />
<br />
Any rSheet = rSheets->getByName( OUString::createFromAscii("Sheet1"));<br />
//query the reference of type Any for the XSpreadsheet interface<br />
Reference< XSpreadsheet > rSpSheet (rSheet, UNO_QUERY);<br />
<br />
Reference< XCell > rCell = rSpSheet->getCellByPosition(0, 0);<br />
rCell->setValue(43);<br />
switch (rCell->getType()){<br />
case CellContentType_EMPTY : printf("Empty\n");break;<br />
case CellContentType_VALUE : printf("Numerical Value\n");break;<br />
case CellContentType_TEXT : printf("Text\n");break;<br />
case CellContentType_FORMULA : printf("Formula\n");break;<br />
}<br />
</code><br />
which writes out “Numerical Value”.<br />
<br />
==Computing the Formula==<br />
Two methods calculate() and calculateAll() are available from the XCalculaTable interface. You can query this interface from a XSreadsheetDocument.<br />
<br />
==Formating a Cell== <br />
The straight forwarder way to format a cell is to use an already defined-style in the spreadsheet. The predefined style's names are in English even they appear in other languages in Object Bar. They are : Result, Result2, Default, Heading, Heading1 ...<br />
<code>[cpp]<br />
//Listing 19 Formating a Cell<br />
//C++<br />
// Don't forget to add : using namespace com::sun::star::beans;<br />
// Don't forget to add : #include <com/sun/star/beans/XPropertySet.hpp><br />
// Don't forget to add "com.sun.star.beans.XPropertySet \" in the makefile<br />
<br />
//query for the cell property interface <br />
Reference< XPropertySet > rCellProps (rCell, UNO_QUERY); <br />
<br />
//create an Any to hold our property value <br />
Any mPropVal; <br />
mPropVal <<= OUString::createFromAscii("Result"); <br />
<br />
//set some properties <br />
rCellProps->setPropertyValue(OUString::createFromAscii("CellStyle"), mPropVal); <br />
</code><br />
==Cell Annotations==<br />
The following example inserts an annotation and make it permanently visible.<br />
<code>[cpp]<br />
//Listing 20 Putting and retrieve Cell Annotations<br />
//C++<br />
// Don't forget to add : using namespace com::sun::star::sheet;<br />
// Don't forget to add : #include <com/sun/star/sheet/XSpreadsheetDocument.hpp><br />
// Don't forget to add "com.sun.star.sheet.XSpreadsheetDocument \" in the makefile<br />
<br />
// Don't forget to add : #include <com/sun/star/sheet/XSpreadsheet.hpp><br />
// Don't forget to add "com.sun.star.sheet.XSpreadsheet \" in the makefile<br />
<br />
// Don't forget to add : #include <com/sun/star/sheet/XCellAddressable.hpp><br />
// Don't forget to add "com.sun.star.sheet.XCellAddressable \" in the makefile<br />
<br />
// Don't forget to add : #include <com/sun/star/sheet/XSheetAnnotationsSupplier.hpp><br />
// Don't forget to add "com.sun.star.sheet.XSheetAnnotationsSupplier \" in the makefile<br />
<br />
// Don't forget to add : #include <com/sun/star/sheet/XSheetAnnotationAnchor.hpp><br />
// Don't forget to add "com.sun.star.sheet.XSheetAnnotationAnchor \" in the makefile<br />
<br />
//query for a XSpreadsheetDocument interface<br />
Reference< XSpreadsheetDocument > rSheetDoc (xcomponent, UNO_QUERY);<br />
Reference< XSpreadsheets > rSheets = rSheetDoc->getSheets();<br />
<br />
Any rSheet = rSheets->getByName( OUString::createFromAscii("Sheet1"));<br />
<br />
//query the reference of type Any for the XSpreadsheet interface<br />
Reference< XSpreadsheet > rSpSheet (rSheet, UNO_QUERY);<br />
<br />
//query for XCell Interface<br />
Reference< XCell > rCell = rSpSheet->getCellByPosition(0, 0);<br />
<br />
//query for the XcellAddressable Interface<br />
Reference< XCellAddressable > rCellAddr (rCell, UNO_QUERY);<br />
CellAddress rAddress = rCellAddr -> getCellAddress();<br />
<br />
//query for XSheetAnnotationsSupplier Interface <br />
Reference< XSheetAnnotationsSupplier > rAnnotationSupp (rSheet, UNO_QUERY);<br />
Reference< XSheetAnnotations > rAnnotations = rAnnotationSupp -> getAnnotations();<br />
rAnnotations -> insertNew(rAddress,OUString::createFromAscii("This is an annotation"));<br />
<br />
// make the annotation visible<br />
<br />
//query the XSheetAnnotationAnchor<br />
Reference< XSheetAnnotationAnchor > rAnnotAnchor (rCell, UNO_QUERY);<br />
Reference< XSheetAnnotation > rAnnotation = rAnnotAnchor -> getAnnotation();<br />
rAnnotation->setIsVisible(true);<br />
</code><br />
If you want an annotation not always visible you only remove the three last lines. Very interesting to put an annotation, but how do you get it if it already exist ? You add for test into the previous code :<br />
<code>[cpp]<br />
//Listing 21 Code for Test of previous Listing<br />
// C++<br />
// Don't forget to add : using namespace com::sun::star::text;<br />
// Don't forget to add : #include <com/sun/star/text/XSimpleText.hpp><br />
// Don't forget to add "com.sun.star.sheet.XSimpleText \" in the makefile<br />
<br />
// query the XSimpleTextInterface<br />
Reference< XSimpleText > rSimpleText (rAnnotation, UNO_QUERY);<br />
<br />
printf("Annotation : %s\n",<br />
OUStringToOString(rSimpleText->getString(),RTL_TEXTENCODING_ASCII_US).getStr());<br />
// or if you want to put the text in the cell :<br />
// rCell->setFormula(rSimpleText->getString());<br />
</code><br />
which writes out the string literal :“Annotation : This is an annotation”.<br />
<br />
=Cell Range=<br />
The way to obtain a cell range is not so easy as in OooBasic. You have first to obtain the Xinterface to have access to the getcellRangeByName method :<br />
<code>[cpp]<br />
//Listing 22 Cell Range Manipulation<br />
//C++<br />
// Don't forget to add : using namespace com::sun::star::table;<br />
// Don't forget to add : #include <com/sun/star/table/XCellRange.hpp><br />
// Don't forget to add "com.sun.star.table.XCellRange \" in the makefile<br />
<br />
//query for a XSpreadsheetDocument interface <br />
Reference< XSpreadsheetDocument > rSheetDoc (xcomponent, UNO_QUERY); <br />
Reference< XSpreadsheets > rSheets = rSheetDoc->getSheets(); <br />
<br />
//use getByName to get a reference (type Any) <br />
Any rSheet = rSheets->getByName( OUString::createFromAscii("Sheet1")); <br />
<br />
// query for the XCellRange interface<br />
Reference< XCellRange > rSheetCellRange (rSheet, UNO_QUERY);<br />
<br />
// query the cell range<br />
Reference< XCellRange> rCellRange = <br />
rSheetCellRange->getCellRangeByName(OUString::createFromAscii("B2:F5"));<br />
</code> <br />
With the XCellRange interface you can also access the range with getCellRangeByPosition method.<br />
To query one cell in the cell range, add to the previous code :<br />
<code>[cpp]<br />
//Listing 23 Finding one Cell in the Range<br />
//C++<br />
Reference< XCell > rCell = rCellRange->getCellByPosition(0, 0);<br />
rCell->setFormula(OUString::createFromAscii("it works"));<br />
</code> <br />
The X and Y position are then relative to the cell Range.<br />
<br />
==Retrieve the absolute X and Y Positions of a Cell ==<br />
This subject has been already tackled in a previous section but embedded in other code. We need first a CellAddress type described in <OpenOffice.org1.1_SDK>/idl/com/sun/star/text/CellAddress.idl :<br />
<pre><br />
// IDL<br />
module com { module sun { module star { module table {<br />
struct CellAddress<br />
{<br />
short Sheet;<br />
long Column;<br />
long Row;<br />
};<br />
}; }; }; };<br />
</pre><br />
Starting from the previous listing and adding :<br />
<code>[cpp]<br />
//Listing 24 Absolute Position of a Cell<br />
// C++<br />
// Don't forget to add : #include <com/sun/star/sheet/XCellAddressable.hpp><br />
// Don't forget to add "com.sun.star.sheet.XCellAddressable \" in the makefile<br />
<br />
// Don't forget to add : #include <com/sun/star/table/CellAddress.hpp><br />
// Don't forget to add "com.sun.star.table.CellAddress \" in the makefile<br />
<br />
//query for the XcellAddressable Interface<br />
Reference< XCellAddressable > rCellAddr (rCell, UNO_QUERY);<br />
CellAddress rAddress = rCellAddr -> getCellAddress();<br />
printf("sheet : %d, column : %d row: %d \n",<br />
rAddress.Sheet,rAddress.Column,rAddress.Row);<br />
</code><br />
gives us a program which writes out the absolute X and Y position of a cell.<br />
<br />
==Retrieve the absolute Address of the Cell Range==<br />
We need first a CellRangeAddress type described in <OpenOffice.org1.1_SDK>/idl/com/sun/star/table/CellRangeAddress.idl :<br />
<pre><br />
// IDL<br />
module com { module sun { module star { module table {<br />
<br />
struct CellRangeAddress<br />
{<br />
short Sheet;<br />
long StartColumn;<br />
long StartRow;<br />
long EndColumn;<br />
long EndRow;<br />
};<br />
}; }; }; };<br />
</pre><br />
and a XCellRangeAdressable interface. Starting from the cell range program, we add :<br />
<code>[cpp]<br />
//Listing 25 Using XCellRangeAddressable Interface<br />
// C++<br />
// Don't forget to add : #include <com/sun/star/sheet/XCellRangeAddressable.hpp><br />
// Don't forget to add "com.sun.star.sheet.XCellRangeAddressable \" in the makefile<br />
<br />
// Don't forget to add : #include <com/sun/star/sheet/CellRangeAddress.hpp><br />
// Don't forget to add "com.sun.star.sheet.CellRangeAddress \" in the makefile<br />
<br />
//query for the XCellRangeAddressable interface<br />
Reference< XCellRangeAddressable > rCellRangeAddr (rCellRange, UNO_QUERY);<br />
CellRangeAddress rRangeAddress = rCellRangeAddr -> getRangeAddress();<br />
printf("sheet : %d, start column : %d start row: %d ...\n",<br />
rRangeAddress.Sheet,rRangeAddress.StartColumn,rRangeAddress.StartRow);<br />
</code><br />
This program only writes out three of the five cell range attribute.<br />
==Getting a Cell range with a Selection==<br />
We have tackled a similar problem in section (<br />
[[OpenOffice_Calc#Retrieve_or_change_the_currently_focused_Sheet|Retrieve or change the currently focused Sheet]]) The way is to also start from a XModel interface, and query with getCurrentSelection an XInterface and then query an XCellRange interface. <br />
<code>[cpp]<br />
//Listing 26 Cell Range under Focus<br />
// C++<br />
Reference< XInterface > rInterface = rSpreadsheetModel->getCurrentSelection();<br />
<br />
// Don't forget to add : #include <com/sun/star/table/XCellRange.hpp><br />
// Don't forget to add "com.sun.star.table.XCellRange \" in the makefile<br />
Reference< XCellRange > rCellRange(rInterface,UNO_QUERY);<br />
rCell = rCellRange ->getCellByPosition(0, 0);<br />
rCell->setFormula(OUString::createFromAscii("Hello !!!"));<br />
</code><br />
This code writes out “Hello !!!” in the top left corner of the selected range.<br />
<br />
=Ready to translate the Developpers Guide into C++=<br />
When you want to go further, the Developers Guide is a good start. But examples are given in Java code. You have then to learn how to translate it into C++. At first glance you can find this translation as a complicate task but I have experimented it as a Java complete novice when writing the chapter on annotation and encounter no difficulties. But I was lucky, I present now examples which give me more difficulties. <br />
<br />
==The Compute Function Example==<br />
Let's start with Compute Function SDK's example :<br />
<code>[java]<br />
//Listing 27 Java first Example (from SDK)<br />
// Java<br />
// --- Sheet operation. --- <br />
// Compute a function <br />
com.sun.star.sheet.XSheetOperation xSheetOp = <br />
(com.sun.star.sheet.XSheetOperation) UnoRuntime.queryInterface<br />
(com.sun.star.sheet.XSheetOperation.class, xCellRange);<br />
double fResult = xSheetOp.computeFunction(com.sun.star.sheet.GeneralFunction.AVERAGE); System.out.println("Average value of the data table A10:C30: " + fResult); <br />
// Clear cell contents<br />
xSheetOp.clearContents( com.sun.star.sheet.CellFlags.ANNOTATION |<br />
com.sun.star.sheet.CellFlags.OBJECTS);<br />
</code><br />
<br />
The C++ translation gives (keeping the same variables names as in Java code) :<br />
<code>[cpp]<br />
//Listing 28 C++ Translation : calling a buildin Function<br />
// C++<br />
// Don't forget to add : #include <com/sun/star/sheet/XSheetOperation.hpp><br />
// Don't forget to add "com.sun.star.sheet.XSheetOperation \" in the makefile<br />
<br />
// Don't forget to add : #include <com/sun/star/sheet/GeneralFunction.hpp><br />
// and see in GeneralFunction.hdl how AVERAGE is generated : here GeneralFunction_AVERAGE<br />
// Don't forget to add "com.sun.star.sheet.GeneralFunction \" in the makefile<br />
<br />
// Don't forget to add : #include <com/sun/star/sheet/CellFlags.hpp><br />
// and see in CellFlags.hdl how ANNOTATION and OBJECT are generated : here ANNOTATION, OBJECT<br />
// in the namespace CellFlags donc :<br />
// Don't forget to add : using namespace com::sun::star::sheet::CellFlags;<br />
// Don't forget to add "com.sun.star.sheet.CellFlags \" in the makefile<br />
<br />
// --- Sheet operation. ---<br />
// Compute a function<br />
Reference< XSheetOperation > xSheetOp( xCellRange,UNO_QUERY);<br />
double fResult= xSheetOp->computeFunction(GeneralFunction_AVERAGE);<br />
printf("Average value of the data table B2:C4: %f", fResult);<br />
// Clear cell contents<br />
xSheetOp->clearContents( ANNOTATION | OBJECTS);<br />
</code><br />
We can see the UNO calls are simpler in C++ than in Java. I have added comments to explain how constants are managed. We are lucky with this piece of code : we can see two different kind of constant :<br />
* one with a specific name : GeneralFunction_AVERAGE instead of AVERAGE in Java. This problem of enumeration has already been tackled [[SDKCppLanguage#To_go_further_:_the_Enumeration_Type_Problem|here]].<br />
* one with the same name as in IDL and Java files but in a namespace which requires the classical “using namespace”.<br />
<br />
To find information requires to generate hdl and hpp files from IDL files and to read not the hpp but hdl files. This job is let for novices, others can see all in IDL files : see the difference between :<br />
<pre><br />
// IDL<br />
// extracted from CellFlags.idl<br />
constants CellFlags<br />
{<br />
const long VALUE = 1;<br />
const long DATETIME = 2;<br />
const long STRING = 4;<br />
const long ANNOTATION = 8;<br />
const long FORMULA = 16;<br />
const long HARDATTR = 32;<br />
const long OBJECTS = 128;<br />
const long EDITATTR = 256;<br />
};<br />
</pre><br />
and<br />
<pre><br />
// IDL<br />
// extracted from GeneralFunction.idl<br />
enum GeneralFunction<br />
{<br />
NONE,<br />
AUTO,<br />
SUM,<br />
COUNT,<br />
AVERAGE,<br />
MAX,<br />
MIN,<br />
PRODUCT,<br />
COUNTNUMS,<br />
STDEV,<br />
STDEVP,<br />
VAR,<br />
VARP<br />
};<br />
</pre><br />
and the consequences on the constants use. You can deduce tips isn't it ?<br />
<br />
==A second Example : adding a Name to a Cell (or Cell Range)==<br />
We give first the Java code still found in SDK :<br />
<code>[java]<br />
//Listing 29 Second Java Example<br />
// Java<br />
// insert a named range <br />
com.sun.star.beans.XPropertySet xDocProp = (com.sun.star.beans.XPropertySet)<br />
UnoRuntime.queryInterface(com.sun.star.beans.XPropertySet.class, xDocument);<br />
Object aRangesObj = xDocProp.getPropertyValue("NamedRanges");<br />
com.sun.star.sheet.XNamedRanges xNamedRanges = (com.sun.star.sheet.XNamedRanges) UnoRuntime.queryInterface(com.sun.star.sheet.XNamedRanges.class, aRangesObj);<br />
com.sun.star.table.CellAddress aRefPos = new com.sun.star.table.CellAddress(); aRefPos.Sheet = 0; <br />
aRefPos.Column = 6; <br />
aRefPos.Row = 44; <br />
xNamedRanges.addNewByName("ExampleName", "SUM(G43:G44)", aRefPos, 0);<br />
// use the named range in formulas <br />
xSheet.getCellByPosition(6, 44).setFormula("=ExampleName"); <br />
xSheet.getCellByPosition(7, 44).setFormula("=ExampleName");<br />
</code><br />
The same code in C++ :<br />
<code>[cpp]<br />
//Listing 30 naming a Cell (Range)<br />
// C++<br />
// Don't forget to add : #include <com/sun/star/beans/XPropertySet.hpp><br />
// Don't forget to add "com.sun.star.beans.XPropertySet \" in the makefile<br />
<br />
// Don't forget to add : #include <com/sun/star/sheet/XNamedRanges.hpp><br />
// Don't forget to add "com.sun.star.sheet.XNamedRanges \" in the makefile<br />
<br />
// Don't forget to add : #include <com/sun/star/table/CellAddress.hpp><br />
// Don't forget to add "com.sun.star.table.CellAddress \" in the makefile<br />
<br />
// insert a named range <br />
// !!! rSheetDoc instead xDocument in our previous code !!!<br />
Reference< XPropertySet > xDocProp(xDocument, UNO_QUERY); <br />
Any aRangesObj = xDocProp->getPropertyValue(OUString::createFromAscii("NamedRanges"));<br />
Reference< XNamedRanges > xNamedRanges(aRangesObj,UNO_QUERY);<br />
CellAddress aRefPos;<br />
aRefPos.Sheet = 0;<br />
aRefPos.Column = 6;<br />
aRefPos.Row = 44;<br />
xNamedRanges->addNewByName(OUString::createFromAscii("ExampleName"),<br />
OUString::createFromAscii("SUM(G43:G44)"), aRefPos, 0);<br />
// use the named range in formulas<br />
// !!! rSpSheet instead xSheet in our previous code !!!<br />
xSheet->getCellByPosition(6, 44)->setFormula(OUString::createFromAscii("=ExampleName"));<br />
xSheet->getCellByPosition(7, 44)->setFormula(OUString::createFromAscii("=ExampleName"));<br />
</code><br />
We can see Object is translated by Any. You have to add “OUString::createFromAscii “ before all strings. This program names a cell “ExampleName” and gives a value associated with this name : "SUM(G43:G44)". When you use this name it is replaced by its value.<br />
<br />
==A third Example==<br />
Here is an other example :<br />
<code>[java]<br />
//Listing 31 Java third Example<br />
// Java<br />
// --- Cell range data --- <br />
com.sun.star.sheet.XCellRangeData xData = (com.sun.star.sheet.XCellRangeData)<br />
UnoRuntime.queryInterface(com.sun.star.sheet.XCellRangeData.class, xCellRange); <br />
Object[][] aValues = { {new Double(1.1), new Integer(10)}, <br />
{new Double(2.2), new String("")},<br />
{new Double(3.3), new String("Text")} }; <br />
xData.setDataArray(aValues);<br />
</code><br />
This very interesting example takes values from an array and put them in a cell range.<br />
The code is given below :<br />
<code>[cpp]<br />
//Listing 32 Putting Cell Range Values in an Array<br />
//C++<br />
// Don't forget to add : using namespace com::sun::star::sheet;<br />
// Don't forget to add : #include <com/sun/star/sheet/XSpreadsheetDocument.hpp><br />
// Don't forget to add "com.sun.star.sheet.XSpreadsheetDocument \" in the makefile<br />
//query for a XSpreadsheetDocument interface<br />
Reference< XSpreadsheetDocument > rSheetDoc (xcomponent, UNO_QUERY);<br />
<br />
//use it to get the XSpreadsheets interface<br />
// Reference< XSpreadsheets > rSheets = rSheetDoc->getSheets();<br />
<br />
// Don't forget to add : using namespace com::sun::star::frame;<br />
// Don't forget to add : #include <com/sun/star/frame/XModel.hpp><br />
// Don't forget to add "com.sun.star.frame.XModel \" in the makefile<br />
Reference< XModel > rSpreadsheetModel (rSheetDoc, UNO_QUERY);<br />
<br />
// then get the current controller from the model<br />
Reference< XController > rSpreadsheetController = <br />
rSpreadsheetModel->getCurrentController();<br />
<br />
// Don't forget to add : #include <com/sun/star/sheet/XSpreadsheetView.hpp><br />
// Don't forget to add "com.sun.star.sheet.XSpreadsheetView \" in the makefile<br />
// get the XSpreadsheetView interface from the controller, we want to call its method<br />
// setActiveSheet<br />
Reference< XSpreadsheetView > rSpreadsheetView (rSpreadsheetController, UNO_QUERY);<br />
Reference< XSpreadsheet> rSheet=rSpreadsheetView->getActiveSheet();<br />
<br />
Reference< XInterface > rInterface = rSpreadsheetModel->getCurrentSelection();<br />
<br />
// Don't forget to add : #include <com/sun/star/table/XCellRange.hpp><br />
// Don't forget to add "com.sun.star.table.XCellRange \" in the makefile<br />
Reference< XCellRange > rCellRange(rInterface,UNO_QUERY);<br />
<br />
// Don't forget to add : #include <com/sun/star/sheet/XCellRangeData.hpp><br />
// Don't forget to add "com.sun.star.sheet.XCellRangeData \" in the makefile<br />
Reference< XCellRangeData> xData(rCellRange, UNO_QUERY);<br />
<br />
// Java translation begins here .........<br />
Sequence< Sequence< Any > > aValues(3); // or aValues(1)(2); ?????<br />
Sequence< Any > aValues2(2);<br />
aValues2[0] <<= (double) 1.1; aValues2[1] <<= (sal_Int32)10;<br />
aValues[0] = aValues2;<br />
aValues2[0] <<= (double)2.2; aValues2[1] <<= OUString::createFromAscii("");<br />
aValues[1] = aValues2;<br />
aValues2[0] <<= (double)3.3; aValues2[1] <<= OUString::createFromAscii("Text");<br />
aValues[2] = aValues2;<br />
xData -> setDataArray(aValues);<br />
</code><br />
can be compiled and works if we have an opened OOoCalc document with focus on a cell range of two rows and three lines. This is important : the cell range size must be the same as the sequence sequence of any !<br />
<br />
<br />
==An Example from OooForum: opening a Password protected Document==<br />
Kscape posts :<br />
“There is some example java code for opening a passworded file which will prompt the user for the password at [http://codesnippets.services.openoffice.org/Office/Office.openPwdProtectedFile.snip|OOo snippets] <br />
but there is no example C++ code, and I cannot seem to get the services and queries around the right way. <br />
Any chance someone can translate that snippet or provide a full example C++ program which will open a passworded document? <br />
<br />
Thanks in advance. “<br />
<br />
Here is the corresponding Java code :<br />
<code>[java]<br />
//Listing 33 Java starting Code<br />
// Java<br />
XInteractionHandler xHandler = (XInteractionHandler)UnoRuntime.queryInterface( XInteractionHandler.class, xSMGR.createInstance("com.sun.star.task.InteractionHandler"));<br />
<br />
PropertyValue[] lArgs = new PropertyValue[1];<br />
lArgs[0] = new PropertyValue();<br />
lArgs[0].Name = "InteractionHandler";<br />
lArgs[0].Value = xHandler;<br />
<br />
xDoc = xDesktop.loadComponentFromURL(sURL, sTarget, nSearchFlags, lArgs);<br />
</code><br />
Here is the C++ translation :<br />
<code>[cpp]<br />
//Listing 34 The correspnding C++ Code<br />
// C++ <br />
// Don't forget to add : #include <com/sun/star/task/XInteractionHandler.hpp> <br />
// Don't forget to add "com.sun.star.task.XInteractionHandler \" in the makefile <br />
// Don't forget to add : using namespace com::sun::star::task; <br />
<br />
Reference <XInteractionHandler> xHandler = <br />
Reference<XInteractionHandler>( rOfficeServiceManager->createInstance( <br />
OUString( RTL_CONSTASCII_USTRINGPARAM( <br />
"com.sun.star.task.InteractionHandler" ))), UNO_QUERY ); <br />
if (xHandler.is()) printf("xHandler OK...\n"); else printf("Error xHandler ... \n"); <br />
<br />
Sequence <PropertyValue > largs(1); <br />
largs[0].Name = OUString::createFromAscii("InteractionHandler"); <br />
largs[0].Value = makeAny(xHandler); <br />
<br />
//get an instance of the OOoDraw document <br />
Reference< XComponent > xcomponent = rComponentLoader->loadComponentFromURL( <br />
OUString::createFromAscii("private:factory/sdraw"), <br />
OUString::createFromAscii("_blank"), <br />
0, <br />
largs); <br />
</code><br />
=Event Listener=<br />
==First Event Listener==<br />
Event listener in C++ are not documented in the Developer's Guide. To find a way to resolve this problem I first read Java Code. I deduce if you want to implement an event listener you have to construct a class which inherit from a known class and then install it. My first try hang completely OOo (without a message...) After I decided to read OOo' source code and hope to find an example. It was the case in the file : OOo_1.1.3_src/basic/source/basmgr/basmgr.cxx<br />
If you want to do that you have to use an helper to create the class :<br />
<code>[cpp]<br />
//Listing 35 First Event Listener<br />
// C++<br />
// Don't forget the #include<com/sun/star/view/XSelectionChangeListener.hpp><br />
// Don't forget to add com.sun.star.view.XSelectionChangeListener \ in the makefile<br />
<br />
// Don't forget the #include <cppuhelper/implbase1.hxx><br />
<br />
typedef ::cppu::WeakImplHelper1< ::com::sun::star::view::XSelectionChangeListener > <br />
SelectionChangeListenerHelper;<br />
<br />
class SelectionChangeListener : public SelectionChangeListenerHelper<br />
{<br />
public:<br />
SelectionChangeListener()<br />
{printf("EventListener installed\n");fflush(stdout);}<br />
<br />
~SelectionChangeListener()<br />
{printf("EventListener released\n");fflush(stdout);}<br />
<br />
virtual void SAL_CALL selectionChanged(const com::sun::star::lang::EventObject& aEvent)<br />
throw ( RuntimeException)<br />
{<br />
printf("Selection changed \n");fflush(stdout);<br />
}<br />
<br />
virtual void SAL_CALL disposing ( const com::sun::star::lang::EventObject& aEventObj )<br />
throw(::com::sun::star::uno::RuntimeException)<br />
{ printf("object listened to will be disposed\n"); }<br />
}; <br />
</code><br />
The selectionChanged will be called when a selection changes : it only prints out a message. The fflush(stdout) is important if you want see the printf when the event occurs (thanks to [[CppSDKAuthors|Emmanuel GUY]]).<br />
Now we want to install this event listener : <br />
<code>[cpp]<br />
//Listing 36 Installing an Event Listener<br />
// C++<br />
// event listener<br />
// Don't forget the #include <com/sun/star/view/XSelectionSupplier.hpp><br />
// Don't forget to add com.sun.star.view.XSelectionSupplier \ in the makefile<br />
<br />
Reference< XSelectionSupplier > aSelSupp(rSpreadsheetController,UNO_QUERY);<br />
<br />
SelectionChangeListener *xListener = new SelectionChangeListener();<br />
<br />
Reference< XSelectionChangeListener > xSelChListener = <br />
static_cast< XSelectionChangeListener* > ( xListener );<br />
<br />
aSelSupp->addSelectionChangeListener(xSelChListener);<br />
<br />
getchar();<br />
aSelSupp->removeSelectionChangeListener(xSelChListener);<br />
</code><br />
We first instantiate our class as usual with a new, but we use after a static_cast before to install it with an appropriate method. For us this method is a addSelectionchangeListener(). It is important now that the program doesn't terminate without removing the listener. We use the C getchar() function for that but with real program this important part has to change.<br />
To test this code you have to provide a rSpreadsheetController interface. A way is to use the previous [[OpenOffice_Calc#A_third_Example|code]], removing the Java translation part. You then launch a OOocalc and select a cell range. You select an other cell range and see the message in the shell windows.<br />
MichaelJ1980 in oooforum indicates he has to write<br />
<code>[cpp]<br />
// C++<br />
SelectionChangeListener *xListener = ::new SelectionChangeListener();<br />
</code><br />
instead<br />
<code>[cpp]<br />
// C++<br />
SelectionChangeListener *xListener = new SelectionChangeListener();<br />
</code><br />
<br />
==A second Event Listener==<br />
Emmanuel GUY has posted an other example in OOoForum :<br />
[http://www.oooforum.org/forum/viewtopic.phtml?t=14697|Use events (XEventListener, XWindowListener, ...) in C++]<br />
<br />
=Graphics=<br />
<br />
==Embedding Images==<br />
<br />
Adding external images to a spreadsheet is possible, and this is different from linking to images. [http://codesnippets.services.openoffice.org/Calc/Calc.InsertImage.snip Linking to images] requires a user to have an external file that is always in the same location relative to the spreadsheet file, while embedding an image deals with including the image in the ODS file itself.<br />
<br />
First, suppose we have a model implementing the XModel interface, and is related to a spreadsheet. We can get the spreadsheet and current (active) sheet using the code below:<br />
<br />
<code>[java]<br />
XSpreadsheetDocument xDoc = (XSpreadsheetDocument)UnoRuntime.queryInterface(XSpreadsheetDocument.class, xDocModel);<br />
XSpreadsheetView xsv = (XSpreadsheetView)UnoRuntime.queryInterface(XSpreadsheetView.class, m_xFrame.getController());<br />
XSpreadsheet curSheet = xsv.getActiveSheet();<br />
</code><br />
<br />
Next, we need to create a XMultiServiceFactory object so we can create components in the actual file. We'll create a BitmapTable, which will be tricked into storing the image internally (([http://codesnippets.services.openoffice.org/Writer/Writer.EmbedAGraphicIntoATextdocument.snip source for Writer]).<br />
<br />
<code>[java]<br />
XMultiServiceFactory xmsf = (XMultiServiceFactory)UnoRuntime.queryInterface(XMultiServiceFactory.class, xDocModel);<br />
XNameContainer xBitmapContainer = (XNameContainer) UnoRuntime.queryInterface(<br />
XNameContainer.class, xmsf.createInstance("com.sun.star.drawing.BitmapTable"));<br />
</code><br />
<br />
The file itself is added to the container as a link, similar to how URLs are represented online. Thus, a path to an image in a user's home directory on Linux would be ''file:///home/username/image.png''. We add this link to the container, and then use the ''AnyConverter'' class to get a URL to the container itself, called the ''internalURL''. This ''internalURL'' will be used as the new link to the (now internal) image.<br />
<br />
<code>[java]<br />
String sPath = "file:///home/wojciech/Desktop/img.png"; <br />
xBitmapContainer.insertByName("someID", sPath);<br />
String internalURL = AnyConverter.toString(xBitmapContainer.getByName("someID"));<br />
</code><br />
<br />
The image itself is stored as an XShape object, which is created below.<br />
<br />
<code>[java]<br />
Object imgTemp = xmsf.createInstance("com.sun.star.drawing.GraphicObjectShape");<br />
XShape xImage = (XShape)UnoRuntime.queryInterface(XShape.class, imgTemp);<br />
</code><br />
<br />
Now we set the properties of the actual shape (and image):<br />
<br />
<code>[java]<br />
XPropertySet xpi = ( XPropertySet )UnoRuntime.queryInterface(XPropertySet.class, xImage );<br />
xpi.setPropertyValue("GraphicURL", internalURL);<br />
Size imgSize = new Size(2500, 5000);<br />
xImage.setSize(imgSize);<br />
</code><br />
<br />
And finally, we get the necessary objects to draw in the spreadsheet itself, and we draw the image. The last line of code simply removes the image entry from the temporary container.<br />
<br />
<code>[java]<br />
XDrawPageSupplier oDPS = (XDrawPageSupplier) UnoRuntime.queryInterface(XDrawPageSupplier.class, curSheet);<br />
XDrawPage xDrawPage = oDPS.getDrawPage(); <br />
xDrawPage.add(xImage);<br />
xBitmapContainer.removeByName("someID");<br />
</code><br />
<br />
{{Template:Home_Page}}<br />
<br />
= See also=<br />
<br />
* [http://perso.wanadoo.fr/moutou/MyUNODoc_HTML/UNOCppAPI5.html OpenOffice Calc] (Chapter 5 from UNO/C++ document) <br />
* Writing a Program to Control OpenOffice.org, by Franco Pingiori — [http://www.linuxjournal.com/article/8550 Part 1] and [http://www.linuxjournal.com/article/8608 Part 2], Linux Journal<br />
<br />
[[Category:Calc|API]]<br />
[[Category:API]]<br />
[[Category:Development]]<br />
[[Category:Cpp]]<br />
[[Category:Uno]]</div>Wojciechhttps://wiki.openoffice.org/w/index.php?title=R_and_Calc&diff=41818R and Calc2007-08-10T05:23:30Z<p>Wojciech: </p>
<hr />
<div><blockquote style="background: white; border: 1px solid rgb(153, 153, 153); padding: 1em;">This page is meant as a general overview and installation guide for the software. Please see [[R and Calc Documentation]] for more information on functions, scripting, and general usage.</blockquote><br />
<br />
"R and Calc" is an [[OpenOffice.org]] (OO.o) [[Calc]] add-on that allows you to use [http://www.r-project.org/ R] methods and functions. The software is currently in early development, though a '''basic''' working version does exist, and is available for download.<br />
<br />
We welcome any and all comments and name suggestions. Please send them to [[User:Wojciech|Wojciech Gryc]].<br />
<br />
For those who come here often, here is the latest version:<br />
* '''Version:''' 0.1.4<br />
* '''Release Date:''' August 10, 2007 (1:22 am EST)<br />
* '''Link:''' http://www.11-55.org/rcalc/2007-08-10/RAddon.uno.pkg<br />
* '''Source Code:''' http://www.11-55.org/rcalc/2007-08-10/rcalc-0_1_4.zip<br />
* '''Manual:''' http://www.11-55.org/rcalc/2007-08-10/manual.pdf<br />
<br />
==Requirements==<br />
<br />
You need the following software to run this add-on. While older versions may suffice, they have not been tested yet.<br />
* OpenOffice.org 2.1<br />
* Java 1.5.0<br />
* RServe 0.4.7<br />
<br />
==Installing==<br />
<br />
The current version is a prototype and implements only one tool: RDUMP. This method is accessed through the actual Calc menu, and allows you to see the R object structure for various method calls. <br />
<br />
To use the add-on, you need to install R and [http://www.rforge.net/Rserve Rserve]. Instructions for installing R can be found at http://www.r-project.org/ Once installed, run R and type the following to install Rserve. Click "enter" at the end of each bullet point:<br />
<br />
* install.packages("Rserve")<br />
<br />
Rserve needs to be running to work, and can be launched with the following commands... Note that you only need to do this when you want to use the R Add-on for Calc.<br />
<br />
* library(Rserve)<br />
* Rserve()<br />
<br />
Now that you have the prerequisites installed, download the package RAddon.uno.pkg (linked above). Unzip the file, and let's call the directory you unzipped it in <RA_DIR>. Now let <OO_HOME> be your OpenOffice.org installation directory. Open the command prompt or terminal window and go to <OO_HOME>/program/ and type:<br />
<br />
* unopkg add <RA_DIR>/RAddon.uno.pkg<br />
<br />
If this is not your first time installing the add-in, you need to check if a previous version is also on the system. If it is, then you will not be able to install the new version. To do this, go to <OO HOME>/program and type:<br />
<br />
* unopkg list<br />
<br />
This will show you the list of packages already installed, and you should be able to check if the add-is is there. Remember to look for "RAddon.uno.pkg". You can also skip this step and try to uninstall RAddon.uno.pkg regardless -- this will not harm your OpenOffice.org installation in any way, even if RAddon.uno.pkg is abset. To do this, type:<br />
<br />
* unopkg remove RAddon.uno.pkg<br />
<br />
Finally, some operating systems require that you restart your OpenOffice.org installation (if you're not sure, restart your computer) to be able to see the cell functions that come with this package.<br />
<br />
==Using==<br />
<br />
Using the add-on is very simple at this stage. To see the tool at work, open Calc. In the menus, go to R Add-on > Rdump(). A new dialog window will pop up. Type in an R script -- here are some examples:<br />
<br />
* rnorm(10)<br />
* cor.test(c(1,2,3,4), c(1,2,2,3))<br />
<br />
Then click "Run". A new sheet should appear. Close the dialog with "Close" and check the new sheet -- you should see various pieces of information on the sheet.<br />
<br />
==Testing==<br />
<br />
So far, the software has been tested on the following.<br />
<br />
===Version 0.1.0===<br />
<br />
* Fedora Core 6 running JDK 1.6.0_01 and OpenOffice 2.2.<br />
* Ubuntu Edgy Eft running SDK 1.5.0_08 and OpenOffice 2.1.<br />
* Windows XP running running JDK 1.6.0_01 and OpenOffice 2.2.<br />
<br />
==Known Issues==<br />
<br />
Yes, we already have some known issues! That's OK, these are common issues and are not problematic with regards to the code:<br />
<br />
* '''Issue #1 (<font color="red">Fixed in 0.1.1</font>):''' Strings and characters, when part of the R object model, do not get published in Rdump().<br />
* '''Issue #2:''' RDUMP() does not print matrices and frames properly, but prints columns instead.<br />
* '''Issue #3:''' Missing values -- need a good way to deal with missing values. We cannot use a test for non-numeric values because of Factors in R.<br />
<br />
==About==<br />
<br />
This add-on is the result of a Google [[Summer of Code 2007]] project. It was initially created by [[User:Wojciech|Wojciech Gryc]]. For information pertaining to the development of this add-on, see [http://www.11-55.org/ooblog/ Wojciech's Blog].<br />
<br />
==Older Versions==<br />
<br />
* '''0.1.3''': [http://www.11-55.org/rcalc/2007-08-02/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-08-02/rcalc-0_1_3.zip Source Code])<br />
* '''0.1.2''': [http://www.11-55.org/rcalc/2007-06-01/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-06-01/rcalc-0_1_2.zip Source Code])<br />
* '''0.1.1''': [http://www.11-55.org/rcalc/2007-05-25/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-05-25/rcalc-0_1_1.zip Source Code])<br />
* '''0.1.0''': [http://www.11-55.org/rcalc/2007-05-15/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-05-15/rcalc-0.1.0.zip Source Code])<br />
<br />
[[Category:Calc]]</div>Wojciechhttps://wiki.openoffice.org/w/index.php?title=R_and_Calc&diff=41817R and Calc2007-08-10T05:23:10Z<p>Wojciech: </p>
<hr />
<div><blockquote style="background: white; border: 1px solid rgb(153, 153, 153); padding: 1em;">This page is meant as a general overview and installation guide for the software. Please see [[R and Calc Documentation]] for more information on functions, scripting, and general usage.</blockquote><br />
<br />
"R and Calc" is an [[OpenOffice.org]] (OO.o) [[Calc]] add-on that allows you to use [http://www.r-project.org/ R] methods and functions. The software is currently in early development, though a '''basic''' working version does exist, and is available for download.<br />
<br />
We welcome any and all comments and name suggestions. Please send them to [[User:Wojciech|Wojciech Gryc]].<br />
<br />
For those who come here often, here is the latest version:<br />
* '''Version:''' 0.1.3<br />
* '''Release Date:''' August 10, 2007 (1:22 am EST)<br />
* '''Link:''' http://www.11-55.org/rcalc/2007-08-10/RAddon.uno.pkg<br />
* '''Source Code:''' http://www.11-55.org/rcalc/2007-08-10/rcalc-0_1_4.zip<br />
* '''Manual:''' http://www.11-55.org/rcalc/2007-08-10/manual.pdf<br />
<br />
==Requirements==<br />
<br />
You need the following software to run this add-on. While older versions may suffice, they have not been tested yet.<br />
* OpenOffice.org 2.1<br />
* Java 1.5.0<br />
* RServe 0.4.7<br />
<br />
==Installing==<br />
<br />
The current version is a prototype and implements only one tool: RDUMP. This method is accessed through the actual Calc menu, and allows you to see the R object structure for various method calls. <br />
<br />
To use the add-on, you need to install R and [http://www.rforge.net/Rserve Rserve]. Instructions for installing R can be found at http://www.r-project.org/ Once installed, run R and type the following to install Rserve. Click "enter" at the end of each bullet point:<br />
<br />
* install.packages("Rserve")<br />
<br />
Rserve needs to be running to work, and can be launched with the following commands... Note that you only need to do this when you want to use the R Add-on for Calc.<br />
<br />
* library(Rserve)<br />
* Rserve()<br />
<br />
Now that you have the prerequisites installed, download the package RAddon.uno.pkg (linked above). Unzip the file, and let's call the directory you unzipped it in <RA_DIR>. Now let <OO_HOME> be your OpenOffice.org installation directory. Open the command prompt or terminal window and go to <OO_HOME>/program/ and type:<br />
<br />
* unopkg add <RA_DIR>/RAddon.uno.pkg<br />
<br />
If this is not your first time installing the add-in, you need to check if a previous version is also on the system. If it is, then you will not be able to install the new version. To do this, go to <OO HOME>/program and type:<br />
<br />
* unopkg list<br />
<br />
This will show you the list of packages already installed, and you should be able to check if the add-is is there. Remember to look for "RAddon.uno.pkg". You can also skip this step and try to uninstall RAddon.uno.pkg regardless -- this will not harm your OpenOffice.org installation in any way, even if RAddon.uno.pkg is abset. To do this, type:<br />
<br />
* unopkg remove RAddon.uno.pkg<br />
<br />
Finally, some operating systems require that you restart your OpenOffice.org installation (if you're not sure, restart your computer) to be able to see the cell functions that come with this package.<br />
<br />
==Using==<br />
<br />
Using the add-on is very simple at this stage. To see the tool at work, open Calc. In the menus, go to R Add-on > Rdump(). A new dialog window will pop up. Type in an R script -- here are some examples:<br />
<br />
* rnorm(10)<br />
* cor.test(c(1,2,3,4), c(1,2,2,3))<br />
<br />
Then click "Run". A new sheet should appear. Close the dialog with "Close" and check the new sheet -- you should see various pieces of information on the sheet.<br />
<br />
==Testing==<br />
<br />
So far, the software has been tested on the following.<br />
<br />
===Version 0.1.0===<br />
<br />
* Fedora Core 6 running JDK 1.6.0_01 and OpenOffice 2.2.<br />
* Ubuntu Edgy Eft running SDK 1.5.0_08 and OpenOffice 2.1.<br />
* Windows XP running running JDK 1.6.0_01 and OpenOffice 2.2.<br />
<br />
==Known Issues==<br />
<br />
Yes, we already have some known issues! That's OK, these are common issues and are not problematic with regards to the code:<br />
<br />
* '''Issue #1 (<font color="red">Fixed in 0.1.1</font>):''' Strings and characters, when part of the R object model, do not get published in Rdump().<br />
* '''Issue #2:''' RDUMP() does not print matrices and frames properly, but prints columns instead.<br />
* '''Issue #3:''' Missing values -- need a good way to deal with missing values. We cannot use a test for non-numeric values because of Factors in R.<br />
<br />
==About==<br />
<br />
This add-on is the result of a Google [[Summer of Code 2007]] project. It was initially created by [[User:Wojciech|Wojciech Gryc]]. For information pertaining to the development of this add-on, see [http://www.11-55.org/ooblog/ Wojciech's Blog].<br />
<br />
==Older Versions==<br />
<br />
* '''0.1.3''': [http://www.11-55.org/rcalc/2007-08-02/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-08-02/rcalc-0_1_3.zip Source Code])<br />
* '''0.1.2''': [http://www.11-55.org/rcalc/2007-06-01/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-06-01/rcalc-0_1_2.zip Source Code])<br />
* '''0.1.1''': [http://www.11-55.org/rcalc/2007-05-25/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-05-25/rcalc-0_1_1.zip Source Code])<br />
* '''0.1.0''': [http://www.11-55.org/rcalc/2007-05-15/RAddon.uno.pkg UNO Package] ([http://www.11-55.org/rcalc/2007-05-15/rcalc-0.1.0.zip Source Code])<br />
<br />
[[Category:Calc]]</div>Wojciech