DPTE – the blog!

Dynamic Process Tracing Environment User Discussion

Some DPTE Updates

With the recent availability of DPTE 3.0 there are some new and improved functions in the system. The full documentation has now been updated to include them, but the FAQ on the main DPTE experimenter page gives a quick update. Following are a couple of the really cool new things you may want to explore:

Social Experiments (updated for version 3.0.0)

The Social Experiment options under Settings in the Experiment Dashboard are for use with Social Experiments, which allow some degree of “Sharing” between Subjects, hypothetical or real. Currently in progress, you can designate an Experiment as Social, which opens new options on the Timed Items screen. These include marking an item as Shared and/or Shareable.

Shared Items appear with an announcement that they were shared by another user. The Subject has an option to open the ’embedded’ item or not. An event is recorded when a Shared Item is presented and closed, and when its embedded item is opened and closed. Stimulus Items and Questionnaires can appear as Shared Items.

Shareable Items contain extra options in the form of buttons that the Subject can select. The button names are editable and their selection will be recorded. These Items also may contain Comments and allow the Subject to leave comments.

Note that if the “master switch” check box–Enable Social Experiment–is deselected, the Timed Items marked as Shared will remain, but appear as regular Timed Items. There is a DPTE System Variable, [[SYS_VAR_SOCIAL_EXP]], used to track whether Sharing is on or off, and this variable can be changed by the experiment using a Calculation item.

The “Read-only” mode feature allows Experiments to start from a “baseline” state, where Comments and button clicks added by a Subject are not visible to subsequent Subjects.

For more detail see Section Three of the DPTE 3.0 Help Manual

Using HTML in (certain) DPTE text fields

As of DPTE 2.8.5, you can use HTML in the following DPTE text fields:
– A Text Stimulus Item’s main text
– an Announcement’s text
– the text of a Question.

In these fields, DPTE will treat the characters {{ and }} as < and > characters to surround your HTML. In the Player, this will render as HTML. For example, the text:

{{a href=”http://www.mylink.com&#8221; target=”_blank”}}Here is a link{{/a}}

would display a link to the location specified. Note that the link text will not appear underlined or blue unless you add that yourself. Remember to always include target=”_blank” so that it opens in a new window/tab.

Flash text fields (and therefore DPTE text fields) support a subset of HTML which includes the majority of simple commands, but complex HTML is not supported or recommended. It doesn’t hurt to try, but don’t count on using HTML to accomplish your DPTE goals.

Most of what you would use HTML for is already provided by DPTE, i.e. bold, italic, etc. Specifying new fonts will probably not work since all of DPTE’s fonts are embedded.

You can, however, use HTML to display an image using the img tag, as in
{{img src=”http://www.mysite.com/myimage.jpg}}

A list of supported HTML appears at: Supported HTML in Flash/DPTE

Fixing Subject Variables using Search/Replace function (DPTE 2.8.5+)

The Search/Replace feature (on the Experiment Dashboard on the Experiment Setup screen) works like a normal Find/Replace function. To use it to rename Subject Variables requires a bit of thought, but the process is not overly complex.

If you have been using Subject Variables in your Calculations or Conditions, and you then rename a Calculation, Question, or Questionnaire, the Subject Variable you embedded in the Condition will no longer be valid.

The first step is to use the Diagnostics to identify the “old” name you are looking for. You need only check “Verify referenced subject variables” to get a list of offenders.

If a Calculation name has changed, just include the double brackets around the old Calculation name, which you can copy from the Diagnostics window. So you would search for [[CalculationName]].

In the ‘Replace’ box, put the new Calculation name, by using the Subject Variables dropdown menu.

Be sure you check the box “Include Conditions and Calculations in Search” since those are the areas where many of your Subject Variable references will be contained.

It’s slightly more difficult for Questionnaires and Questions, since you can’t look for the full Subject Variable name if you just changed, for example, a Questionnaire name. In that case, you would search for:


So that the string will be found for any Question used within that Questionnaire. Use the same format for the replacement Subject Variable. For Questions, you would find/replace:


and that will find all the occurrences of that Question in any Questionnaire.

ploading questions

To upload a batch of questions, you first create an XML file of questions.  Your XML file must follow the format in the schema file contained here:

Question Upload Schema file

You then use the Upload button on the Questions screen and direct it to your XML file of questions.


Leave a Reply

Please log in using one of these methods to post your comment:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Google+ photo

You are commenting using your Google+ account. Log Out / Change )

Connecting to %s

%d bloggers like this: