
    cMh                        d dl mZ d dlmZmZ d dlZd dlmZmZ d dl	Z	d dl
Zd dlZ
d dlZd dlmZ d dlmZ d dlmZ d dlmc mZ erd dlmZ 	 	 	 d.d/dZd0dZd1dZd2dZd3dZd4d Z d5d"Z!d6d$Z"d5d%Z#d7d&Z$d8d'Z%d8d(Z&d9d+Z'd:d-Z(dS );    )annotations)
CollectionIteratorN)TYPE_CHECKINGcast)MatplotlibColor)find_stack_level)is_list_like)Colormapdefault
num_colorsintcolormapColormap | None
color_typestrcolor3dict[str, Color] | Color | Collection[Color] | Nonec                    t          |t                    r|S t          ||||           }t          t	          ||                     S )a  
    Get standard colors based on `colormap`, `color_type` or `color` inputs.

    Parameters
    ----------
    num_colors : int
        Minimum number of colors to be returned.
        Ignored if `color` is a dictionary.
    colormap : :py:class:`matplotlib.colors.Colormap`, optional
        Matplotlib colormap.
        When provided, the resulting colors will be derived from the colormap.
    color_type : {"default", "random"}, optional
        Type of colors to derive. Used if provided `color` and `colormap` are None.
        Ignored if either `color` or `colormap` are not None.
    color : dict or str or sequence, optional
        Color(s) to be used for deriving sequence of colors.
        Can be either be a dictionary, or a single color (single color string,
        or sequence of floats representing a single color),
        or a sequence of colors.

    Returns
    -------
    dict or list
        Standard colors. Can either be a mapping if `color` was a dictionary,
        or a list of colors with a length of `num_colors` or more.

    Warns
    -----
    UserWarning
        If both `colormap` and `color` are provided.
        Parameter `color` will override.
    r   r   r   r   r   )
