yuxiaoluo/rqda-workshop

Introduction to RQDA (Updated in Jul 22 2022)

RQDA (R Qualitative Data Analysis) Workshop

This is a workshop that can be taught as a stand-alone workshop to introduce the qualitative data analysis tool (RQDA) in R. A releated blog post of this workshop has been posted on GCDI Tagging the Tower.

Credits

This workshop was written by Yuxiao Luo.

Workshops

It was first taught at CUNY GC by Yuxiao Luo in the Fall of 2020 as a two hour online synchronous workshop.

Abstract:

In this hands-on workshop, we will learn how to get started with qualitative data analysis in R using RQDA package. No prior R knowledge is required since RQDA has a graphical user interface and can be used with mouse click. However, we highly recommend you learn the basics of R so you can use the functions/commands offered in the package, which can improve your efficiency of data analysis. You can take our online Introduction to R workshop (https://github.com/GC-DRI/R). This workshop will be held online with Zoom.

Requirements

• Students should have R and RStudio installed, so they can install RQDA library in the local desktop and run it on RStudio.
• It would benefit students if they came to this workshop with some basic notions of how RStudio works. Any 5-10 minute long tutorial on Youtube should be enough for that, whoever is leading the workshop should give them the link.
• RQDA installation becomes a little complicated after R 4.0.0 was released, so a complete installation instruciton is drafted to help walk through the process. Do not let that scare you, it's free and useful after all.

Installation Instruction

As RQDA package has been removed from CRAN repository and you cannot use it with the new R version, this repository is intended to offer the necessary dependencies (packages and softwares) to those who still wants to use RQDA in R. Following the instructions below, you can manually install RQDA in your R 3.6.3 (2020-02-29) and use it like before. Please click RQDA official website for more details.

Installing RQDA (Windows)

1. Check R version: R version 3.6.3 (2020-02-29); RStudio version doesn't matter; You can change the R version from "Tools/Global Options" in RStudio setting if you have more than two R version in one computer.

2. Install Rtools35 and don't install the newest Rtools40. After installing Rtools35, run the command below: writeLines('PATH="${RTOOLS35_HOME}\\usr\\bin;${PATH}"', con = "~/.Renviron)

3. Go to SourceForge.net to download GTK+, use the link or download from the uploaded files above.

4. The following 3 packages can be downloaded from CRAN directly: install.packages(c("RGtk2", “cairoDevice", “DBI”)).

   • Update on July 2022: if you see an error msg saying "‘RGtk2’ is not available (for R version 3.6.3)", the reason is that it and cairoDevice have been archived on CRAN but can be installed from a copy on Togaware or downloaded from Packages folder in this repo.
     • Install on Togaware
       • On Windows
         • install.packages("https://access.togaware.com/RGtk2_2.20.36.2.zip", repos=NULL)
         • install.packages("https://access.togaware.com/cairoDevice_2.28.zip", repos=NULL)
       • On Mac
         • install.packages("https://access.togaware.com/RGtk2_2.20.36.2.tgz", repos=NULL)
         • install.packages("https://access.togaware.com/cairoDevice_2.28.tgz", repos=NULL)
     • Download and install manually: I also upload the compressed packages to the folder Packages, so you can download it from there and manually move them to the personal R library as specified in step 5 below.

5. The following 4 packages were delisted from CRAN, please download from the uploaded files above and copy-paste the 4 folders to your personal R library (use command .libPaths() in Rstudio console to see the library location, ex., C:\Users\Henry\Documents\R\win-library\3.6). The four packages are: a.gWidgets; b.gWidgetsRGtk2; c.RQDA; d.RSQLite.

Installing RQDA (Mac)

1. Check R version: R version 3.6.3 (2020-02-29); RStudio version doesn't matter; You can change the R version from "Tools/Global Options" in RStudio setting if you have more than two R version in one computer.

2. Rtools is only for Windows, Mac doesn’t need it.

3. Go to SourceForge.net to download GTK+ for Mac osx, use the link.

4. The following 3 packages can be downloaded from CRAN directly: install.packages(c("RGtk2", “cairoDevice", “DBI”)).

5. The following 4 packages were delisted from CRAN, please download from the uploaded files above and copy-paste the 4 folders to your personal R library (Use command .libPaths() in Rstudio console to see the library location, i.e. desktop/Macintosh HD/Library/Frameworks/R.framework/Resources/library). The four packages are: a.gWidgets; b.gWidgetsRGtk2; c.RQDA; d.RSQLite.

6. Update on Jul 22, 2022: some of you might encounter an error msg about igraph when loading RQDA using library('RQDA').

• If the error says igraph is not installed, just install it with install.packages('igraph').
• If you tried install.packages('igraph') and it doesn't work, try this install.packages('igraph', type = 'binary').

RQDA package dependencies

• DBI
• RSQLite doesn’t support R 4.0+ Version
• gWidgets delisted from CRAN in 2019
• gWidgetsRGtk2 delisted from CRAN in 2019

rqda-workshop's Issues

Install RQDA in Mac Os

The following words were quoted from @staceypark, the link to original post: Ronggui/RQDA#38 (comment)
"
I'm using:

macOS Catalina Version 10.15.4
R 3.6.3
R Studio Version 1.2.5033
Here's what I did:

Download a local copy of the most recent archived source code from the CRAN R archives (https://cran.r-project.org/src/contrib/Archive/) for each of the packages below:
gWidgets: Version 0.0-54.2
https://cran.r-project.org/src/contrib/Archive/gWidgets/gWidgets_0.0-54.2.tar.gz
RGtk2: Version 2.20.35
https://cran.r-project.org/src/contrib/Archive/RGtk2/RGtk2_2.20.35.tar.gz
gWidgetsRGtk2: Version 0.0-86.1
https://cran.r-project.org/src/contrib/Archive/gWidgetsRGtk2/gWidgetsRGtk2_0.0-86.1.tar.gz
magrittr (required for 'igraph'): Version 1.0.1
https://cran.r-project.org/src/contrib/Archive/magrittr/magrittr_1.0.1.tar.gz
RQDA: Version 0.3-1
https://cran.r-project.org/src/contrib/Archive/RQDA/RQDA_0.3-1.tar.gz
At this point I moved all these packages to a specific R working directory that I keep all my R work in. Doesn't matter where you put them as long as you know where.

In the Terminal, install the following in this order (I use iTerm on my Mac, but you can use Terminal):

Install XCode: xcode-select --install
Install Homebrew: /usr/bin/ruby -e "$(curl -fsSL"
Install XQuartz 2.7.11
brew install xquartz
brew reinstall xquartz (If you've previously installed xquartz on a different version of R, make sure to reinstall. Always re-install XQuartz when upgrading your macOS to a new major version.)
Install pkg-config (I used version 0.29.2): brew install pkg-config
Install gtk+:
brew install gtk+
brew upgrade gtk+ (I've previously installed gtk+, but needed to upgrade.)
Install the packages you downloaded in Step 1 in the order they were listed:R CMD INSTALL path-to-package-and-name-of-package - i.e. R CMD INSTALL /Users/staceypark/r_working_directory/gWidgets
In the R Console, install the following packages using the command: "install.packages("package_name") - i.e. install.packages("cairoDevice")
igraph: Version 1.2.6
cairoDevice (required for 'gWidgetsRGtk2'): Version 2.28.2
RSQLite (required for 'RQDA'): Version 2.2.1
this automatically installs the dependency 'DBI': Version 1.1.0
In the R Console, call the RQDA library: library(RQDA)
This will automatically load the libraries for all required packages
In the R Console, use RQDA function to launch RQDA GUI: RQDA()
Other notes:
I wasn't able to make this work in R 4.0.2. However, I expect to keep using more recent versions of R for other projects - which seems to be a concern for other folks on this thread as well.

Check out this awesome guide by @JacobRPrice for help:
https://jacobrprice.github.io/2019/09/19/Installing-multiple-parallel-R-versions.html"