Support Home Release Notes

Release Notes

  • Overview
  • Recent Highlights
  • Coming Soon
  • Release Notes
  • Release Notes (Archive)

Overview


Welcome to our new Release Notes page! With every Gorilla Update will come a new entry on this page, keeping you up-to-date with the latest and greatest news in Gorilla.

How often do you update Gorilla?

At least once a month. At the moment though, we're releasing an update almost every week with new features, functionality, fixes and enhancements.

Is everything that is updated in Gorilla listed here?

Only content in our currently publically accessible tools are listed here. Updates to Task Builder Zones directly commissioned by researchers won't appear here until the researchers 'grace period' has ended. Updates to our new tooling - the long awaited 'Task Builder 2' - won't appear here, as the tool is only available for Gorilla Staff internally. And if I did include those updates, these release notes would be TEN TIMES LONGER than they are now.

Wait, what? Task Builder 2!!! Tell me more, tell me more...

(Surpresses urge to break into song because I starred in a production of Grease as a kid and know all the lyrics to the stage musical) Woah there! All in good time. While we won't be talking in detail about Task Builder 2 for a while yet, I'll occasionnally slip in a little snippet for you, so you can become as excited as I am!

Recent Highlights


Features

  • Shop Builder: Many new features and fixes
    The Shop Builder is Gorilla's unique tool for simulating a realistic online shop. Find out more about it here

  • Support Contact Form: Project Ownership Change Requests
    Users can now request a change of project ownership directly from the Support Contact Form (by selecting the aptly named 'Project Ownership Change Request' option). Both you (the requestor) and the other party (the responder) will need to provide a reason for the transfer and Gorilla Admin's may sometimes need to review these requests.

  • Experiment Tree: Override Dropdown Manipulations via Embedded Data
    Previously, Task manipulations set via a Dropdown (of which the most common is the 'Spreadsheet' dropdown) could not be populated via embedded data. As such, if you wanted to use a Counterbalance Node to dynamically select which spreadsheet to use, you'd have to combine this with some custom script in your task. Well not any more! Now you'll find a new option "(Manual Override)" in a manipulation dropdown which, when selected, allows you to specify an embedded data variable using the standard notation. This will work for all manipulations populated via a Dropdown (including manipulations added in Code Editor tasks).

  • Task Builder: Migrated stable Closed-Beta zones to Open-Beta
    The Screen Calibration, Gabor Patch, Canvas Painting and Mouse Response have seen extensive use to positive appraisal. As such, we've moved them into Open Beta, so they are freely available from the Task Builder Zones menu, without first requesting access via the Support Contact Form.

  • Task Builder: Click Painting scoring regions
    A much requested feature, the Click Painting zone now allows you to define 'boxes' within the Click Painting area that represent a correct click. This marks clicks that fall inside this box (within a pixel tolerance defined by you) as correct in the metrics and also the Active Response embedded data.

  • Task Builder: Click Painting Video zone
    Everything that comes in the Click Painting zone but for Videos instead of Images.

Enhancements

  • Experiment Tree: Direct links to Node Documentation
    In the Questionnaire Builder and Task Builder, there are direct links to the relevant widget/zone documentation. We added the same functionality to the Experiment Tree Nodes. When adding a new node or editing an existing one, you'll see a question mark which will link you to our support documentation.

Fixes

  • Order Node: Increased Order Nodes tether limit
    We've slightly reworked the Order Node to increase the number of Tasks?Questionnaires that can be attached to it, up to 50.

  • Task Builder: Fix issue with Audio Recording filename prefix.
    A previous update introduced a bug where the Audio Recording filename prefix was not added into the recording audio file name. Instead, the default text of 'audioFile' would appear. This would have affected audio files collected between 28th July 2021 and 5th August 2021. While the issue has been resolved (future audio files will contain the correct prefix) already collected audio files will remain incorrectly named.

Coming Soon


