plotSetColorMap
==============================================

Purpose
----------------
Sets the color maps for a surface or contour plot.

Format
----------------
.. function:: plotSetColorMap(&myPlot, color_type)

    :param &myPlot: A :class:`plotControl` structure pointer.
    :type &myPlot: struct pointer

    :param color_type: name of color maps:

      .. csv-table::
        :widths: auto

        "viridis"
        "magma"
        "inferno"
        "plasma"


    :type color_type: string

Examples
----------------

::

    // Clear out variables in GAUSS workspace
    new;

    // Create data
    x = seqa(-4, .125, 161)';
    y = seqa(-8, .125, 161);
    z = sin(x) .* cos(y) * .5;
    z = z .* sin(x/3) .* cos(y/3);
    z = z .* sin(x/5) + sin(y/2.5)/3 + sin(x/2.5)/3;

    // Set up control structure with defaults
    // for surface plots
    struct plotControl myPlot;
    myPlot = plotGetDefaults("surface");

    // Set title and Z axis label
    plotSetTitle(&myPlot, "Contour plot example", "arial", 16, "black");

    // Set color map for contour
    plotSetColormap(&myplot, "viridis");

    // Draw graph using plotcontrol structure
    plotContour(myPlot, x, y, z);

The plot is

.. figure:: _static/images/plotSetColorMap.png

Remarks
-------

.. include:: include/plotattrremark.rst

.. seealso:: Functions :func:`plotGetDefaults`, :func:`plotSetContourLabels`, :func:`plotSetZLevels`