A detailed description of how the ASSP project works on TiddlySpace. Please comment if you have any further questions about this #project.

How it works

A user creates a space via assp
They watch a series of videos and answer questionnaires at the end of them. Their answers are collated into a tiddler called ASSPResults in the space they have created. These results are later analysed.

Structure

The project is organised into a series of logical spaces. However it can be confusing to know what goes where when you are a newcomer!

assp

assp - this provides a landing page and an install script [1] using space-install to create a new space which includes either assp-female or assp-male

assp-female and assp-male

These spaces are identical in structure and in that the both define several Stories e.g. [2] and Videos e.g. [3]. The only difference is the stories and videos in each space are tied to the gender described in the space name.

A story is a questionnaire made using the questionnaire space. It basically lists any questions related to the story (tagged are used to categorise these) as defined in assp-questions and passes them through a template that can read special tiddlers and output questionnaire questions (explained here [4]). A video uses the youtube macro from youtube to render a video. When the video finishes it jumps to the next question. The youtube macro takes a parameter onEnd that does this. The space is themed via assp-theme

assp-questions

This is a space full of questions. The format of them is explained here [4]. These questions are tagged with the story they correspond to. For instance the tag q7f means question 7 for the female version of the questionnaire (assp-female)

Analysis

A final space assp-results is used to look for results and put them into tables. These can be then copied into Excel or Google Docs for further analysis.

The tables are constructed using a modification of the tsScan macro called tsScanTable. A search is made across tiddlyspace for tiddlers called ASSPResults and these are then passed through 2 templates - 1 is a row which defines all the column headers and the second is a row which contains values from each of the results tiddlers.

To take an example [5] the header defines a column like so:
|Info1|
the row template looks like this
|<<view ##Info1 text>>|
This prints a table with a column containing the value of the tiddler slice Info1 in each ASSPResults tiddler it finds. It's worth noting that the slice names are defined by the question names used in assp-results so in this case Info1 refers to the tiddler (the question) called Info1 in the assp-questions space (Info1)


[1] http://assp.tiddlyspace.com/#StartHere
[2] http://assp-female.tiddlyspace.com/#%5B%5BStory%201%5D%5D
[3] http://assp-female.tiddlyspace.com/#%5B%5BVideo%201%5D%5D
[4] http://jon.tiddlyspace.com/Making%20Questionnaires%20out%20of%20tiddlers
[5] http://assp-results.tiddlyspace.com/#[[Results: Participant Summary]]
bag
frontpage_public
created
Mon, 30 Jan 2012 13:26:20 GMT
creator
jon
modified
Mon, 30 Jan 2012 13:26:20 GMT
modifier
jon
tags
assp
project
location
latitude 51.1272039 longitude 0.2606927