isinstancedict_derive_colorslist_cycle_colors)r   r   r   r   colorss        a/var/www/html/test/jupyter/venv/lib/python3.11/site-packages/pandas/plotting/_matplotlib/style.pyget_standard_colorsr      sY    L % 	  F f<<<===     Color | Collection[Color] | Nonestr | Colormap | Nonereturnlist[Color]c                    | |t          ||          S | 3|"t          j        dt                                 t	          |           S t          ||          S )aa  
    Derive colors from either `colormap`, `color_type` or `color` inputs.

    Get a list of colors either from `colormap`, or from `color`,
    or from `color_type` (if both `colormap` and `color` are None).

    Parameters
    ----------
    color : str or sequence, optional
        Color(s) to be used for deriving sequence of colors.
        Can be either be a single color (single color string, or sequence of floats
        representing a single color), or a sequence of colors.
    colormap : :py:class:`matplotlib.colors.Colormap`, optional
        Matplotlib colormap.
        When provided, the resulting colors will be derived from the colormap.
    color_type : {"default", "random"}, optional
        Type of colors to derive. Used if provided `color` and `colormap` are None.
        Ignored if either `color` or `colormap`` are not None.
    num_colors : int
        Number of colors to be extracted.

    Returns
    -------
    list
        List of colors extracted.

    Warns
    -----
    UserWarning
        If both `colormap` and `color` are provided.
        Parameter `color` will override.
    Nr   zC'color' and 'colormap' cannot be used simultaneously. Using 'color')
stacklevel)_get_colors_from_colormapwarningswarnr	   _get_colors_from_color_get_colors_from_color_typer   s       r   r   r   P   sv    N }-(jIIII		MU+--    &e,,,*:*MMMMr    r   Iterator[Color]c              #     K   t          |t          |                     }t          j        t          j        |           |          E d{V  dS )zCycle colors until achieving max of `num_colors` or length of `colors`.

    Extra colors will be ignored by matplotlib if there are more colors
    than needed and nothing needs to be done here.
    N)maxlen	itertoolsislicecycle)r   r   
max_colorss      r   r   r      sR       ZV--J	 7 7DDDDDDDDDDDr    str | Colormapc                h    t          |           fdt          j        dd|          D             S )zGet colors from colormap.c                &    g | ]} |          S  r7   ).0numcmaps     r   
<listcomp>z-_get_colors_from_colormap.<locals>.<listcomp>   s!    CCC#DDIICCCr    r      )r9   )_get_cmap_instancenplinspace)r   r   r:   s     @r   r'   r'      s=    
 h''DCCCCQz!B!B!BCCCCr    r   c                    t          | t                    r)| }t          j        |          } | t	          d| d          | S )z$Get instance of matplotlib colormap.Nz	Colormap z is not recognized)r   r   mpl	colormaps
ValueError)r   r:   s     r   r=   r=      sK    (C   C=*AAAABBBOr    Color | Collection[Color]c                   t          |           dk    rt          d|            t          |           rt          t          |           } | gS t          t
          t                   |           } t          t          |                     S )z!Get colors from user input color.r   zInvalid color argument: )r/   rC   _is_single_colorr   Colorr   r   !_gen_list_of_colors_from_iterabler   s    r   r*   r*      s{     5zzQ;E;;<<< UE""wE"E**E1%88999r    boolc                t    t          | t                    rt          |           rdS t          |           rdS dS )a0  Check if `color` is a single color, not a sequence of colors.

    Single color is of these kinds:
        - Named color "red", "C0", "firebrick"
        - Alias "g"
        - Sequence of floats, such as (0.1, 0.2, 0.3) or (0.1, 0.2, 0.3, 0.4).

    See Also
    --------
    _is_single_string_color
    TF)r   r   _is_single_string_color_is_floats_colorrI   s    r   rF   rF      sE     % "9%"@"@ t t5r    Collection[Color]c              #  ^   K   | D ]'}t          |          r|V  t          d|           dS )zS
    Yield colors from string of several letters or from collection of colors.
    zInvalid color N)rF   rC   )r   xs     r   rH   rH      sS        3 3A 	3GGGG1a11222	3 3r    c                    t          t          |           o>t          |           dk    pt          |           dk    ot          d | D                                 S )zACheck if color comprises a sequence of floats representing color.      c              3  N   K   | ] }t          |t          t          f          V  !d S )N)r   r   float)r8   rP   s     r   	<genexpr>z#_is_floats_color.<locals>.<genexpr>   s0      ;;
1sEl++;;;;;;r    )rJ   r
   r/   allrI   s    r   rM   rM      s_    U 	<ZZ1_/E

a	<;;U;;;;;  r    c                t    | dk    rt          |          S | dk    rt          |          S t          d          )z&Get colors from user input color type.r   randomz/color_type must be either 'default' or 'random')_get_default_colors_get_random_colorsrC   )r   r   s     r   r+   r+      sC    Y":...	x		!*---JKKKr    c                P    ddl m} d |j        d         D             }|d|          S )z=Get `num_colors` of default colors from matplotlib rc params.r   Nc                    g | ]
}|d          S rI   r7   )r8   cs     r   r;   z'_get_default_colors.<locals>.<listcomp>   s    BBBQajBBBr    zaxes.prop_cycle)matplotlib.pyplotpyplotrcParams)r   pltr   s      r   rZ   rZ      s>    ######BB#,/@"ABBBF!J,r    c                4    d t          |           D             S )z"Get `num_colors` of random colors.c                ,    g | ]}t          |          S r7   )_random_color)r8   r9   s     r   r;   z&_get_random_colors.<locals>.<listcomp>   s     <<<3M#<<<r    )ranger   s    r   r[   r[      s    <<%
*;*;<<<<r    columnlist[float]c                x    t          j        |           }|                    d                                          S )z4Get a random color represented as a list of length 3rR   )comrandom_staterandtolist)rg   rss     r   re   re      s0     
	&	!	!B771::r    rG   c                    t           j                                        }	 |                    |            dS # t          $ r Y dS w xY w)a  Check if `color` is a single string color.

    Examples of single string colors:
        - 'r'
        - 'g'
        - 'red'
        - 'green'
        - 'C3'
        - 'firebrick'

    Parameters
    ----------
    color : Color
        Color string or sequence of floats.

    Returns
    -------
    bool
        True if `color` looks like a valid color.
        False otherwise.
    TF)
matplotlibr   ColorConverterto_rgbarC   )r   convs     r   rL   rL      s\    , ++--D 	U t    uus   7 
AA)Nr   N)r   r   r   r   r   r   r   r   )
r   r!   r   r"   r   r   r   r   r#   r$   )r   r$   r   r   r#   r,   )r   r4   r   r   r#   r$   )r   r4   r#   r   )r   rD   r#   r$   )r   rD   r#   rJ   )r   rN   r#   r,   )r   r   r   r   r#   r$   )r   r   r#   r$   )rg   r   r#   rh   )r   rG   r#   rJ   ))
__future__r   collections.abcr   r   r0   typingr   r   r(   rp   rA   matplotlib.colorsnumpyr>   pandas._typingr   rG   pandas.util._exceptionsr	   pandas.core.dtypes.commonr
   pandas.core.commoncorecommonrj   r   r   r   r   r'   r=   r*   rF   rH   rM   r+   rZ   r[   re   rL   r7   r    r   <module>r      sS   " " " " " "                                3 3 3 3 3 3 4 4 4 4 4 4 2 2 2 2 2 2                   +******
 !%AE	0> 0> 0> 0> 0>f1N 1N 1N 1NhE E E ED D D D   : : : :   ,3 3 3 3   L L L L       = = = =
        r    