RCMap is an open-source concept mapping software, implemented in R (R Core Team 2021). It provides a menu-driven user interface to guide users through the concept mapping analytical process (Trochim and McLinden 2017).
This document provides information on the required format of the input data, the installation process, and the graphical and analytical capabilities of RCMap.
RCMap (Bar and Mentch 2017) is user-friendly and does not require any programming experience. It can be used to generate cluster maps, point rating, cluster rating maps, pattern matching, go-zone plots, as well as several other types of plots. It can also be used to generate detailed reports with statistical analyses. Windows users can generate Windows Metafile formatted plots which can be edited in Microsoft Word and PowerPoint, in order to manually adjust various features to achieve the best visual results. Details about the plots, reports, and features appear in the sections below.
The RCMap homepage is https://github.com/haimbar/RCMap https://haim-bar.uconn.edu/software/RCMap/ . For questions, comments, and suggestions, please contact Haim Bar.
To cite RCMap, use
Bar, Haim, and Lucas Mentch. 2017. “RCmap, an Open-Source Software for Concept Mapping.” Evaluation and Program Planning 60: 284-92. doi:10.1016/j.evalprogplan.2016.08.018 and to cite the latest version of the package with BibTeX, use citation(“RCMap”)
@Manual{,
title = {RCMap: Group Concept Mapping},
author = {Haim Bar},
year = {2022},
note = {R package version 0.1.4},
}
To use RCMap, you must first install R (version >= 4.0.0) (R Core Team 2021) which is available from https://www.r-project.org/ .
RCMap requires the following packages:
Follow the installation instruction of R, and start R (version > 0.1.x no longer requires RStudio - any integrated development environment, or IDE, will do.) From the R console install the RCMap library. It will install the required libraries. You can do it by cloning the GitHub repo and building the package on your computer, or by using the install_github function (for which you will have to install the devtools package, first.)
devtools::install_github("haimbar/RCMap")
To start RCMap, type the following in the R console.
library(RCMap)
RCMapMenu()
It will show the top-level menu of the package:
RCMap command-line interface.
Top-level menu
1: Choose the data folder
2: summary
3: Settings
4: Plots
5: Reports
6: Analysis
7: R prompt
Selection:
The menu choices are described in subsequent sections.
A graphical user interface via a browser is not currently available. The menu-driven approach in this new version of RCMap has the advantage that the user can use built-in options and functions through an intuitive interface, but can also get back to the R prompt and perform any additional operations (for example, creating new variables, plots, or analyses.) This also allows greater flexibility in saving results. For example, plots can be saved to a file using the user’s preferred size, and in any format supported by R (pdf, png, jpeg, svg, eps, TIFF, bmp, and on Windows - wmf.)
The input data has to be in four CSV (comma separated values) files. Note that the file and column names below are all case-sensitive. An example is provided with the RCMap software for reference.
Most common data-entry problems occur because of one of the following reasons:
When a new project is loaded, RCMap checks for any possible issues with the data and provides warning or error messages.