docs(demos): better exception-handling, hiding stacktrace

Closes #74

docs/reference/demos/components/angulars.md

@@ -74,18 +74,21 @@ def show_wedge(
     origin=None,
     add_mask=False,
 ):
-    stim = wedge(
-        visual_size=(height, width),
-        ppd=ppd,
-        angle=wwidth,
-        radius=radius,
-        rotation=rotation,
-        inner_radius=inner_radius,
-        intensity_wedge=intensity_wedge,
-        intensity_background=intensity_background,
-        origin=origin,
-    )
-    plot_stim(stim, mask=add_mask)
+    try:
+        stim = wedge(
+            visual_size=(height, width),
+            ppd=ppd,
+            angle=wwidth,
+            radius=radius,
+            rotation=rotation,
+            inner_radius=inner_radius,
+            intensity_wedge=intensity_wedge,
+            intensity_background=intensity_background,
+            origin=origin,
+        )
+        plot_stim(stim, mask=add_mask)
+    except Exception as e:
+        raise ValueError(f"Invalid parameter combination: {e}") from None
 
 # Set interactivity
 out = iw.interactive_output(
@@ -161,16 +164,19 @@ def show_segments(
     origin=None,
     add_mask=False,
 ):
-    stim = segments(
-        visual_size=(height, width),
-        ppd=ppd,
-        angles=(wwidth1, wwidth2, wwidth3),
-        rotation=rotation,
-        intensity_segments=(int1, int2, int3),
-        intensity_background=intensity_background,
-        origin=origin,
-    )
-    plot_stim(stim, mask=add_mask)
+    try:
+        stim = segments(
+            visual_size=(height, width),
+            ppd=ppd,
+            angles=(wwidth1, wwidth2, wwidth3),
+            rotation=rotation,
+            intensity_segments=(int1, int2, int3),
+            intensity_background=intensity_background,
+            origin=origin,
+        )
+        plot_stim(stim, mask=add_mask)
+    except Exception as e:
+        raise ValueError(f"Invalid parameter combination: {e}") from None
 
 # Set interactivity
 out = iw.interactive_output(

docs/reference/demos/components/edges.md

@@ -62,14 +62,16 @@ def show_step_edge(
     intensity2=None,
     add_mask=False,
 ):
-
-    stim = step(
-        visual_size=(height, width),
-        ppd=ppd,
-        rotation=rotation,
-        intensity_edges=(intensity1, intensity2),
-    )
-    plot_stim(stim, mask=add_mask)
+    try:
+        stim = step(
+            visual_size=(height, width),
+            ppd=ppd,
+            rotation=rotation,
+            intensity_edges=(intensity1, intensity2),
+        )
+        plot_stim(stim, mask=add_mask)
+    except Exception as e:
+        raise ValueError(f"Invalid parameter combination: {e}") from None
 
 # Set interactivity
 out = iw.interactive_output(
@@ -129,16 +131,18 @@ def show_gaussian_edge(
     intensity_background=None,
     add_mask=False,
 ):
-
-    stim = gaussian(
-        visual_size=(height, width),
-        ppd=ppd,
-        sigma=sigma,
-        rotation=rotation,
-        intensity_edges=(intensity1, intensity2),
-        intensity_background=intensity_background,
-    )
-    plot_stim(stim, mask=add_mask)
+    try:
+        stim = gaussian(
+            visual_size=(height, width),
+            ppd=ppd,
+            sigma=sigma,
+            rotation=rotation,
+            intensity_edges=(intensity1, intensity2),
+            intensity_background=intensity_background,
+        )
+        plot_stim(stim, mask=add_mask)
+    except Exception as e:
+        raise ValueError(f"Invalid parameter combination: {e}") from None
 
 # Set interactivity
 out = iw.interactive_output(
@@ -202,17 +206,19 @@ def show_cornsweet_edge(
     intensity_plateau=None,
     add_mask=False,
 ):
-
-    stim = cornsweet(
-        visual_size=(height, width),
-        ppd=ppd,
-        ramp_width=ramp_width,
-        exponent=exponent,
-        rotation=rotation,
-        intensity_edges=(intensity1, intensity2),
-        intensity_plateau=intensity_plateau,
-    )
-    plot_stim(stim, mask=add_mask)
+    try:
+        stim = cornsweet(
+            visual_size=(height, width),
+            ppd=ppd,
+            ramp_width=ramp_width,
+            exponent=exponent,
+            rotation=rotation,
+            intensity_edges=(intensity1, intensity2),
+            intensity_plateau=intensity_plateau,
+        )
+        plot_stim(stim, mask=add_mask)
+    except Exception as e:
+        raise ValueError(f"Invalid parameter combination: {e}") from None
 
 # Set interactivity
 out = iw.interactive_output(

docs/reference/demos/components/frames.md

@@ -74,15 +74,18 @@ def show_frames(
     origin=None,
     add_mask=False,
 ):
-    stim = frames(
-        visual_size=(height, width),
-        ppd=ppd,
-        radii=(radius1, radius2, radius3),
-        intensity_frames=(int1, int2, int3),
-        intensity_background=intensity_background,
-        origin=origin,
-    )
-    plot_stim(stim, mask=add_mask)
+    try:
+        stim = frames(
+            visual_size=(height, width),
+            ppd=ppd,
+            radii=(radius1, radius2, radius3),
+            intensity_frames=(int1, int2, int3),
+            intensity_background=intensity_background,
+            origin=origin,
+        )
+        plot_stim(stim, mask=add_mask)
+    except Exception as e:
+        raise ValueError(f"Invalid parameter combination: {e}") from None
 
 # Set interactivity
 out = iw.interactive_output(

docs/reference/demos/components/gaussians.md

@@ -67,16 +67,18 @@ def show_gaussian(
     intensity_max=None,
     add_mask=False,
 ):
-
-    stim = gaussian(
-        visual_size=(height, width),
-        ppd=ppd,
-        sigma=(sigma1, sigma2),
-        origin=origin,
-        rotation=rotation,
-        intensity_max=intensity_max,
-    )
-    plot_stim(stim, mask=add_mask)
+    try:
+        stim = gaussian(
+            visual_size=(height, width),
+            ppd=ppd,
+            sigma=(sigma1, sigma2),
+            origin=origin,
+            rotation=rotation,
+            intensity_max=intensity_max,
+        )
+        plot_stim(stim, mask=add_mask)
+    except Exception as e:
+        raise ValueError(f"Invalid parameter combination: {e}") from None
 
 # Set interactivity
 out = iw.interactive_output(

docs/reference/demos/components/lines.md

@@ -76,19 +76,21 @@ def show_line(
     add_mask=False,
     origin=None,
 ):
-
-    stim = line(
-        visual_size=(height, width),
-        ppd=ppd,
-        line_position=(ypos, xpos),
-        line_length=line_length,
-        line_width=line_width,
-        rotation=rotation,
-        intensity_line=intensity_line,
-        intensity_background=intensity_background,
-        origin=origin,
-    )
-    plot_stim(stim, mask=add_mask)
+    try:
+        stim = line(
+            visual_size=(height, width),
+            ppd=ppd,
+            line_position=(ypos, xpos),
+            line_length=line_length,
+            line_width=line_width,
+            rotation=rotation,
+            intensity_line=intensity_line,
+            intensity_background=intensity_background,
+            origin=origin,
+        )
+        plot_stim(stim, mask=add_mask)
+    except Exception as e:
+        raise ValueError(f"Invalid parameter combination: {e}") from None    
 
 # Set interactivity
 out = iw.interactive_output(
@@ -155,17 +157,19 @@ def show_dipole(
     int2=None,
     add_mask=False,
 ):
-
-    stim = dipole(
-        visual_size=(height, width),
-        ppd=ppd,
-        line_length=line_length,
-        line_width=line_width,
-        line_gap=line_gap,
-        rotation=rotation,
-        intensity_lines=(int1, int2),
-    )
-    plot_stim(stim, mask=add_mask)
+    try:
+        stim = dipole(
+            visual_size=(height, width),
+            ppd=ppd,
+            line_length=line_length,
+            line_width=line_width,
+            line_gap=line_gap,
+            rotation=rotation,
+            intensity_lines=(int1, int2),
+        )
+        plot_stim(stim, mask=add_mask)
+    except Exception as e:
+        raise ValueError(f"Invalid parameter combination: {e}") from None
 
 # Set interactivity
 out = iw.interactive_output(
@@ -228,16 +232,18 @@ def show_ellipse(
     intensity_background=None,
     add_mask=False,
 ):
-
-    stim = ellipse(
-        visual_size=(height, width),
-        ppd=ppd,
-        radius=(rad1, rad2),
-        line_width=line_width,
-        intensity_line=intensity_line,
-        intensity_background=intensity_background,
-    )
-    plot_stim(stim, mask=add_mask)
+    try:
+        stim = ellipse(
+            visual_size=(height, width),
+            ppd=ppd,
+            radius=(rad1, rad2),
+            line_width=line_width,
+            intensity_line=intensity_line,
+            intensity_background=intensity_background,
+        )
+        plot_stim(stim, mask=add_mask)
+    except Exception as e:
+        raise ValueError(f"Invalid parameter combination: {e}") from None
 
 # Set interactivity
 out = iw.interactive_output(
@@ -297,16 +303,18 @@ def show_circle(
     intensity_background=None,
     add_mask=False,
 ):
-
-    stim = circle(
-        visual_size=(height, width),
-        ppd=ppd,
-        radius=radius,
-        line_width=line_width,
-        intensity_line=intensity_line,
-        intensity_background=intensity_background,
-    )
-    plot_stim(stim, mask=add_mask)
+    try:
+        stim = circle(
+            visual_size=(height, width),
+            ppd=ppd,
+            radius=radius,
+            line_width=line_width,
+            intensity_line=intensity_line,
+            intensity_background=intensity_background,
+        )
+        plot_stim(stim, mask=add_mask)
+    except Exception as e:
+        raise ValueError(f"Invalid parameter combination: {e}") from None
 
 # Set interactivity
 out = iw.interactive_output(