Gorilla
Support Home Release Notes
KEY
TB2 Task Builder 2
GB Game Builder

Release Notes

  • Overview
  • Recent Highlights
  • New Tools Preview
  • 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 publicly accessible tools are listed here. Updates to tooling in Early Access or in closed beta, such as drum roll QUESTIONNAIRE BUILDER 2, won't appear here, as the tool is only available for Gorilla Staff and select universities and departments.
Bug fixes will be included if notable - a bug that has proved a considerable annoyance or had a significant impact. Typo corrections won't be included - you're not my PhD supervisor, so you probably don't care about typos. If you are my PhD supervisor, then this must be that dream again and I'd like to wake up now...

Wow, you just have a 2 everything these days don't you?!?

Indeed. Task Builder 2 - which is totally out now btw Task Builder 2: Overview Page. Game Builder 2 (well, to us it's Game Builder 2, but to everyone else it's GB1). And finally Questionnaire Builder 2 - coming later this year!

Recent Highlights


Features

  • Task Builder 2: RELEASED
    At long last, Task Builder 2 (No Task 2 Hard) has been launched. Pooling together feature requests from users around the globe, as well as our own vision for the future of an online Task Builder, we've built the foundations of the most powerful, capable and extensible Task Builder in the history of Task Builders!
    If you haven't done so yet, check out our Task Builder 2: Overview Page, where you can find out everything you could ever want to know about the new Task Builder. And make sure to stay tuned to this Release Notes page and our Twitter feed for more updates and feature showcases
  • Task Builder 2: Staircasing
    Adding to the Difficulty Change: Spreadsheet component, we now have the the Staircasing component available in Task Builder 2. Link variables such as Timelimits and Fixation times to a set of conditions, stepping them up and down in response to participant responses, accuracy or other behaviors. Finally, a fully adaptive Stop Signal Task in Gorilla without a single line of code!
  • 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 The Ultimate Shop Builder
  • Game Builder: Coming to a Gorilla near you
    A fully fledged Game Builder is coming to Gorilla very soon, allowing you to create rich game and game-like experiences, without touching a line of code. We've had a successful round of early access development and feedback, along with the ever important seal approval from the companies most important six year old: Josh building a task in Game Builder. Now, we're putting the finishing touches to the tools, implemented a few more requested features and getting all those lovely docs ready for you to get you up and running. The Gorilla Materials team have been game-builder-er-ing their socks off making demos, examples and walkthroughs for you. Their hardwork can be reviewed at your leisure here: Game Builder Documentation

New Tools Preview


New Tools Preview (OMG)

This is the year folks! A wealth of new tools are coming in 2022 and I think we'll be claiming the GotY (Gorilla of the Year) award pretty early this year.

First is our Game Builder which allows you to take your study experience to the next level. Our simple graphical user interface lets you build dynamic, engaging tasks with ease. The release of this tool is imminent - in the interim, you can get excited over the documentation here Game Builder Documentation

Next is our Multiplayer system, which will be coming to a number of our new tools, allowing you to create classic multi-participant paradigms such as the Dictator Game and Prisoner's Dilemma. You can see more of Game Builder and Multiplayer in our Gorilla Presents... Game Builder and Multiplayer webinar.

Though technically it was 'released' last year, I'm going to include our excellent Shop Builder, which allows you to create a customised, realistic shopping experience with numerous applications such as anchoring effects. Anchoring effects, behavioural interventions, social psychology etc. Check out our Gorilla Shop Builder Demo from last years BeOnline Conference

The long awaited sequel, Task Builder 2: NO TASK 2 HARD is now available for use. You can check out the documentation from our overview: Task Builder 2: Overview Page. Gorilla has had an incredible journey over the last five years and Task Builder 2 represents a culmination of everything we've learnt and all the feedback we've had from you, our incredible users! In the run up to Task Builder 2's release, we'll be showcasing some of the features that I think you'll all be pretty excited about. I'll also be updating our Gorilla Roadmap to indicate your most requested features that have found a home in the new Task Builder.

And last, but by no means least, Questionnaire Builder 2 is now in very active development. Expect this tool to be entering Early Access within the next few months!

2022 is going to be our biggest year yet with a wealth of new tools coming to Gorilla. We've already had an incredible journey with all of you the last five years - we can't wait to share the future with you as well!

Release Notes


12th May 2022 UpdateBuild-2022-05-01
12/05/2022

OOooooWeeee, it's been a while since we last did a Release Notes but gosh have we been busy! Since the release of Task Builder 2 at the beginning of April we've been continuing to add new components to reach feature parity with Task Builder 1. Not only that, but we've been hard at work on our new Game Builder tool (which you'll hearing more about soon). Further, we've been traveling though not just this universe, but all the universes in all the dimensions, to make sure we're creating the greatest Experiment Builder across all of time and space. And that's why, excitingly, we've brought forward the work on our next iteration of the Questionnaire Builder. OoooooWeee! But you'll have to stay tuned to future Seasons, er, I mean, Release Notes, to find out more about that.

Time to read some Rick Riggity Release Notes, son!

The Main Event

Coming soon

  • Game Builder: Coming to a Gorilla near you
    A fully fledged Game Builder is coming to Gorilla very soon, allowing you to create rich game and game-like experiences, without touching a line of code. We've had a successful round of early access development and feedback, along with the ever important seal approval from the companies most important six year old: Josh building a task in Game Builder. Now, we're putting the finishing touches to the tools, implemented a few more requested features and getting all those lovely docs ready for you to get you up and running. The Gorilla Materials team have been game-builder-er-ing their socks off making demos, examples and walkthroughs for you. Their hardwork can be reviewed at your leisure here: Game Builder Documentation
    Another way to find out more is to join this FREE webinar "How to gamify cognitive tasks to increase participant engagement" run in collaboration with Sage Publishing.

Morty: "So, that's, that's, that's like, pretty neat? A whole Game Builder? Do you... do you think that's neat too, Rick?"
Rick: "Shburrrrrghghhg it Morty, 'pretty neat'?!? You're asking the guy who literally invented interdimensional travel if he thinks something is neat. Morty. God Morty, we've had five seasons of this? How are you still such a ... wait, wait is this really all in the UI ONLY?..."
Rick: "Huh... Okay, yeah... this is pretty neat. This Nick guy must, musbuurrrrghgh t be pretty clever. Not entirely sure how I feel about that..."
Morty: "Oh, oh jeeez Rick..."


Features

  • Task Builder 2: Staircasing
    Adding to the Difficulty Change: Spreadsheet component, we now have the the Staircasing component available in Task Builder 2. Link variables such as Timelimits and Fixation times to a set of conditions, stepping them up and down in response to participant responses, accuracy or other behaviors. Finally, a fully adaptive Stop Signal Task in Gorilla without a single line of code!
  • Task Builder 2: Drag and Drop
    We've added Drag and Drop capabilities to Task Builder 2. However, this comes at a significant improvement compared to the TB1 variant. Due to the wonders of the component-entity system, Drag and Drop super-powers come in the form of a component that you can add to... whatever you want. Add it to an image, add it text, add it to a video, add it to your cat. Actually, don't do that last one. That probably wouldn't end well.
  • Experiment Builder: Attrition Report
    You've likely noticed that on the Data tab of your Experiment page, there is a copy of the experiment tree including attrition numbers on each node. Well, now, you can download those attrition numbers in a handy spreadsheet, for that experiment version, using the 'Download CONSORT Data' button. Even more data at the push of a button!

