Statistik und Informatik             10.02.1997 / 3.2.2000 / 2.6.2000 /8.3.2001/ 17.6.02 / 26.6.02 / 04.07.02 / 06.12.02 / 18.3.03 / 11.07.03 / 11.11.03 / 14.05.04

REVWEB

Erstellung und Wiederbelebung statistischer Reports

P. Naeve , H. P. Wolf


R-Editor - Windows-Version ACHTUNG NEU: jetzt gibt es den R-Editor rwined() als eigenes Paket!!

Reportmanager - Windows-Version -- mit R-Editor rwined()

Reportmanager vom 26.06.02 - Windows-Version

REVWEB-System unter S-Plus

WEB-System-Zugabe für Windows-WinEdt zum literaten Programmieren: tanlge, weave, revweb


Zielsetzung

Statistische Analysen sollten zu nachprüfbaren Reports führen.

Zur Unterstützung des Arbeitsprozesses müßte ein geeignetes Werkzeug:

Das REVWEB-System ist zur Erreichung dieser Ziele geschaffen worden.

Außerdem hat das REVWEB-System seine Eignung für die Lehre durch die Wiederbearbeitung von Datenanalysen und durch interaktive Demonstrationen unter Beweis gestellt.

Darüber hinaus ist es für eine verständliche Implementation und Darstellung neuer Strategien und Algorithmen einsetzbar.

Idee

Während der Analyse werden Verfahrensaufrufe und Resulate in einer solchen Form festgehalten, daß leicht erklärende Kommentare ergänzt werden können. Der so entstandene Report läßt sich mit wenigen Schritten ausdrucken aber auch für eine Reanalyse verwenden.

Demonstration

Ein einführendes Beispiel zeigt der File first.ps (Umfang 30 Seiten).


Der Reportmanager basierend auf R und Tcl/Tk

Im Rahmen der Technologie wiederbelebbarer Papiere ist eine neue Oberfläche entstanden, die einerseits über dieselben Fähigkeiten wie die schon klassische revive()-Funktion verfügt, andererseits aber ein völlig neues Oberflächenkonzept bietet. Mit diesem Instrument kann man während der Durchführung von Datenanalysen seine Gedanken und Codesequenzen in einem Fenster niederschreiben. Weiterhin lässt sich ein schon existierendes Papier laden und interaktiv bearbeiten.

Hier ist ein Schnappschuss:

