U /eV$@s|dZddlmZddlZeeZddlmZddl m Z ddl m Z ddl mZmZmZmZmZmZmZmZmZmZmZmZmZmZmZdd lmZdd lm Z d d l!m"Z"d Z#e Gddde"Z$e Gddde$Z%e Gddde$Z&Gddde&e%Z'Gddde&Z(Gddde&Z)e Gddde%Z*Gddde*Z+Gddde*Z,e Gd d!d!e*Z-Gd"d#d#e-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. ) annotationsN)palettes)Palette)abstract)BoolColorEitherEnum FactorSeqFloatHatchPatternTypeInstanceIntList MarkerTypeNullableSeqStringTuple)warning)PALETTE_LENGTH_FACTORS_MISMATCH) Transform) Mapper ColorMapperCategoricalMapperCategoricalColorMapperCategoricalMarkerMapperCategoricalPatternMapperContinuousColorMapperLinearColorMapperLogColorMapperEqHistColorMapperc@seZdZdZdS)rz Base class for mappers. N__name__ __module__ __qualname____doc__r)r)8/tmp/pip-unpacked-wheel-f5fndrjf/bokeh/models/mappers.pyrGsrcsPeZdZdZeeddeeddZ edddZ dd 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*YzColorMapper.ZgrayzD Color to be used if data is NaN or otherwise not mappable. defaultr,NNone)returnc s"|dk r||d<tjf|dS)Npalette)super__init__)selfr4kwargs __class__r)r*r6_szColorMapper.__init__)N) r%r&r'r(rrZacceptsr rr4 nan_colorr6 __classcell__r)r)r9r*rNs  rc@s2eZdZdZeddZedddZeeddZ dS) rzK Base class for mappers that map categorical factors to other values. a= 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+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"``) r0a 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. N) r%r&r'r(r factorsrstartrendr)r)r)r*rds rc@s eZdZdZeeddZdS)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``. cCs@|j}|j}t|t|kr<|t|d}|d|jSdS)Nz! will be assigned to `nan_color` )r4r=lenr;)r7r4r=Z extra_factorsr)r)r*_check_palette_lengths z,CategoricalColorMapper._check_palette_lengthN)r%r&r'r(rrrAr)r)r)r*rsrc@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. F 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. r0N)r%r&r'r(rrmarkers default_valuer)r)r)r*rs rc@s(eZdZdZeeddZedddZdS)rz Map categorical factors to hatch fill patterns. Values that are passed to this mapper that are not in the factors list will be mapped to ``default_value``. Added in version 1.1.1 rBr+ z^ A hatch pattern to use in case an unrecognized factor is passed in to be mapped. r0N)r%r&r'r(rr patternsrDr)r)r)r*rs rc@sbeZdZdZeeedeeeegddZ e e ddZ e e ddZ e eddZe ed dZd S) r z4 Base class for continuous color mapper types. z$bokeh.models.renderers.GlyphRendererz A collection of glyph renderers to pool data from for establishing data metrics. If empty, mapped data will be used instead. r0z The minimum value of the range to map into the palette. Values below this are clamped to ``low``. If ``None``, the value is inferred from data. r+z The maximum value of the range to map into the palette. Values above this are clamped to ``high``. If ``None``, the value is inferred from data. z 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. 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. N)r%r&r'r(rrrr rdomainrr lowhighrZ low_colorZ high_colorr)r)r)r*r s "   r c@seZdZdZdS)r!a 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 Nr$r)r)r)r*r!sr!c@seZdZdZdS)r"a 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. Nr$r)r)r)r*r"sr"c@s eZdZdS)ScanningColorMapperN)r%r&r'r)r)r)r*rJsrJc@s$eZdZedddZedddZdS)r#izNumber of histogram binsr0Fz If there are only a few discrete levels in the values that are color mapped then ``rescale_discrete_levels=True`` decreases the lower limit of the span so that the values are rendered towards the top end of the palette. N)r%r&r'rZbinsrZrescale_discrete_levelsr)r)r)r*r#s r#)/r( __future__rlogging getLoggerr%logrZ core.enumsrZcore.has_propsrZcore.propertiesrrr r r r r rrrrrrrrZcore.validationrZcore.validation.warningsrZ transformsr__all__rrrrrrr r!r"rJr#r)r)r)r*s6     D   &