Enhancements

  • Experiments: Show capacity on Start Page
    We've had some complaints from participants that they'll be invited to a Gorilla study, click on the Start button, only to be told the experiment is already full. This happens for a number of reasons. Sometimes the experiment is genuinely full. Or, there are live but abandoned participants and there isn't an Experiment Timelimit set to automatically reject them. Most commonly, it happens when a recruitment platform has it's own count of 'complete' participants and the two platforms (recruitment + Gorilla) get out of sync.
    We're working on a more permanent solution for this. In the meantime, the Start page itself will now tell you if the experiment is open, running out of spaces or outright full. One less, click and a bit less frustration we hope.

Morty: "Rick, why do they, you know, break the Release Notes up... into, into sections like this?"
Rick: "It's so people can prioritize, MorMooooRRTty. Not everyone has the volume of disposable time that you do."
Morty: "But, like, wouldn't you want people to read all of it? I mean, it's so good and, and, there's so much cool stuff in there. Wouldn't you just, you know, put it all together in a, in a big soup of, awesome release notes??"
Rick: "Oh my god Morty, you're 14, you watch videos on Youtube of other people watching videos on Youtube. I don't think you get to criticize how a Release Notes is structured."


And everything else...

Features

  • Task Builder 2: HTML
  • Task Builder 2: Mouse Button Response
    Continuing our work to reach parity with Task Builder 1, we've added the Mouse Button Response component, which allows you to generate responses directly from left and right mouse button clicks. As well as a HTML component, which allows you to add general HTML to the screen.

Fixes

  • Game Builder: Prevent Sprite Scaling from causing upside down images
    A bug in Game Builder meant that sprite scaling would sometimes cause images to be transported to the upside-down. Or become upside down. I'm not sure which, the Shortcut card was ambiguous. Maybe both??
    Either way, an image being the wrong way up and/or being teleported to a dark 80's tentacles hell scape clearly isn't intended behaviour so we've fixed that now! (Okay, look, as soon as I saw the phrase Upside Down on the card, I knew it was destined for a Stranger Things reference. But then a Rick and Morty themed Release Notes just kind of flowed better overall. More Stranger Things next time, I promise.)

Enhancements

  • Subscriptions: Self removal from subscription
    Tired of getting Gorilla tokens at a lower cost-per-token from your institution or lab subscription? Want to strike it out on your own and get a Researcher Subscription just for you? Or, er, other more practical reasons for leaving a subscription like "not being at that university anymore" or "finishing your course". Well, you can now leave a subscription directly, without having to request a subscription manager do it for you. You'll find this option in the My Subscription tab of your Home Page.

  • Eye Tracking 2: General improvements and fixes
    While we work behind the scenes to bring Eye Tracking into Task Builder 2, we decided to give the existing Task Builder 1 zone a little TLC. We fixed a few issues where the Calibration Start button wouldn't unlock properly, tidied up some of the data cells coming through as NaN and fixed an issue where the x and y values for the Calibration points were normalised incorrectly. Importantly, this only affects the data download for the calibration (it was a post processing problem), not the results of the calibration itself.


Morty: "So... so, there it is everyone. The first Release Notes of May! Pretty exciting huh? Are you... er, are you as excited as I am?"
Rick: "Don't talk to the audience Morty. It's demeaning. This is a Release Notes not a BuUuuuRGGGhhhGh SNL sketch"
Morty: "Oh, oh jeez Rick. It... it's exciting. Yeh, yeah, it's exciting and you... and you, need to, loosen up. Yeah, just relax and enjoy the notes"
Rick: "Oh my god Morty, next time you freak out the squirrels I am switching dimensions without you!"

Summer: "Are you guys doing a Release Notes together? That is so fetch!"
Rick: "Stop trying to make fetch happen Summer. It's never going to happen. It's.. wait, what"
Morty: "Yeah Summer, fetch is never going to happen...."
Rick: "Shut up Morty! Everyone just stop referencing Mean Girls. That's, that's not something we would ever do. Oh god, oh shbbuggugrggghit. None of this is real."
Summer: "Grandpa, is this a scenario 4 again?"
Rick: "No Summer, this is a scenario nothing. Because none of this is real. We're just... we're just characters in some kids over active imagination."
Morty: "Oh jeez."
Rick: "None of this is real Morty! This is just Release Notes on a page. This is us on a page. EVERYTHING IS JUST WORDS ON A PAGE!"


7th April 2022 UpdateBuild-2022-04-01
07/04/2022

The Main Event

Features

  • Task Builder 2: RELEASED
    At long last, Task Builder 2 (No Task 2 Hard) has been launched. Pooling together feature requests from users around the globe, as well as our own vision for the future of an online Task Builder, we've built the foundations of the most powerful, capable and extensible Task Builder in the history of Task Builders!
    You've probably written that sentence off as overbearing marketting fluff, haven't you? But I'm being serious. See, I'm even going to take off my "Cauldron employee" hat for a moment.
    (takes off "Cauldron employee" hat)
    Task Builder 2 is genuinely incredible. The things it's already capable of, features that previously would be lines and lines of script, all possible with just a few clicks. And there are so many more things to come in the following weeks and months. It's been an honor and privilege to be a part of the team that has brought it to life (and it really was a full team effort!). And I can't wait to see what amazing online research you and all of our users unlock with it in the comings months and years!
    (puts back on "Cauldron employee" hat)
    If you haven't done so yet, check out our Task Builder 2: Overview Page, where you can find out everything you could ever want to know about the new Task Builder. And make sure to stay tuned to this Release Notes page and our Twitter feed for more updates and feature showcases
  • Task Builder 2: Added Change Difficulty (Spreadsheet) component
    In the first of our "Oh my gosh, I can do that without code now?!?" features: introducing the Change Difficulty (Spreadsheet) component. Link this component to accuracy data (correct/incorrect answers, percentage correct/incorrect etc.) or other data fields to dynamically increase or decrease the difficulty of a task by switching to an easier or harder spreadsheet. All with simple, flexible settings and mouse clicks.
    For those of you looking for a more Staircasing oriented approach to adaptivity, stay tuned: there's something coming round the corner just for you!

Enhancements

  • Project: Removed a collaborator cancels their currently open changes
    Removing a Collaborator from a Project where they have open changes on a Task/Questionnaire/Experiment would leave those changes in a state of limbo. None may close them, nor save them, nor overwrite them, an immortal testament to that collaborator who once was. A touch inconvenient really so now, when you remove a collaborator, you'll be warned if they have any open changes in the Project. You can then either ask them to resolve the changes themselves, or continue on and remove the collaborator, which will automatically cancel their open changes.
  • Task Builder 2: Audio components automatically enable Audio Subsystem
    Task Builder 2 features a new concept of 'Subsystems'. Subsystems control functionality that is either required throughout your task (such as Multiplayer tooling), or requires participant action to unlock. An example of this is the Audio Subsystem - this activates Gorilla's audio tooling and runs an initial test to make sure autoplay is unlocked on the participants device. Whenever you add an Audio component to your task, Gorilla will automatically enable the Audio Subsystem. As we add more features to Gorilla, we'll add more subsystems to complement them. For example, we'll soon be adding Microphone and Camera subsystems, to run initial checks on your participant audio/visual communication hardware. These will be much more indepth than in Task Builder 1 and will guide participants through basic debugging steps as well as more detailed testing of their hardwares capabilities.

And everything else...