All listed updates are anticipated to be released by the end of September 2021

  • Haptic Feedback zone in Gorilla
    An implementation of the Vibration API, which is accessible on most Android based devices, allowing you to create tactile vibration patterns to use as stimuli.

  • Eye Tracking 2 improvements
    We'll be implementing our own solution for the performance issue that has affected many online tools implementing Web Gazer 2. We'll also be updating to the latest version of the Web Gazer library, and adding additional features for limiting participants based on camera quality and directly branching participants who fail calibration to specific Task Builder screens

  • Data Generation UI Improvements
    Download your additional files (audio files, eye tracking etc.) as a separate zip folder (and correctly filtered by Start and End Time!!). Get live updates on where you data is in the queue and improved feedback when things go wrong/get delayed.

Plus I'll be giving you a sneak peak at some new Task Builder 2 features!

Release Notes

15th SeptemberBuild-2021-25
15/09/2021

Today marks the release of the Hearth and Home update for Valheim and the beginning of another few hundred hours of my life disappearing into a virtual world. Before I run off, build another turnip farm and spend the rest of time defending it from a horde of trolls however, here's the new features, enhancements and fixes that have happened in Gorilla today.

Features

  • Support Contact Form: Project Ownership Change Requests
    Users can now request a change of project ownership directly from the Support Contact Form (by selecting the aptly named 'Project Ownership Change Request' option). You can request a change of project ownership from you to someone else, or vice versa. You will need to have the Gorilla account email address of the Gorilla user you want to transfer to/from. If you aren't the owner of the project or a collaborator on the project, you'll need the Project ID (the string of numbers in the URL after admin/project/)

    Both you (the requestor) and the other party (the responder) will need to provide a reason for the transfer. Gorilla staff will need to review some requests and the reasons given will be critical - if we are unsatisifed with the reasoning given, we reserve the right to reject the request! We'll try not to let the power go to our heads...

