Gorilla
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

  • 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!

  • Eye Tracking 2: Performance improvements
    We've now addressed the timing performance issues caused by changes in Web Gazer 2, along with a host of other improvements. See Build-2021-29 for more information!

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

  • Task Builder: Release of Vernier GoDirect Handdynamometer zone
    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.

  • Task Builder: 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.

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

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.

Coming Soon


  • Task Builder: Download all stimuli
    We will be improving the functionality of the Stimuli tab interface in the Task Builder by adding a "Download all Stimuli" button. It should... do approximately what you expect it to. If, instead of Stimuli, zip folder contains Bob cat, feel free to not download again...

Update: The following items are taking a bit longer than hoped. I'm working hard to get these delivered as soon as possible. Thank you for your understanding and continued patience.

  • Data Generation UI Improvements
    Download your additional files (audio files, eye tracking etc.) as an independent zip folder (rather than as part of the full data zip folder). Get live updates on where you data is in the queue and improved feedback when things go wrong/get delayed.

Release Notes


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.