Fixes

  • Questionnaire Builder: Radio Button widget text entry now saved correctly to embedded data
    The Radio Button widget has an Include Text Entry option, which allows you to add an 'Other' field to your list of Radio Buttons. However, this field wasn't getting added to embedded data correctly. This has been resolved now, so you can access it in branch nodes and other Tasks/Questionnaires
  • Task Builder 1: Reading Zone text no longer accidently highlighted when using mouse-based interactions
    When using mouse responses with the Reading Zones, an accidental click and drag could lead to the text being highlighted. A user highlighted this to us as being undesirable so that highlighting has now been removed, as it's certainly not functionality we would want to have highlighted in the future....

Enhancements

  • Task Builder 2: Made edit box for Markdown Component bigger
    For those of you who like to write as much as I do, we've increased the size of the edit box for the markdown component. Now you can both write and see all of the words. All of them!!
  • Experiment: Improved 'Check for Errors' messaging
    Before committing an Experiment, Gorilla will run a series of checks designed to catch common problems within an experiment. When describing some of these issues though, the terminology used wasn't lining up with the words we use elsewhere, making it harder to understand what the actual problem is! We've adjusted this now, to use terms you should be more familiar with from our documentation.

21st March 2022 UpdateBuild-2022-03
21/03/2022

NB: This update was originally planned for the 17th March 2022. But everything changed when the Fire Nation attacked... er, I mean, Github went down for most of the afternoon, rendering much of a normal development pipeline completely unsuable. Not wanting to push to production on a Friday, we opted to delay until Monday.


Have you missed me, everyone? Me, the 'Release Notes'. I've certainly missed me, in so much as a collection of words on a page can miss something. And oh gosh, what a collection of words I have for you today. A whole bunch of fixes, along with a few enhancements, you've all been asking for.

Also, I was originally going to litter this with Elden Ring puns and references. But, honestly, when thinking about Elden Ring, I'm still in the "how I'm going to show that crystal-fire-breathing, sarcastically wing-flapping a-hole of a dragon who the boss is" phase. Rather than the "how can I turn this into a Release Notes meme" phase.
Alas, I am nought but a lowly, maidenless tarnished. Give it time...

The Main Events

Fixes

  • Experiment Tree: Removed Include at Start setting
    The Start Node previously had an optional, off-by-default setting called Include at Start. When on, participants would be automatically included at the beginning of a study, permanently and irrevokably consuming a participant token. This feature was useful when researchers knew that they would need/want the data from all participants, regardless of how far they progressed. It was actually implemented on researcher request for this reason.
    Regrettably, the setting was frequently misused. Inspite of the many warnings we tried to put in place, users would activate the setting, have all of their tokens consumed by participants who drop out part way through and become understandably but frustratingly upset with us. As, ultimately, the setting appeared to be causing more harm than good we have decided to remove it entirely. By default now, participants will only be included (consuming a token) when they either complete your experiment or are manually included.
    There still exists the option to manually include participants and you can do this in bulk via the Include All button on the participants page. We'll be adding new options for managing participants via the Participants tab in a future update to Gorilla.
  • Task Builder: AudioRecording mode setting automatically removes whitespace
    Urgh, don't you just hate it when a single errant key stroke can completely break something? I certainly do. Like when the Audio Recording mode setting wasn't cleaning itself of spaces and return carriages, meaning that 'record ' != 'record'. This would mean that the Audio Recording zone would default to it's 'test' mode and this wouldn't become apparent until the task was previewed.
    Now, the mode setting text will be full cleaned before comparison. This should make us errant whitespace safe. However, please bare in mind that we are not yet "cat walked over keyboard when I wasn't looking" safe - machine/cat learning hasn't quite reached that level of capability. So always preview your tasks before release, just to be safe.
  • Task Builder: Remove 'stablise with arms' advice from Eye Tracking zone calibration text
    The default Eye Tracking Calibration introduction text previously included advice on using your arms to stabilise yourself, to reduce the motion of your head. A researcher recently contacted us querying this advice, as recent research suggested this may no longer be advisible best practice. Scheegans et al. (2021), Robal et al., 2018
    As we decided it would be better for Gorilla to remain neutral in the advice it directly offers participants, we removed the relevant text for both Eye Tracking and Eye Tracking 2. You can use the localisation settings for these zones to add the guidance back in if required.
  • Questionnaire Builder: Updated all widgets to store result on back button press
    A few of the more recent Questionnaire Builder widgets weren't saving their data on the press of a back button. This meant that if a participant went back with a partially filled current page, they would lose the entered information when they return. This has now mostly been resolved.
    The main caveat here: if you are using the date widget and have opted for the settings that restricts the detail that gets stored (for example, storing the date in months only), the entered date will still be lost on a back button press. These date restriction settings are primarily used when data protection or GDPR requirements mean you can't collect a full date and, in order to respect this, we don't store the originally entered date in any form.

Enhancements

  • Experiment Tree: Redundant Quota's will now be removed on commit
    This has been on the bucket list for a while! Previously, if you added a Quota Node (creating a new Quota for the experiment) and then removed the Quota Node, the actual Quota would still remain in your recruitment settings. If left unset or still enabled, this Quota would have undesirable consequences like preventing participants from entering your experiment. Boooo!
    Now, when you next commit your experiment after removing a Quota node, you'll be warned if there are any Quota's that are no longer associated with a Quota Node in your experiment. If you continue with the commit, the Quota's will be deleted from your experiment, troubling you no longer! Hurrah!
  • Collaboration modal: Change search to be triggered on button press
    A number of researchers have pointed out that the collaboration modal has become rather slow of late. As a short-term solution, we've changed the modal to only begin searching for a user when you press the magnifying glass button. If you type in most or all of the users name or email address before pressing to search, this should result in a far faster return.

And everything else...

Fixes

  • Task Builder: Fixed multiple issues with Mouseview data files
    The mouseview data file was defaulting to the name mousetracking and, in a few circumstances, would fail to open correctly in Excel with some rows of data becomes corrupted. Both of these issues have been resolved.
  • Task Builder: Haptic Feedback zone Record mode settings can now be accessed
    With the Haptic Feedback zone, it's possible to have a user "tap out" their own pattern of vibrations. This can then be saved and replayed to them via embedded data. At least, it would have been possible, if you could actually open the record mode settings for the zone! Now you can - good vibrations all around.
  • Task Builder: Drag and Drop zone dragged elements no longer reset position on refreshLayout call
    The function "refreshLayout" is called by Gorilla whenever the position of elements on the page needs to be checked and potentially adjusted. This typically is triggered when, say, displaying the "hover" or "pressed" image of an image response button. However, this function call was also resetting the position of Drag and Drop zone elements that had been dragged to a new location, undoing all of your participants deligent mouse movements. Drag and Drop zone's are now immune to layout refresh - they'll now remain precisely where you last put them down (unlike my house keys, phone, wallet etc.)

Enhancements

  • Task Builder: Video Recording zone metrics now include RT's
    A while back, we added RT values to the Audio Recording zone, so you could more easily determine when certain events (like the recording beginning or ending) triggered in relation to the beginning of the screen. We've now added these RT values to the Video Recording zone as well.

10th February 2022 UpdateBuild-2022-02
10/02/2022

Just a little release notes today with the usual mix of features/enchancements/fixes. In the background, the whole Gorilla team continues to beaver away on the new tools.

Urgh, okay, it turns out I can't say the word Beaver without shamelessly plugging this delightful city builder game populated by the furriest of buck-toothed dam builders: Timberborn! Soon you could be (pause of comedic effect)... beavering away too! (ba-dum tss)

Anyway, you came here for release notes, not a listing of my most recently played on Steam...