Enhancements

  • Task Builder: Right click context menu overridden on video zones
    We've added functionality that attempts to prevent the Right-click context menu from being accessible on Video, Click Painting Video and GoNoGo Video zones. This should prevent the majority of participants from being able to access additional video controls. Some browser security settings and browser add-ons/extentions will, er, override our override. We don't have the ability to override an override to our override (and even if we could, I'm sure it would just be overridden).

  • Experiment Tree: Direct links to Node Documentation
    In the Questionnaire Builder and Task Builder, there are direct links to the relevant widget/zone documentation. We added the same functionality to the Experiment Tree Nodes. When adding a new node or editing an existing one, you'll see a question mark which will link you to our support documentation.

The development team is continually working on improvements to Gorilla's performance and implementing additional redundancies to its mechanisms. We have two announcements in that regard this week.

  • Stimuli and resources: Additional storage layer
    We've added an additional layer to our storage services, which should provide better download speeds in some circumstances. This new storage medium will only affect the content and stimuli uploaded to Tasks and Questionnaires and there should be no discernable change to task behaviour or functionality.

  • Data Generation Services: First stage of improvements
    With the new term beginning, we've already seen significant increases in usage of our platform over the last few weeks. The main Gorilla server swiftly expands to accomodate additional traffic. Today's update marks the first step to adding that capability to our Data Generation server as well. While there will inevitable be some increase in data download time during peak usage, we are working to keep these increases as small as possible.

Fixes

  • Order Node: Increased Order Nodes tether limit
    A new Gorilla "Book of Records" entry has been made. A researcher recently attempted to attach more than 24 nodes to a single Order node which had some... undesirable consequences. As a result, we've slightly reworked the Order Node to increase the limit to 50 and to also provide researchers with an error message, should they try to attach more than this.

  • Task Builder: Response Text Entry zone correctly counts attempt numbers
    Previously, when capturing both a metric on first key-press and on enter key-press, the number of response attempts would be incorrectly increased on each metric. This issue has now been resolved.


9th September UpdateBuild-2021-24
09/09/2021

Back after a short hiatus with a seemingly light update today. Behind the scenes, Task Builder 2.0 has entered internal alpha - a key milestone on the road to release. We also have a number of new Task Builder zones in-the-wings, ready for release over the next few months.

Features

  • Task Builder: Audio Recording zone now include Echo Cancellation setting
    Some users have requested the ability to supress other audio streams (such as from an Audio or Video zone) from entering a participants audio recording. Conversely, other users have requested the ability to not supress other audio streams, including them in the audio recording for analysis. To satisfy both groups, we've included the option to add an Echo Cancellation constriant to the Audio Recording zone. You can read more on the intended function of Echo Cancellation here

Behind the Scenes

  • Task Builder: Implementation of the Device Motion API
    As part of a consultancy project, we've implemented a DeviceMotion zone. This allows you to detect spatial movement and acceleration of a mobile/tablet device with settings for required acceleration thresholds and measurement intervals. In the Project, the zone is being used as part of a real-effort paradigm. The zone will be early access for the project research team only for approximately one month. You can read more about the Device Motion API here.

  • Task Builder: Implementation of a Drag and Drop zone
    As part of a consultancy project, the much-requested, long-awaited Drag and Drop functionality has been implemented. This works as a set of two zones: a Drag and Drop zone which on it's own allows you to drag an image to anywhere on the screen; and a Drop Scoring zone, which allows you to mark specific sections of the screen as drop locations. These drop locations can also be individually marked as correct or incorrect, allowing you to add scoring and feedback to a Drag and Drop paradigm. The zone will be early access for the project research team only for approximately one month.

  • Task Builder: Implementation of a Haptics zone
    As part of a consultancy project, we've implemented a Haptics zone, making use of the excellent Haptics.js library and the VibrationAPI This allows you to play a series of vibrations on a compatible mobile device and also includes the ability to record a participants input (screen taps) as a vibration pattern (as well as store it in embedded data so it can be replayed to the participant). As this zone has already been available to the research team for some time, it will be entering general closed beta (accessible via the Support Contact Form) within the next week.

  • Task Builder: Implementation of Vernier GoDirect Handdynamometer zone
    As part of a consultancy project, we've implemented an integration with the Go Direct (R) Hand Dynamometer. This represents our first integration with an external device via the WebUSB API and an exciting entry into the world of external sensors and devices. The zone facilitates the initial connection to the device, as well as collected measurements which can be presented to users in a number of ways (plain text, graphs, filling bars etc.) via the Task Builder scripting tools. In the Project, the zone is being used as part of a real-effort paradigm. As this zone has already been available to the research team for some time, it will be entering general closed beta (accessible via the Support Contact Form) within the next week.

Those are some cool new zones, yeah? Do you have a project or experimental paradigm that you could now implement Online with Gorilla via these new zones? Tell us all about it on Twitter @GorillaPsyc with the hashtag #ZonesOfAwesome


26th August UpdateBuild-2021-23
26/08/2021

Features

  • Task Builder: Click Painting Zones now include Screen Calibration settings
    The size of the image in the Click Painting zone and the video in the Click Painting Video zone can now be set to a width in centimeters or visual degrees. This requires either the Screen Calibration zone (which is now in Open Beta!) or a Code Task like the Virtual Chinrest

Enhancements

  • Shop Builder: Improved mobile layout
    Another round of Shop Builder improvements. Find out more about it here!

Fixes

  • Task Builder: Fix GoNoGo Video full playthrough setting
    Yes, this is the second time you've seen this in a month. No, I don't want to talk about it. All that matters is that this time it is actually fixed. Honest!

  • Projects: Collaboration modal no longer crashes during some invites
    Previously, trying to invite a user who had not finished creating their account to collaborate on a project would cause the collaboration modal to crash and do nothing. A proposal to have the Collaboration Modal "do a dance", to distract users from it doing nothing, was rejected. Instead, we opted to fix the problem. Users, at any stage of account creation, are now added as collaborators correctly. You can find out more about collaborating with other Gorilla Users here.

    (Plans for dancing modals may be revisited at a later date...)


19th August UpdateBuild-2021-22
19/08/2021

Features

  • Experiment Tree: Override Dropdown Manipulations via Embedded Data
    Previously, Task manipulations set via a Dropdown (of which the most common is the 'Spreadsheet' dropdown) could not be populated via embedded data. As such, if you wanted to use a Counterbalance Node to dynamically select which spreadsheet to use, you'd have to combine this with some custom script in your task. Well not any more! Now you'll find a new option "(Manual Override)" in a manipulation dropdown which, when selected, allows you to specify an embedded data variable using the standard notation. This will work for all manipulations populated via a Dropdown (including manipulations added in Code Editor tasks). To see this in action, check out our example Experiment here

Fixes

  • Code Editor: Manipulation values no longer missing from preview data.
    Previously, the value for manipulations set in the preview of a Code Editor task weren't being passed through to the preview metrics, causing the manipulation columns to empty. This issue has now been resolved.

Enhancements

  • Delay Node: Clarify delay node email reminder text
    Previously, the delay node email reminder text was phrased quite passively, to the point of implying that providing an email address was optional. However, when researchers select this setting in the Delay node, its often because the participants need to receive the email reminder to resume the experiment. Without it, they'll be unable to re-enter the study. A typical example of this would be recruiting for a longitudinal study via Simple Link. As a result, we've reworded the instruction to make it clearer that the participants may not be able to resume the study without this reminder email 9so should enter their email address). In a future update to Gorilla, we will make this text customisable so that it can be reworded to suit your specific circumstances and desired participant language.

  • Order Node: Update Order Node settings text to better describe Latin Square/Balanced
    The previous describe for the Latin Square and Balanced options in the Order Node was causing some confusion over what these two options actually meant. The setting text has been altered to better reflect what Latin Square vs Balanced means in this context.


