jupyter-widgets/traittypes

Name: traittypes

Owner: Jupyter Widgets

Description: Traitlets types for NumPy, SciPy and friends

Created: 2015-10-29 13:30:38.0

Updated: 2018-05-09 12:01:46.0

Pushed: 2018-05-09 12:01:44.0

Homepage: null

Size: 38

Language: Python

GitHub Committers

User	Most Recent Commit	# Commits

Other Committers

User	Email	Most Recent Commit	# Commits

README

Scipy Trait Types

Trait types for NumPy, SciPy and friends

Goals

Provide a reference implementation of trait types for common data structures used in the scipy stack such as

• numpy arrays
• pandas and xarray data structures

which are out of the scope of the main traitlets project but are a common requirement to build applications with traitlets in combination with the scipy stack.

Another goal is to create adequate serialization and deserialization routines for these trait types to be used with the ipywidgets project (to_json and from_json). These could also return a list of binary buffers as allowed by the current messaging protocol.

Installation

Using pip:

Make sure you have pip installed and run:

install traittypes

Using conda:

a install -c conda-forge traittypes

Usage

traittypes extends the traitlets library with an implementation of trait types for numpy arrays, pandas dataframes and pandas series.

• traittypes works around some limitations with numpy array comparison to only trigger change events when necessary.
• traittypes also extends the traitlets API for adding custom validators to constained proposed values for the attribute.

For a general introduction to traitlets, check out the traitlets documentation.

Example usage with a custom validator

 traitlets import HasTraits, TraitError
 traittypes import Array

shape(*dimensions):
def validator(trait, value):
    if value.shape != dimensions:
        raise TraitError('Expected an of shape %s and got and array with shape %s' % (dimensions, value.shape))
    else:
        return value
return validator

s Foo(HasTraits):
bar = Array(np.identity(2)).valid(shape(2, 2))
= Foo()

bar = [1, 2]  # Should raise a TraitError