Feature/Enhancement/Fix

  • Experiment Requirements tool: Improved browser filtering tools
    This is a combination Feature/Enhancement/Fix. A FeatchantX? An EnhantureX? Something else with a capital X at the end (because that looks way cooler than a regular x, right?)

    Anyway, the browser filtering tools have received a Quality of Life update, with new features, some bug fixes and layout improvements. On the features front, you can now filter by additional browser. While there can be only one winner of the prize, there will always be more than one Microsoft Edge - specifically the current, modern Edge based on Chromium, and the original version Edge (Legacy). Under the hood, these browsers are very different and with Edge (Legacy) no longer supported, it's unlikely the latter will be compatible with all modern browser features. So, you can now specifically allow/block participants on Edge (Legacy). You can also allow/block users on the Opera browser!

    At the same time, we've reworked the UI to make it clearer which browsers are being allowed and which are blocked. Previously, this distinguish was made by colour alone, with the choice of colours being a bit not-great for colour blind users. Now, there are specific sections titled 'Allowed' and 'Blocked', to more clearly indicate for all users what settings have been chosen.

    Finally, we've fixed a few issues with detection of Internet Explorer and some variants of Safari!

Enhancements

  • Subscription Management: Assign tokens directly to members
  • Subscription Management: Improved editing of tags and member search
    We're continuing our enhancements based directly on requests from Subscription Managers. The first is the ability to assign tokens directly to users. Subscription managers can now setup available tokens for users in advance or handle token requests that come from outside Gorilla's own token request system. Next, we've made some QoL improvements to the search tools, and added the ability for the 'tags' assigned to a member to be edited on an individual basis, via the members tab.

Fixes

  • Experiment Builder: Manipulations are copied over when "Clone & Edit"ing a node
    The observant among you will have noticed that, when using the "Clone & Edit" tool to replace a node in the experiment tree the existing manipulations would just, kind of, disappear... They probably weren't supposed to do that, so we've fixed it so they should stay in place. Yah! Hopefully it won't turn out that they were disappearing off to do something critical, like save the world. That would be inconvenient... and quite improbable. I hope.

20th January 2022 UpdateBuild-2022-01
20/01/2022

Features Preview

  • New Tools: OMG!
    This is the year folks! A wealth of new tools are coming in 2022 and I think we'll be claiming the GotY (Gorilla of the Year) award pretty early this year. First is our Game Builder which allows you to take your study experience to the next level. Our simple graphical user interface lets you build dynamic, engaging tasks with ease.

    Next is our Multiplayer system, which will be coming to a number of our new tools, allowing you to create classic multi-participant paradigms such as the Dictator Game and Prisoner's Dilemma. You can see more of Game Builder and Multiplayer in our Gorilla Presents... Game Builder and Multiplayer webinar. Both of these tools are availabel via our Early Access scheme currently. However, sign up quickly, as the scheme will be closing soon!

    Though technically it was 'released' last year, I'm going to include our excellent Shop Builder allows you to create a customised, realistic shoppoing experience with numerous applications. Anchoring effects, behavioural interventions, social psychology etc. Check out our Gorilla Shop Builder Demo from last years BeOnline Conference

    And last, but by no means least, the long awaiting sequel, Task Builder 2: NO TASK 2 HARD. Gorilla has had an incredible journey over the last five years and Task Builder 2 represents a culmination of everything we've learnt and all the feedback we've had from you, our incredible users! In the run up to Task Builder 2's release, we'll be showcasing some of the features that I think you'll all be pretty excited about. I'll also be updating our Gorilla Roadmap to indicate your most requested features that have found a home in the new Task Builder.

    Oh gosh, I'm so excited! Are you excited too?!? OMG TWEET AT US WITH THE HASHTAG #TaskBuilder2 TO TELL ME HOW EXCITED YOU ARE!!!

Enhancements

  • Task Builder: Change Mode settings description to be clearer
    Many of our Task Builder zones can be run in different modes, such as our Eye Tracking zone (which can run in calibrate, record or upload mode) or our Audio Recording zone (test or record mode). To distinguish the specific text for these modes from the surrounding descriptive text, we'd previously wrapped them in double-quotes. However, this unexpectedly but understandably resulted in users typing the mode name in... with the doublequotes as well. We've ammended the setting text to make it clearer what the mode names are, without any additional characters that could be confusing. In Task Builder 2, settings like this will be straight up Dropdown Menu's! Hurrah for usability!
  • Subscription Management: Quality of Life improvements to the members page
    The first of two enhancements requested directly by subscription managers. Now, on a Subscription's Members page, you'll see both the Total number of tokens a user has requested from a subscription and the number of those tokens that are still unassigned. Even better, you can order the Members list by both of those categories so you can find your top users and biggest hoarders with ease.
  • Projects: Name of collaborating project owner visible from Projects page
    Are you a university technician, research assistant or PI? Are you added as a collaborator on hundreds of projects by your students? Do you wake up at night in a cold sweat because the Projects are all called 'Dissertation' and your Projects I'm Collaborating On is just a neverending list of 'Dissertation' cascading into the voids gaping maw?
    Fear no more, Gorilla Update is here! Now the Projects page includes a Project Owner column for projects you are collaborating on! One less thing to trigger the existential dread today, heh?

    Speaking of project owners...

Fixes

  • Projects: Adding self as a collaborator no longer removes Project Owner
    laughes nervously Sometime ago we introduced the ability to invite collaborators to Gorilla directly when adding via an email address on the Collaborate menu. However, while the system would filter out email addresses of existing collaborators, it wouldn't do the same for the Project Owner. As a result, a Project Owner could add themself as a collaborator, using their email address, become a collaborator and the Project Owner becomes... er, nobody. But not the kick-ass Bob Odenkirk flavour of 'Nobody'. Just, nobody. Yikes! We've fixed that now, so don't try and go adding yourself as a collaborator on a Project. Nothing will happen. I hope...
  • Task Builder: Mouseview Continue Recording setting now obeyed correctly
    HAVE I TOLD YOU THAT WE HAVE THE MOUSEVIEW ZONE IN GORILLA?!? Well, in case you didn't know, I fixed a bug in it so I would have an opportunity to tell you about it again! The Continue Recording setting, which allows you to combine moouseview recordings across multiple screens, wasn't being obeyed correctly, resulting in you getting a file per screen anyway! I've fixed that now so you can have one file to rule them all!
  • Task Builder: Eye Tracking 2 calibration filename corrected
    While updating Eye Tracking 2 a few releases ago, a bug slipped in where the calibration data filename defaulted to eyetracking_collection instead of eyetracking_calibration (as it was in Eye Tracking 1). This is fixed now!

Oh dear, I'm still too excited about all our new tools that are coming this year! I think I need to go have a lie down. They maybe I'll do a few rounds of Carlton Dance around the room first!


16th December UpdateBuild-2021-32
16/12/2021

And here it is. The last major update before Christmas.

It's truly Treemendous how many excellent new features and improvements the team have launch this year. And this week is Snow exception. Seriously, Yule not be disappointed with this collection of unFirgetable bug fixes and new features. Am I totally Sleighing it with this Christmas wordplay, or am I just a rebel without a Claus?

cough Sorry, I just took a call from my doctor and they've advised me that further christmas related puns might be bad for my health. Or possibly other peoples. Maybe both.

So no myrrh waiting, it's time for the release notes!

