Remote Work - cogcommscience-lab/lab-docs GitHub Wiki

Connect to Zoom

As a member of the College of Letters and Science, you have access to a Zoom Pro license. You can request a Pro license using this form. A Zoom Pro license will allow for meetings up to 300 people with no time limits, and enable a variety of advanced features.

Alternatively, any College employee (with an active UCPath appointment) can log in with their UC Davis credentials and get a basic (free) account at https://ucdavisdss.zoom.us/. A free account will allow for unlimited one-to-one meetings, such as virtual office hours, tutoring, etc. The free account will also allow for multi-person meetings (i.e., more than two people, up to 100 people) up to 40 minutes long. However, the free account does NOT include many of the advanced features, such as recording the Zoom call.

To Access Zoom, follow these steps:

Navigate to: https://ucdavisdss.zoom.us

From that page, click the "Sign In" button, then log in with your UC Davis credentials. If you run into problems signing in, please contact [email protected].

If you have downloaded and installed the Zoom client and are logging in from within the Zoom client:

  1. Open the Zoom application and click the "Sign In with SSO" button.
  2. Click on "I know the company domain" and Type "ucdavisdss" in the box, then click continue.
  3. The UC Davis ADFS login screen will open in your browser, where you can log in with your UC Davis credentials.

For information on how to use Zoom for teaching, please see the "Zoom Web Conferencing" section on this page:

https://keepteaching.ucdavis.edu/teach

How to work with Jupyter notebook remotely

  1. On the lab workstation, move to the dir where your notebook is at.

  2. Start a tmux session with tmux new -s jupyter_notebook

  3. In the tmux session, start jupyter notebook with jupyter notebook --no-browser --port=8889. And you should leave the tmux session running.

  4. On your local machine, connect to the jupyter notebook with ssh -N -f -L localhost:8888:localhost:8889 <username>@<your_remote_host_name>

  5. Then you should see something like:

The Jupyter Notebook is running at: http://localhost:8889/?token=<this is the token that you should copy> And copy the token.

  1. Open a browser page on your local machine, and type in localhost:8888

  2. Paste the token when asked to type in. Then you should be connected to the remote jupyter notebook server and ready to run scripts.

How to build an online experiment pipeline SQPQS

To conduct online experiment, we will need three components:

  1. The first step is to design an online survey to give consent to participants.

When doing so, we must collect the participants' ID that SONA or Prolific automatically gives.

So, we need to create a metadata field in Qualtrics to collect the participants' ID and store it in survey data.

To do so, go to Survey Flow, add Embedded Data, then create a new field called id.

  1. The second step is to build an online behavioral experiment and host it on an online experiment host site.

We recommend using PsychoPy/PsychoJS to build the behavioral experiment task and host it in Pavlovia.

  1. We need to connect the consent page to the online behavioral experiment.

This can be done by redirecting the participants to the online experiment after they have completed the consent survey.

To do so, we need to copy the online experiment hyperlink like https://run.pavlovia.org/<YOUR ORGANIZATION ID>/<YOUR STUDY NAME>/html.

You can easily find this link on your Pavlovia study page.

Next, we need to copy and paste this link into the Qualtrics survey, you can do this by setting End of Survey to Redirect to URL, and pasting the link to Website URL.

After you have pasted the link into Website URL, you need to pass the participants' ID to Pavlovia experiment.

To do so, you need to copy and paste this ?id=${e://Field/id} to the end of the URL you just inserted.

After doing so, the Qualtrics survey will automatically put the participants' ID into the URL to Pavlovia.

  1. Next, you will need to do a second Qualtrics survey to collect demographic data from participants. So, you need to build a new demographic survey in Qualtrics.

  2. Similarly, you need to set an embedded data id in step 1 in your demographic survey.

  3. Next, you need to connect the online experiment with the demographic survey.

To do so, you will go to the Javascript file in Pavlovia, and find the function updateInfo.

In the updateInfo function, you can find util.addInfoFromUrl(expInfo);. This code will help Pavlovia recognize the embedded variable, participants' ID, and save it in the expInfo dictionary.

If you can not find this line of code. you need to insert this code.

Next, you need to set the redirect URL using

let redirectUrlQualtrics = 'https://<DEMOGRAPHIC SURVEY URL>?id=' + expInfo['id'];

you may also set a withdrawn URL for participants who withdrawn from the experiment to be redirected as well

let withdrawUrlQualtrics = 'https://<WITHDRWAN SURVEY URL>?id=' + expInfo['id'];

Note that if you have a withdrawn survey, you need to create a new survey in Qualtrics.

Lastly, you need to set

psychoJS.setRedirectUrls(redirectUrlQualtrics, withdrawUrlQualtrics);

So that participants who completed the experiment will be redirected to redirectUrlQualtrics, and participants who withdrawn will be redirected to withdrawUrlQualtrics.

  1. For the first step, we need to insert the Qualtrics consent survey into the SONA or Prolific study design.

In Prolific, in How do you want to collect your data?, choose External study link, and insert the consent survey URL into the URL box.

In Recording Prolific IDs, choose I'll use URL parameters, and click Configure parameters, then change the text in PROLIFIC PID box to id.

In SONA, what you need to do is insert the URL to Study URL, and add ?id=%SURVEY_CODE% at the end of the survey URL.

  1. Finally, we need to redirect participants from the demographic survey to SONA or Prolific to automatically grant participants credits or compensations.

In Prolific, it uses a completion code for each participant, so you can just put the URL with completion code to your demographic survey redirect URL similar to step 3, like https://app.prolific.com/submissions/complete?cc=<COMPLETION CODE>.

You can find this URL on your Prolific study design page.

In SONA, you can also find the URL on SONA experiment page.

After you have created the SONA experiment, it will appear at the Qualtrics Redirect to a URL box.

It looks like https://ucdavis.sona-systems.com/webstudy_credit.aspx?experiment_id=<SOME ID>&credit_token=<SOME TOKEN>&survey_code=${e://Field/id}.

Then, you can test if this pipeline works.

⚠️ **GitHub.com Fallback** ⚠️