API docs

Note that ipyvolume.pylab and ipyvolume.widgets are imported in the ipyvolume namespace, to you can access ipyvolume.scatter instead of ipyvolume.pylab.scatter.

Quick list for plotting.

ipyvolume.pylab.volshow(data[, lighting, …]) Visualize a 3d array using volume rendering.
ipyvolume.pylab.scatter(x, y, z[, color, …]) Plots many markers/symbols in 3d
ipyvolume.pylab.quiver(x, y, z, u, v, w[, …]) Create a quiver plot, which is like a scatter plot but with arrows pointing in the direction given by u, v and w
ipyvolume.pylab.plot(x, y, z[, color]) Plot a line in 3d
ipyvolume.pylab.plot_surface(x, y, z[, …]) Draws a 2d surface in 3d, defined by the 2d ordered arrays x,y,z
ipyvolume.pylab.plot_trisurf(x, y, z[, …]) Draws a polygon/triangle mesh defined by a coordinate and triangle indices
ipyvolume.pylab.plot_wireframe(x, y, z[, …]) Draws a 2d wireframe in 3d, defines by the 2d ordered arrays x,y,z
ipyvolume.pylab.plot_mesh(x, y, z[, color, …]) Draws a 2d wireframe+surface in 3d: generalization of plot_wireframe and plot_surface
ipyvolume.pylab.plot_isosurface(data[, …]) Plot a surface at constant value (like a 2d contour)

Quick list for controlling the figure.

ipyvolume.pylab.figure([key, width, height, …]) Create a new figure (if no key is given) or return the figure associated with key
ipyvolume.pylab.gcf() Get current figure, or create a new one
ipyvolume.pylab.gcc() Return the current container, that is the widget holding the figure and all the control widgets, buttons etc.
ipyvolume.pylab.clear() Remove current figure (and container)
ipyvolume.pylab.show([extra_widgets]) Display (like in IPython.display.dispay(…)) the current figure
ipyvolume.pylab.view([azimuth, elevation, …]) Sets camera angles and distance and returns the current.
ipyvolume.pylab.xlim(xmin, xmax) Set limits of x axis
ipyvolume.pylab.ylim(ymin, ymax) Set limits of y axis
ipyvolume.pylab.zlim(zmin, zmax) Set limits of zaxis
ipyvolume.pylab.xyzlim(vmin[, vmax]) Set limits or all axis the same, if vmax not given, use [-vmin, vmax]

Quick list for style and labels.

ipyvolume.pylab.xlabel(label) Set the labels for the x-axis
ipyvolume.pylab.ylabel(label) Set the labels for the y-axis
ipyvolume.pylab.zlabel(label) Set the labels for the z-axis
ipyvolume.pylab.xyzlabel(labelx, labely, labelz) Set all labels at once
ipyvolume.pylab.style.use(style) Set the style of the current figure/visualization
ipyvolume.pylab.style.set_style_dark() Short for style.use(‘dark’)
ipyvolume.pylab.style.set_style_light() Short for style.use(‘light’)
ipyvolume.pylab.style.box_off() Do not draw the box around the visible volume
ipyvolume.pylab.style.box_on() Draw a box around the visible volume
ipyvolume.pylab.style.axes_off() Do not draw the axes
ipyvolume.pylab.style.axes_on() Draw the axes
ipyvolume.pylab.style.background_color(color) Sets the background color

Quick list for saving figures.

ipyvolume.pylab.save(filepath[, makedirs, …]) Save the current container to a HTML file
ipyvolume.pylab.savefig(filename[, width, …]) Save the figure to an image file.
ipyvolume.pylab.screenshot([width, height, …]) Save the figure to a PIL.Image object.

ipyvolume.pylab

ipyvolume.pylab.scatter(x, y, z, color='red', size=2, size_selected=2.6, color_selected='white', marker='diamond', selection=None, grow_limits=True, **kwargs)[source]

Plots many markers/symbols in 3d