Features

  • Task Builder: Download all Stimuli button
    There are several categories of Christmas films. One of my favourites is the classic "grouchy individual/diverse collection of peoples must travel across city/country/world to retrieve macguffin and bring home in time for Christmas". Which is why I'm thrilled to announce our own Christmas film: "Stimulus all the way". It's the last day before Christmas and you've totally lost that insert university approved cloud sharing platform name folder of stimuli you used for that Gorilla task. And you desperately need them for important Christmas reasons!!! You could download them one-by-one from the task of coursse but that would just take all day.
    After a hilarious chase across the university campus, in which we blow a considerable amount of our film budget on cameos from celebrity behavioural scientists, you return empty-handed and crestfallen to your home. Oh gosh, it's way to late to download them all one by one now. Your children are going to be so unhappy with the lack of Stimuli this Christmas. You can't bare to face them. So you sit down at your laptop/mac/iPad/surface etc. and stare despondantly at the screen. But what's this in your twitter feed? A Gorilla Release Notes tweet?!? Gorilla have released a final update the night before Christmas?!? And my days, just look at that! It adds a Download all Stimuli button! Hurrah, Christmas is saved! Everyone is happy and filled with Christmas cheer. And stimuli. For some reason.

    Okay, okay, it's not getting a 'Fresh' rating on Rotten Tomatoes any time soon. But, maybe, it will become some cult Christmas classic with drinking games like "drink everytime they say stimuli or replication crisis or every time Reviewer 2 rejects something."

Fixes

  • Task Builder: Fixed GoNoGo Web Audio triggering advance multiple times
    The new GoNoGo Web Audio launched with an unfortunate bug that meant, in certain conditions, the function that advances to the next screen would trigger multiple times. This would cause future screens to advance unexpectedly, audio to play haphazardly and general chaos in the space-time continuium. I was going to tell a joke about time travel here, but nobody found it funny. So, instead, we resolved the issue before the Time Variance Authority could get involved much to everyones relief.
  • Task Builder: Resolved Eye Tracking 2 issue where the calibration would not restart
    The Eye Tracking 2 zone introduced a sparkly new, user-requested feature to allow repeating the calibration a fixed number of times. If your participant fails to calibrate X times, you can then advance them on to the rest of the task or branch them out of the task entirely. However, due to an unfortunate mix up beween the max failed calibration attempts variable and the max failed calibration points variable, the task would not allow the calibration to be repeated under certain circumstances. This issue has now been resolved and remains a reminder of the most important Christmas message of all - check your variables names. I mean, at least I think that's what a Muppet's Christmas Carol was about...
  • Task Builder: Resolved Mouseview issue where Upload mode would crash the task
    To give you more control over when individual data files are generated and uploaded, the Mouseview zone added a new mode Upload (which also appears in Eye Tracking 2). This mode indicates that all of the data generated so far should now be uploaded and cleared, but without running the Mouseview logic itself. This allows you to more easily break down data generation by trail, block, or one file for the whole task. While an issue with this has now been resolved, it turns out there's actually another issue here, meaning that no matter what settings you use, you'll always get a file per screen. That will be resolved in a few days.
  • Task Builder: Web Audio can now be played unlimited times in Manual mode
    Setting the number of replays setting to 0 should have allowed the audio to be replayed unlimited times. The Christmas Grinch that it was though, the zone was refusing to cooperate, playing once only and no more. We threatened it with a movie retelling of it's stubborness starring Jim Carrie and, suddenly, being played unlimited times, endlessly, for all mind numbing eternity, actually seemed agreeable.
  • Task Builder: Timelimit Section no resets correctly in Strict mode
    The Timelimit (Section) was upgraded with a new setting a few months ago, that allowed you to add a 'strict' timelimit to a section. This would enforce an absolute maximum on the length of time a user could spend in a section of the task, immediately moving on to the next section when it expires. However, once the Strict Section was resolved, Gorilla was not resetting a few critical internal variables. This meant that if you tried to setup another Timelimit (Section) in the same task Gorilla would immediately skip that too. We found the mischevious elf responsible, and put them right back on the shelf. A task with multiple Timelimit (Sections) should now function correctly.
  • Questionnaire Builder: Resolved the mystery of the missing -quantised values
    There has been a long running and elusive issue where -quantised values would not appear in participant data, seemingly at random. At last though, a Christmas Miracle has occurred. After an unbearably sad (think David Tennant in the rain gif but with snow) pentultimate muscial scene between the leading couple resulting in the christmasy villian having a convienently timed, subjectively sweet but objectively absurd change of heart, leading to a ridiculously lavish final number in which everyone is needlessly happy, a finally stopped embellishing the Release Notes long enough to tell you I found and fixed the problem. We also resolved an issue where multiple Radio Button/Check List Grid widgets would not have their quantised values created either. An important note on this: quantised values are generated and stored when a participant gives their initial responses. As a result, the above changes won't affect existing data sets.

2nd December UpdateBuild-2021-31
02/12/2021

First and foremost, if you missed last weeks excellent webinar on our new Game Builder and Multiplayer tools you should stop whatever you are doing and go watch this. If you like what you see and want to get in on the action, cancel whatever plans you had for immediately after the above video and go apply to our Gorilla Early Access scheme. Be the first to get in on the magic!

To the Release Notes. Much like me, the Build's for this year are now in their thirties (?!?)(I might be a slightly older thirties...) As I find myself contemplating the endless march of time I ask myself... Do I do my usual nerdy release notes? Maybe something themed around Netflix's unexpected wonder "Arcane"? Or maybe the impending release of Spiderman: No Way Home. Or, maybe I embrace the words of Admiral Pellow to Horatio Hornblower "When I was a child, I spoke as a child, I understood as a child, I thought as a child, but when I became a man, I put away childish things."... And, I dunno, quote Aristotle, or something...

Grownups!

As ever, XKCD has the wisdom we all truly need to get by every day. Next week, shortly before our next (likely pentultimate) release notes of the year, something else will be releasing. Likely suplanting Factorio as the reason why I look like death warmed over in our morning team meetings. So, once you figure it out from the numerous quotes below, tweet me the answer (bonus points for tweeting it in emojis). And, when next week comes, just wake me... when you need me.

Features

  • Task Builder: Web Audio Feedback zone
  • Task Builder: GoNoGo Web Audio zone
    It's a 2-4-1 special this week with Web Audio versions of the Audio Feedback and GoNoGo Audio zones. The Web Audio API is a more modern framework for playing audio files, with better resiliance against autoplay restrictions, improved timing performance and improved compatibility with wav files.
    This of means that, after many years of service, the original Audio Feedback and GoNoGo Audio zones are being retired and should be considered deprecated. And, maybe one day, when the Web Audio API becomes outdated and superseded by something better, I'll have to retire these new zones in the same manner. At the end of the game, the king and the pawn go into the same box.
    Woah woah woah, what have I told you about yelling at me in all caps?!? As ever, a zone being deprecated just means that it can't be added to a task. All existing zones in existing tasks will continue to function as normal. I promise we won't ever break your existing tasks... Er, at least not knowingly...

Oh, one more thing. Not content with just a straight recreation of the original zone, I add a requested feature from the Gorilla Roadmap as well. Specifically this one Both the Web Audio Feedback and GoNoGo Web Audio zones now allow you to set additional wait time after the audio has finished playing. Axios!

If you have a feature you want to see implemented in Gorilla, why not add it to our Gorilla Roadmap. Who knows - maybe it will appear as an early Christmas present before the end of the year! I'm not gonna make a person a promise I know I can't keep.

