U Gv f'@sRddlmZddlmZmZmZddlZddlmZm Z m Z ddl m Z ddl ZddlZddlZddl mZddlmZddlmZdd lmZdd lmZmZmZmZmZdd lm Z Gd d d Z!e e"e!fZ#e e$e!fZ%e e&e!fZ'e e$e(e!fZ)e e$eee!fZ*eGdddZ+dddddddZ,d ddddddddZ-ddZ.dS)!) annotations) dataclassfieldsfieldN)AnyCallableUnion) Generator)ndarray) DataFrame)Artist)Scale) PROPERTIESProperty RGBATuple DashPatternDashPatternWithOffset) PlotSpecErrorc@sbeZdZddddddddd Zd d Zedd d dZedd ddZedd ddZdS)MappableNFTrz str | Nonebool)valdependrcautogroupingcCsL|dk r|tkst|dk r*|tjks*t||_||_||_||_||_dS)a Property that can be mapped from data or set directly, with flexible defaults. Parameters ---------- val : Any Use this value as the default. depend : str Use the value of this feature as the default. rc : str Use the value of this rcParam as the default. auto : bool The default value will depend on other parameters at compile time. grouping : bool If True, use the mapped variable to define groups. N) rAssertionErrormplrcParams_val_rc_depend_auto _grouping)selfrrrrrr$7/tmp/pip-unpacked-wheel-ir0tye89/seaborn/_marks/base.py__init__s zMappable.__init__cCsf|jdk rdt|jd}nD|jdk r8d|jd}n*|jdk rRd|jd}n|jr^d}nd}|S)z?Nice formatting for when object appears in Mark init signature.N<>zz )rreprr rr!)r#sr$r$r%__repr__?s   zMappable.__repr__)returncCs|jS)z>Return the name of the feature to source a default value from.)r r#r$r$r%rMszMappable.dependcCs|jSN)r"r-r$r$r%rRszMappable.groupingcCs,|jdk r|jS|jdk r(tj|jSdS)zGGet the default value for this feature, or access the relevant rcParam.N)rrrrgetr-r$r$r%defaultVs  zMappable.default)NNNFT) __name__ __module__ __qualname__r&r+propertyrrr0r$r$r$r%rs$rc@seZdZUdZeedZded<eddZ eddZ dd d d d dddZ dd dddZ ddd ddddZ dd dddddZd S) Markz4Base class for objects that visually represent data.)default_factorydict artist_kwscsfddtDS)Ncs(i|] }t|jtr|jt|jqSr$) isinstancer0rnamegetattr.0fr-r$r% ps z(Mark._mappable_props..rr-r$r-r%_mappable_propsns zMark._mappable_propscCsddt|DS)NcSs&g|]}t|jtr|jjr|jqSr$)r9r0rrr:r<r$r$r% ys z(Mark._grouping_props..r@r-r$r$r%_grouping_propsuszMark._grouping_propsNzDataFrame | dict[str, Any]strdict[str, Scale] | Noner)datar:scalesr,c Cs^|j|}t|t|}t|t }t|tj}|o@|d }|dkrV|oT||k}|r| |}|rv|gt |}|rt |}|S||kr|dks||kr||}nN||} ||} z | | }Wn0t k r} ztd|| W5d} ~ XYnX|r t |}|S|jdk r*|||j|S| |j} |rJ| gt |} |rZt | } | S)aObtain default, specified, or mapped value for a named feature. Parameters ---------- data : DataFrame or dict with scalar values Container with data values for features that will be semantically mapped. name : string Identity of the feature / semantic. scales: dict Mapping from variable to corresponding scale object. Returns ------- value or array of values Outer return type depends on whether `data` is a dict (implying that we want a single value) or DataFrame (implying that we want an array of values with matching length). stylewidthNzScaling operation)rArr/rr9rpdr endswithZ standardizelennparray ExceptionrZ_duringZasarrayr_resolver0) r#rFr:rGZfeaturepropZdirectly_specifiedZreturn_multipleZ return_arrayZscalevalueerrr0r$r$r%rPsD              z Mark._resolve)rGr,cCs@d|kr dn|dj}d|kr"dn|dj}||kr8dSdSdS)Nxry)Z _priority)r#rGrTrUr$r$r% _infer_orients zMark._infer_orientzCallable[[], Generator]dict[str, Scale]None)split_generatorrGorientr,cCs tdS)z#Main interface for creating a plot.N)NotImplementedError)r#rYrGrZr$r$r%_plotsz Mark._plotz list[str]z Artist | None) variablesrRrGr,cCsdSr.r$)r#r]rRrGr$r$r%_legend_artistszMark._legend_artist)N)r1r2r3__doc__rr7r8__annotations__r4rArCrPrVr\r^r$r$r$r%r5hs   I r5r rWzdict[str, Any])markrFrGr,csfddjD}|S)Ncsi|]}||qSr$)rP)r=r:rFrarGr$r%r?sz&resolve_properties..)rA)rarFrGpropsr$rbr%resolve_propertiessrdzDataFrame | dictrDrEzRGBATuple | ndarray)rarFprefixrGr,cCs|||d|}|d|jkr:|||d|}n||d|}d dd}t|dkrtdd|Drt|d krtj|S||r|ntj }tj||St|dkr|j d d krtj |St ||d d |tj }tj ||SdS) a Obtain a default, specified, or mapped value for a color feature. This method exists separately to support the relationship between a color and its corresponding alpha. We want to respect alpha values that are passed in specified (or mapped) color values but also make use of a separate `alpha` variable, which can be mapped. This approach may also be extended to support mapping of specific color channels (i.e. luminance, chroma) in the future. Parameters ---------- mark : Mark with the color property. data : Container with data values for features that will be semantically mapped. prefix : Support "color", "fillcolor", etc. coloralphaNcSs"t|jjdkp t||S)z5Detect "invisible" colors to set alpha appropriately.r>)rMrNZdtypekindisfiniteall)rTaxisr$r$r%visibleszresolve_color..visiblecss|]}t|tVqdSr.)r9float)r=rTr$r$r% sz resolve_color..)rl)N) rPrArMndimrkrLrcolorsZto_rgbananshapeZ to_rgba_arraywhere)rarFrfrGrgrhrmr$r$r% resolve_colors     rxcCspddt|D}ddtjddd|Ddddd g}|jd }d |dd ||d d}||_|S) NcSsg|]}t|jtr|jqSr$)r9r0rr:r<r$r$r%rB,s z'document_properties..rez/ This mark defines the following properties:z, cSsg|]}d|dqS)|r$)r=pr$r$r%rB1sNz )rIinitial_indentsubsequent_indent rn)rtextwrapfilljoinr_split)raZ propertiestextZdocstring_linesZ new_docstringr$r$r%document_properties*s$   r)reN)/ __future__rZ dataclassesrrrrtypingrrrcollections.abcr ZnumpyrMZpandasrJZ matplotlibrr r Zmatplotlib.artistr Zseaborn._core.scalesr Zseaborn._core.propertiesrrrrrZseaborn._core.exceptionsrrrZ MappableBoolrDZMappableStringroZ MappableFloattupleZ MappableColorZ MappableStyler5rdrxrr$r$r$r%s4       G    8