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:

[[QuestionnaireName.

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:

.QuestionName]]

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


U
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.

Advertisements

DPTE Downtime Scheduled

There will be downtime on Thursday, March 13  (7:30am central, 8:30 eastern) to apply some server patches and make a change to the nightly restart (it will be moving to 1:55am central time, rather than 2am, to avoid being on a Daylight Savings Time boundary). The downtime should be less than 1/2 hour but could be up to an hour.

Please note that after this update, the DPTE server will be restarted every morning at 1:55AM Central Time (UTC 07:55 when daylight savings time is not in force and UTC 06:55 when it is.) When the server is restarted any subject taking a DPTE study may be disconnected and results for that subject may be unreliable. We suggest avoiding running subjects at this time. Restart generally takes only a couple minutes.

DPTE Downtime Tuesday Dec 10, 7AM Central Standard Time

We nee to place maintenance updates on the server that hosts DPTE. This server update is scheduled for Tuesday morning (7am Central Standard Time, 01:00 UTC) Dec 10.  During this period there will be no access to the DPTE system for either experiment setup or running subjects. We anticipate the system will be down for no more than 1 hour.

If there is a problem with this time let us know as soon as possible.

DOWNTIME NOTICE: FRI SEPT 20

As you may know, we had a system crash the other day. The crash appears to have been at least partly performance related: that day DPTE processed the largest number of subjects in one day ever.  As the tech staff has examined it, they’ve found some areas to fix to improve performance, so we should be in good shape going forward.

However, patches need to be applied to the server. Scheduled downtime will be between 9AM and 11AM, CDT (14:00 to 16:00 UTC) on Friday, September 20. During this time you will be unable to access DPTE or to run any subjects. Please plan accordingly.

Thanks for your patience and always feel free to let us know if you have any questions or problems.

DPTE Version 2.9.95 is Live

We meant to put this announcement up last week. A new version of DPTE was loaded, version 2.9.5. Among the updates in this version are:

1. Bulk Question uploading via XML file (Details on how to do this are in the FAQ on the DPTE landing page at http://www.processtracing.org. Note that this functionality is intended to allow you to author questionnaires outside of DPTE and load them into the system. It requires that you follow a very specific format as detailed in the FAQ.

2. The initial states of every Flow Item in terms of its Button Clicks and Comment Count is now being written when in a Social Experiment so this data can be used later for analysis.

3. The documentation for 3.0 is nearly complete and will be posted when it is.

We have a few more features to add to the system (including Data Cleanup on the Experiment Dashboard for example) but we are nearing a 3.0 version.

Let us know if you find these features useful.

System Restarted

All, DPTE is restarted and now seems to be operating properly. If you find any problems, please let us know.

System Crash

To all DPTE Users,

We appear to have suffered a system crash this evening around 6:45 pm US Central time.  At this time we are not sure what has caused it but the DPTE server is not responding.

The technical support team for DPTE has  been notified. As soon as we have a resolution of the problem, we will post here. But the system may be down for a while since we are now outside of regular working hours.

We apologize for the inconvenience and will do what we can to get the system back up and running as soon as possible.

Latest Update: DPTE V2.8.5

An update has been made to DPTE to add some new features. When you log into the system you should now be on v 2.8.5.  If you are not, then refresh your browser to clear cache.

This update includes the following:

– Owners can re-assign Experiment to another Researcher (“Owner” is now an option on the Role menu)

– Search/replace feature, which can also be used to help synchronize Subject Variable names (see DPTE faq pages for details)

– Hyperlinks and images (and other HTML) can be used in text fields (see DPTE faq pages)

– new System Variable SYS_VAR_RECORD_EVENTS can be used to turn event recording on/off. Please note if you turn off event recording you will severely limit the data you have available while recording is off.

– several Rec Data Set additions/bug fixes

We are particularly excited that hyperlinks and images are now available in text fields.  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 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.

As always, let us know if you run into any problems or have any suggestions for additional features.

DPTE Update Completed; New Features!

The DPTE update to version 2.8 (2.8.1) has been completed. If you do not see version 2.8.1 make sure your refresh your browser.

New and Updated User features of DPTE include:

Rectangular Data Set enhancements:

For multiple answer questions, the numeric number returned in the subject file is a count of how many items are selected. This is now done by the Player — the numeric answer for a Multiple Answer question is the count of answers selected, and so will be reflected in the Rec Data Set.

There have been some other incremental fixes to the rectangular datasets.

Visualization Function:

Add a visualization sheet that lists each questionnaire in the experiment (with the name of each questionnaire in its own column), and then all of the questions that are in that questionnaire in the rows below it.

Duplication Functions:

When duplicating stimuli items within an experiment, the alternatives and attributes that are assigned to that stimulus item are now carried over to the duplicate.

Language Support:

Czech language support has been added.

Player Enhancements:

Every call that DPTE can make is now tracked and reissued if it fails or does not come back with a result. The intention is to be able to recover from any state short of a prolonged outage (>30 seconds). This will probably take some further tweaking and different Experiments might yield different obstacles. This has been tested with a relatively simple experiment using a utility to “shut off” the internet for short instances, seeing if the software recovers. The major loading at the Stage and Substage breaks is tracked; apart from that, DPTE only has to load data for Questionnaires, Images, Follow-on Items, and social data (Button Click counts, and Comments). All of these are kept track of and re-issued if necessary; for example, every time the Flow Panels move, each one checks to see if it needs to reload the Button Count / Comment count data at the bottom.

The goal of these enhancements is to cut back on the number of failures of the player due to “internet lag” type problems.

 

As always, please test your experiments now that the revision is up, and let us know if you find any problems.

 

DPTE Will be Down Briefly Thursday May 2 for Upgrades

The DPTE system will be unavailable Thursday, May 2, from 10am to 10:30am CDT (11am-11:30am EDT, 15:00-15:30 UTC) for a server update. Since this is a fairly substantial update, afterwards you should test your experiments in the DPTE Player before running any larger groups of subjects, and report any inconsistencies or errors you encounter.

You will be UNABLE to run any experiments or access the experimenter interface during this time. Data for any subjects running at the time the system is taken down will be lost, so please avoid starting new subjects who will not finish before Thursday, May 2, at 10:00am CDT .

This update includes a number of new and improved features. We intend to get the user guide updated as soon as possible to include these features, including enhancements to social experiments and additional capability in the downloadable datasets.