Enhancements

  • Task Builder: Amended misleading default setting text in Audio Recording zone
    In the Audio Recording settings, the 'Mode' setting had record and test in speechmarks, to make clearer what word should be placed as the setting. awkward cough Unfortunately, these speechmarks were also included when defining the default setting resulting in them having a very literal interpretation. There was much talk (support tickets), and we have listened. Through rock and metal and time...
    As the setting should be just test or record, we've removed the speechmarks from the Default: test text.
    Also, as some users didn't realise that the Audio Recording zone defaults to the testing mode, the setting will now autopopulate with test when adding a new Audio Recording zone.
  • Organisations: Force DD/MM/YYYY format for uploaded expiry dates
    Previously, Gorilla would default to your browsers language settings when determing how to parse expiry dates. So if you were in a normal country with the DD/MM/YYYY format, it would use the DD/MM/YYYY format. But, if you were living in some distant corner of the galaxy that insists upon using MM/DD/YYYY shudders it would begrudgingly use that format. It turns out this is problematic for a number of reasons (beyond the obvious of WHY?!?!). First, our documentation stated that expiry dates should be in the DD/MM/YYYY format. Obviously, this could have been changed to say that expiry dates should be in whatever format you use on your local corner of space-time. However, second problem: all it would require is for something in the "device -> operating system -> browser" chain to have the language set to English (US) and it will try to parse dates as MM/DD/YYYY, regardless of whether you would want that or not.
    Now, that's not going to happen! We've enforced DD/MM/YYYY when uploading expiry dates, regardless of what your local settings may, correctly or erroneously, try to implement.

Fixes

  • Task Builder: Fixed Drag and Drop issue in non-Chromium based browsers
    I remember when I joined Gorilla, we didn't have any fancy shmancy zones; we had sticks! Two sticks and a rock for the whole platform... and we had to share the rock! Now of course, you can do all sorts of cool things like create Drag and Drop interactive tasks with zone specific scoring. However, the Covenant infiltrated our codebase and a small bug arose where, in Firefox, dragging and dropping an image would cause the image to open in a new tab. Rather than, you know, dragging and dropping it. That's been fixed now. Drag and Drop for all on all browsers. Now, Sir, Permission to leave the station. To give the Covenent back their bomb.

Important annoucements

  • Recruitment: Removal of Research Now/Dynata recruitment policy
    While we've had a Research Now recruitment policy option available for a while now, there have eben two issues with it. One: Research Now is actually now Dynata. Two: it no longer works - Dynata have considerably changed how their platform works, such that it's no longer possible for us to implement and maintain a straight forward integration. As such, and avoid future confusion, we've removed the Recruitment Policy from the menu. If you want to make use of Dynata, you can still set up a connection via the Third Party recruitment policy. If you have any trouble with this, don't hesitate to get in touch with us via the support desk.

And now, to wrap up, probably one my favourite quotes from the whole series.

"I could give you over forty thousand reasons why I know that sun isn't real. I know it because the emitter's Rayleigh Effect is disproportionate to its suggested size. I know it because its stellar cycle is more symmetrical than that of an actual star. But for all that, I'll never actually know if it looks real. If it feels real. Before this is over, promise me you'll figure out which one of us is the machine."


25th November UpdateBuild-2021-30
25/11/2021

It's today, it's today! Yes, today is a very exciting release notes day as this evening is the first in a new series of Gorilla Presents... Beginning with an Exclusive Premiere of Gorilla's upcoming Game Builder and Multiplayer tooling, courtesy of CTO and renowned coding wizard Nick Hodges. There's still time to register for Gorilla Presents so forget the rest of the Release Notes for a moment and go do that!!

Also making a premiere this week is the "Definitely Coming Next Week" category, for all the things that we didn't quite manage to finish coding before the testing window closed. I blame Factorio and the endless desire to optimise it instills. Sometimes in life, all that matters is that it works, even if you can't look at it for a long time without breathing into a paper bag.

But if I just moved the main bus over here and circuit production over there I could... batman appears and slaps face

