RDS Analyst Install

From HPMRG

(Difference between revisions)
Jump to: navigation, search
(Installation on an Windows PC)
(Installation on an Apple Macintosh)
 
(26 intermediate revisions not shown)
Line 41: Line 41:
<!--http://neolab.stat.ucla.edu/cranstats/RdsAnalystSetup.0.42.exe -->
<!--http://neolab.stat.ucla.edu/cranstats/RdsAnalystSetup.0.42.exe -->
-
http://hpmrg.org/software/RDSAnalystSetup.0.7_181202.exe
+
<!--http://hpmrg.org/software/RDSAnalystSetup.0.7.exe-->
 +
http://www.stat.ucla.edu/~handcock/hpmrg/software/RDSAnalystSetup.0.72.exe
-
Download the install and double-click on it to install the software.  
+
Download the installer and double-click on it to install the software.  
This can install all programs and utilities needed. If you already have some elements installed you can deselect (or cancel) during the installs. It is recommended that you install this all the first time. This installer is almost 400Mb in size and will take time to download.
This can install all programs and utilities needed. If you already have some elements installed you can deselect (or cancel) during the installs. It is recommended that you install this all the first time. This installer is almost 400Mb in size and will take time to download.
Line 52: Line 53:
<!---* Download the <u>RDS Analyst</u> Updater: http://hpmrg.org/software/RDSAnalystUpdater.0.62.exe-->
<!---* Download the <u>RDS Analyst</u> Updater: http://hpmrg.org/software/RDSAnalystUpdater.0.62.exe-->
<!--- This just installs minor updates for the core packages (that is, anything that has changed since the full install was made). It will typically be a few Mb in size.-->
<!--- This just installs minor updates for the core packages (that is, anything that has changed since the full install was made). It will typically be a few Mb in size.-->
-
 
<!---After you install, you <b>should</b> use the updater to keep your installation to the latest version of the packages:-->
<!---After you install, you <b>should</b> use the updater to keep your installation to the latest version of the packages:-->
<!--->
<!--->
Line 61: Line 61:
<!-- You need the Java Runtime Environment to use  <u>RDS Analyst</u>. You can check to see if you have java installed at http://javatester.org/version.html-->
<!-- You need the Java Runtime Environment to use  <u>RDS Analyst</u>. You can check to see if you have java installed at http://javatester.org/version.html-->
<!-- If you get the message <i>A JRE has been found. Do you want to install another one anyway?</i>, it means that Java is already installed. In this case, click <i>No</i> so as to not reinstall it.-->
<!-- If you get the message <i>A JRE has been found. Do you want to install another one anyway?</i>, it means that Java is already installed. In this case, click <i>No</i> so as to not reinstall it.-->
-
 
+
This is a new portable version that does not need  the Java Runtime Environment to use.
-
This is a new portable version that does not need  the Java Runtime Environment to use. -->
+
<!-- You need the Java Runtime Environment to use  <u>RDS Analyst</u>. You can check to see if you have the right java installed through the Windows Start menu:-->
<!-- You need the Java Runtime Environment to use  <u>RDS Analyst</u>. You can check to see if you have the right java installed through the Windows Start menu:-->
<!-- # Launch the <b>Windows Start</b> menu-->
<!-- # Launch the <b>Windows Start</b> menu-->
Line 68: Line 67:
<!-- # Find the <b>Java</b> program listing-->
<!-- # Find the <b>Java</b> program listing-->
<!-- # Click <b>About Java</b> to see the Java version -->
<!-- # Click <b>About Java</b> to see the Java version -->
-
<!-- If you get a result like [[Media:RDSA_MAC_Java.png|this]], it means that Java is correctly installed.If there is no <b>Java</b> listing or an earlier version number you do not have Java correctly installed. In this case, in the installer click <i>Yes</i> so as to install it-->
+
<!-- If you get a result like [[Media:RDSA_MAC_Java.png|this]], it means that Java is correctly installed.If there is no <b>Java</b> listing or an earlier version number you do not have Java correctly installed. In this case, in the installer click <i>Yes</i> so as to install it -->
-
<!--  If you do not have Administrator privileges and the Java Runtime Environment is not installed then you will not be able to run  <u>RDS Analyst</u>.-->
+
<!--  If you do not have Administrator privileges and the Java Runtime Environment is not installed then you will not be able to run  <u>RDS Analyst</u>. -->
Line 79: Line 78:
=== Installation on an Apple Macintosh ===
=== Installation on an Apple Macintosh ===
-
There is a version for Apple Macintosh computers. They must have Intel CPUs (i.e., be purchased post-2006). To install, please follow the steps below:
+
There is a version for Apple Macintosh computers. They must have Intel CPUs (i.e., be purchased post-2006).  
-
* STEP 1: Download and install R-3.5.1 from here: http://hpmrg.org/software/R-3.5.1.pkg
+
The installer is at:
-
** This requires Mac OS 10.10 or newer. If you have an older Mac with a Mac OS that has not been updated since mid  2013, then you likely need to update via the Apple Store.
+
-
<!--* <u>RDS Analyst</u> uses Java to work. If you need to install Java, it can be found [http://www.oracle.com/technetwork/java/javase/downloads/jre8-downloads-2133155.html here].-->
+
-
<!--**Select Java SE Runtime Environment 8uXX, where XX is the latest version (e.g. , Java SE Runtime Environment 8u102)-->
+
-
<!--**OPTIONAL: You can check to see if you have Java installed at http://javatester.org/version.html. If you install the above version of Java it should report "Java Version: 1.8.0_102 from Oracle Corporation" (or a number greater than 102).-->
+
-
<!--* STEP 2: <u>RDS Analyst</u> uses Java to work. It uses the Apple version of Java. PLEASE INSTALL FROM THIS LINK: http://hpmrg.org/software/javaforosx-2017-001.dmg -->
+
-
<!--**You can check to see if you have Java installed at http://javatester.org/version.html. If you install the above version of Java it should report "Version number translation:  1.6.0_34  is, in English,  Java 6 Update 34".-->
+
-
* STEP 2: <u>RDS Analyst</u> uses Java to work. It uses the Apple version of Java. PLEASE INSTALL FROM THIS LINK: http://hpmrg.org/software/jdk-8u191-macosx-x64.dmg
+
-
**You can check to see if you have Java installed by typing "java -version" in a <u>Terminal</u> window. If you have enabled the browser version of Java (not necessary for RDS Analyst), you can find the version at http://javatester.org/version.html. If you install the above version of Java it should report "Version number translation:  1.8.0_191  is, in English,  Java 8 Update 191".
+
-
* STEP 3: Download the <u>RDS Analyst</u> Installer: http://hpmrg.org/software/RDSAnalystInstaller.0.66.dmg
+
-
** It should mount as a disk-image. Double-click on the installer in it (i.e., "RDSAnalystInstaller") to install the software.
+
-
<!--* <u>RDS Analyst</u> uses Java to work. If you need to install Java, it is at http://hpmrg.org/software/javaforosx.dmg-->
+
-
A reboot is not required. You do not need to uninstall any components to update (This includes R and Java). However the <u>RDS Analyst</u> application or the R application must not be running when you update.  
+
<!--http://hpmrg.org/software/RDSAnalystInstaller.0.71.dmg-->
 +
http://www.stat.ucla.edu/~handcock/hpmrg/software/RDSAnalystInstaller.0.72.dmg
 +
 
 +
Download the installer and double-click on it to install the software.
 +
 
 +
This can install all programs and utilities needed. If you already have some elements installed you can deselect (or cancel) during the installs. It is recommended that you install this all the first time. This installer is almost 400Mb in size and will take time to download.
 +
 
 +
A reboot is not required. You do not need to uninstall any components to update (This includes R and Java). However the <u>RDS Analyst</u> application or the R application must not be running when you update.
The <u>RDS Analyst</u> application and R will be in your Applications folder. To run <u>RDS Analyst</u>, double-click on it in the Applications folder.
The <u>RDS Analyst</u> application and R will be in your Applications folder. To run <u>RDS Analyst</u>, double-click on it in the Applications folder.
-
<b>Tips</b>: The recent updates to the Apple Mac OS (Sierra and High Sierra) have reorganized the ways apps, like <u>RDS Analyst</u>, work. So sometimes <u>RDS Analyst</u> will not be configured correctly and will not start (e.g., bouncing icon or no response to double clicking). Most of these relate to how Java works on the Mac. The  first thing to try is to open the <u>Terminal</u> and type in :
+
This is a new portable version that does not need the Java Runtime Environment to use.
-
R CMD javareconf
+
'''Note on Xcode and gfortran:'''
 +
Some Macs need the application Xcode and a version of Fortran to be installed. Xcode is software written by Apple to help people develop software on the Mac, including compiling some R packages from source code. In some cases, <u>RDS Analyst</u> will not run unless it is installed.
-
This asks R to check on the configuration of Java and try to get in sync with it.
+
Here are the steps:
 +
 
 +
* Install the Xcode application from the Mac App Store
 +
* Open the installed Xcode app, agree to the license, and let it install some "components"
 +
* Open a terminal window by opening the Terminal application (Applications > Utilities > Terminal).
 +
Type <i>xcode-select --install</i> and follow the dialogs that open. This installs some tools for making R packages from source.
 +
* Install gfortran by downloading the installer at:  https://cran.r-project.org/bin/macosx/tools/gfortran-4.2.3.pkg
 +
The file will be an Apple style installer (.pkg) which you will need to open to install gfortran on your computer.
 +
It should install by default in /usr/local/bin/gfortran.
 +
 
 +
'''Note for experienced users:'''
 +
This creates a private version of R for <u>RDS Analyst</u> to use and ensures <u>RDS Analyst</u> has the right version of R available for its use.  If you already have R installed separately, the two versions will peacefully coexist and you can use the other version of R just as you were originally.
<!--After you install, you <b>should</b> use the updater to keep your installation to the latest version of the packages:-->
<!--After you install, you <b>should</b> use the updater to keep your installation to the latest version of the packages:-->

Current revision as of 01:48, 17 February 2022

Contents

Introduction

RDS Analyst (RDS-A) is a software package for the analysis of Respondent-driven sampling (RDS) data that implements recent advances in statistical methods.

RDS Analyst has an easy-to-use graphical user interface to the powerful and sophisticated capabilities of the computer package R. RDS Analyst provides a comprehensive framework for working with RDS data, including tools for sample and population estimations, testing, confidence intervals and sensitivity analysis.

Example capabilities are an easy format for entering data, the visualization of recruitment chains, regression modeling, and missing data.

The interface of RDS Analyst is similar to SPSS. RDS Analyst is also a free, easy to use, alternative to proprietary data analysis software such as SPSS, STATA, SAS/JMP, and Minitab. It has a menu system to do common data manipulation and analysis tasks, and an Excel-like spreadsheet in which to view and edit data.

RDS Analyst is meant for users who want to use state-of-the-art techniques for estimation and quantification of uncertainty from data collected via RDS. It represents advanced, comprehensive and open-source software to visualize, model and conduct sensitivity analyzes for RDS data.

RDS Analyst is an intuitive, cross-platform graphical data analysis system for the analysis of RDS data. It uses menus and dialogs to guide the user efficiently through the data manipulation and analysis process, and has an Excel-like spreadsheet for easy data frame visualization and editing. It is also the front-end to the very powerful capabilities accessible via the R command-line interface and also the extensive capabilities of the R statistical language.

Basic facts

  • RDS Analyst is written for the R statistical environment.
  • The current development form is for Windows and Macintosh. A LINUX version will be available in installers when it is released publicly.

Installation

Installation on an Windows PC

The installer is at:

http://www.stat.ucla.edu/~handcock/hpmrg/software/RDSAnalystSetup.0.72.exe

Download the installer and double-click on it to install the software.

This can install all programs and utilities needed. If you already have some elements installed you can deselect (or cancel) during the installs. It is recommended that you install this all the first time. This installer is almost 400Mb in size and will take time to download.

A reboot is not required. You do not need to uninstall any components to update (This includes R and Java). However the RDS Analyst application or the R application must not be running when you update.

This is a new portable version that does not need the Java Runtime Environment to use.


Note for experienced users: This creates a private version of R for RDS Analyst to use and ensures RDS Analyst has the right version of R available for its use. If you already have R installed separately, the two versions will peacefully coexist and you can use the other version of R just as you were originally.

Finally, be sure to sign up for the RDS Analyst Users Group.

Installation on an Apple Macintosh

There is a version for Apple Macintosh computers. They must have Intel CPUs (i.e., be purchased post-2006).

The installer is at:

http://www.stat.ucla.edu/~handcock/hpmrg/software/RDSAnalystInstaller.0.72.dmg

Download the installer and double-click on it to install the software.

This can install all programs and utilities needed. If you already have some elements installed you can deselect (or cancel) during the installs. It is recommended that you install this all the first time. This installer is almost 400Mb in size and will take time to download.

A reboot is not required. You do not need to uninstall any components to update (This includes R and Java). However the RDS Analyst application or the R application must not be running when you update.

The RDS Analyst application and R will be in your Applications folder. To run RDS Analyst, double-click on it in the Applications folder.

This is a new portable version that does not need the Java Runtime Environment to use.

Note on Xcode and gfortran: Some Macs need the application Xcode and a version of Fortran to be installed. Xcode is software written by Apple to help people develop software on the Mac, including compiling some R packages from source code. In some cases, RDS Analyst will not run unless it is installed.

Here are the steps:

  • Install the Xcode application from the Mac App Store
  • Open the installed Xcode app, agree to the license, and let it install some "components"
  • Open a terminal window by opening the Terminal application (Applications > Utilities > Terminal).

Type xcode-select --install and follow the dialogs that open. This installs some tools for making R packages from source.

The file will be an Apple style installer (.pkg) which you will need to open to install gfortran on your computer. It should install by default in /usr/local/bin/gfortran.

Note for experienced users: This creates a private version of R for RDS Analyst to use and ensures RDS Analyst has the right version of R available for its use. If you already have R installed separately, the two versions will peacefully coexist and you can use the other version of R just as you were originally.


Finally, be sure to sign up for the RDS Analyst Users Group.

Getting started - The Manual

For the manual, go to RDS Analyst Manual

RDS Analyst citation information

To cite RDS Analyst, go to citation.

Personal tools