bqplot.marks.Hist

class bqplot.marks.Hist(**kwargs)[source]

Histogram mark.

In the case of the Hist mark, scales for ‘sample’ and ‘count’ MUST be provided.

icon

string (class-level attribute) – font-awesome icon for that mark

name

string (class-level attribute) – user-friendly name of the mark

bins

nonnegative int (default: 10) – number of bins in the histogram

normalized

bool (default: False) – Boolean attribute to return normalized values which sum to 1 or direct counts for the count attribute. The scale of count attribute is determined by the value of this flag.

colors

list of colors (default: CATEGORY10) – List of colors of the Histogram. If the list is shorter than the number of bins, the colors are reused.

stroke

Color or None (default: None) – Stroke color of the histogram

opacities

list of floats (default: []) – Opacity for the bins of the histogram. Defaults to 1 when the list is too short, or the element of the list is set to None.

midpoints

list (default: []) – midpoints of the bins of the histogram. It is a read-only attribute.

Data Attributes
sample

numpy.ndarray (default: []) – sample of which the histogram must be computed.

count

numpy.ndarray (read-only) – number of sample points per bin. It is a read-only attribute.

Notes

The fields which can be passed to the default tooltip are:
midpoint: mid-point of the bin related to the rectangle hovered on count: number of elements in the bin hovered on bin_start: start point of the bin bin-end: end point of the bin index: index of the bin
__init__(**kwargs)

Public constructor

Methods

__init__(**kwargs) Public constructor
add_traits(**traits) Dynamically add trait attributes to the Widget.
class_own_trait_events(name) Get a dict of all event handlers defined on this class, not a parent.
class_own_traits(**metadata) Get a dict of all the traitlets defined on this class, not a parent.
class_trait_names(**metadata) Get a list of all the names of this class’ traits.
class_traits(**metadata) Get a dict of all the traits of this class.
close() Close method.
close_all()
get_manager_state([widgets]) Returns the full state for a widget manager for embedding
get_state([key, drop_defaults]) Gets the widget state, or a piece of it.
get_view_spec()
handle_comm_opened(msg) Static method, called when a widget is constructed.
has_trait(name) Returns True if the object has a trait with the specified name.
hold_sync() Hold syncing any state until the outermost context manager exits
hold_trait_notifications() Context manager for bundling trait change notifications and cross validation.
notify_change(change) Called when a property has changed.
observe(handler[, names, type]) Setup a handler to be called when a trait changes.
on_background_click(callback[, remove])
on_click(callback[, remove])
on_displayed(callback[, remove]) (Un)Register a widget displayed callback.
on_element_click(callback[, remove])
on_hover(callback[, remove])
on_legend_click(callback[, remove])
on_legend_hover(callback[, remove])
on_msg(callback[, remove]) (Un)Register a custom msg receive callback.
on_trait_change([handler, name, remove]) DEPRECATED: Setup a handler to be called when a trait changes.
on_widget_constructed() Registers a callback to be called when a widget is constructed.
open() Open a comm to the frontend if one isn’t already open.
send(content[, buffers]) Sends a custom msg to the widget model in the front-end.
send_state([key]) Sends the widget state, or a piece of it, to the front-end, if it exists.
set_state(sync_data) Called when a state is received from the front-end.
set_trait(name, value) Forcibly sets trait attribute, including read-only attributes.
setup_instance(*args, **kwargs) This is called before self.__init__ is called.
trait_events([name]) Get a dict of all the event handlers of this class.
trait_metadata(traitname, key[, default]) Get metadata values for trait by key.
trait_names(**metadata) Get a list of all the names of this class’ traits.
traits(**metadata) Get a dict of all the traits of this class.
unobserve(handler[, names, type]) Remove a trait change handler.
unobserve_all([name]) Remove trait change handlers of any type for the specified name.

Attributes

apply_clip A boolean (True, False) trait.
bins An int trait.
colors An instance of a Python list.
comm A trait whose value must be an instance of a specified class.
count A numpy array trait type.
cross_validation_lock A contextmanager for running a block with our cross validation lock set to True.
display_legend A boolean (True, False) trait.
enable_hover A boolean (True, False) trait.
icon
interactions An instance of a Python dict.
keys An instance of a Python list.
labels An instance of a Python list.
log A trait whose value must be an instance of a specified class.
mark_types
midpoints An instance of a Python list.
model_id Gets the model id of this widget.
name
normalized A boolean (True, False) trait.
opacities An instance of a Python list.
preserve_domain An instance of a Python dict.
sample A numpy array trait type.
scales An instance of a Python dict.
scales_metadata An instance of a Python dict.
selected An instance of a Python list.
selected_style An instance of a Python dict.
stroke A string holding a valid HTML color such as ‘blue’, ‘#060482’, ‘#A80’
tooltip A trait whose value must be an instance of a specified class.
tooltip_location An enum whose value must be in a given sequence.
tooltip_style An instance of a Python dict.
unselected_style An instance of a Python dict.
visible A boolean (True, False) trait.
widget_types
widgets