Parameters:
  • x – numpy array of shape (N,) or (S, N) with x positions. If an (S, N) array, the first dimension will be used for frames in an animation.
  • y – idem for y
  • z – idem for z
  • color – color for each point/vertex/symbol, can be string format, examples for red:’red’, ‘#f00’, ‘#ff0000’ or ‘rgb(1,0,0), or rgb array of shape (N, 3 or 4) or (S, N, 3 or 4)
  • size – float representing the size of the glyph in percentage of the viewport, where 100 is the full size of the viewport
  • size_selected – like size, but for selected glyphs
  • color_selected – like color, but for selected glyphs
  • marker – name of the marker, options are: ‘arrow’, ‘box’, ‘diamond’, ‘sphere’, ‘point_2d’, ‘square_2d’, ‘triangle_2d’, ‘circle_2d’
  • selection – numpy array of shape (N,) or (S, N) with indices of x,y,z arrays of the selected markers, which can have a different size and color
  • kwargs
Returns:

Scatter

ipyvolume.pylab.quiver(x, y, z, u, v, w, size=20, size_selected=26.0, color='red', color_selected='white', marker='arrow', **kwargs)[source]

Create a quiver plot, which is like a scatter plot but with arrows pointing in the direction given by u, v and w

Parameters:
  • x – numpy array of shape (N,) or (S, N) with x positions. If an (S, N) array, the first dimension will be used for frames in an animation.
  • y – idem for y
  • z – idem for z
  • u – numpy array of shape (N,) or (S, N) indicating the x component of a vector. If an (S, N) array, the first dimension will be used for frames in an animation.
  • v – idem for y
  • w – idem for z
  • size – float representing the size of the glyph in percentage of the viewport, where 100 is the full size of the viewport
  • size_selected – like size, but for selected glyphs
  • color – color for each point/vertex/symbol, can be string format, examples for red:’red’, ‘#f00’, ‘#ff0000’ or ‘rgb(1,0,0), or rgb array of shape (N, 3 or 4) or (S, N, 3 or 4)
  • color_selected – like color, but for selected glyphs
  • marker – (currently only ‘arrow’ would make sense)
  • kwargs – extra arguments passed on to the Scatter constructor
Returns:

Scatter

ipyvolume.pylab.plot(x, y, z, color='red', **kwargs)[source]

Plot a line in 3d

Parameters:
  • x – numpy array of shape (N,) or (S, N) with x positions. If an (S, N) array, the first dimension will be used for frames in an animation.
  • y – idem for y
  • z – idem for z
  • color – color for each point/vertex/symbol, can be string format, examples for red:’red’, ‘#f00’, ‘#ff0000’ or ‘rgb(1,0,0), or rgb array of shape (N, 3 or 4) or (S, N, 3 or 4)
  • kwargs – extra arguments passed to the Scatter constructor
Returns:

Scatter

ipyvolume.pylab.volshow(data, lighting=False, data_min=None, data_max=None, max_shape=256, tf=None, stereo=False, ambient_coefficient=0.5, diffuse_coefficient=0.8, specular_coefficient=0.5, specular_exponent=5, downscale=1, level=[0.1, 0.5, 0.9], opacity=[0.01, 0.05, 0.1], level_width=0.1, controls=True, max_opacity=0.2, memorder='C', extent=None)[source]

Visualize a 3d array using volume rendering.

Currently only 1 volume can be rendered.

Parameters:
  • data – 3d numpy array
  • origin – origin of the volume data, this is to match meshes which have a different origin
  • domain_size – domain size is the size of the volume
  • lighting (bool) – use lighting or not, if set to false, lighting parameters will be overriden
  • data_min (float) – minimum value to consider for data, if None, computed using np.nanmin
  • data_max (float) – maximum value to consider for data, if None, computed using np.nanmax
  • tf – transfer function (or a default one)
  • stereo (bool) – stereo view for virtual reality (cardboard and similar VR head mount)
  • ambient_coefficient – lighting parameter
  • diffuse_coefficient – lighting parameter
  • specular_coefficient – lighting parameter
  • specular_exponent – lighting parameter
  • downscale (float) – downscale the rendering for better performance, for instance when set to 2, a 512x512 canvas will show a 256x256 rendering upscaled, but it will render twice as fast.
  • level – level(s) for the where the opacity in the volume peaks, maximum sequence of length 3
  • opacity – opacity(ies) for each level, scalar or sequence of max length 3
  • level_width – width of the (gaussian) bumps where the opacity peaks, scalar or sequence of max length 3
  • controls (bool) – add controls for lighting and transfer function or not
  • max_opacity (float) – maximum opacity for transfer function controls
  • extent – list of [[xmin, xmax], [ymin, ymax], [zmin, zmax]] values that define the bounds of the volume, otherwise the viewport is used
Parap int max_shape:
 

