IT-Notizen. 31. Oktober Laupenstrasse Bern Tel. +41 (0) Fax +41 (0)

Transkript

1 IT-Notizen 31. Oktober 2018 Laupenstrasse Bern Tel. +41 (0) Fax +41 (0)

2 Inhaltsverzeichnis 1 Ausführbare Version IT Bemerkungen Systemanforderungen der ausführbaren Version Systemanforderungen Betriebssystem Weitere Informationen Installation der ausführbaren Version Betrieb der ausführbaren Version Das R-Paket sstmodel Systemanforderungen für das R Paket Systemanforderungen Betriebssystem Benötigte Programme Benötigte R-Pakete Installation des R-Paketes Betrieb des R-Paketes /17

3 1 Ausführbare Version IT Bemerkungen Die ausführbare Version des SST-Tools ist eine eigenständige Anwendung zur Berechnung des SST- Quotienten in der Form eines ausführbaren Windows-Programmes (Executable file). Sie besteht aus 1. dem R-Package sstmodel 2. den zum Betrieb des R-Paketes sstmodel benötigten R-Programmen und Paketen 3. einem portablen Chromium Browser 4. einem Programm zur automatischen Installation auf einem Windows-Computer. Die Systemanforderungen haben sich seit dem Feldtest nicht geändert. 1.1 Systemanforderungen der ausführbaren Version Systemanforderungen Ein Intel-kompatibler Computer, mit mindestens 4GB RAM Betriebssystem Die ausführbare Version wird in zwei unterschiedlichen Formen verteilt: Datei SSTTool_setup_x86.exe SSTTool_setup_x64.exe Windows Versionen 32 bit 64 bit Beide Versionen benötigen zum Betrieb keine externen Bibliotheken oder Programme ausser den Windows Systembibliotheken. Sie sind getestet und unterstützt von den folgenden Windows Versionen: Windows Windows 7 Windows 8.1 Windows 10 Versionen 32 & 64 bit 32 & 64 bit 32 & 64 bit Die ausführbare Version könnte auch auf anderen Windows Versionen laufen, wurde jedoch nur für die aufgelisteten Versionen konzipiert Weitere Informationen Zu beachten ist, dass das SST-Tool in einem Verzeichnis zu installieren ist, in dem der Endbenutzer Schreibrechte besitzt. 3/17

4 1.2 Installation der ausführbaren Version Schritt 1 Die passende ausführbare Version ist von der SST-Internetseite herunterzuladen. Für die Systemanforderungen siehe Kapitel 5. Schritt 2 Es ist doppelt auf die heruntergeladene Datei zu klicken. Schritt 3 Die gesetzlichen Hinweise sind zu lesen und Next zu klicken. Schritt 4 Es ist zu warten, bis die Installation fertig ist. Sie dauert ungefähr 5 Minuten. 4/17

5 Schritt 5 Es ist zu wählen, ob das SST-Tool nach der Installation gestartet werden soll (Launch SST-Tool). Anschliessend ist Finish zu klicken. 1.3 Betrieb der ausführbaren Version Folgendes Bild veranschaulicht den Austausch zwischen Excel Oberfläche und R-Programm. Schritt 1 Nach der Installation befindet sich auf der Benutzeroberfläche ein Shortcut für das SST-Tool. Auf diesen Shortcut ist doppelt zu klicken. 5/17

6 Schritt 2 Das SST-Tool wird gestartet und der Browser mit dem Dashboard öffnet sich. Für die gesetzlichen Hinweise zu Betrieb und Weitergabe des Programmes ist auf Legal Notices zu klicken. 6/17

7 Schritt 3 Das befüllte SST-Template.xlsx ist hochzuladen. Schritt 4 Die Anzahl der Simulationen ist zwischen 1000 und 1 Million zu wählen. Der Seed kann manuell im Dashboard eingegeben werden. Zum Start der Rechnung ist auf Run simulations zu klicken. Schritt 5 Im Schritt Parsing excel file werden die Daten vom SST-Template.xlsx eingelesen. Bei unvollständigen oder ungültigen Eingaben gibt es spezifische Fehlermeldungen. 7/17

8 Schritt 6 Im Schritt Computing simulations werden die Simulationen zur Berechnung des SST-Quotienten generiert. Dieser Schritt kann einige Minuten dauern. Schritt 7 Sobald das Programm die Simulationen durchgeführt und die Ergebnisse für das Fundamental Data Sheet berechnet hat, erscheint eine Graphik mit den wichtigsten Ergebnissen und Randverteilungen. 8/17

9 Schritt 8 Um Simulationen gewünschter Risikofaktoren und Ergebnisse für das Fundamental Data Sheet herunterzuladen, sind die gewünschten Risikofaktoren anzuticken und anschliessend auf Simulation results zu klicken. Schritt 9 Eine Excel Datei Fundamental_Data.xlsx wird mit den gewünschten Ergebnissen heruntergeladen. 9/17

