regl-error2d

Draw error bars for a set of points with regl.

Remake on gl-error2d:

• color may define per-bar colors.
• max number of points extended 40 times (from 1e5 to 4e6) via instanced draw.
• lineWidth and capSize are adjusted to actual pixels.
• enhanced performance via vertex shader.

Demo.

Usage

let regl = require('regl')({extensions: 'angle_instanced_arrays'})
let createError2d = require('regl-error2d')

let error2d = createError2d(regl)

error2d({
  positions: [0,0, .5,0, ...],
  errors: [.5,.5,.5,.6, .2,.3,.4,.1, ...],
  color: 'rgba(0, 100, 200, .75)'
})

createError2d(regl, options?)

Create new error2d instance from regl and initial options. Note that regl instance should have ANGLE_instanced_arrays extension enabled.

error2d(options|list?)

Draw errors, update options.

Option | Default | Description ---|---|--- positions, points, data | [] | An array of unrolled xy coordinates of the points as [x,y, x,y, ...] or array of points [[x,y], [x,y], ...]. errors, error | [] | Array with error values corresponding to the points [e0l,e0r,e0b,e0t, e1l,e1r,e1b,e1t, ...] capSize, cap | 5 | Error bar cap size, in pixels lineWidth, thickness | 1 | Error bar line width, in pixels color, colors | 'red' | Color or array with colors. Each color can be a css color string or an array with float 0..1 values. opacity | 1 | Error bars opacity. range, dataBox | null | Visible data range. viewport, viewBox | null | Output area within the canvas.

A list of options can be passed for batch rendering:

error2d([options1, options2, ...])

error2d.update(options|list)

Update options, not incurring redraw.

error2d.draw(id?)

Draw errors based on last options. id integer can specify a list item to redraw from batch update.

error2d.destroy()

Dispose error2d and associated resources.

License

(c) 2017 Dima Yv. MIT License

Development supported by plot.ly.