maximum shape for the 3d cube, if larger, the data is reduced by skipping/slicing (data[::N]), set to None to disable.

Returns:

ipyvolume.pylab.plot_surface(x, y, z, color='red', wrapx=False, wrapy=False)[source]

Draws a 2d surface in 3d, defined by the 2d ordered arrays x,y,z

Parameters:
  • x – numpy array of shape (N,M) or (S, N, M) with x positions. If an (S, N, M) array, the first dimension will be used for frames in an animation.
  • y – idem for y
  • z – idem for z
  • color – color for each point/vertex string format, examples for red:’red’, ‘#f00’, ‘#ff0000’ or ‘rgb(1,0,0), or rgb array of shape (2, N, 3 or 4) or (S, 2, N, 3 or 4)
  • wrapx (bool) – when True, the x direction is assumed to wrap, and polygons are drawn between the end end begin points
  • wrapy (bool) – simular for the y coordinate
Returns:

Mesh

ipyvolume.pylab.plot_trisurf(x, y, z, triangles=None, lines=None, color='red', u=None, v=None, texture=None)[source]

Draws a polygon/triangle mesh defined by a coordinate and triangle indices

The following example plots a rectangle in the z==2 plane, consisting of 2 triangles:

>>> plot_trisurf([0, 0, 3., 3.], [0, 4., 0, 4.], 2,
       triangles=[[0, 2, 3], [0, 3, 1]])

Note that the z value is constant, and thus not a list/array. For guidance, the triangles refer to the vertices in this manner:

^ ydir
|
2 3
0 1  ---> x dir

Note that if you want per face/triangle colors, you need to duplicate each vertex.

Parameters:
  • x – numpy array of shape (N,) or (S, N) with x positions. If an (S, N) array, the first dimension will be used for frames in an animation.
  • y – idem for y
  • z – idem for z
  • triangles – numpy array with indices referring to the vertices, defining the triangles, with shape (M, 3)
  • lines – numpy array with indices referring to the vertices, defining the lines, with shape (K, 2)
  • color – color for each point/vertex/symbol, can be string format, examples for red:’red’, ‘#f00’, ‘#ff0000’ or ‘rgb(1,0,0), or rgb array of shape (N, 3 or 4) or (S, N, 3 or 4)
  • u – numpy array of shape (N,) or (S, N) indicating the u (x) coordinate for the texture. If an (S, N) array, the first dimension will be used for frames in an animation.
  • v – numpy array of shape (N,) or (S, N) indicating the v (y) coordinate for the texture. If an (S, N) array, the first dimension will be used for frames in an animation.
  • texture – PIL.Image object or ipywebrtc.MediaStream (can be a seqence)
Returns:

Mesh

ipyvolume.pylab.plot_wireframe(x, y, z, color='red', wrapx=False, wrapy=False)[source]

Draws a 2d wireframe in 3d, defines by the 2d ordered arrays x,y,z

See also ipyvolume.pylab.plot_mesh

Parameters:
  • x – numpy array of shape (N,M) or (S, N, M) with x positions. If an (S, N, M) array, the first dimension will be used for frames in an animation.
  • y – idem for y
  • z – idem for z
  • color – color for each point/vertex string format, examples for red:’red’, ‘#f00’, ‘#ff0000’ or ‘rgb(1,0,0), or rgb array of shape (2, N, 3 or 4) or (S, 2, N, 3 or 4)
  • wrapx (bool) – when True, the x direction is assumed to wrap, and polygons are drawn between the begin and end points
  • wrapy (bool) – idem for y
Returns:

Mesh

ipyvolume.pylab.plot_mesh(x, y, z, color='red', wireframe=True, surface=True, wrapx=False, wrapy=False, u=None, v=None, texture=None)[source]

Draws a 2d wireframe+surface in 3d: generalization of plot_wireframe and plot_surface

Parameters:
  • x – {x2d}
  • y – {y2d}
  • z – {z2d}
  • color – {color2d}
  • wireframe (bool) – draw lines between the vertices
  • surface (bool) – draw faces/triangles between the vertices
  • wrapx (bool) – when True, the x direction is assumed to wrap, and polygons are drawn between the begin and end points
  • wrapy (boool) – idem for y
  • u – {u}
  • v – {v}
  • texture – {texture}
Returns:

Mesh

