Staircase paradigms¶
- class psynet.trial.staircase.GeometricStaircaseChain(*args, **kwargs)[source]¶
Bases:
ChainNetwork
- creation_time¶
the time at which the Network was created.
- details¶
a generic column for storing structured JSON data
- failed¶
boolean indicating whether the Network has failed which prompts Dallinger to ignore it unless specified otherwise. Objects are usually failed to indicate something has gone wrong.
- failed_reason¶
an optional reason the object was failed. If the object is failed as part of a cascading failure triggered from another object, the chain of objects will be captured in this field.
- full¶
Whether the network is currently full
- id¶
a unique number for every entry. 1, 2, 3 and so on…
- max_size¶
How big the network can get, this number is used by the full() method to decide whether the network is full
- property1¶
a generic column that can be used to store experiment-specific details in String form.
- property2¶
a generic column that can be used to store experiment-specific details in String form.
- property3¶
a generic column that can be used to store experiment-specific details in String form.
- property4¶
a generic column that can be used to store experiment-specific details in String form.
- property5¶
a generic column that can be used to store experiment-specific details in String form.
- role¶
The role of the network. By default dallinger initializes all networks as either “practice” or “experiment”
- time_of_death¶
the time at which failing occurred
- type¶
A String giving the name of the class. Defaults to “network”. This allows subclassing.
- vars¶
- class psynet.trial.staircase.GeometricStaircaseNode(*args, **kwargs)[source]¶
Bases:
ChainNode
- k¶
The number of consecutive correct responses required to increase the difficulty. Defaults to 2, which corresponds to a 2-up-1-down procedure.
- Type:
int
- parameter¶
The parameter that determines the difficulty of the task.
- Type:
object
- reversal¶
Whether the present node constitutes a ‘reversal’. A reversal is a node where the difficulty changes direction. More formally, a node is a reversal if its parameter value was originally reached from one direction (e.g. ascending), but the parameter value of the next node changed in the opposite direction (e.g. descending). Reversals are often used for score estimation.
- Type:
bool
- n_prev_correct¶
The number of consecutive correct responses that have already occurred at the same difficulty level in the immediate preceding nodes, not including the present node.
- Type:
int
- n_prev_reversals¶
The number of reversals that have occurred before (but not including) the present node.
- Type:
int
- last_difficulty_change¶
The direction of the last difficulty change, potentially including any difficulty change that produced the current node. Can be either “increase” or “decrease”.
- Type:
str
- creation_time¶
the time at which the Network was created.
- details¶
a generic column for storing structured JSON data
- failed¶
boolean indicating whether the Network has failed which prompts Dallinger to ignore it unless specified otherwise. Objects are usually failed to indicate something has gone wrong.
- failed_reason¶
an optional reason the object was failed. If the object is failed as part of a cascading failure triggered from another object, the chain of objects will be captured in this field.
- id¶
a unique number for every entry. 1, 2, 3 and so on…
- network¶
the network the node is in
- network_id¶
the id of the network that this node is a part of
- participant¶
the participant the node is associated with
- participant_id¶
the id of the participant whose node this is
- property1¶
a generic column that can be used to store experiment-specific details in String form.
- property2¶
a generic column that can be used to store experiment-specific details in String form.
- property3¶
a generic column that can be used to store experiment-specific details in String form.
- property4¶
a generic column that can be used to store experiment-specific details in String form.
- property5¶
a generic column that can be used to store experiment-specific details in String form.
- time_of_death¶
the time at which failing occurred
- type¶
A String giving the name of the class. Defaults to
node
. This allows subclassing.
- vars¶
- class psynet.trial.staircase.GeometricStaircaseTrial(*args, **kwargs)[source]¶
Bases:
ChainTrial
- complete¶
whether the info is ‘complete’, i.e. has received its contents
- creation_time¶
the time at which the Network was created.
- details¶
a generic column for storing structured JSON data
- failed¶
boolean indicating whether the Network has failed which prompts Dallinger to ignore it unless specified otherwise. Objects are usually failed to indicate something has gone wrong.
- failed_reason¶
an optional reason the object was failed. If the object is failed as part of a cascading failure triggered from another object, the chain of objects will be captured in this field.
- id¶
a unique number for every entry. 1, 2, 3 and so on…
- make_definition(experiment, participant)[source]¶
Creates and returns a definition for the trial, which will be later stored in the
definition
attribute. This can be an arbitrary object as long as it is serialisable to JSON.- Parameters:
experiment – An instantiation of
psynet.experiment.Experiment
, corresponding to the current experiment.participant – An instantiation of
psynet.participant.Participant
, corresponding to the current participant.
- network¶
the network the info is in
- network_id¶
the id of the network the info is in
- origin¶
the Node that created the info.
- origin_id¶
the id of the Node that created the info
- property1¶
a generic column that can be used to store experiment-specific details in String form.
- property2¶
a generic column that can be used to store experiment-specific details in String form.
- property3¶
a generic column that can be used to store experiment-specific details in String form.
- property4¶
a generic column that can be used to store experiment-specific details in String form.
- property5¶
a generic column that can be used to store experiment-specific details in String form.
- time_of_death¶
the time at which failing occurred
- type¶
a String giving the name of the class. Defaults to “info”. This allows subclassing.
- vars¶
- class psynet.trial.staircase.GeometricStaircaseTrialMaker(*, id_, trial_class, node_class, network_class=None, start_nodes, max_nodes_per_chain, max_reversals_per_chain=None, balance_across_chains=False, min_passing_score=None, max_passing_score=None, expected_trials_per_participant=None, max_trials_per_participant=None, target_n_participants=None, recruit_mode='n_participants', assets=None, choose_participant_group=None, sync_group_type=None)[source]¶
Bases:
ChainTrialMaker