Für nähere Einzelheiten kann im Moment nur auf das Quelldokument verwiesen werden. Wie oft gilt auch hier: Keine Garantie, nichtkommerzielle Verwendung frei, Herkunft immer angeben. Da dieser Vorschlag auf Komponenten von R, noweb, Tcl/Tk und Gnu-Komponenten aufgebaut ist, sind die für diese Produkte die geltenden Nutzungsrechte/Gewährleistungen zu beachten (vgl. http://cran.at.r-project.org/ http://www.eecs.harvard.edu/~nr/noweb/ http://www.sco.com/technology/tcl/Tcl.html http://www.gnu.org/ ).

Viel Spass und Erfolg

Peter Wolf


Den neue R-Editor rwined()

... gibt es jetzt als eigenes Paket. Nach Installation des Paketes sind nur zwei Anweisungen zum Start erforderlich:

library(rwined); rwined()

und schon zeigt sich das neue Fenster, das in der Bedienung viel einfacher ist als die Oberfläche von rtrevive(). Hier ein Schnappschuss:


Aktuelle Version

Voraussetzungen

Bevor man mit der Installation beginnen / dem rtrevive-System arbeiten kann, müssen einige Voraussetzungen erfüllt sein:

R-1.8.1 bzw. R-1.9.0 installieren, woher?

Installation

Zur Installation ist auf dem Windows-Rechner zu starten und als Zielverzeichnis .../rw1081/library bzw. .../rw1090/library zu wählen. Nach der Installation muss in diesem Verzeichnis das neue Verzeichnis rwined zu finden sein.



Installation von rtrevive

Zur Installation von rtrevive: geht entsprechend zu rwined.

Auflistung (alter) Dateien zu rtrevive

Arbeiten mit rtrevive

Wie kann man nun mit rtrevive arbeiten?
R starten
> library(rtrevive)
> rtrevive()        oder kurz > r()

Arbeiten mit dem Revbook unter rtrevive

Wie lässt sich das Revbook mit Hilfe von rtrevive öffnen?
R starten
> library(rtrevive)
> r()
  -> OpenLibPaper
     -> Open: rbk


alte Versionen des Reportmanagers incl. revbook

(Notation der Versionsnummern hier: JJMMTT)

Für R-1.4.1 und R-1.5.1 unter Windows: rtrevive.020315.exe, rtrevive.020626.exe, rtrevive.020704.exe. Als Ziel der Entpackung muss ../rw1041/library bzw. ../rw1051/library angegeben werden.

Für R-1.6.1 unter Windows: rtrevive.021206.exe, rtrevive.021211.exe. Als Ziel der Entpackung muss ../rw1061/library angegeben werden.

Für R-1.7.0 unter Windows: rtrevive.033005.exe, Als Ziel der Entpackung muss ../rw1070/library angegeben werden.


alte Hinweise

Eine Minimalanleitung in Form von 10 Schritten wird gegeben in rtrevweb.txt

Für die exakte Umsetzung der 10 Schritte wird noch die Test-Datei rtrtest.rev benötigt.

Für die Formatierung mit LaTeX ist übrigens der File noweb.sty erforderlich.

Natürlich werden nun viele Mails mit Fehlermeldungen erwartet.


rtrevweb only

Diejenigen, die nur die Programme für die Verarbeitung installieren wollen, die also nur an Tangle und Weave unter R interessiert sind, können dieses mit Hilfe von: umsetzen. Dieser Selbstentpacker enthält alle notwendigen Dateien. Zur Installation ist der Inhalt unter dem Verzeichnis ../rw106?/library des R-Baums auszupacken. Für die Nutzung ist dann

Alternativ kann man auch die zu verarbeitende Datei in das Verzeichnis ../rw106?/library/rtrevweb/rtrevweb unter dem Namen work.rev ablegen und dort die Batch-Datei rtrevweb.bat aufrufen. Dann werden die neuen Dateien work.tex (TeX-Datei), work.sch (Code-Datei) und work.htm (einfache Html-Datei) man erstellt. Bei regelmässig wiederkehrenden Verarbeitungswünschen kann man natürlich sich schnell eine eigene Bat-Datei schreiben, die die eigenen Wünsche umsetzt.

Eigene Experimente mit Tcl/Tk

Wer mit Hilfe der Tcl/Tk-Bibliothek von R eigene Oberflächen bauen will, kann dies auch ohne die oben beschriebenen Dinge tun. Dazu ist zuerst Tcl/Tk zu installieren:

FAQ: http://resource.tcl.tk/resource/doc/faq/

woher? http://dev.scriptics.com/software/tcltk/download83.html oder: http://www.tcl.tk/software/tcltk/ Ist das R gestartet, sind zwei Umgebungsvariablen zu setzen, damit das Tcl/Tk gefunden wird. Bei normaler Installation leistet dieses:

  Sys.putenv("TCL_LIBRARY"="C:\\Programme\\Tcl\\lib\\tcl8.3")
  Sys.putenv("PATH"="C:\\Programme\\Tcl\\bin")
Wird Tcl/Tk an anderer Stelle installiert, sind die Pfade anzupassen.

Eine kleine Knopfleiste zur Wiederbelebung ohne sonstige Zutaten

Revweb-Testversion mit Tcl/Tk-Knopfleiste zur Wiederbelebung fuer R-1.4.1 als Selbstenpacker: rtrr.050302.exe. Diese Version ist nur fuer Mutige geeignet.



Die Architektur der alten S-Plus-Lösung

Die Idee wurde zuerst durch Kombination folgender Subsysteme umgesetzt:

Wesentliche Grundlage bildet Knuth's Programmierstil des literate programming .

Implementation unter S-Plus

Bisher existieren Implementationen des REVWEB-Systems unter windows 3.1 (mit Splus ab 3.1) und hp-ux (mit Splus ab 3.0). Andere Plattformen, auf denen die genannten Subsysteme laufen, dürften auch keine Schwierigkeiten machen.

Software

Der File revweb.zip (ca. 1.6 MB) enthält die aktuelle Windows-Version, die sich mit pkunzip entpacken läßt. In dieser sind enthalten: die Elemente des Systems revsys.zip (ca. 0.6 MB) sowie Beschreibungen und Beispiele, die auch noch einmal gesondert in der Datei revnosys.zip (ca. 1 MB) zusammengefügt sind. Letztere Datei enthält auch eine readme-Datei READ_ME!.NOW.

Eine einfache R-Portation

Der File rrevweb4.sch (ca. 3.3 kB) enthält eine Modifikation für R. Vorgehensvorschlag: lade die in rrevweb4.sch definierte R-Funktion in den Interpreter und starte sie ohne Argumente. Dann werden die Installationsvoraussetzungen ausgegeben: Aufruf der Funktion rrevweb und Position für das in revsys.zip abgelegten revweb-Systems. Beispiel: > rrevweb("test","\\work") wird aus der Datei test.rev aus dem Verzeichnis \work im Verzeichnis \work die Dateien test.tex (Ergebnis des WEAVE-Prozesses), test.sch (Ergebnis des TANGLE-Prozesses) und test.tch erstellen.

Zum Test noch eine Sammlung von rr-Funktionen für die Wiederbelebung unter R. Erforderlich zur Aktivierung der Menuesteuerung: R-1.1.0 sowie Tcl/Tk. Hier ist eine fast aktuelle Beschreibung rr.ps. An diesem Differenz-File kann die Differenz zwischen der Beschreibung und dem Code-File abgelesen werden.



WEB-System-Zugabe für Windows-WinEdt zum literaten Programmieren

Mit dieser Zugabe gelingt es einfach aus dem WinEdt heraus literate Programme zu tanglen und zu weaven. Weiterhin lassen sich für das REVWEB-System Reports zu einen Code-File und einer netten Dokumentation verarbeiten. Mit dieser Zugabe sind also alle diejenigen angesprochen, die gerne Programmieren sowie unter Windows mit dem WinEdt arbeiten.

gesammelte Dateien (Version 11.07.2003): revwebWE.zip für tanlge, weave, revweb.

Dokumentation (12 Seiten): PS-Format PDF-Format REV-Quelldatei