5th August UpdateBuild-2021-21
05/08/2021

Fixes

  • Task Builder: Fix issue with Audio Recording filename prefix.
    An update introduced a bug where the Audio Recording filename prefix was not added into the recording audio file name. Instead, the default text of 'audioFile' would appear. This would have affected audio files collected between 28th July 2021 and 5th August 2021. While the issue has been resolved (future audio files will contain the correct prefix) already collected audio files will remain incorrectly named.

Enhancements

  • Home Page: Link to 'My Subscription' now appears in the dropdown 'burger menu' on the home page.

28th July UpdateBuild-2021-20
28/07/2021

Features

  • Shop Builder: Many new features and fixes
    The Shop Builder is Gorilla's unique tool for simulating a realistic online shop. Find out more about it here

  • Task Builder: Migrated stable Closed-Beta zones to Open-Beta
    The Screen Calibration, Gabor Patch, Canvas Painting and Mouse Response have seen extensive use to positive appraisal. As such, we've moved them into Open Beta, so they are freely available from the Task Builder Zones menu, without first requesting access via the Support Contact Form. As with all our zones, if you encounter any issues that aren't resolved through out documentation, please don't hesitate to get in touch via the SupportContactForm

Enhancements

  • Task Builder: Allow video replay on Click Painting Video zone
    The Click Painting (Video) zone added last update has been improved with a setting to allow the video to be looped/replayed a set number of times, bringing it more in line with the functionality of the existing Video zone

  • Task Builder: Allow screen branching based on correct/incorrect response in Click Painting zones
    When a screen advance is triggered by a Click Painting/Click Painting Video zone, whether the participants response was marked as correct or incorrect is now passed into the advance logic. This means that you can branch to a different screen depending on whether their response was correct or incorrect

  • Task Builder: Add RT's to Audio Recording metrics
    To make it easier to work out when different Audio Recording metrics occurred, we've added the current RT (time from start of screen) into the metrics


21st July UpdateBuild-2021-19
21/07/2021

Features

  • Task Builder: Click Painting scoring regions
    A much requested feature, the Click Painting zone now allows you to define 'boxes' within the Click Painting area that represent a correct click. This marks clicks that fall inside this box (within a pixel tolerance defined by you) as correct in the metrics and also the Active Response embedded data. At the moment, this only allows you to define square or rectangular regions. A more advanced version of this with more region options will be coming in the next iteration of our Task Builder Tooling

  • Task Builder: Click Painting Video zone
    Everything that comes in the Click Painting zone but for Videos instead of Images.

Fixes

  • Task Builder: Fix GoNoGo Video full playthrough setting
    The GoNoGo Video setting wasn't responding correctly to the zone being set to run through the full video. This was caused by an error in the settings which has now been resolved.

Release Notes (Archive)

Our previous release notes covering August 2016 to Feb 2020 can be found here.