Skip to content

Version control for asset files used in deliberation experiments

License

Notifications You must be signed in to change notification settings

Watts-Lab/deliberation-assets

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Deliberation Assets

This repository contains assets served to participants in deliberation experiments.

License

The collection presented here is the work of a variety of authors. Unless otherwise specified in README.mdorLICENSE files within subfolders, the original authors retain all rights to the materials presented.

Production Usage

This repo is synced to a CDN, but also provides version control for files, so that we can refer to the precise version of a file when tracing the data.

Dev Usage

During dev, you can start this as a local webserver by running:

npx http-server --cors -a localhost -p 9090

or:

npx http-server --cors -a 127.0.0.1 -p 9090

or:

npx serve -l 9090 --cors

In the deliberation-empirica admin, specify the cdn as:

{
  "batchName": "demo",
  "treatmentFile": "projects/example/treatments.demo.yaml",
  "dispatchWait": 1,
  "introSequence": "demoIntro",
  "cdn": "local",
  "treatments": ["demo_2p"]
}

Defining an experiment

Supported Config Options

  • batchName name to use in filepath of saved data
  • treatmentFile path relative to the root of the repository to the treatment file containing the treatments to be included in the batch. At the moment you can only use one treatment file.
  • introSequence is the name of the sequence defined in treatmentFile to be shown to all participants prior to assignment to treatment condition
  • treatments list of strings, each string corresponding to a treatment condition defined in the treatmentFile
  • useData [true/false] whether the data collected in this batch should be preregistered and used in data analysis. Use false when testing or developing
  • dispatchWait window for collecting participants before randomizing to groups, in seconds
  • platformConsent [US/UK/EU] which of several pre-baked consent forms to show to participants
  • consentAddendum path to a markdown file containing contents to be appended to the end of the consent form, that can be used to provide particular information about collaborating research teams.
  • launchDate date at which randomization to groups can begin
  • dataRepos: list of objects describing the repo, branch, and directory where data should be stored. Need to include deliberaiton-data-private as well.
[
  {
    "owner": "Watts-Lab",
    "repo": "deliberation-data-test",
    "branch": "main",
    "directory": "cypress_test_exports"
  }
  //... other repos that should also get the data
]

Future Config Options:

  • embargoThrough: a datestring after which data collected in this batch can be automatically made public
  • videoStorageBucket**: path and name of an AWS S3 storage bucket for video recordings to be stored in

About

Version control for asset files used in deliberation experiments

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 4

  •  
  •  
  •  
  •