ArrayInput#

Download this notebook from GitHub (right-click to download).


import numpy as np
import panel as pn

pn.extension()

The ArrayInput widget allows rendering and editing NumPy arrays using a text entry box whose contents are then parsed in Python. In order to avoid issues with large arrays the ArrayInput defines a max_array_size, if the array exceeds this size the textual representation will be summarized and editing will be disbaled.

For more information about listening to widget events and laying out widgets refer to the widgets user guide. Alternatively you can learn how to build GUIs by declaring parameters independently of any specific widgets in the param user guide. To express interactivity entirely using Javascript without the need for a Python server take a look at the links user guide.

Parameters:#

For layout and styling related parameters see the customization user guide.

Core#

  • max_array_size (int): Arrays larger than this limit will be allowed in Python but will not be serialized into JavaScript. Although such large arrays will thus not be editable in the widget, such a restriction helps avoid overwhelming the browser and lets other widgets remain usable.

  • value: Parsed value of the indicated type

Display#

  • disabled (boolean): Whether the widget is editable

  • name (str): The title of the widget

  • placeholder (str): A placeholder string displayed when no value is entered


array_input = pn.widgets.ArrayInput(name='Array Input ', value=np.random.randint(0, 10, (10, 2)))
array_input

ArrayInput.value returns a value of the evaluated type that can be read out and set like other widgets:

array_input.value
array([[1, 6],
       [6, 7],
       [6, 0],
       [7, 5],
       [3, 4],
       [5, 2],
       [6, 0],
       [4, 3],
       [8, 9],
       [1, 7]])

Controls#

The ArrayInput widget exposes a number of options which can be changed from both Python and Javascript. Try out the effect of these parameters interactively:

pn.Row(array_input.controls(jslink=True), array_input)
This web page was generated from a Jupyter notebook and not all interactivity will work on this website. Right click to download and run locally for full Python-backed interactivity.

Download this notebook from GitHub (right-click to download).