10 2 Das R-Paket sstmodel Das R-Paket sstmodel zur Berechnung des SST-Quotienten besteht aus 1. dem eigenständigen R-Paket sstmodel selbst 2. einer graphischen Benutzeroberfläche Dashboard, die über einen Browser gestartet wird. Es benötigt die Programme R, RTools und Rstudio sowie einige R-Pakete. Die Systemanforderungen haben sich seit dem Feldtest nicht geändert. 2.1 Systemanforderungen für das R Paket Systemanforderungen Ein Intel-kompatibler Computer, mit mindestens 4GB RAM Betriebssystem Das sstmodel R-Paket ist getestet und unterstützt von den folgenden Windows Versionen: Windows Windows 7 Windows 8.1 Windows 10 Versionen 32 & 64 bit 32 & 64 bit 32 & 64 bit Das sind die Windows Versionen, die R unterstützen. Das sstmodel R-Paket kann auch auf anderen Unix-basierten Betriebssystemen laufen, die R unterstützen. Es wurde jedoch lediglich für die aufgelisteten Versionen konzipiert Benötigte Programme Die folgenden Programme müssen auf dem Computer des Benutzers vorinstalliert werden. Programmname Mindestversion Aktuelle Version R Rtools RStudio* *RStudio wird benötigt, um die graphische Benutzeroberfläche Dashboard zu betreiben. 10/17

11 2.1.4 Benötigte R-Pakete Das sstmodel R-Paket benötigt andere R-Pakete, die in der R-Paket-Bibliothek des Benutzers zu installieren sind. Kursiv geschriebene R-Pakete sind bereits vorinstalliert. Paketname Mindestversion Aktuelle Version auf CRAN data.table readxl openxlsx MASS None shiny shinydashboard cellranger None Rcpp tibble httpuv mime jsonlite xtable None digest None htmltools R sourcetools None rematch None cli None crayon None pillar None rlang None assertthat None utf stats - - utils - - tools - - methods - - grdevices - - graphics Installation des R-Paketes Vor der Installation des sstmodel R-Paketes sind die im Kapitel 8 aufgeführten Programme und Pakete zu installieren. 11/17

12 Schritt 1 Das R-Paket sstmodel_2.0.1.tar.gz ist von der SST-Webseite herunterzuladen. Schritt 2 Rstudio ist zu starten. Danach ist Mitte rechts der Reiter Packages zu wählen und Install zu klicken. Es öffnet sich eine Dialogbox. Schritt 3 In der Dialogbox ist auf Browse zu klicken, das R-Paket sstmodel_2.0.1.tar.gz zu suchen und Install zu klicken. 12/17

13 Schritt 4 Es ist einen Moment zu warten. In der Konsole unten links erscheint der Befehl in blau, die Rückmeldung in rot und alle Funktionen aus sstmodel in schwarz. Schritt 5 Erscheint keine rote Schrift mehr, ist die Installation geglückt. Anderenfalls finden sich Details zu den Systemanforderungen und den benötigten Programmen und Paketen im Kapitel Betrieb des R-Paketes Folgendes Bild veranschaulicht den Austausch zwischen der Excel-Oberfläche und dem R-Programm. 13/17

14 Schritt 1 Rstudio ist zu starten. Danach ist unten links in die Konsole der Befehl library(sstmodel) einzugeben. Es erscheinen Copyright-Notes und einige Hinweise. Danach ist der Befehl launchdashboard() einzugeben. Schritt 2 Das SST-Tool wird gestartet und der Browser mit dem Dashboard öffnet sich. Für die gesetzlichen Hinweise zu Betrieb und Weitergabe des Programmes ist auf Legal Notices zu klicken. 14/17

15 Schritt 3 Das befüllte SST-Template.xlsx ist hochzuladen. Schritt 4 Die Anzahl der Simulationen ist zwischen 1000 und 1 Million zu wählen. Der Seed kann manuell im Dashboard eingegeben werden. Zum Start der Rechnung ist auf Run simulations zu klicken. 15/17

16 Schritt 5 Im Schritt Parsing excel file werden die Daten vom SST-Template.xlsx eingelesen. Bei unvollständigen oder ungültigen Eingaben gibt es spezifische Fehlermeldungen. Schritt 6 Im Schritt Computing simulations werden die Simulationen zur Berechnung des SST-Quotienten generiert. Dieser Schritt kann einige Minuten dauern. Schritt 7 Sobald das Programm die Simulationen durchgeführt und die Ergebnisse für das Fundamental Data Sheet berechnet hat, erscheint eine Graphik mit den wichtigsten Ergebnissen und Randverteilungen. 16/17

17 Schritt 8 Um Simulationen gewünschter Risikofaktoren und Ergebnisse für das Fundamental Data Sheet herunterzuladen, sind die gewünschten Risikofaktoren anzuticken und anschliessend auf Simulation results zu klicken. Schritt 9 Eine Excel Datei Fundamental_Data.xlsx wird mit den gewünschten Ergebnissen heruntergeladen. Es wird empfohlen einen neuen Pfad zu wählen (d.h. keine Überschreibung einer bereits existierenden Datei), wenn die Excel-Datei Fundamental_Data.xlsx heruntergeladen wird. 17/17