Skip to content
Stata commands for sensor streams
Stata TeX
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
admin
src
testfiles
LICENSE
README.md

README.md

Stata package with SurveyCTO related utility functions

This repo Stata commands was developed to work with data collected using SurveyCTO's data collection software.

Content

This Stata package includes three commands related to processing data outputted from SurveyCTO Surveys:

  • sctomedia - creates copies of SurveyCTO media files in a specified folder with user-friendly names constructed from values stored in your dataset. This includes images, audio, video and text media files. This command can also optionally organize such files into a folder structure, also named using values stored in your data.
  • sctostreamcsv - reads sensor stream csv files and calculates statistics for each time period used when collecting the sensor stream. This command can be used to see which part of the questionnaire was done in a context that was quiet, dark etc.
  • sctostreamsum - reads sensor stream csv files and calculates statistics for each submission and saves them all in a .dta file that can merged with the main survey data. This allows you to get all the features from the sensor_statistics field even after the data collection as long as you used the sensor_stream field for the sensor you are interested in.

Installation

This package requires Stata 13 or newer.

The easiest way to install this package of commands and keep it up to date is to type ssc install scto in Stata. Keep the files up to date by running adoupdate regularly, and follow the instructions if any of your installed packages are out of date.

Installation alternatives to SSC

An alternative to SSC is to install this package directly from the files in this repository. This should not be the preferred method for most users as the only advantage of this method compared to ssc install scto is that it allows you to install a version of the scto package from another branch in this repo where we are developing features not yet published on SSC. This is only relevant to users that are helping us to test out new features.

If you want to install the version of the package in the master branch, simply use the code below. You rarely want to do that, as that is the same as installing the commands using ssc install scto. If you want to install the files from another branch than the master branch, simply replace master in the URL below with the name of the branch you want to install from.

    cap net uninstall scto
    net install scto , from("https://raw.githubusercontent.com/surveycto/scto/master/src") replace

If you are not able to run net install from your computer, then you can download a .zip file with the content of this repository, extract it, and then replace the URL with the file location of the src folder where you extracted the content of the .zip file. Make sure that you are in the branch you want to install beofre you downaload the .zip archive, otherwise you will get the master branch version, which you can install much easier using ssc install scto.

Contributions

Contributions and any type of feedback is welcomed. Please feel free to submit a pull request with your own contributions, or open up a new issue on this page with a feature request, bug report or anything else. You can also send an email with your feedback to the email address below.


License

The scto package is developed under Apache License 2.0. See http://www.apache.org/licenses/LICENSE-2.0 or see the LICENSE file for details.

Main Contact

SurveyCTO (support@surveycto.com)

You can’t perform that action at this time.