Enhancments

  • Experiment Builder: Delay unlock time added to Progress Modal
    To save you from doing time/date math on the fly (which, let's face it, is the hardest kind of math) the Delay Node and Redirect Node (if a delay is set) will now tell you the expected unlock time in the Participant Progress Modal. Now when participants message you saying they can't access the next day of your longitudinal study you can reply "HRNGHGGHG, IT'S NOT BEEN 48 HOURS YET" even faster than before.
  • Experiment Builder: Additional documentation links for Tree Nodes
    "I find television very educating. Every time somebody turns on the set, I go into the other room and read a book." Today's bonus points will be awarded for correctly identifying the owner of this quote. And don't go using Google... I won't know that you used Google, but Google will and don't they know enough about you already??
    Ahem, anyway, as part of our ongoing efforts to add resources where they are needed most, we've placed some additional advice and Support Links in many of the Experiment Tree Nodes. These highlight some of the important features or content users should consider when setting up an experiment node. Found these new links helpful? Tweet us on Facebook! Or Facebook us on Twitter! Either is fine.

Fixes

  • Subscription Management: Corrected case detection in member email addresses
    Gorilla was being just a little overzealous handling existing subscription members on a csv invite list, resulting in some... misleading removals and additions to subscriptions. We've amended that now. And, er, also fixed the bug we introduced in the process. How does the saying go? You can't make an omelette without forgetting a few null checks?

Definitely coming next week

  • Task Builder: GoNoGo Web Audio and Web Audio Feedback
    These are Web Audio API replacements for our existing GoNoGo Auio and Audio Feedback zones, bringing all of our audio based zones up to the latest technology. Not content with a straight replication though, I took the liberty of reviewing our Gorilla Roadmap and adding a few feature requests from there too!
    This also means that the existing GoNoGo Audio and Audio Feedback zones are entering the formal deprecation and retirement cycle. Whoah there, before you start typing in all caps at me - nothing will change in your existing tasks and experiments and the zones themselves will still function as expected. You just won't be able to add the zones to new/existing tasks. They've worked hard and had a good run - time to let the vacation in the Bahamas (or whatever a Gorilla Zone does when it's retired...)
  • Task Builder: Download All Stimuli
    By popular request, we'll be adding the option to download all of a tasks stimuli as a zip folder, making it easier to transfer stimuli from one task to another. Particularly if, like me, you have a constantly evolving, "better organised" file structure leading to an endless nest of half-finished designs you can't find anything in. This is one I can't blame on Factorio instilling the desire to constantly optimise. Truth is, my file structures have always been like this.

That's it for this week! Before I go, incase you are also a Factorio addict like myself, allow me to share this cursed Factorio video I shared it with my friends in Discord and I'm now not allowed to post in the Factorio Chat anymore. An overreaction if you ask me - it's just a few diagonal buses and pipes facing the wrong direction...


11th November UpdateBuild-2021-29
11/11/2021

Oh gosh, oh gosh, it's a big one today. So big that I haven't had time to think of a suitable tv/film/media bit for this post.

Or have I?

(I haven't. I really didn't have time.)

((Or did I?!?))

EYE TRACKING 2 UPDATE

You read correctly - the long awaited Eye Tracking 2 update has arrived. Below is a summary of the key updates, enhancements and bug fixes.

  • Eye Tracking 2: Decoupled Gaze Predictions from the Request Animation Frame loop
    WebGazer has always used the requestAnimationFrame functionality to handle gathering predictions on eye gaze. However, in WebGazer 2, the call to gather predictions is explicitly marked as async and then awaited within the requestAnimationFrame loop. As the browser won't start processing the next animation frame until the previous one has finished, any point where the browser is specifically told "wait here until this code comes back with a response" has the potential to slow down the main animation frame loop. As many packages for running experiments online use requestAnimationFrame to handle timing accuracy, any additional load within the requestAnimationFrame can have deterimental consequences on the overall timing of the task.
    To resolve this, we've extracted the main section of gaze prediction logic from the requestAnimationFrameLoop. This logic is then manually at a set interval, preventing the timing fallout from too much load on RAF (I haven't had enough coffee yet to keep typing out requestAnimationFrame...) What we've kept within the RAF is the repainting of the canvas with the latest video frame and then explicitly storing the performance.now() timestamp for when that frame was rendered. Gaze predictions are based on the content of the canvas so when collecting a prediction, the important time to store is not when the gaze prediction was requested but instead when the canvas was last updated!

    Aside: The ideal world would be one where I am much better at playing League, I finished writing that series of novels and there was an explicit event for a new frame of data comed from the participant web camera or a video element updates with a new frame. Then we could directly tie gaze predictions to when we know, for certain, there is new information to base them on. (There are functions out there for getting media stream data in a more piecemeal way, but it's not the same thing). There are experimental API's in development like requestVideoFrameCallback but they aren't widely adopted.

  • Eye Tracking 2: Set Gaze Prediction collection interval to cough match cough the camera's framerate
    When setting up our separate gaze prediction collection loop, we set our time between predictions to be 1 divided by the camera's frame rate. As noted above, this doesn't mean that we actually collect a prediction each time the camera sends a new frame of data. More that, if the web camera is running at 30 frames per second, trying to collect data 60 collections per second is going to be a bit pointless...

    Aside: some users have requested the option to detect and filter out users whose camera's are outputting at too low a framerate. While exploring this option (which now could be implemented) I discovered that media streams within the browser, via WebRTC, are inherently limited to a max of 30 frames per second. If users just want to enforce this (weed out anyone who's camera is running at less than 30 fps) then we can set that up for a future release. However, if you were hoping to enforce a higher minimum than 30... well, there's only disappoint to be had down that road, for the time being. At least it would be possible to enforce some kind of limit now though, right? I guess it depends on what kind of glass-fill-depth person you are. Or glass-fill-height, depends on what kind of ahhhhhhhhhhh.....

  • Eye Tracking 2: Branch to specific screen in Display on calibration failure
    While initially requested as a new feature, this option didn't make it into the initial release of Eye Tracking 2 due to some technical hurdles. After a rocky-style training montage, those hurdles have been faced again and conquered. You can now redirect to a specific screen within the same Display if the participant fails to Calibrate correctly. This will make it easier to then branch them to a different part of your Spreadsheet or indeed to exit them from the Task entirely.

  • Eye Tracking 2: Fix for Start Calibration button not unlocking
    In some instances, the Start Calibration button would not unlock, even if the users face had been detected and was in the required frame of the video. This issue has been resolved.

  • Eye Tracking 2: Fix for edge case where multiple requestAnimationFrame loops are created
    Within Gorilla, we pause the Webgazer module at the end of a screen (to prevent unnecessary load on the users device). On the next screen where Eye Tracking is used, Webgazer is then resumed. If Eye Tracking is used on consecutive screens and pause and resume are called within the same animation frame, this can result in multiple loop() calls being generated (resulting in multiple requestAnimationFrame loops). This edge case has been resolved (by directly cancelling the animation frame request on pause).

In other Gorilla news....

Enhancements

  • Task Builder: Added Response Type entries to Response Text Entry metrics
    The Response Text Entry zone allows you to collect the reaction time for both the first key press and the final enter key press. To make these metrics easier to distinguish when post-processing your data, the Response Type field in the participants data will now contain either 'First Key', or 'Enter Key' respectively

Fixes

  • Task Builder: Dropdown menus will now work on earlier screens revisited by screen branching
    Setup a Dropdown response zone on a screen. Then, branch back to that screen via the Advanced Branching options and the Dropdown menu will be disabled. Boooo! This is a result of how our lookahead system works when branching back to a recent screen and with zones not properly restoring themselves to default settings on a screen revisit. This has been fixed for the Response Dropdown Zone. We'll be reviewing other zones in the future, to make sure they behave consistently when screen branching.

  • Experiment Builder: Spreadsheets set via Manual Override won't reset on task update
    When updating the version of a task used in the experiment tree, Gorilla will check to make sure the values for manipulations set (primarily the spreadsheet used) are still valid. This is to make sure, if you've changed the names of spreadsheets in a task, you know that this will need to be updated in the task node (rather than Gorilla just.... trying to use a spreadsheet that doesn't exist or defaulting to another spreadsheet without telling you). However, when set to Manual Override, Gorilla is incorrectly stating that the spreadsheet name no longer exists and defaulting to whatever spreadsheet is first in your list. Gorilla will now correctly recognise this setting and leave it as is when updating a Task tree node.

Existence is pain

  • Device Restrictions: Added warning about iOS devices spoofing as desktop macs
    Hrrnnggnrh So, many modern iPad's and iPhones will now fib to the browser, claiming that they are Apple Mac's when they really, really aren't. I don't know why - you'll have to ask Apple. This means though that choosing to filter out Phone's or Tablets from participating in your study... won't always work. The available options for correctly identifying a device as being a computer/phone/tablet are becoming increasingly unreliable. For example, with many laptop's and all-in-one PC's coming with touch screens, trying to filter based on touch capabilities will give you increasing false positives/negatives. As such, we now strongly recommend that you explicitly ask users what kind of device they are using and use Branch Nodes to filter as a appropriate.

4th November UpdateBuild-2021-28
04/11/2021

Good morning Gorilla Experiment Builder. I am your Release Notes Dean, with a few announcements on this weeks release notes!

And yes, I'm doing another guess the TV Show bit! Specifically, one of my most favourited tv-shows. And if 'Dean' didn't give it away already, there is plenty, plenty more where that came from. SIX SEASONS AND A MOVIE!

Features

  • Task Builder: Drag and Drop zones
    As part of a consultancy project, we've implemented a set of Drag and Drop zones in Gorilla - these have now entered closed beta and can be accessed via the Support Contact Form. This zone is actually a 2-for-1 special! There is Drag and Drop Main, which enables Drag and Drop functionality on an image. By default, this can be dragged to anywhere on the screen. However, you also get Drag and Drop Scoring, which allows you to define specific areas of the screen to Drag'n'Drop to! You can give these different areas different response values and Drag'n'Drops to these areas can be marked as correct or incorrect according to your Active Response settings. Cool cool cool!

    If you like the new Drag'n'Drop zone, tweet at us to let us know! (Leonard has already liked this post!)

Enhancements

  • Subscriptions: Researcher subscription auto-assigns tokens
    Did you know that there's a Researcher Subscription option in Gorilla? Offering an up to 18% discount compared to buying tokens on PAYG, this subscription is perfect for the lone wolf striking out on their own with a smaller budget. Now, the subscription auto-assigns the tokens to your account (rather than using the request system that features in our Lab and Department subscriptions), making it even easier you to get started on your data collection. Check out our full range of pricing options - with one of these, you'll be streets ahead in no time!

  • Data Generation: Improved data generation message
    We've updated the data generation text to make it clearer what happens during data generation. For example, the data generation request gets sent to our separate data generation server so you don't need to leave your browser open on the Data tab. You can meerily be on your way, getting on with your vital research. Research like "are weiner dogs born that way, or start off normal and then get weiner?!?". We also advise that, while data generation is usually pretty quick, you should leave 2 - 4 hours during peak times, just in case.

  • Task Builder: Separate seeked in backwards and forwards in Web Audio zone
    Last Release Notes we announced an update to the Web Audio zone - a new setting that allows you to give the participant full control over the progression of the audio file. They can pause, play, rewind and fastforward to their hearts content. Following feedback from the user this setting was implemented for, we've created specific metrics to indicate whether the participant went backwards or forwards in the audio when seeking to a new position. But don't worry, there's still no Britta in this!

