---
jupytext:
  formats: md:myst
  text_representation:
    extension: .md
    format_name: myst
    format_version: 0.13
    jupytext_version: 1.14.5
kernelspec:
  display_name: Python 3 (ipykernel)
  language: python
  name: python3
---

```{attention}
To run locally, the code for these interactive demos requires
a [Jupyter Notebook](https://jupyter.org/) environment,
and the [Panel extension](https://panel.holoviz.org/).
```

# Frames
{py:func}`stimupy.components.frames.frames`

```{pyodide}
:skip-embed:

import param

class FramesParams(param.Parameterized):
    # Image size parameters
    height = param.Integer(default=10, bounds=(1, 20), doc="Height in degrees")
    width = param.Integer(default=10, bounds=(1, 20), doc="Width in degrees")
    ppd = param.Integer(default=20, bounds=(1, 40), doc="Pixels per degree")
    
    # Frame geometry parameters
    radius1 = param.Number(default=1, bounds=(0, 2), step=0.1, doc="Radius 1 in degrees")
    radius2 = param.Number(default=2, bounds=(1, 3), step=0.1, doc="Radius 2 in degrees")
    radius3 = param.Number(default=3, bounds=(2, 4), step=0.1, doc="Radius 3 in degrees")
    
    # Intensity parameters
    intensity1 = param.Number(default=0.8, bounds=(0, 1), step=0.01, doc="Frame 1 intensity")
    intensity2 = param.Number(default=0.5, bounds=(0, 1), step=0.01, doc="Frame 2 intensity")
    intensity3 = param.Number(default=0.3, bounds=(0, 1), step=0.01, doc="Frame 3 intensity")
    intensity_background = param.Number(default=0.5, bounds=(0, 1), step=0.01, doc="Background intensity")
    
    # Additional parameters
    origin = param.Selector(default="mean", objects=["mean", "corner", "center"], doc="Origin")
    add_mask = param.Boolean(default=False, doc="Add mask to visualization")

    def get_stimulus_params(self):
        return {
            "visual_size": (self.height, self.width),
            "ppd": self.ppd,
            "radii": (self.radius1, self.radius2, self.radius3),
            "intensity_frames": (self.intensity1, self.intensity2, self.intensity3),
            "intensity_background": self.intensity_background,
            "origin": self.origin,
        }
```

```{pyodide}
:skip-embed:

from stimupy.components.frames import frames
from stimupy._docs.display_stimulus import InteractiveStimDisplay

# Create and display the interactive frames
frames_params = FramesParams()
disp = InteractiveStimDisplay(frames, frames_params)
disp.layout
```