Resource Manager Component¶

Pre-load resources into memory so that components using them can start without having to load first.

This component is only relevant to online studies. If you use this component it will override loading of resources at the beginning of the experiment. This means that any resources specified in the Experiment Settings > Online > Additional Resources will not be used, make sure to load all required resources within the experiment.

Most experiments need “resources” in order to run. Be it images, sounds, spreadsheets or movies. When running a study online through pavlovia.org, these resources are loaded by default at the beginning of the experiment, and you will usually see a loading bar.

However, sometimes this loading can take a pretty long time. This happens either because you have a very large number of resources or because individual files are large (e.g. long movies) . In cases like this, it may be preferred to load these within your experiment, for example whilst your participants are reading through the instructions, in an inter-trial interval or during a break between blocks. This is where the Resource Manager component and/or the Static Component come in.

You can find the Resource Manager under “Custom” in the Component Panel. The component has many properties similar to any other component, a start time, a duration etc. The most important fields in the component are Resources, indicating the list of resources to load, and Preload Actions, indicating if we are initiating loading (Start), checking previously initiated loading has completed (Check), or both (Start and Check). For experiments where we might have several resource manager components, we can also check if the resources from all components currently exist in memory by selecting “Check All”.

Categories:: Custom
Works in:: PsychoJS

Note: Since this is still in beta, keep an eye out for bug fixes.

Examples¶

Loading resources in the background of instructions¶

A common use case for resource manager might be to load resources in the background of instructions (or any routine!), and only let your participants move forward when the resources are loaded. To do this:

Add a resource manager component.
Populate the resources field with the resources to be loaded.
Set Preload Actions to Start and Check.
Add a code component and use this in the “Each Frame” tab (where “resources” refers to the name of your resource manager component):
```
if resources.status == FINISHED:
    continueRoutine = False
```
Alternatively to step 4, you might want to have an image or text that is clickable, but have Start set to resources.status == FINISHED. This will make the button “pop-up” when the resources have finished loading!

Note

The resource manager has an attribute “status” and we can check if it has finished using resources.status == FINISHED (where resources corresponds to the name of your resource manager component).

Loading resources for blocked or branched designs, or loading trial-by-trial¶

Sometimes we might have a design where participants only need to be presented with a subset of resources. We might have 100 movies, but group 1 sees 50 movies and group 2 sees the other 50. In cases like this you might ask “How to I make the resources in my resource manager conditional?”. Well, for designs like this we actually recommend you use something a little different, the Static Component - so check it out!.

Parameters¶

Basic¶

The required attributes of the stimulus, controlling its basic function and behaviour

Name: Everything in a PsychoPy^® experiment needs a unique name. The name should contain only letters, numbers and underscores (no punctuation marks or spaces).

Start: When the Resource Manager Component should start, see Defining the onset/duration of components.

Expected start (s): If you are using frames to control timing of your stimuli, you can add an expected start time to display the component timeline in the routine.

Start type

How do you want to define your start point?

Options:

time (s)
frame N
condition

Check: When the Resource Manager Component should stop, see Defining the onset/duration of components.

Expected duration (s): If you are using frames to control timing of your stimuli, you can add an expected duration to display the component timeline in the routine.

Stop type

How do you want to define your end point?

Options:

duration (s)
duration (frames)
time (s)
frame N
condition

Resources: Resources to download/check

Check all: When checking these resources, also check for all currently downloading?

Preload actions

Should this Component start an / or check resource preloading?

Options:

Start and Check
Start Only
Check Only

Force end Routine: Should we end the Routine when the resource download is complete?

Testing¶

Tools for testing, debugging and checking the performance of this Component.

Disable Component: Disable this Component