ipyvolume.pylab.plot_isosurface(data, level=None, color='red', wireframe=True, surface=True, controls=True, extent=None)[source]

Plot a surface at constant value (like a 2d contour)

Parameters:
  • data – 3d numpy array
  • level (float) – value where the surface should lie
  • color – color of the surface, although it can be an array, the length is difficult to predict beforehand, if per vertex color are needed, it is better to set them on the returned mesh afterwards.
  • wireframe (bool) – draw lines between the vertices
  • surface (bool) – draw faces/triangles between the vertices
  • controls (bool) – add controls to change the isosurface
  • extent – list of [[xmin, xmax], [ymin, ymax], [zmin, zmax]] values that define the bounding box of the mesh, otherwise the viewport is used
Returns:

Mesh

ipyvolume.pylab.xlim(xmin, xmax)[source]

Set limits of x axis

ipyvolume.pylab.ylim(ymin, ymax)[source]

Set limits of y axis

ipyvolume.pylab.zlim(zmin, zmax)[source]

Set limits of zaxis

ipyvolume.pylab.xyzlim(vmin, vmax=None)[source]

Set limits or all axis the same, if vmax not given, use [-vmin, vmax]

ipyvolume.pylab.xlabel(label)[source]

Set the labels for the x-axis

ipyvolume.pylab.ylabel(label)[source]

Set the labels for the y-axis

ipyvolume.pylab.zlabel(label)[source]

Set the labels for the z-axis

ipyvolume.pylab.xyzlabel(labelx, labely, labelz)[source]

Set all labels at once

ipyvolume.pylab.view(azimuth=None, elevation=None, distance=None)[source]

Sets camera angles and distance and returns the current.

Parameters:
  • azimuth (float) – rotation around the axis pointing up in degrees
  • elevation (float) – rotation where +90 means ‘up’, -90 means ‘down’, in degrees
  • distance (float) – radial distance from the center to the camera.
ipyvolume.pylab.figure(key=None, width=400, height=500, lighting=True, controls=True, controls_vr=False, controls_light=False, debug=False, **kwargs)[source]

Create a new figure (if no key is given) or return the figure associated with key

Parameters:
  • key – Python object that identifies this figure
  • width (int) – pixel width of WebGL canvas
  • height (int) –
  • lighting (bool) – use lighting or not
  • controls (bool) – show controls or not
  • controls_vr (bool) – show controls for VR or not
  • debug (bool) – show debug buttons or not
Returns:

Figure

ipyvolume.pylab.gcf()[source]

Get current figure, or create a new one

Returns:Figure
ipyvolume.pylab.gcc()[source]

Return the current container, that is the widget holding the figure and all the control widgets, buttons etc.

ipyvolume.pylab.clear()[source]

Remove current figure (and container)

ipyvolume.pylab.show(extra_widgets=[])[source]

Display (like in IPython.display.dispay(…)) the current figure

ipyvolume.pylab.save(filepath, makedirs=True, title='IPyVolume Widget', all_states=False, offline=False, scripts_path='js', drop_defaults=False, template_options=(('extra_script_head', ''), ('body_pre', ''), ('body_post', '')), devmode=False, offline_cors=False)[source]

Save the current container to a HTML file

By default the HTML file is not standalone and requires an internet connection to fetch a few javascript libraries. Use offline=True to download these and make the HTML file work without an internet connection.

Parameters:
  • filepath (str) – The file to write the HTML output to.
  • makedirs (bool) – whether to make directories in the filename path, if they do not already exist
  • title (str) – title for the html page
  • all_states (bool) – if True, the state of all widgets know to the widget manager is included, else only those in widgets
  • offline (bool) – if True, use local urls for required js/css packages and download all js/css required packages (if not already available), such that the html can be viewed with no internet connection
  • scripts_path (str) – the folder to save required js/css packages to (relative to the filepath)
  • drop_defaults (bool) – Whether to drop default values from the widget states
  • template_options – list or dict of additional template options
  • devmode (bool) – if True, attempt to get index.js from local js/dist folder
  • offline_cors (bool) – if True, sets crossorigin attribute of script tags to anonymous
ipyvolume.pylab.savefig(filename, width=None, height=None, fig=None, timeout_seconds=10, output_widget=None, headless=False, devmode=False)[source]

Save the figure to an image file.

