Return to the Cannabis Timeline Followback page
										
___________________________________________________________________________________________________________________	

								*TIMELINE FOLLOWBACK TEMPLATE (last 30 days) - Example: Cannabis*
___________________________________________________________________________________________________________________	

Script Author: Katja Borchert, Ph.D. (katjab@millisecond.com) for Millisecond Software, LLC
Date: 05-20-2013
last updated:  11-05-2019 by K. Borchert (katjab@millisecond.com) for Millisecond Software, LLC

Script Copyright © 11-05-2019 Millisecond Software

___________________________________________________________________________________________________________________
BACKGROUND INFO 	
___________________________________________________________________________________________________________________	
This script implements a Cannabis Timeline Follow-Back calendar.
For more information about Timeline Follow-Backs at:
http://www.nova.edu/gsc/online_files.html#time_followback

___________________________________________________________________________________________________________________
TASK DESCRIPTION	
___________________________________________________________________________________________________________________
Participants are asked to fill out a calendar with their cannabis use for the last 30 days, 
starting with yesterday.

___________________________________________________________________________________________________________________	
DURATION 
___________________________________________________________________________________________________________________	
the default set-up of the script takes appr. 5 minutes to complete
___________________________________________________________________________________________________________________	
DATA FILE INFORMATION 
___________________________________________________________________________________________________________________	
The default data stored are:

Data file: 'timelinefollowback*.iqdat' (a separate file for each participant)

build:							The specific Inquisit version used (the 'build') that was run
computer.platform:				the platform the script was run on (win/mac/ios/android)
date, time, 						date and time script was run 
subject, group, 					with the current subject/groupnumber
script.sessionid:					with the current session id

blockcode, blocknum:				the name and number of the current block (built-in Inquisit variable)
trialcode, trialnum: 				the name and number of the currently recorded trial (built-in Inquisit variable)
										Note: trialnum is a built-in Inquisit variable; it counts all trials run; even those
										that do not store data to the data file such as feedback trials. Thus, trialnum 
										may not reflect the number of main trials run per block. 
									
values.yesterday_date:				stores yesterday's date as a string (e.g. 5/20/2013)
values.yesterday_weekday:			stores yesterday's weekday as an integer (e.g. 1 for Monday, ..., 7 for Sunday)
expressions.leapyear:				stores whether the year is a leap year

expressions.totalamount:			sums up all the quantities that participants reported over the 30 day span; regardless of method
expressions.mean_amount:			mean daily quantity consumed (over 30 days); regardless of method
values.count_nouse:				sums up how often a participant has checked the nouse checkbox

+all individual data points

values.date11:					individual dates of each of the calendar boxes (e.g. 11 = 1st row, 1st column....61 = 6th row, 1st column)
...
values.date61 = ""

___________________________________________________________________________________________________________________	
SET-UP 
___________________________________________________________________________________________________________________	
1. Screen that asks for information input about start day ("yesterday") -> year, leap year, month, day, weekday
2. Screen that displays instructions (edit instructions under EDITABLE CODE -> Editable Instructions)
3. Calendar Display: a calendar display with the last 30 days filled in with the appropriate days
(all 30 days are displayed on one page)
=> each days asks for a) quantity b) method or c) No use checkbox
=> a screenshot is taken of the filled in calendar (default; works on Inquisit Lab only)
=> computer totals the quantities and calculates mean quantity for the last 30 days
=> computer totals the number of times participants select "no use"

___________________________________________________________________________________________________________________	
EDITABLE CODE 
___________________________________________________________________________________________________________________	
check below for (relatively) easily editable parameters, stimuli, instructions etc. 
Keep in mind that you can use this script as a template and therefore always "mess" with the entire code 
to further customize your experiment.