RKWard

General info

The RKWard project is currently in the process of moving to KDE.org. See Incubator/Projects/Rkward. Current web site is still at Sourceforge.net: http://rkward.sf.net .

Feedback

This page is going to be a hub for RKWard related feedback and work-in-progress tracking. Might need subdividing over time.

Note that this is intended for things that may need discussing. Not for fully-specified feature requests. The latter should go to the tracker.

We're (mis-) using the \{\{Note\}\}-template to keep suggested solutions separate from the feedback.

Keep this page clean. Items that are done (or moved to the feature tracker) should be removed.

Installation issues

Mac OS X

As of 0.6.3, the dock icon, and the miniature icon in window title bars, still does not appear. This has been so since 0.6.1 at least. See example below.

The struggle I've run into with many Mac users is that they have to install R and then RKWard. It would be great if those could be bundled together again.

Windows

Abatty: With the Windows package, the issue is that it's just a .zip and you can run it from anywhere. People really aren't used to that, and they don't know how to add a shortcut to the Start menu/giant-useless-screen-with-live-advertisements.

Note

Idea: Ten virtual credits for the first person to provide an NSIS or WIX script that will wrap the self-extractor into an installer, adding

• Some cover page to look more like other installers
• Prompt for install path
• Adding an icon to desktop and/or application menu

Abatty: Also, many people are confused/freaked-out when a scary-looking black terminal window comes up upon starting it. The Windows package also seems pretty fragile. Most of the Windows students have tossed it and reinstalled it at least once. It's intermittent, and I haven't been able to reproduce it, but it just stops working at some point. The terminal window comes up, and that's all. I'd give you guys more information if I had it. Just generally speaking, the Windows version is not as reliable as the Mac, I'm finding.

Data import

Abatty: This is just rather confusing. You go to File or the Open... menu in the toolbar, and go to Import, and then there are a bunch of options. You have "Import Data," then a line, then "Import format," which is a submenu about importing data. If you use the first one, it just opens up the SPSS data importer, and there's no way to tell it otherwise. I have started providing my classes with .sav files for everything to just spare myself the headache of pointing out again and again, that they actually need to go to "Import → Import format → Import text / CSV data." It doesn't make sense because the way that menu is organized, it looks like that is some sort of separate function from importing data, because it's under the line separating it from "Import Data."

Abatty: The quickest/easiest fix right away for this would be to just kill the "Import Data" entry, rename "Import format" to "Import data format" and move it above the line in the menu, separating it from the script options. Just doing that would at least avoid the problem of people finding themselves stuck in the SPSS format importer, trying to feed it CSV data or whatever.

Tfry: Well, actually, there is a way. I sort of agree it may be a tiny bit unintuitive that you'd need to change the bottom-most control before clicking on any file name, though...

Jan I agree with Abatty here. If one needs to specify the import format anyway there should be *one* obvious way to do this. The general import dialog would make much sense if it would recognize the format (by file suffix, mime or the like), but if it does not, the calling the import dialogs directly is much better from the point of usability.

R Console

Abatty: It would be great if there were a way to permanently set text size there, or at least have a keyboard shortcut to change it. It's tiny by default, and the only way to get it bigger is to keep going up to "View" and clicking "Enlarge font" over and over. Then upon restart of RKWard, it's back to tiny again. This is another teaching issue more than anything. If I need the students to do something in R, it's very hard to demonstrate without bumping that way up, but it takes forever as I keep going up to that menu over and over until I see the students stop squinting at the projector screen!

Plotting issues of various kinds

Abatty: I can't seem to figure out how to make a grouped barplot out of the Plots → Barplot dialog. I've been telling my students to do it via the "N to 1 Crosstabulation" dialog, where it works fine.

Note

Will need to be added to one_var_tabulation plugin. It should be able to output a 2d matrix. The difficult part is making the interface easy. Perhaps two varslots: "Group by:", and "Group separatly by:".

Abatty: A Q-Q/Normality plot in the Scatterplot dialog would be awesome. The only place I can find that in RKWard seems to be one of the options in the Scatterplot Matrix dialog.

Abatty: It would be very helpful if the Scatterplot pulled axis labels from the Label header, or, if empty, the variable name itself, for the variable by default. Right now you have to enter labels manually. This results in me getting a lot of test answers labeled "Xrange" and "Yrange," which I still give full marks for if they are obviously the right variables.

Note

The whole scatterplot dialog is just crying for a complete redesign (around an <optionset>-element).

