findTimeFormat (str)

Return the timeformat in d3.timeParse function

Returns

unique (array, sorting, _sort)

Return unique values of an array (including if there are dates)

Returns

Examples

let uniqueArray = unique([1, 1, 2, 3 ])
uniqueArray 
> [1, 2, 3]

getOptimalPrecision (maxN)

Get optimal decimal precision for number formatting

Returns

updateDict (dict, newDict)

Update a nested dictionary (stored as an Object)

getDimensionText (text, fontSize)

Retrieve the width and height of some text based on its font

Returns

to_csv (j, header)

Transform a JSON object into a csv

Returns

splitString (s, n, sep)

Split a string in substrings of length of approx. n characters and splitting on space only. The function will split the string in substring of minimum length 'n' on spaces inside the string.

Returns

wideToLong (wideData, pivotColumns, keyName, valueName, category, mapLongElement)

Transform a 'wide' array of Dict to 'long' array, pivoting on some 'pivot' columns (keys). The long format is a {id, key, value}, where id is one or multiple 'pivot' columns, 'key' are the non pivot columns of the original array and the value are the value of the corresponding keys. A category value can also be passed as a new 'column'. The long format becomes {id, key, value, category}. A mapping function can also be passed to be applied to each long element (for instance to parse a date)

Examples

wideArray = [{'date':'2020-07-19','temperature':32,'pressure':1016},
             {'date':'2020-07-20','temperature':25,'pressure':1020}];
longArray = wideToLong(wideArray, ['date']);
longArray = [{'date':'2020-07-19', 'field_id':'temperature','field_value':32},
             {'date':'2020-07-19', 'field_id':'pressure','field_value':1016},
             {'date':'2020-07-20', 'field_id':'temperature','field_value':25},
             {'date':'2020-07-20', 'field_id':'pressure','field_value':1020}]

longToWide (longData, index, column, value, keyName, valueName, mapLongElement)

Transform a 'long' array of Dict to 'wide' array, pivoting on some 'index' columns (keys).

Examples

longArray = [{'date':'2020-07-19', 'field_id':'temperature','field_value':32},
             {'date':'2020-07-19', 'field_id':'pressure','field_value':1016},
             {'date':'2020-07-20', 'field_id':'temperature','field_value':25},
             {'date':'2020-07-20', 'field_id':'pressure','field_value':1020}] 
longToWide(longArray, 'date', 'field_id', 'field_value');
wideArray = [{'date':'2020-07-19','temperature':32,'pressure':1016},
             {'date':'2020-07-20','temperature':25,'pressure':1020}];

barycenterColor (startColor, endColor, weight)

Compute the barycenter between two colors. Returned color will be startColor weight + endColor (1 - weight)

Returns

getBackgroundColor (el, defaultColor)

Return the background color of an element, if transparent returns the background color of the parent element. If no parent, then the defaultColor is returned.

groupBy (array, key, colSum, colCount, colFirst)

This function mimics Python pandas function group by.

GrapherBase (id, type, width, height)

Base class for Grapher linking the chart to the DOM element and creating the svg

Instance Members

Chart (id, options, width, height)

The Chart object represents the graph.

You create a Chart by specifying a container (a DOM element) that will contain the graph, and other options.

Examples

let myGraphExample1 = new Grapher('myGraphExample1',
                                {"data": data,
                                 "x": {
                                     "name": "date",
                                      "scale": "scaleTime",
                                      "parse": (d) => d3.timeParse('%Y-%m-%d')(d),
                                      "tickFormat": d3.timeFormat("%d/%m/%y"),
                                      "label": "Date"
                                  },
                                  "y": {
                                      "name": "value",
                                      "tickFormat": d3.format('.3s'),
                                      "label": "Glucose"
                                  },
                                  "type": "dotted-line",
                                  });

Instance Members

margin (margin)

Get and sets the values of the inner margins

Returns

margin (margin)

Get and sets the values of the inner margins

Returns

options (options)

Gets and sets the option for Grapher object. Note that setter is called only by typing myGraph.options = {something}; Typing myGraph.options.data = something; do work but setter is not called and data is not parsed again, etc.

draw (options)

Draw the Grapher object

Donut (id, options, displayText, size, type)

The Donut class is a children class of the Grapher class. This is still a work in progress. Currently the Donut is mainly a Gauge.

Examples

let myArc = new g.Donut("myArc",
                        {"value": 30},
                        size=100);
myArc.draw();

Instance Members

Gauge (id, options, size)

The Gauge is a child of Donut class with convenient defaults for plotting a gauge.

Examples

let myGauge = new g.Donut("myGauge",
                         {"value": 20},
                         size=100);
myGauge.draw();