Function update

src/plot_api/plot_api.js:2237–2304

* update: update trace and layout attributes of an existing plot * * @param {String | HTMLDivElement} gd * the id or DOM element of the graph container div * @param {Object} traceUpdate * attribute object `{astr1: val1, astr2: val2 ...}` * corresponding to updates in the plot's traces * @p

(gd, traceUpdate, layoutUpdate, _traces)

 *
 */
function update(gd, traceUpdate, layoutUpdate, _traces) {
    gd = Lib.getGraphDiv(gd);
    helpers.clearPromiseQueue(gd);

    if (!Lib.isPlainObject(traceUpdate)) traceUpdate = {};
    if (!Lib.isPlainObject(layoutUpdate)) layoutUpdate = {};

    if (Object.keys(traceUpdate).length) gd.changed = true;
    if (Object.keys(layoutUpdate).length) gd.changed = true;

    var traces = helpers.coerceTraceIndices(gd, _traces);

    var restyleSpecs = _restyle(gd, Lib.extendFlat({}, traceUpdate), traces);
    var restyleFlags = restyleSpecs.flags;

    var relayoutSpecs = _relayout(gd, Lib.extendFlat({}, layoutUpdate));
    var relayoutFlags = relayoutSpecs.flags;

    // clear calcdata and/or axis types if required
    if (restyleFlags.calc || relayoutFlags.calc) gd.calcdata = undefined;
    if (restyleFlags.clearAxisTypes) helpers.clearAxisTypes(gd, traces, layoutUpdate);

    // fill in redraw sequence
    var seq = [];

    if (relayoutFlags.layoutReplot) {
        // N.B. works fine when both
        // relayoutFlags.layoutReplot and restyleFlags.fullReplot are true
        seq.push(subroutines.layoutReplot);
    } else if (restyleFlags.fullReplot) {
        seq.push(exports._doPlot);
    } else {
        seq.push(Plots.previousPromises);
        axRangeSupplyDefaultsByPass(gd, relayoutFlags, relayoutSpecs) || Plots.supplyDefaults(gd);

        if (restyleFlags.style) seq.push(subroutines.doTraceStyle);
        if (restyleFlags.colorbars || relayoutFlags.colorbars) seq.push(subroutines.doColorBars);
        if (relayoutFlags.legend) seq.push(subroutines.doLegend);
        if (relayoutFlags.layoutstyle) seq.push(subroutines.layoutStyles);
        if (relayoutFlags.axrange) addAxRangeSequence(seq, relayoutSpecs.rangesAltered);
        if (relayoutFlags.ticks) seq.push(subroutines.doTicksRelayout);
        if (relayoutFlags.modebar) seq.push(subroutines.doModeBar);
        if (relayoutFlags.camera) seq.push(subroutines.doCamera);

        seq.push(emitAfterPlot);
    }

    seq.push(Plots.rehover, Plots.redrag, Plots.reselect);

    Queue.add(gd, update, [gd, restyleSpecs.undoit, relayoutSpecs.undoit, restyleSpecs.traces], update, [
        gd,
        restyleSpecs.redoit,
        relayoutSpecs.redoit,
        restyleSpecs.traces
    ]);

    var plotDone = Lib.syncOrAsync(seq, gd);
    if (!plotDone || !plotDone.then) plotDone = Promise.resolve(gd);