Outputs

Abatty: Exporting outputs is the area of the most confusion for my students. The only option for getting things out of the output is to export the entire giant HTML file, which still just pulls graphics from the invisible .rkward directory. To get a histogram out to submit for my test (I give tests with Moodle), the process is:

  1. Export the output to HTML.
  2. Open the output in your browser.
  3. Locate the desired graphic on the giant page of everything you've
  ever done with the software ever, unless you've flushed the output, but you
  were afraid to do that so it's still there.
  4. Right-click the graphic and save it to a file.
  5. Upload it to Moodle.

Abatty: A big part of this, of course, is that RKWard is running KDE, not the host OS, really. But this is a lot of steps for an undergrad or not-terribly-savvy user to complete correctly. Every time I've taught with RKWard, whether it be to undergrads or colleagues, everyone gets lost here. They can see the graphic right there in front of them. They don't understand why they can't just export it directly from the output (they'd love to just drag it out, but I point out that even SPSS doesn't do this, and JMP is a pain, too).

Abatty: Even I, as a pretty confident user of RKWard, find this to be a massive PITA, and what I do is just navigate to the .rkward directory and keep it open as I work, sorted by date, and just copy stuff out of there as needed. But even when I show people this workaround, they invariably MOVE things out of that directory and then cry, "Where did it gooooooo???" the next time they open RKWard.

Tfry: Not to say that this solves, everything, but dragging out graphics (to file browser, or openoffice) works just fine, here. What are the symptoms on Mac, when you try to do so? - Do you see a drag symbol / mouse pointer at all? - Does the drag symbol disappear when leaving the RKWard window? - Does the target refuse to accept the drop?

Note

With a bit of luck, the drag-and-drop issues will be fixed by the (post-0.6.3) port from KHMTL to QtWebKit. Check this.

Abatty: The whole system is extremely unwieldy and unintuitive, and what it means is that I get a lot of screenshots of RKWard on the tests. Even of the tabular outputs!

Abatty: This, I suspect, is a much bigger fix. What I would love to see, though, is that output HTML file and the associated images be in a folder with the workspace if saved, similar to how it works in SPSS, but less locked down and headache-inducing. So perhaps you open RKWard up to just play with some ideas, as I often do, and then opt to discard the workspace on close. While you're working on an unsaved workspace, the behavior is the same as now, but when you close it, the output files are also discarded. If you save the workspace, however, it creates a folder containing the R and RKWard workspace files, the same as now, but also a folder containing the outputs. Loading that workspace later will use that output folder instead. This solves the problem of an endless scroll of everything you've ever done with the software because if you even need one thing in there, you can't flush it, and makes it much easier to find things later. The current HTML-based output system is wonderful in that it can be opened in your browser and all the graphics files are already "exported" to PNG, but since they are locked away in an invisible directory, and necessarily chained to everything else you've ever done, it makes it very hard to get information out of it.

Abatty: Last comment about the outputs is one that has already come up here before: The tables are, by and large, very ugly. There needs to be more of a margin inside cells, and it would be nice if there were borders by default. Also, many of them have far, far too many decimal places. The contingency table/crosstabs are the worst for this. If any of the values need decimal places, they all get them. So even though most of the cells are actually just counts/sums, they all have approximately one million zeros behind them. It's just very hard to read.

Note

Some of this was improved on: Added margins inside cells, fewer issues of excessive digits printing. The issue in crosstabs is still unresolved.

Recode

Is is possible to select values from a variable-picker like picker (let’s say a "value-picker"). On the left are possible values to recode on the right the values we want to change.

• **Bug**: To add/remove the values from the picker can be tricky; there are conditions in which the add/remove button (green triangle) does not update to point away from the list which value is most recently marked – e.g. if you lick a value on the left (available), add that, than select that newly added value on the right (values to edit) and than (without click on the add/remove button) select a value on the left (available values) again. The arrow *should* point right, but is still points left, despite the focus being on the left list.

1. 
2. 
3. 

- Since the list displays an id/counter is is hard to use if your values are low numbers since it is easy to mistake the index number with your value. Since the index numbers seem not to add any informations, it makes sense to ditch them to reduce clutter and confusion. If they serve any purpose, they should have some sort of inactive formatting, like a gray background.

General UI

There are "workspace-buttons" (Open, Create, Save) and the "Object-buttons" which change according to whatever is displayed currently. They should have some visual separator.