B @\@s,dZddlmZmZmZmZddlZeeZ ddl Z ddl m Z ddl mZddlmZmZmZmZmZmZmZmZmZddlmZd d lmZd ZeGd d d eZeGdddeZeGdddeZ Gddde eZ!Gddde Z"eGdddeZ#Gddde#Z$Gddde#Z%dS)z Models for mapping values from one range or space to another in the client. Mappers (as opposed to scales) are not presumed to be invertible. )absolute_importdivisionprint_functionunicode_literalsN)palettes)abstract) ColorEitherEnumFloatInt MarkerTypeSeqStringTuple)Palette) Transform)Mapper ColorMapperCategoricalMapperCategoricalColorMapperCategoricalMarkerMapperContinuousColorMapperLinearColorMapperLogColorMapperc@seZdZdZdS)rz Base class for mappers. N)__name__ __module__ __qualname____doc__r!r!3lib/python3.7/site-packages/bokeh/models/mappers.pyr8srcsJeZdZdZeeddeeddZ edddZ d fd d Z Z S) rz) Base class for color mapper types. z A sequence of colors to use as the target palette for mapping. This property can also be set as a ``String``, to the name of any of the palettes shown in :ref:`bokeh.palettes`. )helpcCs tt|S)N)getattrr)Zpalr!r!r"JszColorMapper.ZgrayzV Color to be used if data is NaN or otherwise not mappable. (Default: 'gray') )defaultr#Nc s&|dk r||d<tt|jf|dS)Npalette)superr__init__)selfr'kwargs) __class__r!r"r)PszColorMapper.__init__)N) rrrr rr Zacceptsr rr' nan_colorr) __classcell__r!r!)r,r"r?s rc@sReZdZdZeeeeeeeeeeeedddZe dddZ e ddZ dS) rzK Base class for mappers that map categorical factors to other values. Na= A sequence of factors / categories that map to the some target range. For example the following color mapper: .. code-block:: python mapper = CategoricalColorMapper(palette=["red", "blue"], factors=["foo", "bar"]) will map the factor ``"foo"`` to red and the factor ``"bar"`` to blue. )r&r#raw A start index to "slice" data factors with before mapping. For example, if the data to color map consists of 2-level factors such as ``["2016", "sales"]`` and ``["2016", "marketing"]``, then setting ``start=1`` will perform color mapping only based on the second sub-factor (i.e. in this case based on the department ``"sales"`` or ``"marketing"``) a A start index to "slice" data factors with before mapping. For example, if the data to color map consists of 2-level factors such as ``["2016", "sales"]`` and ``["2017", "marketing"]``, then setting ``end=1`` will perform color mapping only based on the first sub-factor (i.e. in this case based on the year ``"2016"`` or ``"2017"``) If ``None`` then all sub-factors from ``start`` to the end of the factor will be used for color mapping. )r#) rrrr r rrrfactorsr startendr!r!r!r"rUs$  rcs eZdZdZfddZZS)rz Map categorical factors to colors. Values that are passed to this mapper that are not in the factors list will be mapped to ``nan_color``. c sftt|jf||j}|j}|dk rb|dk rbt|t|krb|t|d}td||jfdS)NzVPalette length does not match number of factors. %s will be assigned to `nan_color` %s) r(rr)r'r/lenwarningswarnr-)r*r+r'r/Z extra_factors)r,r!r"r)szCategoricalColorMapper.__init__)rrrr r)r.r!r!)r,r"r|src@s(eZdZdZeeddZedddZdS)ra1 Map categorical factors to marker types. Values that are passed to this mapper that are not in the factors list will be mapped to ``default_value``. .. note:: This mappers is primarily only useful with the ``Scatter`` marker glyph that be parameterized by marker type. zF A sequence of marker types to use as the target for mapping. )r#Zcirclez\ A marker type to use in case an unrecognized factor is passed in to be mapped. )r&r#N)rrrr rrZmarkersZ default_valuer!r!r!r"rs  rc@s<eZdZdZeddZeddZedddZedddZ dS) rz4 Base class for continuous color mapper types. zo The minimum value of the range to map into the palette. Values below this are clamped to ``low``. )r#zp The maximum value of the range to map into the palette. Values above this are clamped to ``high``. Nz Color to be used if data is lower than ``low`` value. If None, values lower than ``low`` are mapped to the first color in the palette. )r&r#z Color to be used if data is higher than ``high`` value. If None, values higher than ``high`` are mapped to the last color in the palette. ) rrrr r ZlowZhighr Z low_colorZ high_colorr!r!r!r"rsrc@seZdZdZdS)ra Map numbers in a range [*low*, *high*] linearly into a sequence of colors (a palette). For example, if the range is [0, 99] and the palette is ``['red', 'green', 'blue']``, the values would be mapped as follows:: x < 0 : 'red' # values < low are clamped 0 >= x < 33 : 'red' 33 >= x < 66 : 'green' 66 >= x < 99 : 'blue' 99 >= x : 'blue' # values > high are clamped N)rrrr r!r!r!r"rs rc@seZdZdZdS)ra Map numbers in a range [*low*, *high*] into a sequence of colors (a palette) on a natural logarithm scale. For example, if the range is [0, 25] and the palette is ``['red', 'green', 'blue']``, the values would be mapped as follows:: x < 0 : 'red' # values < low are clamped 0 >= x < 2.72 : 'red' # math.e ** 1 2.72 >= x < 7.39 : 'green' # math.e ** 2 7.39 >= x < 20.09 : 'blue' # math.e ** 3 20.09 >= x : 'blue' # values > high are clamped .. warning:: The ``LogColorMapper`` only works for images with scalar values that are non-negative. N)rrrr r!r!r!r"rsr)&r Z __future__rrrrZloggingZ getLoggerrlogr3rZcore.has_propsrZcore.propertiesr r r r r rrrrZ core.enumsrZ transformsr__all__rrrrrrrrr!r!r!r" s,   ,     &