Parameters:
  • filename (str) – must have extension .png, .jpeg or .svg
  • width (int) – the width of the image in pixels
  • height (int) – the height of the image in pixels
  • fig (ipyvolume.widgets.Figure or None) – if None use the current figure
  • timeout_seconds (float) – maximum time to wait for image data to return
  • output_widget (ipywidgets.Output) – a widget to use as a context manager for capturing the data
  • headless (bool) – if True, use headless chrome to save figure
  • devmode (bool) – if True, attempt to get index.js from local js/dist folder
ipyvolume.pylab.screenshot(width=None, height=None, format='png', fig=None, timeout_seconds=10, output_widget=None, headless=False, devmode=False)[source]

Save the figure to a PIL.Image object.

Parameters:
  • width (int) – the width of the image in pixels
  • height (int) – the height of the image in pixels
  • format – format of output data (png, jpeg or svg)
  • fig (ipyvolume.widgets.Figure or None) – if None use the current figure
  • timeout_seconds (int) – maximum time to wait for image data to return
  • output_widget (ipywidgets.Output) – a widget to use as a context manager for capturing the data
  • headless (bool) – if True, use headless chrome to take screenshot
  • devmode (bool) – if True, attempt to get index.js from local js/dist folder
Returns:

PIL.Image

ipyvolume.pylab.selector_default(output_widget=None)[source]

Capture selection events from the current figure, and apply the selections to Scatter objects

Example:

>>> import ipyvolume as ipv
>>> ipv.figure()
>>> ipv.examples.gaussian()
>>> ipv.selector_default()
>>> ipv.show()

Now hold the control key to do selections, type

  • ‘C’ for circle
  • ‘R’ for rectangle
  • ‘L’ for lasso
  • ‘=’ for replace mode
  • ‘&’ for logically and mode
  • ‘|’ for logically or mode
  • ‘-‘ for subtract mode
ipyvolume.pylab.movie(f='movie.mp4', function=<function _change_azimuth_angle>, fps=30, frames=30, endpoint=False, cmd_template_ffmpeg='ffmpeg -y -r {fps} -i {tempdir}/frame-%5d.png -vcodec h264 -pix_fmt yuv420p {filename}', cmd_template_gif='convert -delay {delay} {loop} {tempdir}/frame-*.png {filename}', gif_loop=0)[source]

Create a movie (mp4/gif) out of many frames

If the filename ends in .gif, convert is used to convert all frames to an animated gif using the cmd_template_gif template. Otherwise ffmpeg is assumed to know the file format.

Example:

>>> def set_angles(fig, i, fraction):
>>>     fig.angley = fraction*np.pi*2
>>> # 4 second movie, that rotates around the y axis
>>> p3.movie('test2.gif', set_angles, fps=20, frames=20*4,
        endpoint=False)

Note that in the example above we use endpoint=False to avoid to first and last frame to be the same

Parameters:
  • f (str) – filename out output movie (e.g. ‘movie.mp4’ or ‘movie.gif’)
  • function – function called before each frame with arguments (figure, framenr, fraction)
  • fps – frames per seconds
  • frames (int) – total number of frames
  • endpoint (bool) – if fraction goes from [0, 1] (inclusive) or [0, 1) (endpoint=False is useful for loops/rotatations)
  • cmd_template_ffmpeg (str) – template command when running ffmpeg (non-gif ending filenames)
  • cmd_template_gif (str) – template command when running imagemagick’s convert (if filename ends in .gif)
  • gif_loop – None for no loop, otherwise the framenumber to go to after the last frame
Returns:

the temp dir where the frames are stored

ipyvolume.pylab.animation_control(object, sequence_length=None, add=True, interval=200)[source]

Animate scatter, quiver or mesh by adding a slider and play button.

Parameters:
  • objectScatter or Mesh object (having an sequence_index property), or a list of these to control multiple.
  • sequence_length – If sequence_length is None we try try our best to figure out, in case we do it badly, you can tell us what it should be. Should be equal to the S in the shape of the numpy arrays as for instance documented in scatter or plot_mesh.
  • add – if True, add the widgets to the container, else return a HBox with the slider and play button. Useful when you want to customise the layout of the widgets yourself.
  • interval – interval in msec between each frame
Returns:

If add is False, if returns the ipywidgets.HBox object containing the controls

ipyvolume.pylab.transfer_function(level=[0.1, 0.5, 0.9], opacity=[0.01, 0.05, 0.1], level_width=0.1, controls=True, max_opacity=0.2)[source]