Bugs

  • Home Page: Fixed BeOnline links
    Sometimes I think I lost something really important to me, and then it turns out I already ate it! Fortunately, while I lost the correct link to this years BeOnline 2021 talks, I hadn't eaten it yet, so was able to put it back where it belongs. Check out all the incredible talks from this year (and more) here

  • Task Builder: Fix End Calibration Text setting
    The End Calibration Button Text in the Eye Tracking zones was incorrectly linking to the Start Calibration Button Text setting, so the two couldn't actually be defined independently. Nice going, tweedledumb and... even tweedlerdumb. That's been fixed up now!

Coming Really REALLY soon

  • Task Builder: Eye Tracking 2 performance fix As some of you may know, changes to how Webgazer handles collecting gaze predictions in Web Gazer 2 has caused significant losses in screen timing performance. Most platforms that make use of Web Gazer have had to implement bespoke fixes for this issue and our own is going live next week. Though we're preserving Eye Tracking 2's core functionality, (even adding a few new features!), the fix will require some changes to how and when we collect the prediction data. We wanted to give some advance notice that this change is coming for users currently collecting data using Eye Tracking 2. Consider yourself Chang'd!

That's it for today! More release notes coming next week. And remember: You are all better than you think you are, you are just designed not to believe it when you hear it from yourself.


21st October UpdateBuild-2021-27
21/10/2021

Zoinks! Has it really been three weeks since the last release? Wow, where does the time go? Seriously, do any of you know? Because, to me, it's still March 2020. I don't understand how I can be a half year older already.

Wait... WHAT YEAR IS IT??!?

Ahem, anyway, only a few things to note in this build. As we approach the end of the year (hrrnghgh!) the remaining Release Notes will be a bit fuller, as the backlog of requests/pending work gets cleared ready for my regular Christmas Hibernation.

Also, bonus points to the users who can correctly identify the classic childhood tv show being referenced in these notes...

Features

  • Task Builder: Full audio controls for Web Audio zone
    As part of a consultancy project, we've implemented a new setting for the Web Audio zone that presents a fuller set of controls to the participant. This allows them to play and pause an audio file at will, as well as seek to different positions throughout the audio. You receive metrics for each event, so you can review participants listening patterns. The keen readers of all the drivel exciting words I post on Gorilla, the Support Desk etc. will be thinking "Hang on, didn't your consultancy desk close before the summer?!?". Indeed, it did. At which point we still had some four to six months of work booked in! Jinkies!

  • Experiment: Select specific email to resend
    Did you know that when using either the Email ID or Email Shot recruitment policy you can set your own customised recruitment email? Pretty neat! This email was only sent when the participant was initially activated, however. The 'Resend Email' action would default to sending Gorilla's "Resume" Email template. Not anymore though! If you're using the Email ID or Email Shot policy, you can select which email type to send, so you can choose to resend the initial recruitment email instead. This is the first part in a small piece of work to improve email dispatch options within an experiment, the next stage of which will be allowing for customising the 'Resume' email template. Looks like we have another mystery localisation on our hands!

Fixes

  • Experiment: Fix typo in Custom Recruitment Email instructions
    Previously, the instructions for the Custom Recruitment Email modal said "You can also add in the participants name (as it appears in your Participants tab) using the tag {{url}}." This was of course supposed to be {{name}}. Ruh-roh! Many thanks to the users who alerted us to this!

  • Data: Uploads folder now respects Timeframe settings
    Previously, when building the full zip folder of experiment data, the Uploads folder would always give you all of the uploaded files for an experiment version. Regardless of the Timeframe settings used. Jeepers! That should be fixed now - as always, if you experience any issues/inconsistencies, please contact the Support Desk via our Contact Form.


30th September UpdateBuild-2021-26
30/09/2021

Fixes, 14:35

Many thanks to the researchers who alerted the support team to the errors in building Single Participant metrics and the missing metrics columns. These issues have now been resolved! Your patience and understanding is greatly appreciated.


It's been a couple of weeks since the last Gorilla update. Most of the last fortnight has been focused on Task Builder 2.0 (and Questionnaire Builder 2.0!!!) as well as improving our Game Builder tool and general Multiplayer tooling. However, we've managed to sneak in a few nuggets for the release this week.

(So, no, I haven't just been playing Valheim solidly for two weeks. Seriously, ask anyone on the Gorilla team - we're all friends on Steam so they can attest to my playtime... And anyway, Valheim is old news. New World (aka Amazon Game Studios MMO Queuing simulator) released at the beginning of this week so if I'd been doing anything gaming related, it would have been sitting in a queue with 5000 other people waiting to get into a server just as they take it down for maintenance...)

Features

  • Task Builder: Release of a Haptics zone
    The Haptic Feedback zone is now available by request through the Support Contact Form -> Beta Feature Access category. The Haptics zone makes 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). Documentation for this zone will appear in our support pages within the next couple of days (I'll need something to do while queuing for New World...)

  • Task Builder: Release of Vernier GoDirect Handdynamometer zone
    The Go Direct Hand Dynamometer zone is now available by request through the Support Contact Form -> Beta Feature Access category. This represents our first integration with an external device (the Go Direct (R) Hand Dynamometer) 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. As above, documentation for this will appear within the next few days (I'll need lots to do!)

Enhancements

  • Questionnaire Builder: Switch Widget now stores current page answers on switch
    Previously, when using the Switch Widget to switch between a Questionnaire and another Task/Questionnaire, any responses the participant had entered on the current Questionnaire page wouldn't be saved. This meant that the questions would be blank if they switched back. We've changed this behaviour, so the responses will be saved and repopulated when they switch back. Note that these responses won't be added to the participant metrics - that only happens when they actually complete the current page (by clicking the next button).

  • Task Builder: Update all documentation links
    I guess this a combo Bug fix/Enhancement. Some documentation links in the Task Builder zone settings weren't linking to the correct page. These links have now been fixed. Additionally, as some zones don't have any actual settings, they didn't have a settings block... which then also meant that there was no direct link to their respective documentation. We've now changed this, so every zone will have a settings block. If there are no actual settings to set there will be no settings in the settings block but the settings block will still link to the documentation for that zone. (Achievement unlock: use the word settings so many times in a paragraph that it now just looks weird and you're convinced it's spelt wrong...)

  • Data Generation Services: Second 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 includes the second 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. The next stage of improvements will mostly focus on the front-end UI i.e. the bit that you researchers see, giving you more information on what's going on with your data, where it sits in the build queue etc.

Fixes

  • Live experiments: Tab title is now Research instead of Gorilla
    When running a live experiment, Gorilla branding is kept to a minimum - we use a different domain (research.sc/) and Gorilla is only mentioned on the initial start page and finish page. However, at somepoint in the last few months, a bug crept in that meant the actual title for the browser window/tab would be 'Gorilla' instead of 'Research'. I noticed it a week ago and have dutifully fixed it, which I'm sure will be a great relief for all concerned.

15th September UpdateBuild-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.