Trial Placement¶
Trial placement strategies for adaptive psychophysical experiments.
Package Overview¶
trial_placement
¶
trial_placement¶
Trial placement that does not depend on the posterior.
This module is untested and still in development.
- GridPlacement: proposes the points of a fixed grid, in order.
- SobolPlacement: proposes quasi-random points that fill the stimulus space evenly.
Both take a posterior argument in propose and ignore it. psyphy does
not yet place trials adaptively, from the posterior.
Examples:
Classes:
| Name | Description |
|---|---|
GridPlacement |
Fixed grid placement. |
SobolPlacement |
Sobol quasi-random placement. |
GridPlacement
¶
Fixed grid placement.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
grid_points
|
list of (ref, probe)
|
Predefined set of trial stimuli. |
required |
Notes
- grid = your set of allowable trials; this class simply walks through that set.
Methods:
| Name | Description |
|---|---|
propose |
Return the next batch of trials from the grid. |
Attributes:
| Name | Type | Description |
|---|---|---|
grid_points |
|
Source code in src/psyphy/trial_placement/grid.py
propose
¶
propose(posterior, batch_size: int) -> TrialBatch
Return the next batch of trials from the grid.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
posterior
|
Posterior
|
|
required |
batch_size
|
int
|
Number of trials to return. |
required |
Returns:
| Type | Description |
|---|---|
TrialBatch
|
Fixed batch of (ref, probe). |
Source code in src/psyphy/trial_placement/grid.py
SobolPlacement
¶
Sobol quasi-random placement.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
dim
|
int
|
Dimensionality of stimulus space. |
required |
bounds
|
list of (low, high)
|
Bounds per dimension. |
required |
seed
|
int
|
RNG seed. |
0
|
Notes
TrialBatch stores stimuli as list[tuple[Any, Any]], and the reference
vector is fixed at zero.
Methods:
| Name | Description |
|---|---|
propose |
Propose Sobol points (ignores posterior). |
Attributes:
| Name | Type | Description |
|---|---|---|
bounds |
|
|
engine |
|
Source code in src/psyphy/trial_placement/sobol.py
propose
¶
propose(posterior, batch_size: int) -> TrialBatch
Propose Sobol points (ignores posterior).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
posterior
|
Posterior
|
Ignored. |
required |
batch_size
|
int
|
Number of trials to return. |
required |
Returns:
| Type | Description |
|---|---|
TrialBatch
|
Candidate trials from Sobol sequence. |
Source code in src/psyphy/trial_placement/sobol.py
Grid¶
grid
¶
grid.py
Grid-based placement strategy.
Full WPPM mode: - Could refine the grid adaptively around regions of high posterior uncertainty.
Classes:
| Name | Description |
|---|---|
GridPlacement |
Fixed grid placement. |
GridPlacement
¶
Fixed grid placement.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
grid_points
|
list of (ref, probe)
|
Predefined set of trial stimuli. |
required |
Notes
- grid = your set of allowable trials; this class simply walks through that set.
Methods:
| Name | Description |
|---|---|
propose |
Return the next batch of trials from the grid. |
Attributes:
| Name | Type | Description |
|---|---|---|
grid_points |
|
Source code in src/psyphy/trial_placement/grid.py
propose
¶
propose(posterior, batch_size: int) -> TrialBatch
Return the next batch of trials from the grid.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
posterior
|
Posterior
|
|
required |
batch_size
|
int
|
Number of trials to return. |
required |
Returns:
| Type | Description |
|---|---|
TrialBatch
|
Fixed batch of (ref, probe). |
Source code in src/psyphy/trial_placement/grid.py
Sobol¶
sobol
¶
sobol.py
Sobol quasi-random placement.
What it does: - Uses a Sobol engine to generate low-discrepancy points. - Ignores the posterior (pure exploration).
Levaraging WPPM's posterior: - Could combine Sobol exploration (early) with posterior-aware exploitation (later).
Classes:
| Name | Description |
|---|---|
SobolPlacement |
Sobol quasi-random placement. |
SobolPlacement
¶
Sobol quasi-random placement.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
dim
|
int
|
Dimensionality of stimulus space. |
required |
bounds
|
list of (low, high)
|
Bounds per dimension. |
required |
seed
|
int
|
RNG seed. |
0
|
Notes
TrialBatch stores stimuli as list[tuple[Any, Any]], and the reference
vector is fixed at zero.
Methods:
| Name | Description |
|---|---|
propose |
Propose Sobol points (ignores posterior). |
Attributes:
| Name | Type | Description |
|---|---|---|
bounds |
|
|
engine |
|
Source code in src/psyphy/trial_placement/sobol.py
propose
¶
propose(posterior, batch_size: int) -> TrialBatch
Propose Sobol points (ignores posterior).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
posterior
|
Posterior
|
Ignored. |
required |
batch_size
|
int
|
Number of trials to return. |
required |
Returns:
| Type | Description |
|---|---|
TrialBatch
|
Candidate trials from Sobol sequence. |