Create a transfer function, see volshow

class ipyvolume.pylab.style[source]

Bases: object

‘Static class that mimics a matplotlib module.

Example:

>>> import ipyvolume as ipv
>>> ipv.style.use('light'])
>>> ipv.style.use('seaborn-darkgrid'])
>>> ipv.style.use(['seaborn-darkgrid', {'axes.x.color':'orange'}])
Possible style values:
  • figure.facecolor: background color
  • axes.color: color of the box around the volume/viewport
  • xaxis.color: color of xaxis
  • yaxis.color: color of xaxis
  • zaxis.color: color of xaxis
static axes_off()[source]

Do not draw the axes

static axes_on()[source]

Draw the axes

static background_color(color)[source]

Sets the background color

static box_off()[source]

Do not draw the box around the visible volume

static box_on()[source]

Draw a box around the visible volume

static set_style_dark()

Short for style.use(‘dark’)

static set_style_demo()

Short for style.use(‘demo’)

static set_style_light()

Short for style.use(‘light’)

static set_style_nobox()

Short for style.use(‘nobox’)

static use(style)[source]

Set the style of the current figure/visualization

Parameters:style – matplotlib style name, or dict with values, or a sequence of these, where the last value overrides previous
Returns:

ipyvolume.widgets

Test pythreejs.Camera

ipyvolume.widgets.quickvolshow(data, lighting=False, data_min=None, data_max=None, max_shape=256, level=[0.1, 0.5, 0.9], opacity=[0.01, 0.05, 0.1], level_width=0.1, extent=None, memorder='C', **kwargs)[source]

Visualize a 3d array using volume rendering

Parameters:
  • data – 3d numpy array
  • lighting – boolean, to use lighting or not, if set to false, lighting parameters will be overriden
  • data_min – minimum value to consider for data, if None, computed using np.nanmin
  • data_max – maximum value to consider for data, if None, computed using np.nanmax
  • extent – list of [[xmin, xmax], [ymin, ymax], [zmin, zmax]] values that define the bounds of the volume, otherwise the viewport is used
  • level – level(s) for the where the opacity in the volume peaks, maximum sequence of length 3
  • opacity – opacity(ies) for each level, scalar or sequence of max length 3
  • level_width – width of the (gaussian) bumps where the opacity peaks, scalar or sequence of max length 3
  • kwargs – extra argument passed to Volume and default transfer function
Parap int max_shape:
 

maximum shape for the 3d cube, if larger, the data is reduced by skipping/slicing (data[::N]), set to None to disable.

Returns:

ipyvolume.widgets.quickscatter(x, y, z, **kwargs)[source]
ipyvolume.widgets.quickquiver(x, y, z, u, v, w, **kwargs)[source]
ipyvolume.widgets.volshow(*args, **kwargs)[source]

Deprecated: please use ipyvolume.quickvolshow or use the ipyvolume.pylab interface

class ipyvolume.widgets.Figure(**kwargs)[source]

Bases: ipywebrtc.webrtc.MediaStream

Widget class representing a volume (rendering) using three.js

ambient_coefficient

A float trait.

animation

A float trait.

animation_exponent

A float trait.

camera

A pythreejs.Camera instance to control the camera

camera_center

An instance of a Python list.

camera_control

A trait for unicode strings.

camera_fov

A casting version of the float trait.

capture_fps

A casting version of the float trait.

cube_resolution

A casting version of the int trait.

diffuse_coefficient

A float trait.

displayscale

A casting version of the float trait.

downscale

A casting version of the int trait.

eye_separation

A casting version of the float trait.

height

A casting version of the int trait.

matrix_projection

An instance of a Python list.

matrix_world

An instance of a Python list.

meshes

An instance of a Python list.

mouse_mode

A trait for unicode strings.

on_screenshot(callback, remove=False)[source]
on_selection(callback, remove=False)[source]
panorama_mode

An enum whose value must be in a given sequence.

project(x, y, z)[source]
render_continuous

A boolean (True, False) trait.

scatters

An instance of a Python list.

scene

A trait whose value must be an instance of a specified class.

The value can also be an instance of a subclass of the specified class.

Subclasses can declare default classes by overriding the klass attribute

screenshot(width=None, height=None, mime_type='image/png')[source]
selection_mode

A trait for unicode strings.

selector

A trait for unicode strings.

show

A trait for unicode strings.

specular_coefficient

