Git Product home page Git Product logo

qualtrics's Introduction

qualtrics

qualtrics is an R client for the Qualtrics survey platform.

You will need an account and an API token for most functionality. Set the environment variable QUALTRICS_TOKEN to your token. You can do this during R startup (recommended), using a configuration file and read_config(), or interactively with Sys.setenv():

Sys.setenv("QUALTRICS_TOKEN" = "mykey")

Usage

library("qualtrics")

Installation

CRAN Downloads Travis Build Status

Appveyor Build Status codecov.io

This package is not yet on CRAN. To install the latest development version you can install from the cloudyr drat repository:

# latest stable version
install.packages("qualtrics", repos = c(cloudyr = "http://cloudyr.github.io/drat", getOption("repos")))

Or, to pull a potentially unstable version directly from GitHub:

if (!require("ghit")) {
  install.packages("ghit")
}
ghit::install_github("cloudyr/qualtrics")

Related

cloudyr project logo

qualtrics's People

Contributors

jamesdunham avatar leeper avatar

Stargazers

avatar avatar avatar avatar avatar avatar

Watchers

avatar avatar avatar avatar avatar avatar avatar avatar

Forkers

dulani isabella232

qualtrics's Issues

Return survey as a tidy data frame with optional metadata

Currently, a user who queries a survey using any of the available R packages is returned a messy data frame.

Ideally, the returned data frame should:

  • Be Tidy
  • Contain information about data types (e.g. numeric, factor, character binary etc.)
  • Be able to deal with advanced Qualtrics features such as scoring, labelling etc.

Survey exports are provided in CSV, JSON, SPSS or XML format. Exports do not contain information about data structures, variable names, labels etc.

This information can be gathered through the 'get survey' option. Using these two data sets, we can give the user a lot of control over what/how data is returned, whether to store a copy on-disk, in what format to store data and so forth.

try to read key and subdomain from the disk if environment variables aren't set

qualtrics functions that make API requests take arguments key and subdomain, so users can provide these in the function call. The arguments' defaults are Sys.getenv("QUALTRICS_KEY") and Sys.getenv("QUALTRICS_SUBDOMAIN"), so if omitted, these environment variables are checked next.

Functions should also make a final attempt to read a key and subdomain from the disk, at some recommended location like ~/.qualtrics_api, as we discussed in the github.io thread.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.