A float trait.

specular_exponent

A float trait.

stereo

A boolean (True, False) trait.

style

An instance of a Python dict.

volumes

An instance of a Python list.

width

A casting version of the int trait.

xlabel

A trait for unicode strings.

xlim

An instance of a Python list.

ylabel

A trait for unicode strings.

ylim

An instance of a Python list.

zlabel

A trait for unicode strings.

zlim

An instance of a Python list.

class ipyvolume.widgets.Volume(**kwargs)[source]

Bases: ipywidgets.widgets.widget.Widget

Widget class representing a volume (rendering) using three.js

brightness

A casting version of the float trait.

clamp_max

A casting version of the boolean trait.

clamp_min

A casting version of the boolean trait.

data

A numpy array trait type.

data_max

A casting version of the float trait.

data_max_shape

A casting version of the int trait.

data_min

A casting version of the float trait.

data_original

A numpy array trait type.

extent

A trait which allows any value.

extent_original

A trait which allows any value.

lighting

A boolean (True, False) trait.

opacity_scale

A casting version of the float trait.

ray_steps

defines the length of the ray (1/ray_steps) for each step, in normalized coordintes.

rendering_method

An enum whose value must be in a given sequence.

show_max

A casting version of the float trait.

show_min

A casting version of the float trait.

tf

A trait whose value must be an instance of a specified class.

The value can also be an instance of a subclass of the specified class.

Subclasses can declare default classes by overriding the klass attribute

update_data(change=None)[source]
class ipyvolume.widgets.Scatter(**kwargs)[source]

Bases: ipywidgets.widgets.widget.Widget

color

A numpy array trait type.

color_selected

A trait type representing a Union type.

connected

A casting version of the boolean trait.

geo

A trait for unicode strings.

line_material

A pythreejs.ShaderMaterial that is used for the lines/wireframe

material

A pythreejs.ShaderMaterial that is used for the mesh

selected

A numpy array trait type.

sequence_index

An int trait.

size

A trait type representing a Union type.

size_selected

A trait type representing a Union type.

texture

A trait type representing a Union type.

visible

A casting version of the boolean trait.

vx

A numpy array trait type.

vy

A numpy array trait type.

vz

A numpy array trait type.

x

A numpy array trait type.

y

A numpy array trait type.

z

A numpy array trait type.

class ipyvolume.widgets.Mesh(**kwargs)[source]

Bases: ipywidgets.widgets.widget.Widget

color

A numpy array trait type.

line_material

A pythreejs.ShaderMaterial that is used for the lines/wireframe

lines

A numpy array trait type.

material

A pythreejs.ShaderMaterial that is used for the mesh

sequence_index

An int trait.

texture

A trait type representing a Union type.

triangles

A numpy array trait type.

u

A numpy array trait type.

v

A numpy array trait type.

visible

A casting version of the boolean trait.

x

A numpy array trait type.

y

A numpy array trait type.

z

A numpy array trait type.

ipyvolume.examples

Some examples for quick testing/demonstrations

All function accept show and draw arguments

  • If draw is True it will return the widgets (Scatter, Volume, Mesh)
  • If draw is False, it will return the data
  • if show is False, ipv.show() will not be called.
ipyvolume.examples.ball(rmax=3, rmin=0, shape=128, limits=[-4, 4], draw=True, show=True, **kwargs)[source]

Show a ball

ipyvolume.examples.brain(draw=True, show=True, fiducial=True, flat=True, inflated=True, subject='S1', interval=1000, uv=True, color=None)[source]

Show a human brain model

Requirement:

ipyvolume.examples.example_ylm(m=0, n=2, shape=128, limits=[-4, 4], draw=True, show=True, **kwargs)[source]

Show a spherical harmonic

ipyvolume.examples.gaussian(N=1000, draw=True, show=True, seed=42, color=None, marker='sphere')[source]

Show N random gaussian distributed points using a scatter plot

ipyvolume.examples.head(draw=True, show=True, max_shape=256)[source]

Show a volumetric rendering of a human male head

ipyvolume.examples.klein_bottle(draw=True, show=True, figure8=False, endpoint=True, uv=True, wireframe=False, texture=None, both=False, interval=1000)[source]

Show one or two Klein bottles

ipyvolume.examples.xyz(shape=128, limits=[-3, 3], spherical=False, sparse=True, centers=False)[source]

ipyvolume.headless