dMtddlZddlmZddlZddlmZmZddlm Z ddl m Z m Z ej dkrddl mZnddlmZGd d ZGd d ZGd dZeGddeejZeGddeejZeGddeejZeGddeejZeGddeejZeGddeejZeGddeejZ eGddeej!Z"eGdd eej#Z$eGd!d"eej%Z&eGd#d$eej'Z(eGd%d&eejZ)eGd'd(eejZ*eGd)d*eejZ+eGd+d,eejZ,eGd-d.eejZ-eGd/d0eejZ.eGd1d2eej!Z/eGd3d4eej#Z0eGd5d6eej%Z1eGd7d8eej2Z3eGd9d:eej4Z5eGd;deej4Z8eGd?d@eej9Z:eGdAdBeej2Z;eGdCdDeej4ZeGdIdJeej9Z?eGdKdLeejZ@eGdMdNeejZAeGdOdPeejZBeGdQdReejCZDeGdSdTeejEZFeGdUdVeejGZHeGdWdXeejIZJeGdYdZeej9ZKeGd[d\eej6ZLeGd]d^eej4ZMeGd_d`eej9ZNeGdadbeejZOeGdcddeejPZQeGdedfeejRZSeGdgdheejTZUeGdidjeejZVeGdkdleejZWeGdmdneejZXeGdodpeejZYeGdqdreejZZeGdsdteejZ[eGdudveej\Z]eGdwdxeej^Z_eGdydzeej`ZaeGd{d|eejZbeGd}d~eejZceGddeejZdeGddeejZeeGddeejZfeGddeejZgeGddeejhZieGddeejjZkeGddeejlZmeGddeejGZneGddeejIZoeGddeej9ZpeGddeej6ZqeGddeej4ZreGddeej9ZseGddeej!ZteGddeej#ZueGddeej!ZveGddeej#ZweGddeejxZyeGddeejzZ{eGddeej9Z|eGddeej6Z}eGddeej4Z~eGddeej9ZeGddeej6ZeGddeejZeGddeej6ZeGddeejZeGddeejZeGddeejZeGddeejZeGddeejxZeGddeejzZeGddeej9ZeGddeej6ZeGdÄdeej4ZeGdńdeej9ZeGdDŽdeej6ZeGdɄdeejZeGd˄deej6ZeGd̈́deejZeGdτdeejZeGdфdeejZeGdӄdeejZdS)N)core) Undefinedwith_property_setters)parse_shorthand)overloadList))Literalc eZdZdfd ZxZS)FieldChannelMixinTNc pid}d}|tur7|tur.tdjj||t |ttfr@j d fd|DS|turi}nt |trt|dd}dj v}d|v}dtu} |s| ddn{|st| srt ddtjr"td|td |nd|i}|d <t#t$ S) N shorthandfieldz-{} specifies both shorthand={} and field={}. cXg|]&}j|fi'S)validateignorecontext) __class__to_dict).0shrrkwdsselfrs Blib/python3.11/site-packages/altair/vegalite/v5/schema/channels.py z-FieldChannelMixin.to_dict..sT)))#DN2....66QWah6ii)))data)r!typezUnable to determine data type for the field "{}"; verify that the field name is not misspelled. If you are referencing a field from a transform, also confirm that the data type is specified correctly.z{} encoding field is specified without a type; the type cannot be automatically inferred because the data is not specified as a pandas.DataFrame.parsed_shorthandr)_getr ValueErrorformatr__name__ isinstancetuplelist_kwdscopypopstrrgetpd DataFramesuperrr) rrrrrrparsed type_requiredtype_in_shorthandtype_defined_explicitlyrrs ```` @rrzFieldChannelMixin.to_dictsU-RIIk**  '"" I % %%y*@*@ &t~'> 5 Q QSS S i% / / ):??$$D HH[ ! ! !))))))))'))) )  ! !FF  3 ' ' *$YW[[5N5NOOOF"dj0M && 0 &*ii&7&7y&H #  ; 64((((' ;+B ;gkk&$77FF ;$STZSYZcSdSd %&()/y(9(9;;;y)F&,"#&--556   r TrNr' __module__ __qualname__r __classcell__rs@rrrs=2 2 2 2 2 2 2 2 2 2 r rc eZdZdfd ZxZS)ValueChannelMixinTrNc|pi}|dt}|}|turt|tjrndd|vr`d|vr\t |d|dd}|dg}|d|tt| |||S)N conditionrr"r!)deepr) r$rr(r SchemaBaserr/r,updater2r>r)rrrrr@r,rrs rrzValueChannelMixin.to_dictHs-RIIk955  I % %)T_55 /I%%& *A*A&y'97;;vt;T;TUUyy{my44[!((...&--55x=C>E6GG Gr r7r8r<s@rr>r>GsG G G G G G G G G G Gr r>c eZdZdfd ZxZS)DatumChannelMixinTrNc|pi}|dt}|}|turt|tjr t t ||||S)Ndatumr)r$rr(rrBr2rEr)rrrrrGr,rs rrzDatumChannelMixin.to_dictYsy-R '9--  ! !%11 &--55x=C>E6GG Gr r7r8r<s@rrErEXsG G G G G G G G G G Gr rEcCeZdZdZdZdZededddfdZee fd4dZee fd4d Zde ddfd Z ede ddfd Z ee e e e e e e e e e f d4d Z ed5dZ ee e fd4dZee e e fd4dZedeejddfdZededdfdZee fd4dZee e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e fBd4dZed5dZee e e e e e e e e e e e e e e e e e e e e e e fd4dZed5dZedee ddfdZedeeddfdZedee ddfdZedeejddfdZededddfdZededddfdZeded ddfd!Zee e e fd4d"Zee e fd4d#Zed5d$Zeded%ddfd&Zeded'ddfd(Zeded)ddfd*Zeded+ddfd,Zee e e e fd4d-Zededdfd.Zedeeddfd/Zed5d0Zded1ddfd2Ze e e e e e e e e e e e f fd3 ZxZS)6Angleaz/Angle schema wrapper Mapping(required=[shorthand]) Parameters ---------- shorthand : string shorthand for field, aggregate, and type aggregate : :class:`Aggregate` Aggregation function for the field (e.g., ``"mean"``, ``"sum"``, ``"median"``, ``"min"``, ``"max"``, ``"count"`` ). **Default value:** ``undefined`` (None) **See also:** `aggregate `__ documentation. bandPosition : float Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to ``0``, and at the middle of the band if set to ``0.5``. bin : anyOf(boolean, :class:`BinParams`, None) A flag for binning a ``quantitative`` field, `an object defining binning parameters `__, or indicating that the data for ``x`` or ``y`` channel are binned before they are imported into Vega-Lite ( ``"binned"`` ). If ``true``, default `binning parameters `__ will be applied. If ``"binned"``, this indicates that the data for the ``x`` (or ``y`` ) channel are already binned. You can map the bin-start field to ``x`` (or ``y`` ) and the bin-end field to ``x2`` (or ``y2`` ). The scale and axis will be formatted similar to binning in Vega-Lite. To adjust the axis ticks based on the bin step, you can also set the axis's `tickMinStep `__ property. **Default value:** ``false`` **See also:** `bin `__ documentation. condition : anyOf(:class:`ConditionalValueDefnumberExprRef`, List(:class:`ConditionalValueDefnumberExprRef`)) One or more value definition(s) with `a parameter or a test predicate `__. **Note:** A field definition's ``condition`` property can only contain `conditional value definitions `__ since Vega-Lite only allows at most one encoded field per encoding channel. field : :class:`Field` **Required.** A string defining the name of the field from which to pull a data value or an object defining iterated values from the `repeat `__ operator. **See also:** `field `__ documentation. **Notes:** 1) Dots ( ``.`` ) and brackets ( ``[`` and ``]`` ) can be used to access nested objects (e.g., ``"field": "foo.bar"`` and ``"field": "foo['bar']"`` ). If field names contain dots or brackets but are not nested, you can use ``\`` to escape dots and brackets (e.g., ``"a\.b"`` and ``"a\[0\]"`` ). See more details about escaping in the `field documentation `__. 2) ``field`` is not required if ``aggregate`` is ``count``. legend : anyOf(:class:`Legend`, None) An object defining properties of the legend. If ``null``, the legend for the encoding channel will be removed. **Default value:** If undefined, default `legend properties `__ are applied. **See also:** `legend `__ documentation. scale : anyOf(:class:`Scale`, None) An object defining properties of the channel's scale, which is the function that transforms values in the data domain (numbers, dates, strings, etc) to visual values (pixels, colors, sizes) of the encoding channels. If ``null``, the scale will be `disabled and the data value will be directly encoded `__. **Default value:** If undefined, default `scale properties `__ are applied. **See also:** `scale `__ documentation. sort : :class:`Sort` Sort order for the encoded field. For continuous fields (quantitative or temporal), ``sort`` can be either ``"ascending"`` or ``"descending"``. For discrete fields, ``sort`` can be one of the following: * ``"ascending"`` or ``"descending"`` -- for sorting by the values' natural order in JavaScript. * `A string indicating an encoding channel name to sort by `__ (e.g., ``"x"`` or ``"y"`` ) with an optional minus prefix for descending sort (e.g., ``"-x"`` to sort by x-field, descending). This channel string is short-form of `a sort-by-encoding definition `__. For example, ``"sort": "-x"`` is equivalent to ``"sort": {"encoding": "x", "order": "descending"}``. * `A sort field definition `__ for sorting by another field. * `An array specifying the field values in preferred order `__. In this case, the sort order will obey the values in the array, followed by any unspecified values in their original order. For discrete time field, values in the sort array can be `date-time definition objects `__. In addition, for time units ``"month"`` and ``"day"``, the values can be the month or day names (case insensitive) or their 3-letter initials (e.g., ``"Mon"``, ``"Tue"`` ). * ``null`` indicating no sort. **Default value:** ``"ascending"`` **Note:** ``null`` and sorting by another channel is not supported for ``row`` and ``column``. **See also:** `sort `__ documentation. timeUnit : anyOf(:class:`TimeUnit`, :class:`TimeUnitParams`) Time unit (e.g., ``year``, ``yearmonth``, ``month``, ``hours`` ) for a temporal field. or `a temporal field that gets casted as ordinal `__. **Default value:** ``undefined`` (None) **See also:** `timeUnit `__ documentation. title : anyOf(:class:`Text`, None) A title for the field. If ``null``, the title will be removed. **Default value:** derived from the field's name and transformation function ( ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function, the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ). Otherwise, the title is simply the field name. **Notes** : 1) You can customize the default field title format by providing the `fieldTitle `__ property in the `config `__ or `fieldTitle function via the compile function's options `__. 2) If both field definition's ``title`` and axis, header, or legend ``title`` are defined, axis/header/legend title will be used. type : :class:`StandardType` The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also be a ``"geojson"`` type for encoding `'geoshape' `__. Vega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal scale for a field with ``bin`` or ``timeUnit``. **Default value:** 1) For a data ``field``, ``"nominal"`` is the default data type unless the field encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or ``timeUnit`` that satisfies the following criteria: * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin`` or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a quantitative scale `__. * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit`` or (2) the specified scale type is a time or utc scale * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort order `__, (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is ``order``. 2) For a constant value in data domain ( ``datum`` ): * ``"quantitative"`` if the datum is a number * ``"nominal"`` if the datum is a string * ``"temporal"`` if the datum is `a date time object `__ **Note:** * Data ``type`` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data. * Data values for a temporal field can be either a date-time string (e.g., ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a timestamp number (e.g., ``1552199579097`` ). * When using with `bin `__, the ``type`` property can be either ``"quantitative"`` (for using a linear bin scale) or `"ordinal" (for using an ordinal bin scale) `__. * When using with `timeUnit `__, the ``type`` property can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal" (for using an ordinal scale) `__. * When using with `aggregate `__, the ``type`` property refers to the post-aggregation data type. For example, we can calculate count ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct", "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``. * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have ``type`` as they must have exactly the same type as their primary channels (e.g., ``x``, ``y`` ). **See also:** `type `__ documentation. Fangle_averagecountdistinctmaxmeanmedianminmissingproductq1q3ci0ci1stderrstdevstdevpsumvalidvaluesvariance variancepreturnc dSNrrrKrs r aggregatezAngle.aggregateJ r c dSrdrrargmaxrs rrfzAngle.aggregateNrgr c dSrdrrargminrs rrfzAngle.aggregateRrgr c dSrdrres r bandPositionzAngle.bandPositionV r c dSrdrres rbinz Angle.binYrgr c  dSrdr ranchorbasebinneddivideextentmaxbinsminstepnicestepstepsrs rrrz Angle.bin]rgr Nc dSrdrres rrrz Angle.binargr c dSrdrrtestvaluers rr@zAngle.conditionergr c dSrdrremptyparamrrs rr@zAngle.conditionirgr c dSrdrres rr@zAngle.conditionmrgr c dSrdrres rrz Angle.fieldqrgr c dSrdrrrepeatrs rrz Angle.fieldurgr cC dSrdrDraria clipHeight columnPaddingcolumns cornerRadius description direction fillColorr& formatTypegradientLengthgradientOpacitygradientStrokeColorgradientStrokeWidthgradientThickness gridAlign labelAlign labelBaseline labelColor labelExpr labelFont labelFontSizelabelFontStylelabelFontWeight labelLimit labelOffset labelOpacity labelOverlap labelPaddinglabelSeparationlegendXlegendYoffsetorientpadding rowPadding strokeColor symbolDashsymbolDashOffsetsymbolFillColor symbolLimit symbolOffset symbolOpacity symbolSizesymbolStrokeColorsymbolStrokeWidth symbolType tickCount tickMinSteptitle titleAlign titleAnchor titleBaseline titleColor titleFont titleFontSizetitleFontStyletitleFontWeight titleLimittitleLineHeight titleOpacity titleOrient titlePaddingr"r_zindexrsD rlegendz Angle.legendyrgr c dSrdrres rrz Angle.legend}rgr c dSrdrralignrvbinsclampconstantdomain domainMax domainMid domainMinexponent interpolater|r paddingInner paddingOuterrangerangeMaxrangeMinreverseroundschemer"zerors rscalez Angle.scalergr c dSrdrres rrz Angle.scalergr c dSrdrres rsortz Angle.sortrgr c dSrdrres rrz Angle.sortrgr c dSrdrres rrz Angle.sortrgr c dSrdrres rrz Angle.sortrgr  ascending descendingc dSrdrres rrz Angle.sortrgr xycolorfillstroke strokeWidthsizeshape fillOpacity strokeOpacityopacitytextc dSrdrres rrz Angle.sortrgr z-xz-yz-colorz-fillz-strokez -strokeWidthz-sizez-shapez -fillOpacityz-strokeOpacityz-opacityz-textc dSrdrres rrz Angle.sortrgr c dSrdrrroporderrs rrz Angle.sortrgr c dSrdrrencodingrrs rrz Angle.sortrgr c dSrdrres rrz Angle.sortrgr yearquartermonthweekday dayofyeardatehoursminutesseconds millisecondsc dSrdrres rtimeUnitzAngle.timeUnitrgr utcyear utcquarterutcmonthutcweekutcday utcdayofyearutcdateutchours utcminutes utcsecondsutcmillisecondsc dSrdrres rrzAngle.timeUnitrgr  yearquarteryearquartermonth yearmonth yearmonthdateyearmonthdatehoursyearmonthdatehoursminutes yearmonthdatehoursminutessecondsyearweek yearweekdayyearweekdayhoursyearweekdayhoursminutesyearweekdayhoursminutesseconds yeardayofyear quartermonth monthdatemonthdatehoursmonthdatehoursminutesmonthdatehoursminutessecondsweekday weeksdayhoursweekdayhoursminutesweekdayhoursminutessecondsdayhoursdayhoursminutesdayhoursminutesseconds hoursminuteshoursminutessecondsminutessecondssecondsmillisecondsc dSrdrres rrzAngle.timeUnitrgr utcyearquarterutcyearquartermonth utcyearmonthutcyearmonthdateutcyearmonthdatehoursutcyearmonthdatehoursminutes#utcyearmonthdatehoursminutesseconds utcyearweekutcyearweekdayutcyearweekdayhoursutcyearweekdayhoursminutes!utcyearweekdayhoursminutessecondsutcyeardayofyearutcquartermonth utcmonthdateutcmonthdatehoursutcmonthdatehoursminutesutcmonthdatehoursminutesseconds utcweekdayutcweeksdayhoursutcweekdayhoursminutesutcweekdayhoursminutesseconds utcdayhoursutcdayhoursminutesutcdayhoursminutessecondsutchoursminutesutchoursminutessecondsutcminutessecondsutcsecondsmillisecondsc dSrdrres rrzAngle.timeUnitrgr c dSrdrrrzr}unitutcrs rrzAngle.timeUnitrgr c dSrdrres rrz Angle.titlergr c dSrdrres rrz Angle.titlergr c dSrdrres rrz Angle.titlergr  quantitativeordinaltemporalnominalc dSrdrres rr"z Angle.typerpr c  btt|jd||||||||| | | | d | dSN) rrfrorrr@rrrrrrr"r)r2rI__init__rrrfrorrr@rrrrrrr"rrs rrpzAngle.__init__b $eT# ,i9[g(+yV\*/dXUZae , ,'+ , , , , ,r )rbrI)rKNrbrIr'r9r:__doc__ _class_is_valid_at_instantiation_encoding_namerr rfrfloatroboolrrr@r r ConditionalValueDefnumberExprRefr.rrrrDateTimerrr"rpr;r<s@rrIrIes3 __@(-$N  7$bc pw   X (    X (    X  e      T g   X "9Y_hr{FOV_fow@    X    X &i    X 'y     X  4 EF SZ   X  s w   X $    X # \et}LUajvHQ^gxAS\r{QZnwCLYbr{HQ]fr{KTen@ I V _ m v E N ] f u ~ P Y c l v  H Q Z c m v C L Z c p y LUgp~GV_oxENbkHU^jsAJR[hqHXanwCL\evQZgpBKZcqzIRYbkt}F    X    X #))9_hqzGP\eqzEN\eluHW`ox@IT]hq{DLU^gnw~G    X    X  d5k g   X  d3i G   X  d4j W   X  d4=) g   X  g78 W   X  gUV cj   X  gab ov   X "y     X %Y    X    X  '#PQ ^e   X  '#qr F   X  '#x y  F M    X  '#O P  ] d    X (yyi    X  s w   X  tCy W   X    X  gNO \c    "+ii]f$Iiy)99,,,,,,,,,,r rIc8eZdZdZdZdZdeddfdZee e fddZ ee e e fddZ ede e j ddfd Z ededdfd Zede eddfd Zedd ZdedddfdZe e e e ffd ZxZS) AngleDatumagAngleDatum schema wrapper Mapping(required=[]) Parameters ---------- bandPosition : float Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to ``0``, and at the middle of the band if set to ``0.5``. condition : anyOf(:class:`ConditionalValueDefnumberExprRef`, List(:class:`ConditionalValueDefnumberExprRef`)) One or more value definition(s) with `a parameter or a test predicate `__. **Note:** A field definition's ``condition`` property can only contain `conditional value definitions `__ since Vega-Lite only allows at most one encoded field per encoding channel. datum : anyOf(:class:`PrimitiveValue`, :class:`DateTime`, :class:`ExprRef`, :class:`RepeatRef`) A constant value in data domain. title : anyOf(:class:`Text`, None) A title for the field. If ``null``, the title will be removed. **Default value:** derived from the field's name and transformation function ( ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function, the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ). Otherwise, the title is simply the field name. **Notes** : 1) You can customize the default field title format by providing the `fieldTitle `__ property in the `config `__ or `fieldTitle function via the compile function's options `__. 2) If both field definition's ``title`` and axis, header, or legend ``title`` are defined, axis/header/legend title will be used. type : :class:`Type` The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also be a ``"geojson"`` type for encoding `'geoshape' `__. Vega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal scale for a field with ``bin`` or ``timeUnit``. **Default value:** 1) For a data ``field``, ``"nominal"`` is the default data type unless the field encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or ``timeUnit`` that satisfies the following criteria: * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin`` or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a quantitative scale `__. * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit`` or (2) the specified scale type is a time or utc scale * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort order `__, (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is ``order``. 2) For a constant value in data domain ( ``datum`` ): * ``"quantitative"`` if the datum is a number * ``"nominal"`` if the datum is a string * ``"temporal"`` if the datum is `a date time object `__ **Note:** * Data ``type`` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data. * Data values for a temporal field can be either a date-time string (e.g., ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a timestamp number (e.g., ``1552199579097`` ). * When using with `bin `__, the ``type`` property can be either ``"quantitative"`` (for using a linear bin scale) or `"ordinal" (for using an ordinal bin scale) `__. * When using with `timeUnit `__, the ``type`` property can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal" (for using an ordinal scale) `__. * When using with `aggregate `__, the ``type`` property refers to the post-aggregation data type. For example, we can calculate count ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct", "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``. * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have ``type`` as they must have exactly the same type as their primary channels (e.g., ``x``, ``y`` ). **See also:** `type `__ documentation. FrJrKrbc dSrdrres rrozAngleDatum.bandPositionQrpr c dSrdrrs rr@zAngleDatum.conditionTrgr c dSrdrrs rr@zAngleDatum.conditionXrgr c dSrdrres rr@zAngleDatum.condition\rgr c dSrdrres rrzAngleDatum.title`rgr c dSrdrres rrzAngleDatum.titledrgr Nc dSrdrres rrzAngleDatum.titlehrgr rirjrkrlgeojsonc dSrdrres rr"zAngleDatum.typelrpr c Ttt|jd|||||d|dSN)rGror@rr"r)r2r|rprrGror@rr"rrs rrpzAngleDatum.__init__pT(j$( Iu<[d/44 I ICG I I I I Ir )rbr|)rKNrbr|r'r9r:rtrurvrwrorrr@r rryr.rr r"rpr;r<s@rr|r|smm\(-$N e     &i    X 'y     X  4 EF S_   X  s |   X  tCy \   X    X  gYZ gs    ,5 QZIIIIIIIIIIr r|c VeZdZdZdZdZeeeeeeeeeeeef ddZeeeeeeeefddZeeeeeeeeeeeeef ddZeeeeeeeeefddZeeefdd Zeeeefdd Zed e e j ddfd Zeffd Z xZ S) AngleValueadAngleValue schema wrapper Mapping(required=[]) Parameters ---------- condition : anyOf(:class:`ConditionalMarkPropFieldOrDatumDef`, :class:`ConditionalValueDefnumberExprRef`, List(:class:`ConditionalValueDefnumberExprRef`)) A field definition or one or more value definition(s) with a parameter predicate. value : anyOf(float, :class:`ExprRef`) A constant value in visual domain (e.g., ``"red"`` / ``"#0099ff"`` / `gradient definition `__ for color, values between ``0`` to ``1`` for opacity). FrJrbc  dSrdr rrfrorrrrrrrrrr"rs rr@zAngleValue.conditionrgr c dSrdr rrorGrrrrr"rs rr@zAngleValue.conditionrgr c  dSrdrrrfrorrrrrrrrrrr"rs rr@zAngleValue.conditionrgr c  dSrdr rrorGrrrrrr"rs rr@zAngleValue.conditionrgr c dSrdrrs rr@zAngleValue.conditionrgr c dSrdrrs rr@zAngleValue.conditionrgr rKc dSrdrres rr@zAngleValue.conditionrgr c Ntt|jd||d|dSN)rr@r)r2rrprrr@rrs rrpzAngleValue.__init__3(j$(Ru RRTRRRRRr )rbrr'r9r:rtrurvrrr@r rryrpr;r<s@rrrvs4  (-$N "+)Zclu~GNW^gr{CLS\    X %.i Ybir{DKT    X "+)Zckt~GOX`ipyDMU^en    X %.iyYbjs|EMV]f    X &i    X 'y     X  4 EF S_   X )2SSSSSSSSSSr rcCeZdZdZdZdZededddfdZee fd4dZee fd4d Zde ddfd Z ede ddfd Z ee e e e e e e e e e f d4d Z ed5dZ ee e fd4dZee e e fd4dZedeejddfdZededdfdZee fd4dZee e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e fBd4dZed5dZee e e e e e e e e e e e e e e e e e e e e e e fd4dZed5dZedee ddfdZedeeddfdZedee ddfdZedeejddfdZededddfdZededddfdZeded ddfd!Zee e e fd4d"Zee e fd4d#Zed5d$Zeded%ddfd&Zeded'ddfd(Zeded)ddfd*Zeded+ddfd,Zee e e e fd4d-Zededdfd.Zedeeddfd/Zed5d0Zded1ddfd2Ze e e e e e e e e e e e f fd3 ZxZS)6Colora/Color schema wrapper Mapping(required=[shorthand]) Parameters ---------- shorthand : string shorthand for field, aggregate, and type aggregate : :class:`Aggregate` Aggregation function for the field (e.g., ``"mean"``, ``"sum"``, ``"median"``, ``"min"``, ``"max"``, ``"count"`` ). **Default value:** ``undefined`` (None) **See also:** `aggregate `__ documentation. bandPosition : float Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to ``0``, and at the middle of the band if set to ``0.5``. bin : anyOf(boolean, :class:`BinParams`, None) A flag for binning a ``quantitative`` field, `an object defining binning parameters `__, or indicating that the data for ``x`` or ``y`` channel are binned before they are imported into Vega-Lite ( ``"binned"`` ). If ``true``, default `binning parameters `__ will be applied. If ``"binned"``, this indicates that the data for the ``x`` (or ``y`` ) channel are already binned. You can map the bin-start field to ``x`` (or ``y`` ) and the bin-end field to ``x2`` (or ``y2`` ). The scale and axis will be formatted similar to binning in Vega-Lite. To adjust the axis ticks based on the bin step, you can also set the axis's `tickMinStep `__ property. **Default value:** ``false`` **See also:** `bin `__ documentation. condition : anyOf(:class:`ConditionalValueDefGradientstringnullExprRef`, List(:class:`ConditionalValueDefGradientstringnullExprRef`)) One or more value definition(s) with `a parameter or a test predicate `__. **Note:** A field definition's ``condition`` property can only contain `conditional value definitions `__ since Vega-Lite only allows at most one encoded field per encoding channel. field : :class:`Field` **Required.** A string defining the name of the field from which to pull a data value or an object defining iterated values from the `repeat `__ operator. **See also:** `field `__ documentation. **Notes:** 1) Dots ( ``.`` ) and brackets ( ``[`` and ``]`` ) can be used to access nested objects (e.g., ``"field": "foo.bar"`` and ``"field": "foo['bar']"`` ). If field names contain dots or brackets but are not nested, you can use ``\`` to escape dots and brackets (e.g., ``"a\.b"`` and ``"a\[0\]"`` ). See more details about escaping in the `field documentation `__. 2) ``field`` is not required if ``aggregate`` is ``count``. legend : anyOf(:class:`Legend`, None) An object defining properties of the legend. If ``null``, the legend for the encoding channel will be removed. **Default value:** If undefined, default `legend properties `__ are applied. **See also:** `legend `__ documentation. scale : anyOf(:class:`Scale`, None) An object defining properties of the channel's scale, which is the function that transforms values in the data domain (numbers, dates, strings, etc) to visual values (pixels, colors, sizes) of the encoding channels. If ``null``, the scale will be `disabled and the data value will be directly encoded `__. **Default value:** If undefined, default `scale properties `__ are applied. **See also:** `scale `__ documentation. sort : :class:`Sort` Sort order for the encoded field. For continuous fields (quantitative or temporal), ``sort`` can be either ``"ascending"`` or ``"descending"``. For discrete fields, ``sort`` can be one of the following: * ``"ascending"`` or ``"descending"`` -- for sorting by the values' natural order in JavaScript. * `A string indicating an encoding channel name to sort by `__ (e.g., ``"x"`` or ``"y"`` ) with an optional minus prefix for descending sort (e.g., ``"-x"`` to sort by x-field, descending). This channel string is short-form of `a sort-by-encoding definition `__. For example, ``"sort": "-x"`` is equivalent to ``"sort": {"encoding": "x", "order": "descending"}``. * `A sort field definition `__ for sorting by another field. * `An array specifying the field values in preferred order `__. In this case, the sort order will obey the values in the array, followed by any unspecified values in their original order. For discrete time field, values in the sort array can be `date-time definition objects `__. In addition, for time units ``"month"`` and ``"day"``, the values can be the month or day names (case insensitive) or their 3-letter initials (e.g., ``"Mon"``, ``"Tue"`` ). * ``null`` indicating no sort. **Default value:** ``"ascending"`` **Note:** ``null`` and sorting by another channel is not supported for ``row`` and ``column``. **See also:** `sort `__ documentation. timeUnit : anyOf(:class:`TimeUnit`, :class:`TimeUnitParams`) Time unit (e.g., ``year``, ``yearmonth``, ``month``, ``hours`` ) for a temporal field. or `a temporal field that gets casted as ordinal `__. **Default value:** ``undefined`` (None) **See also:** `timeUnit `__ documentation. title : anyOf(:class:`Text`, None) A title for the field. If ``null``, the title will be removed. **Default value:** derived from the field's name and transformation function ( ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function, the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ). Otherwise, the title is simply the field name. **Notes** : 1) You can customize the default field title format by providing the `fieldTitle `__ property in the `config `__ or `fieldTitle function via the compile function's options `__. 2) If both field definition's ``title`` and axis, header, or legend ``title`` are defined, axis/header/legend title will be used. type : :class:`StandardType` The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also be a ``"geojson"`` type for encoding `'geoshape' `__. Vega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal scale for a field with ``bin`` or ``timeUnit``. **Default value:** 1) For a data ``field``, ``"nominal"`` is the default data type unless the field encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or ``timeUnit`` that satisfies the following criteria: * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin`` or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a quantitative scale `__. * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit`` or (2) the specified scale type is a time or utc scale * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort order `__, (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is ``order``. 2) For a constant value in data domain ( ``datum`` ): * ``"quantitative"`` if the datum is a number * ``"nominal"`` if the datum is a string * ``"temporal"`` if the datum is `a date time object `__ **Note:** * Data ``type`` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data. * Data values for a temporal field can be either a date-time string (e.g., ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a timestamp number (e.g., ``1552199579097`` ). * When using with `bin `__, the ``type`` property can be either ``"quantitative"`` (for using a linear bin scale) or `"ordinal" (for using an ordinal bin scale) `__. * When using with `timeUnit `__, the ``type`` property can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal" (for using an ordinal scale) `__. * When using with `aggregate `__, the ``type`` property refers to the post-aggregation data type. For example, we can calculate count ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct", "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``. * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have ``type`` as they must have exactly the same type as their primary channels (e.g., ``x``, ``y`` ). **See also:** `type `__ documentation. FrrKrLrbc dSrdrres rrfzColor.aggregatergr c dSrdrris rrfzColor.aggregatergr c dSrdrrls rrfzColor.aggregatergr c dSrdrres rrozColor.bandPositionrpr c dSrdrres rrrz Color.binrgr c  dSrdrrts rrrz Color.binrgr Nc dSrdrres rrrz Color.binrgr c dSrdrrs rr@zColor.conditionrgr c dSrdrrs rr@zColor.conditionrgr c dSrdrres rr@zColor.conditionrgr c dSrdrres rrz Color.fieldrgr c dSrdrrs rrz Color.fieldrgr cC dSrdrrsD rrz Color.legendrgr c dSrdrres rrz Color.legendrgr c dSrdrrs rrz Color.scalergr c dSrdrres rrz Color.scalergr c dSrdrres rrz Color.sortrgr c dSrdrres rrz Color.sortrgr c dSrdrres rrz Color.sortrgr c dSrdrres rrz Color.sortrgr rc dSrdrres rrz Color.sortrgr rc dSrdrres rrz Color.sortrgr rc dSrdrres rrz Color.sortrgr c dSrdrrs rrz Color.sortrgr c dSrdrrs rrz Color.sortrgr c dSrdrres rrz Color.sortrgr rc dSrdrres rrzColor.timeUnitrgr rc dSrdrres rrzColor.timeUnitrgr r#c dSrdrres rrzColor.timeUnitrgr rBc dSrdrres rrzColor.timeUnitrgr c dSrdrrbs rrzColor.timeUnitrgr c dSrdrres rrz Color.title rgr c dSrdrres rrz Color.titlergr c dSrdrres rrz Color.titlergr rhc dSrdrres rr"z Color.typerpr c  btt|jd||||||||| | | | d | dSro)r2rrprqs rrpzColor.__init__rrr )rbr)rKNrbrr'r9r:rtrurvrr rfrrwrorxrrr@r r,ConditionalValueDefGradientstringnullExprRefr.rrrrrzrrr"rpr;r<s@rrrs3 __@(-$N  7$bc pw   X (    X (    X  e      T g   X "9Y_hr{FOV_fow@    X    X &i    X 'y     X  4 QR _f   X  s w   X $    X # \et}LUajvHQ^gxAS\r{QZnwCLYbr{HQ]fr{KTen@ I V _ m v E N ] f u ~ P Y c l v  H Q Z c m v C L Z c p y LUgp~GV_oxENbkHU^jsAJR[hqHXanwCL\evQZgpBKZcqzIRYbkt}F    X    X #))9_hqzGP\eqzEN\eluHW`ox@IT]hq{DLU^gnw~G    X    X  d5k g   X  d3i G   X  d4j W   X  d4=) g   X  g78 W   X  gUV cj   X  gab ov   X "y     X %Y    X    X  '#PQ ^e   X  '#qr F   X  '#x y  F M    X  '#O P  ] d    X (yyi    X  s w   X  tCy W   X    X  gNO \c    "+ii]f$Iiy)99,,,,,,,,,,r rc8eZdZdZdZdZdeddfdZee e fddZ ee e e fddZ ede e j ddfd Z ededdfd Zede eddfd Zedd ZdedddfdZe e e e ffd ZxZS) ColorDatumaColorDatum schema wrapper Mapping(required=[]) Parameters ---------- bandPosition : float Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to ``0``, and at the middle of the band if set to ``0.5``. condition : anyOf(:class:`ConditionalValueDefGradientstringnullExprRef`, List(:class:`ConditionalValueDefGradientstringnullExprRef`)) One or more value definition(s) with `a parameter or a test predicate `__. **Note:** A field definition's ``condition`` property can only contain `conditional value definitions `__ since Vega-Lite only allows at most one encoded field per encoding channel. datum : anyOf(:class:`PrimitiveValue`, :class:`DateTime`, :class:`ExprRef`, :class:`RepeatRef`) A constant value in data domain. title : anyOf(:class:`Text`, None) A title for the field. If ``null``, the title will be removed. **Default value:** derived from the field's name and transformation function ( ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function, the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ). Otherwise, the title is simply the field name. **Notes** : 1) You can customize the default field title format by providing the `fieldTitle `__ property in the `config `__ or `fieldTitle function via the compile function's options `__. 2) If both field definition's ``title`` and axis, header, or legend ``title`` are defined, axis/header/legend title will be used. type : :class:`Type` The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also be a ``"geojson"`` type for encoding `'geoshape' `__. Vega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal scale for a field with ``bin`` or ``timeUnit``. **Default value:** 1) For a data ``field``, ``"nominal"`` is the default data type unless the field encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or ``timeUnit`` that satisfies the following criteria: * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin`` or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a quantitative scale `__. * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit`` or (2) the specified scale type is a time or utc scale * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort order `__, (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is ``order``. 2) For a constant value in data domain ( ``datum`` ): * ``"quantitative"`` if the datum is a number * ``"nominal"`` if the datum is a string * ``"temporal"`` if the datum is `a date time object `__ **Note:** * Data ``type`` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data. * Data values for a temporal field can be either a date-time string (e.g., ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a timestamp number (e.g., ``1552199579097`` ). * When using with `bin `__, the ``type`` property can be either ``"quantitative"`` (for using a linear bin scale) or `"ordinal" (for using an ordinal bin scale) `__. * When using with `timeUnit `__, the ``type`` property can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal" (for using an ordinal scale) `__. * When using with `aggregate `__, the ``type`` property refers to the post-aggregation data type. For example, we can calculate count ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct", "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``. * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have ``type`` as they must have exactly the same type as their primary channels (e.g., ``x``, ``y`` ). **See also:** `type `__ documentation. FrrKrbc dSrdrres rrozColorDatum.bandPositionrpr c dSrdrrs rr@zColorDatum.conditionrgr c dSrdrrs rr@zColorDatum.conditionrgr c dSrdrres rr@zColorDatum.conditionrgr c dSrdrres rrzColorDatum.titlergr c dSrdrres rrzColorDatum.titlergr Nc dSrdrres rrzColorDatum.titlergr rc dSrdrres rr"zColorDatum.typerpr c Ttt|jd|||||d|dSr)r2rrprs rrpzColorDatum.__init__rr )rbr)rKNrbrr'r9r:rtrurvrwrorrr@r rrr.rr r"rpr;r<s@rrr#smm\(-$N e     &i    X 'y     X  4 QR _k   X  s |   X  tCy \   X    X  gYZ gs    ,5 QZIIIIIIIIIIr rc VeZdZdZdZdZeeeeeeeeeeeef ddZeeeeeeeefddZeeeeeeeeeeeeef ddZeeeeeeeeefddZeeefdd Zeeeefdd Zed e e j ddfd Zeffd Z xZ S) ColorValueaColorValue schema wrapper Mapping(required=[]) Parameters ---------- condition : anyOf(:class:`ConditionalMarkPropFieldOrDatumDef`, :class:`ConditionalValueDefGradientstringnullExprRef`, List(:class:`ConditionalValueDefGradientstringnullExprRef`)) A field definition or one or more value definition(s) with a parameter predicate. value : anyOf(:class:`Gradient`, string, None, :class:`ExprRef`) A constant value in visual domain (e.g., ``"red"`` / ``"#0099ff"`` / `gradient definition `__ for color, values between ``0`` to ``1`` for opacity). Frrbc  dSrdrrs rr@zColorValue.conditionrgr c dSrdrrs rr@zColorValue.conditionrgr c  dSrdrrs rr@zColorValue.conditionrgr c  dSrdrrs rr@zColorValue.conditionrgr c dSrdrrs rr@zColorValue.conditionrgr c dSrdrrs rr@zColorValue.conditionrgr rKc dSrdrres rr@zColorValue.conditionrgr c Ntt|jd||d|dSr)r2rrprs rrpzColorValue.__init__rr )rbrr'r9r:rtrurvrrr@r rrrpr;r<s@rrrs4  (-$N "+)Zclu~GNW^gr{CLS\    X %.i Ybir{DKT    X "+)Zckt~GOX`ipyDMU^en    X %.iyYbjs|EMV]f    X &i    X 'y     X  4 QR _k   X )2SSSSSSSSSSr rc!zeZdZdZdZdZededddfdZee fd.dZee fd.d Zded ddfd Z de ddfd Z ede ddfd Zee e e e e e e e e e f d.dZed/dZde ddfdZededdfdZee fd.dZee e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e f d.dZed/dZedee ddfdZedeeddfdZedee ddfdZedeejddfdZededddfdZee e e fd.dZed/dZde ddfdZededddfd Zeded!ddfd"Zeded#ddfd$Zeded%ddfd&Zee e e e fd.d'Zededdfd(Zedeeddfd)Zed/d*Zded+ddfd,Ze e e e e e e e e e e e e f fd- ZxZS)0Columna+Column schema wrapper Mapping(required=[shorthand]) Parameters ---------- shorthand : string shorthand for field, aggregate, and type aggregate : :class:`Aggregate` Aggregation function for the field (e.g., ``"mean"``, ``"sum"``, ``"median"``, ``"min"``, ``"max"``, ``"count"`` ). **Default value:** ``undefined`` (None) **See also:** `aggregate `__ documentation. align : :class:`LayoutAlign` The alignment to apply to row/column facet's subplot. The supported string values are ``"all"``, ``"each"``, and ``"none"``. * For ``"none"``, a flow layout will be used, in which adjacent subviews are simply placed one after the other. * For ``"each"``, subviews will be aligned into a clean grid structure, but each row or column may be of variable size. * For ``"all"``, subviews will be aligned and each row or column will be sized identically based on the maximum observed size. String values for this property will be applied to both grid rows and columns. **Default value:** ``"all"``. bandPosition : float Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to ``0``, and at the middle of the band if set to ``0.5``. bin : anyOf(boolean, :class:`BinParams`, None) A flag for binning a ``quantitative`` field, `an object defining binning parameters `__, or indicating that the data for ``x`` or ``y`` channel are binned before they are imported into Vega-Lite ( ``"binned"`` ). If ``true``, default `binning parameters `__ will be applied. If ``"binned"``, this indicates that the data for the ``x`` (or ``y`` ) channel are already binned. You can map the bin-start field to ``x`` (or ``y`` ) and the bin-end field to ``x2`` (or ``y2`` ). The scale and axis will be formatted similar to binning in Vega-Lite. To adjust the axis ticks based on the bin step, you can also set the axis's `tickMinStep `__ property. **Default value:** ``false`` **See also:** `bin `__ documentation. center : boolean Boolean flag indicating if facet's subviews should be centered relative to their respective rows or columns. **Default value:** ``false`` field : :class:`Field` **Required.** A string defining the name of the field from which to pull a data value or an object defining iterated values from the `repeat `__ operator. **See also:** `field `__ documentation. **Notes:** 1) Dots ( ``.`` ) and brackets ( ``[`` and ``]`` ) can be used to access nested objects (e.g., ``"field": "foo.bar"`` and ``"field": "foo['bar']"`` ). If field names contain dots or brackets but are not nested, you can use ``\`` to escape dots and brackets (e.g., ``"a\.b"`` and ``"a\[0\]"`` ). See more details about escaping in the `field documentation `__. 2) ``field`` is not required if ``aggregate`` is ``count``. header : anyOf(:class:`Header`, None) An object defining properties of a facet's header. sort : anyOf(:class:`SortArray`, :class:`SortOrder`, :class:`EncodingSortField`, None) Sort order for the encoded field. For continuous fields (quantitative or temporal), ``sort`` can be either ``"ascending"`` or ``"descending"``. For discrete fields, ``sort`` can be one of the following: * ``"ascending"`` or ``"descending"`` -- for sorting by the values' natural order in JavaScript. * `A sort field definition `__ for sorting by another field. * `An array specifying the field values in preferred order `__. In this case, the sort order will obey the values in the array, followed by any unspecified values in their original order. For discrete time field, values in the sort array can be `date-time definition objects `__. In addition, for time units ``"month"`` and ``"day"``, the values can be the month or day names (case insensitive) or their 3-letter initials (e.g., ``"Mon"``, ``"Tue"`` ). * ``null`` indicating no sort. **Default value:** ``"ascending"`` **Note:** ``null`` is not supported for ``row`` and ``column``. spacing : float The spacing in pixels between facet's sub-views. **Default value** : Depends on ``"spacing"`` property of `the view composition configuration `__ ( ``20`` by default) timeUnit : anyOf(:class:`TimeUnit`, :class:`TimeUnitParams`) Time unit (e.g., ``year``, ``yearmonth``, ``month``, ``hours`` ) for a temporal field. or `a temporal field that gets casted as ordinal `__. **Default value:** ``undefined`` (None) **See also:** `timeUnit `__ documentation. title : anyOf(:class:`Text`, None) A title for the field. If ``null``, the title will be removed. **Default value:** derived from the field's name and transformation function ( ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function, the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ). Otherwise, the title is simply the field name. **Notes** : 1) You can customize the default field title format by providing the `fieldTitle `__ property in the `config `__ or `fieldTitle function via the compile function's options `__. 2) If both field definition's ``title`` and axis, header, or legend ``title`` are defined, axis/header/legend title will be used. type : :class:`StandardType` The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also be a ``"geojson"`` type for encoding `'geoshape' `__. Vega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal scale for a field with ``bin`` or ``timeUnit``. **Default value:** 1) For a data ``field``, ``"nominal"`` is the default data type unless the field encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or ``timeUnit`` that satisfies the following criteria: * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin`` or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a quantitative scale `__. * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit`` or (2) the specified scale type is a time or utc scale * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort order `__, (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is ``order``. 2) For a constant value in data domain ( ``datum`` ): * ``"quantitative"`` if the datum is a number * ``"nominal"`` if the datum is a string * ``"temporal"`` if the datum is `a date time object `__ **Note:** * Data ``type`` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data. * Data values for a temporal field can be either a date-time string (e.g., ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a timestamp number (e.g., ``1552199579097`` ). * When using with `bin `__, the ``type`` property can be either ``"quantitative"`` (for using a linear bin scale) or `"ordinal" (for using an ordinal bin scale) `__. * When using with `timeUnit `__, the ``type`` property can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal" (for using an ordinal scale) `__. * When using with `aggregate `__, the ``type`` property refers to the post-aggregation data type. For example, we can calculate count ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct", "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``. * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have ``type`` as they must have exactly the same type as their primary channels (e.g., ``x``, ``y`` ). **See also:** `type `__ documentation. FcolumnrKrLrbc dSrdrres rrfzColumn.aggregatergr c dSrdrris rrfzColumn.aggregatergr c dSrdrrls rrfzColumn.aggregatergr alleachnonec dSrdrres rrz Column.alignrpr c dSrdrres rrozColumn.bandPositionrpr c dSrdrres rrrz Column.binrgr c  dSrdrrts rrrz Column.binrgr Nc dSrdrres rrrz Column.binrgr c dSrdrres rcenterz Column.centerrpr c dSrdrres rrz Column.fieldrgr c dSrdrrs rrz Column.fieldrgr c! dSrdr"rr&rr labelAnchor labelAnglerrrrrrrrlabelLineHeight labelOrientrlabelsrrrr titleAnglerrrrrrrrrrrs" rheaderz Column.headerrgr c dSrdrres rrz Column.headerrgr c dSrdrres rrz Column.sortrgr c dSrdrres rrz Column.sortrgr c dSrdrres rrz Column.sortrgr c dSrdrres rrz Column.sortrgr rc dSrdrres rrz Column.sortrgr c dSrdrrs rrz Column.sort rgr c dSrdrres rrz Column.sortrgr c dSrdrres rspacingzColumn.spacingrpr rc dSrdrres rrzColumn.timeUnitrgr rc dSrdrres rrzColumn.timeUnitrgr r#c dSrdrres rrzColumn.timeUnitrgr rBc dSrdrres rrzColumn.timeUnit"rgr c dSrdrrbs rrzColumn.timeUnit&rgr c dSrdrres rrz Column.title*rgr c dSrdrres rrz Column.title.rgr c dSrdrres rrz Column.title2rgr rhc dSrdrres rr"z Column.type6rpr c dtt|jd||||||||| | | | | d |dSN) rrfrrorrrrrrrrrr"r)r2rrprrrfrrorrrrrrrrrr"rrs rrpzColumn.__init__:so %fd$ EyIUZ2>CPV^c,2wYa+0t E E@D E E E E Er )rbr)rKNrbrr'r9r:rtrurvrr rfrrrwrorxrrrr.rrr rrrzrrrr"rpr;r<s@rrrsQQd(-$N  7$bc px   X (    X (    X  w45 (     e      T h   X "9Y_hr{FOV_fow@    X    X        s x   X $    X %) _hu~OXenzCOXhqBK]fs|NWen}FOXajr{HQ_hu~NWdmyB R [ l u G P ] f x A O X g p     X    X  d5k h   X  d3i H   X  d4j X   X  d4=) h   X  g78 X   X "y     X    X   8     '#PQ ^f   X  '#qr G   X  '#x y  F N    X  '#O P  ] e    X (yyi    X  s x   X  tCy X   X    X  gNO \d    "+iy'YyPY! 9y yEEEEEEEEEEr rc eZdZdZdZdZededddfdZee fd'dZee fd'd Zde ddfd Z ede ddfd Z ee e e e e e e e e e f d'd Z ededdfd Z ed(dZ ee e fd'dZee e e fd'dZedeejddfdZededdfdZee fd'dZededdfdZededdfdZdeddfdZededddfdZededddfdZededddfdZededddfdZee e e e fd'd Zededdfd!Zedeeddfd"Zed(d#Zded$ddfd%Ze e e e e e e e e e e f fd& ZxZS)) Descriptiona)Description schema wrapper Mapping(required=[shorthand]) Parameters ---------- shorthand : string shorthand for field, aggregate, and type aggregate : :class:`Aggregate` Aggregation function for the field (e.g., ``"mean"``, ``"sum"``, ``"median"``, ``"min"``, ``"max"``, ``"count"`` ). **Default value:** ``undefined`` (None) **See also:** `aggregate `__ documentation. bandPosition : float Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to ``0``, and at the middle of the band if set to ``0.5``. bin : anyOf(boolean, :class:`BinParams`, string, None) A flag for binning a ``quantitative`` field, `an object defining binning parameters `__, or indicating that the data for ``x`` or ``y`` channel are binned before they are imported into Vega-Lite ( ``"binned"`` ). If ``true``, default `binning parameters `__ will be applied. If ``"binned"``, this indicates that the data for the ``x`` (or ``y`` ) channel are already binned. You can map the bin-start field to ``x`` (or ``y`` ) and the bin-end field to ``x2`` (or ``y2`` ). The scale and axis will be formatted similar to binning in Vega-Lite. To adjust the axis ticks based on the bin step, you can also set the axis's `tickMinStep `__ property. **Default value:** ``false`` **See also:** `bin `__ documentation. condition : anyOf(:class:`ConditionalValueDefstringExprRef`, List(:class:`ConditionalValueDefstringExprRef`)) One or more value definition(s) with `a parameter or a test predicate `__. **Note:** A field definition's ``condition`` property can only contain `conditional value definitions `__ since Vega-Lite only allows at most one encoded field per encoding channel. field : :class:`Field` **Required.** A string defining the name of the field from which to pull a data value or an object defining iterated values from the `repeat `__ operator. **See also:** `field `__ documentation. **Notes:** 1) Dots ( ``.`` ) and brackets ( ``[`` and ``]`` ) can be used to access nested objects (e.g., ``"field": "foo.bar"`` and ``"field": "foo['bar']"`` ). If field names contain dots or brackets but are not nested, you can use ``\`` to escape dots and brackets (e.g., ``"a\.b"`` and ``"a\[0\]"`` ). See more details about escaping in the `field documentation `__. 2) ``field`` is not required if ``aggregate`` is ``count``. format : anyOf(string, :class:`Dict`) When used with the default ``"number"`` and ``"time"`` format type, the text formatting pattern for labels of guides (axes, legends, headers) and text marks. * If the format type is ``"number"`` (e.g., for quantitative fields), this is D3's `number format pattern `__. * If the format type is ``"time"`` (e.g., for temporal fields), this is D3's `time format pattern `__. See the `format documentation `__ for more examples. When used with a `custom formatType `__, this value will be passed as ``format`` alongside ``datum.value`` to the registered function. **Default value:** Derived from `numberFormat `__ config for number format and from `timeFormat `__ config for time format. formatType : string The format type for labels. One of ``"number"``, ``"time"``, or a `registered custom format type `__. **Default value:** * ``"time"`` for temporal fields and ordinal and nominal fields with ``timeUnit``. * ``"number"`` for quantitative fields as well as ordinal and nominal fields without ``timeUnit``. timeUnit : anyOf(:class:`TimeUnit`, :class:`TimeUnitParams`) Time unit (e.g., ``year``, ``yearmonth``, ``month``, ``hours`` ) for a temporal field. or `a temporal field that gets casted as ordinal `__. **Default value:** ``undefined`` (None) **See also:** `timeUnit `__ documentation. title : anyOf(:class:`Text`, None) A title for the field. If ``null``, the title will be removed. **Default value:** derived from the field's name and transformation function ( ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function, the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ). Otherwise, the title is simply the field name. **Notes** : 1) You can customize the default field title format by providing the `fieldTitle `__ property in the `config `__ or `fieldTitle function via the compile function's options `__. 2) If both field definition's ``title`` and axis, header, or legend ``title`` are defined, axis/header/legend title will be used. type : :class:`StandardType` The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also be a ``"geojson"`` type for encoding `'geoshape' `__. Vega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal scale for a field with ``bin`` or ``timeUnit``. **Default value:** 1) For a data ``field``, ``"nominal"`` is the default data type unless the field encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or ``timeUnit`` that satisfies the following criteria: * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin`` or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a quantitative scale `__. * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit`` or (2) the specified scale type is a time or utc scale * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort order `__, (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is ``order``. 2) For a constant value in data domain ( ``datum`` ): * ``"quantitative"`` if the datum is a number * ``"nominal"`` if the datum is a string * ``"temporal"`` if the datum is `a date time object `__ **Note:** * Data ``type`` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data. * Data values for a temporal field can be either a date-time string (e.g., ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a timestamp number (e.g., ``1552199579097`` ). * When using with `bin `__, the ``type`` property can be either ``"quantitative"`` (for using a linear bin scale) or `"ordinal" (for using an ordinal bin scale) `__. * When using with `timeUnit `__, the ``type`` property can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal" (for using an ordinal scale) `__. * When using with `aggregate `__, the ``type`` property refers to the post-aggregation data type. For example, we can calculate count ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct", "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``. * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have ``type`` as they must have exactly the same type as their primary channels (e.g., ``x``, ``y`` ). **See also:** `type `__ documentation. FrrKrLrbc dSrdrres rrfzDescription.aggregatergr c dSrdrris rrfzDescription.aggregatergr c dSrdrrls rrfzDescription.aggregatergr c dSrdrres rrozDescription.bandPositionrpr c dSrdrres rrrzDescription.binrgr c  dSrdrrts rrrzDescription.bin!rgr c dSrdrres rrrzDescription.bin%rgr Nc dSrdrres rrrzDescription.bin)rgr c dSrdrrs rr@zDescription.condition-rgr c dSrdrrs rr@zDescription.condition1rgr c dSrdrres rr@zDescription.condition5rgr c dSrdrres rrzDescription.field9rgr c dSrdrrs rrzDescription.field=rgr c dSrdrres rr&zDescription.formatArgr c dSrdrres rr&zDescription.formatErgr c dSrdrres rrzDescription.formatTypeIrpr rc dSrdrres rrzDescription.timeUnitLrgr rc dSrdrres rrzDescription.timeUnitPrgr r#c dSrdrres rrzDescription.timeUnitTrgr rBc dSrdrres rrzDescription.timeUnitXrgr c dSrdrrbs rrzDescription.timeUnit\rgr c dSrdrres rrzDescription.title`rgr c dSrdrres rrzDescription.titledrgr c dSrdrres rrzDescription.titlehrgr rhc dSrdrres rr"zDescription.typelrpr c  `tt|jd||||||||| | | d | dSN) rrfrorrr@rr&rrrr"r)r2rrprrrfrorrr@rr&rrrr"rrs rrpzDescription.__init__psi *k4  ) ]I7CXa05fQ[3;5t ] ]X\ ] ] ] ] ]r )rbr)rKNrbrr'r9r:rtrurvrr rfrrwrorxrrr.r@r r ConditionalValueDefstringExprRefrr&dictrrrr"rpr;r<s@rrrDs-DDJ(-$"N  7$bc p}   X (    X (    X  e      T m   X "9Y_hr{FOV_fow@    X  S ]   X    X &i    X 'y     X  4 EF S`   X  s }   X $    X      X      X  C M     '#PQ ^k   X  '#qr L   X  '#x y  F S    X  '#O P  ] j    X (yyi    X  s }   X  tCy ]   X    X  gNO \i    "+ii]f$IiT]#99]]]]]]]]]]r rc VeZdZdZdZdZeeeeeeeeeeeef ddZeeeeeeeefddZeeeeeeeeeeeeef ddZeeeeeeeeefddZeeefdd Zeeeefdd Zed e e j ddfd Zeffd Z xZ S)DescriptionValueayDescriptionValue schema wrapper Mapping(required=[]) Parameters ---------- condition : anyOf(:class:`ConditionalMarkPropFieldOrDatumDef`, :class:`ConditionalValueDefstringnullExprRef`, List(:class:`ConditionalValueDefstringnullExprRef`)) A field definition or one or more value definition(s) with a parameter predicate. value : anyOf(string, None, :class:`ExprRef`) A constant value in visual domain (e.g., ``"red"`` / ``"#0099ff"`` / `gradient definition `__ for color, values between ``0`` to ``1`` for opacity). Frrbc  dSrdrrs rr@zDescriptionValue.conditionrgr c dSrdrrs rr@zDescriptionValue.conditionrgr c  dSrdrrs rr@zDescriptionValue.conditionrgr c  dSrdrrs rr@zDescriptionValue.conditionrgr c dSrdrrs rr@zDescriptionValue.conditionrgr c dSrdrrs rr@zDescriptionValue.conditionrgr rKc dSrdrres rr@zDescriptionValue.conditionrgr c Ntt|jd||d|dSr)r2r2rprs rrpzDescriptionValue.__init__5.%%.XUiXXSWXXXXXr )rbr2r'r9r:rtrurvrrr@r r$ConditionalValueDefstringnullExprRefrpr;r<s@rr2r2ys4  (-$"N "+)Zclu~GNW^gr{CLS\    X %.i Ybir{DKT    X "+)Zckt~GOX`ipyDMU^en    X %.iyYbjs|EMV]f    X &i    X 'y     X  4 IJ Wi   X )2YYYYYYYYYYr r2c eZdZdZdZdZededddfdZee fd!dZee fd!d Zde ddfd Z ede ddfd Z ee e e e e e e e e e f d!d Z ededdfd Z ed"dZ ededdfdZee fd!dZededddfdZededddfdZededddfdZededddfdZee e e e fd!dZededdfdZedeeddfdZed"dZdedddfdZe e e e e e e e ffd ZxZS)#Detailau!Detail schema wrapper Mapping(required=[shorthand]) Definition object for a data field, its type and transformation of an encoding channel. Parameters ---------- shorthand : string shorthand for field, aggregate, and type aggregate : :class:`Aggregate` Aggregation function for the field (e.g., ``"mean"``, ``"sum"``, ``"median"``, ``"min"``, ``"max"``, ``"count"`` ). **Default value:** ``undefined`` (None) **See also:** `aggregate `__ documentation. bandPosition : float Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to ``0``, and at the middle of the band if set to ``0.5``. bin : anyOf(boolean, :class:`BinParams`, string, None) A flag for binning a ``quantitative`` field, `an object defining binning parameters `__, or indicating that the data for ``x`` or ``y`` channel are binned before they are imported into Vega-Lite ( ``"binned"`` ). If ``true``, default `binning parameters `__ will be applied. If ``"binned"``, this indicates that the data for the ``x`` (or ``y`` ) channel are already binned. You can map the bin-start field to ``x`` (or ``y`` ) and the bin-end field to ``x2`` (or ``y2`` ). The scale and axis will be formatted similar to binning in Vega-Lite. To adjust the axis ticks based on the bin step, you can also set the axis's `tickMinStep `__ property. **Default value:** ``false`` **See also:** `bin `__ documentation. field : :class:`Field` **Required.** A string defining the name of the field from which to pull a data value or an object defining iterated values from the `repeat `__ operator. **See also:** `field `__ documentation. **Notes:** 1) Dots ( ``.`` ) and brackets ( ``[`` and ``]`` ) can be used to access nested objects (e.g., ``"field": "foo.bar"`` and ``"field": "foo['bar']"`` ). If field names contain dots or brackets but are not nested, you can use ``\`` to escape dots and brackets (e.g., ``"a\.b"`` and ``"a\[0\]"`` ). See more details about escaping in the `field documentation `__. 2) ``field`` is not required if ``aggregate`` is ``count``. timeUnit : anyOf(:class:`TimeUnit`, :class:`TimeUnitParams`) Time unit (e.g., ``year``, ``yearmonth``, ``month``, ``hours`` ) for a temporal field. or `a temporal field that gets casted as ordinal `__. **Default value:** ``undefined`` (None) **See also:** `timeUnit `__ documentation. title : anyOf(:class:`Text`, None) A title for the field. If ``null``, the title will be removed. **Default value:** derived from the field's name and transformation function ( ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function, the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ). Otherwise, the title is simply the field name. **Notes** : 1) You can customize the default field title format by providing the `fieldTitle `__ property in the `config `__ or `fieldTitle function via the compile function's options `__. 2) If both field definition's ``title`` and axis, header, or legend ``title`` are defined, axis/header/legend title will be used. type : :class:`StandardType` The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also be a ``"geojson"`` type for encoding `'geoshape' `__. Vega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal scale for a field with ``bin`` or ``timeUnit``. **Default value:** 1) For a data ``field``, ``"nominal"`` is the default data type unless the field encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or ``timeUnit`` that satisfies the following criteria: * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin`` or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a quantitative scale `__. * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit`` or (2) the specified scale type is a time or utc scale * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort order `__, (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is ``order``. 2) For a constant value in data domain ( ``datum`` ): * ``"quantitative"`` if the datum is a number * ``"nominal"`` if the datum is a string * ``"temporal"`` if the datum is `a date time object `__ **Note:** * Data ``type`` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data. * Data values for a temporal field can be either a date-time string (e.g., ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a timestamp number (e.g., ``1552199579097`` ). * When using with `bin `__, the ``type`` property can be either ``"quantitative"`` (for using a linear bin scale) or `"ordinal" (for using an ordinal bin scale) `__. * When using with `timeUnit `__, the ``type`` property can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal" (for using an ordinal scale) `__. * When using with `aggregate `__, the ``type`` property refers to the post-aggregation data type. For example, we can calculate count ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct", "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``. * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have ``type`` as they must have exactly the same type as their primary channels (e.g., ``x``, ``y`` ). **See also:** `type `__ documentation. FdetailrKrLrbc dSrdrres rrfzDetail.aggregateOrgr c dSrdrris rrfzDetail.aggregateSrgr c dSrdrrls rrfzDetail.aggregateWrgr c dSrdrres rrozDetail.bandPosition[rpr c dSrdrres rrrz Detail.bin^rgr c  dSrdrrts rrrz Detail.binbrgr c dSrdrres rrrz Detail.binfrgr Nc dSrdrres rrrz Detail.binjrgr c dSrdrres rrz Detail.fieldnrgr c dSrdrrs rrz Detail.fieldrrgr rc dSrdrres rrzDetail.timeUnitvrgr rc dSrdrres rrzDetail.timeUnitzrgr r#c dSrdrres rrzDetail.timeUnit~rgr rBc dSrdrres rrzDetail.timeUnitrgr c dSrdrrbs rrzDetail.timeUnitrgr c dSrdrres rrz Detail.titlergr c dSrdrres rrz Detail.titlergr c dSrdrres rrz Detail.titlergr rhc dSrdrres rr"z Detail.typerpr c Ztt|jd||||||||d| dSN)rrfrorrrrrr"r)r2r?rp rrrfrorrrrrr"rrs rrpzDetail.__init__s[$fd$ EyI2>Cu_g+0t E E?C E E E E Er )rbr?)rKNrbr?r'r9r:rtrurvrr rfrrwrorxrrr.rrrr r"rpr;r<s@rr?r?s\\z(-$N  7$bc px   X (    X (    X  e      T h   X "9Y_hr{FOV_fow@    X  S X   X    X  s x   X $    X  '#PQ ^f   X  '#qr G   X  '#x y  F N    X  '#O P  ] e    X (yyi    X  s x   X  tCy X   X    X  gNO \d    "+ii]f 9IIEEEEEEEEEEr r?c!4eZdZdZdZdZededddfdZee fd4dZee fd4d Zeded ddfd Z ee e fd4d Z de ddfd Z ede ddfdZee e e e e e e e e e f d4dZed5dZdedddfdZede ddfdZee e fd4dZde ddfdZededdfdZee fd4dZee e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e f d4dZed5dZedee ddfdZedeeddfdZedee ddfdZedeejddfdZededddfd Zee e e fd4d!Zed5d"Zede ddfd#Zee e fd4d$Zeded%ddfd&Zeded'ddfd(Zeded)ddfd*Zeded+ddfd,Zee e e e fd4d-Zededdfd.Zedeeddfd/Zed5d0Zded1ddfd2Ze e e e e e e e e e e e e e e ffd3 ZxZS)6Faceta 3Facet schema wrapper Mapping(required=[shorthand]) Parameters ---------- shorthand : string shorthand for field, aggregate, and type aggregate : :class:`Aggregate` Aggregation function for the field (e.g., ``"mean"``, ``"sum"``, ``"median"``, ``"min"``, ``"max"``, ``"count"`` ). **Default value:** ``undefined`` (None) **See also:** `aggregate `__ documentation. align : anyOf(:class:`LayoutAlign`, :class:`RowColLayoutAlign`) The alignment to apply to grid rows and columns. The supported string values are ``"all"``, ``"each"``, and ``"none"``. * For ``"none"``, a flow layout will be used, in which adjacent subviews are simply placed one after the other. * For ``"each"``, subviews will be aligned into a clean grid structure, but each row or column may be of variable size. * For ``"all"``, subviews will be aligned and each row or column will be sized identically based on the maximum observed size. String values for this property will be applied to both grid rows and columns. Alternatively, an object value of the form ``{"row": string, "column": string}`` can be used to supply different alignments for rows and columns. **Default value:** ``"all"``. bandPosition : float Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to ``0``, and at the middle of the band if set to ``0.5``. bin : anyOf(boolean, :class:`BinParams`, None) A flag for binning a ``quantitative`` field, `an object defining binning parameters `__, or indicating that the data for ``x`` or ``y`` channel are binned before they are imported into Vega-Lite ( ``"binned"`` ). If ``true``, default `binning parameters `__ will be applied. If ``"binned"``, this indicates that the data for the ``x`` (or ``y`` ) channel are already binned. You can map the bin-start field to ``x`` (or ``y`` ) and the bin-end field to ``x2`` (or ``y2`` ). The scale and axis will be formatted similar to binning in Vega-Lite. To adjust the axis ticks based on the bin step, you can also set the axis's `tickMinStep `__ property. **Default value:** ``false`` **See also:** `bin `__ documentation. bounds : enum('full', 'flush') The bounds calculation method to use for determining the extent of a sub-plot. One of ``full`` (the default) or ``flush``. * If set to ``full``, the entire calculated bounds (including axes, title, and legend) will be used. * If set to ``flush``, only the specified width and height values for the sub-view will be used. The ``flush`` setting can be useful when attempting to place sub-plots without axes or legends into a uniform grid structure. **Default value:** ``"full"`` center : anyOf(boolean, :class:`RowColboolean`) Boolean flag indicating if subviews should be centered relative to their respective rows or columns. An object value of the form ``{"row": boolean, "column": boolean}`` can be used to supply different centering values for rows and columns. **Default value:** ``false`` columns : float The number of columns to include in the view composition layout. **Default value** : ``undefined`` -- An infinite number of columns (a single row) will be assumed. This is equivalent to ``hconcat`` (for ``concat`` ) and to using the ``column`` channel (for ``facet`` and ``repeat`` ). **Note** : 1) This property is only for: * the general (wrappable) ``concat`` operator (not ``hconcat`` / ``vconcat`` ) * the ``facet`` and ``repeat`` operator with one field/repetition definition (without row/column nesting) 2) Setting the ``columns`` to ``1`` is equivalent to ``vconcat`` (for ``concat`` ) and to using the ``row`` channel (for ``facet`` and ``repeat`` ). field : :class:`Field` **Required.** A string defining the name of the field from which to pull a data value or an object defining iterated values from the `repeat `__ operator. **See also:** `field `__ documentation. **Notes:** 1) Dots ( ``.`` ) and brackets ( ``[`` and ``]`` ) can be used to access nested objects (e.g., ``"field": "foo.bar"`` and ``"field": "foo['bar']"`` ). If field names contain dots or brackets but are not nested, you can use ``\`` to escape dots and brackets (e.g., ``"a\.b"`` and ``"a\[0\]"`` ). See more details about escaping in the `field documentation `__. 2) ``field`` is not required if ``aggregate`` is ``count``. header : anyOf(:class:`Header`, None) An object defining properties of a facet's header. sort : anyOf(:class:`SortArray`, :class:`SortOrder`, :class:`EncodingSortField`, None) Sort order for the encoded field. For continuous fields (quantitative or temporal), ``sort`` can be either ``"ascending"`` or ``"descending"``. For discrete fields, ``sort`` can be one of the following: * ``"ascending"`` or ``"descending"`` -- for sorting by the values' natural order in JavaScript. * `A sort field definition `__ for sorting by another field. * `An array specifying the field values in preferred order `__. In this case, the sort order will obey the values in the array, followed by any unspecified values in their original order. For discrete time field, values in the sort array can be `date-time definition objects `__. In addition, for time units ``"month"`` and ``"day"``, the values can be the month or day names (case insensitive) or their 3-letter initials (e.g., ``"Mon"``, ``"Tue"`` ). * ``null`` indicating no sort. **Default value:** ``"ascending"`` **Note:** ``null`` is not supported for ``row`` and ``column``. spacing : anyOf(float, :class:`RowColnumber`) The spacing in pixels between sub-views of the composition operator. An object of the form ``{"row": number, "column": number}`` can be used to set different spacing values for rows and columns. **Default value** : Depends on ``"spacing"`` property of `the view composition configuration `__ ( ``20`` by default) timeUnit : anyOf(:class:`TimeUnit`, :class:`TimeUnitParams`) Time unit (e.g., ``year``, ``yearmonth``, ``month``, ``hours`` ) for a temporal field. or `a temporal field that gets casted as ordinal `__. **Default value:** ``undefined`` (None) **See also:** `timeUnit `__ documentation. title : anyOf(:class:`Text`, None) A title for the field. If ``null``, the title will be removed. **Default value:** derived from the field's name and transformation function ( ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function, the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ). Otherwise, the title is simply the field name. **Notes** : 1) You can customize the default field title format by providing the `fieldTitle `__ property in the `config `__ or `fieldTitle function via the compile function's options `__. 2) If both field definition's ``title`` and axis, header, or legend ``title`` are defined, axis/header/legend title will be used. type : :class:`StandardType` The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also be a ``"geojson"`` type for encoding `'geoshape' `__. Vega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal scale for a field with ``bin`` or ``timeUnit``. **Default value:** 1) For a data ``field``, ``"nominal"`` is the default data type unless the field encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or ``timeUnit`` that satisfies the following criteria: * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin`` or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a quantitative scale `__. * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit`` or (2) the specified scale type is a time or utc scale * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort order `__, (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is ``order``. 2) For a constant value in data domain ( ``datum`` ): * ``"quantitative"`` if the datum is a number * ``"nominal"`` if the datum is a string * ``"temporal"`` if the datum is `a date time object `__ **Note:** * Data ``type`` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data. * Data values for a temporal field can be either a date-time string (e.g., ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a timestamp number (e.g., ``1552199579097`` ). * When using with `bin `__, the ``type`` property can be either ``"quantitative"`` (for using a linear bin scale) or `"ordinal" (for using an ordinal bin scale) `__. * When using with `timeUnit `__, the ``type`` property can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal" (for using an ordinal scale) `__. * When using with `aggregate `__, the ``type`` property refers to the post-aggregation data type. For example, we can calculate count ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct", "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``. * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have ``type`` as they must have exactly the same type as their primary channels (e.g., ``x``, ``y`` ). **See also:** `type `__ documentation. FfacetrKrLrbc dSrdrres rrfzFacet.aggregate rgr c dSrdrris rrfzFacet.aggregate rgr c dSrdrrls rrfzFacet.aggregate rgr rc dSrdrres rrz Facet.align rgr c dSrdrrrrowrs rrz Facet.align rgr c dSrdrres rrozFacet.bandPosition rpr c dSrdrres rrrz Facet.bin rgr c  dSrdrrts rrrz Facet.bin rgr Nc dSrdrres rrrz Facet.bin rgr )fullflushc dSrdrres rboundsz Facet.bounds rpr c dSrdrres rrz Facet.center rgr c dSrdrr`s rrz Facet.center rgr c dSrdrres rrz Facet.columns rpr c dSrdrres rrz Facet.field rgr c dSrdrrs rrz Facet.field rgr c! dSrdrrs" rrz Facet.header rgr c dSrdrres rrz Facet.header rgr c dSrdrres rrz Facet.sort rgr c dSrdrres rrz Facet.sort rgr c dSrdrres rrz Facet.sort rgr c dSrdrres rrz Facet.sort rgr rc dSrdrres rrz Facet.sort rgr c dSrdrrs rrz Facet.sort rgr c dSrdrres rrz Facet.sort rgr c dSrdrres rrz Facet.spacing rgr c dSrdrr`s rrz Facet.spacing rgr rc dSrdrres rrzFacet.timeUnit rgr rc dSrdrres rrzFacet.timeUnit rgr r#c dSrdrres rrzFacet.timeUnit rgr rBc dSrdrres rrzFacet.timeUnit rgr c dSrdrrbs rrzFacet.timeUnit rgr c dSrdrres rrz Facet.title rgr c dSrdrres rrz Facet.title rgr c dSrdrres rrz Facet.title rgr rhc dSrdrres rr"z Facet.type# rpr c htt|jd||||||||| | | | | ||d|dS)N)rrfrrorrrirrrrrrrrr"r)r2rYrp)rrrfrrorrrirrrrrrrrr"rrs rrpzFacet.__init__' ss $eT# hi9TY1=3v^d,35VZ,3heZ^ h hcg h h h h hr )rbrY)rKNrbrY)r'r9r:rtrurvrr rfrrrwrorxrrrirrr.rrr rrrzrrrr"rpr;r<s@rrYrYswwp(-$N  7$bc pw   X (    X (    X  w45 '   X $)    X  e      T g   X "9Y_hr{FOV_fow@    X    X  0 W         X %9    X   7     s w   X $    X %) _hu~OXenzCOXhqBK]fs|NWen}FOXajr{HQ_hu~NWdmyB R [ l u G P ] f x A O X g p     X    X  d5k g   X  d3i G   X  d4j W   X  d4=) g   X  g78 W   X "y     X    X   7   X &I    X  '#PQ ^e   X  '#qr F   X  '#x y  F M    X  '#O P  ] d    X (yyi    X  s w   X  tCy W   X    X  gNO \c    "+iy'YyQZ")II"Yiihhhhhhhhhhr rYcCeZdZdZdZdZededddfdZee fd4dZee fd4d Zde ddfd Z ede ddfd Z ee e e e e e e e e e f d4d Z ed5dZ ee e fd4dZee e e fd4dZedeejddfdZededdfdZee fd4dZee e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e fBd4dZed5dZee e e e e e e e e e e e e e e e e e e e e e e fd4dZed5dZedee ddfdZedeeddfdZedee ddfdZedeejddfdZededddfdZededddfdZeded ddfd!Zee e e fd4d"Zee e fd4d#Zed5d$Zeded%ddfd&Zeded'ddfd(Zeded)ddfd*Zeded+ddfd,Zee e e e fd4d-Zededdfd.Zedeeddfd/Zed5d0Zded1ddfd2Ze e e e e e e e e e e e f fd3 ZxZS)6Filla/Fill schema wrapper Mapping(required=[shorthand]) Parameters ---------- shorthand : string shorthand for field, aggregate, and type aggregate : :class:`Aggregate` Aggregation function for the field (e.g., ``"mean"``, ``"sum"``, ``"median"``, ``"min"``, ``"max"``, ``"count"`` ). **Default value:** ``undefined`` (None) **See also:** `aggregate `__ documentation. bandPosition : float Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to ``0``, and at the middle of the band if set to ``0.5``. bin : anyOf(boolean, :class:`BinParams`, None) A flag for binning a ``quantitative`` field, `an object defining binning parameters `__, or indicating that the data for ``x`` or ``y`` channel are binned before they are imported into Vega-Lite ( ``"binned"`` ). If ``true``, default `binning parameters `__ will be applied. If ``"binned"``, this indicates that the data for the ``x`` (or ``y`` ) channel are already binned. You can map the bin-start field to ``x`` (or ``y`` ) and the bin-end field to ``x2`` (or ``y2`` ). The scale and axis will be formatted similar to binning in Vega-Lite. To adjust the axis ticks based on the bin step, you can also set the axis's `tickMinStep `__ property. **Default value:** ``false`` **See also:** `bin `__ documentation. condition : anyOf(:class:`ConditionalValueDefGradientstringnullExprRef`, List(:class:`ConditionalValueDefGradientstringnullExprRef`)) One or more value definition(s) with `a parameter or a test predicate `__. **Note:** A field definition's ``condition`` property can only contain `conditional value definitions `__ since Vega-Lite only allows at most one encoded field per encoding channel. field : :class:`Field` **Required.** A string defining the name of the field from which to pull a data value or an object defining iterated values from the `repeat `__ operator. **See also:** `field `__ documentation. **Notes:** 1) Dots ( ``.`` ) and brackets ( ``[`` and ``]`` ) can be used to access nested objects (e.g., ``"field": "foo.bar"`` and ``"field": "foo['bar']"`` ). If field names contain dots or brackets but are not nested, you can use ``\`` to escape dots and brackets (e.g., ``"a\.b"`` and ``"a\[0\]"`` ). See more details about escaping in the `field documentation `__. 2) ``field`` is not required if ``aggregate`` is ``count``. legend : anyOf(:class:`Legend`, None) An object defining properties of the legend. If ``null``, the legend for the encoding channel will be removed. **Default value:** If undefined, default `legend properties `__ are applied. **See also:** `legend `__ documentation. scale : anyOf(:class:`Scale`, None) An object defining properties of the channel's scale, which is the function that transforms values in the data domain (numbers, dates, strings, etc) to visual values (pixels, colors, sizes) of the encoding channels. If ``null``, the scale will be `disabled and the data value will be directly encoded `__. **Default value:** If undefined, default `scale properties `__ are applied. **See also:** `scale `__ documentation. sort : :class:`Sort` Sort order for the encoded field. For continuous fields (quantitative or temporal), ``sort`` can be either ``"ascending"`` or ``"descending"``. For discrete fields, ``sort`` can be one of the following: * ``"ascending"`` or ``"descending"`` -- for sorting by the values' natural order in JavaScript. * `A string indicating an encoding channel name to sort by `__ (e.g., ``"x"`` or ``"y"`` ) with an optional minus prefix for descending sort (e.g., ``"-x"`` to sort by x-field, descending). This channel string is short-form of `a sort-by-encoding definition `__. For example, ``"sort": "-x"`` is equivalent to ``"sort": {"encoding": "x", "order": "descending"}``. * `A sort field definition `__ for sorting by another field. * `An array specifying the field values in preferred order `__. In this case, the sort order will obey the values in the array, followed by any unspecified values in their original order. For discrete time field, values in the sort array can be `date-time definition objects `__. In addition, for time units ``"month"`` and ``"day"``, the values can be the month or day names (case insensitive) or their 3-letter initials (e.g., ``"Mon"``, ``"Tue"`` ). * ``null`` indicating no sort. **Default value:** ``"ascending"`` **Note:** ``null`` and sorting by another channel is not supported for ``row`` and ``column``. **See also:** `sort `__ documentation. timeUnit : anyOf(:class:`TimeUnit`, :class:`TimeUnitParams`) Time unit (e.g., ``year``, ``yearmonth``, ``month``, ``hours`` ) for a temporal field. or `a temporal field that gets casted as ordinal `__. **Default value:** ``undefined`` (None) **See also:** `timeUnit `__ documentation. title : anyOf(:class:`Text`, None) A title for the field. If ``null``, the title will be removed. **Default value:** derived from the field's name and transformation function ( ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function, the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ). Otherwise, the title is simply the field name. **Notes** : 1) You can customize the default field title format by providing the `fieldTitle `__ property in the `config `__ or `fieldTitle function via the compile function's options `__. 2) If both field definition's ``title`` and axis, header, or legend ``title`` are defined, axis/header/legend title will be used. type : :class:`StandardType` The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also be a ``"geojson"`` type for encoding `'geoshape' `__. Vega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal scale for a field with ``bin`` or ``timeUnit``. **Default value:** 1) For a data ``field``, ``"nominal"`` is the default data type unless the field encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or ``timeUnit`` that satisfies the following criteria: * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin`` or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a quantitative scale `__. * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit`` or (2) the specified scale type is a time or utc scale * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort order `__, (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is ``order``. 2) For a constant value in data domain ( ``datum`` ): * ``"quantitative"`` if the datum is a number * ``"nominal"`` if the datum is a string * ``"temporal"`` if the datum is `a date time object `__ **Note:** * Data ``type`` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data. * Data values for a temporal field can be either a date-time string (e.g., ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a timestamp number (e.g., ``1552199579097`` ). * When using with `bin `__, the ``type`` property can be either ``"quantitative"`` (for using a linear bin scale) or `"ordinal" (for using an ordinal bin scale) `__. * When using with `timeUnit `__, the ``type`` property can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal" (for using an ordinal scale) `__. * When using with `aggregate `__, the ``type`` property refers to the post-aggregation data type. For example, we can calculate count ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct", "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``. * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have ``type`` as they must have exactly the same type as their primary channels (e.g., ``x``, ``y`` ). **See also:** `type `__ documentation. FrrKrLrbc dSrdrres rrfzFill.aggregate rgr c dSrdrris rrfzFill.aggregate rgr c dSrdrrls rrfzFill.aggregate rgr c dSrdrres rrozFill.bandPosition" rpr c dSrdrres rrrzFill.bin% rgr c  dSrdrrts rrrzFill.bin) rgr Nc dSrdrres rrrzFill.bin- rgr c dSrdrrs rr@zFill.condition1 rgr c dSrdrrs rr@zFill.condition5 rgr c dSrdrres rr@zFill.condition9 rgr c dSrdrres rrz Fill.field= rgr c dSrdrrs rrz Fill.fieldA rgr cC dSrdrrsD rrz Fill.legendE rgr c dSrdrres rrz Fill.legendI rgr c dSrdrrs rrz Fill.scaleM rgr c dSrdrres rrz Fill.scaleQ rgr c dSrdrres rrz Fill.sortU rgr c dSrdrres rrz Fill.sortY rgr c dSrdrres rrz Fill.sort] rgr c dSrdrres rrz Fill.sorta rgr rc dSrdrres rrz Fill.sorte rgr rc dSrdrres rrz Fill.sorti rgr rc dSrdrres rrz Fill.sortm rgr c dSrdrrs rrz Fill.sortq rgr c dSrdrrs rrz Fill.sortu rgr c dSrdrres rrz Fill.sorty rgr rc dSrdrres rrz Fill.timeUnit} rgr rc dSrdrres rrz Fill.timeUnit rgr r#c dSrdrres rrz Fill.timeUnit rgr rBc dSrdrres rrz Fill.timeUnit rgr c dSrdrrbs rrz Fill.timeUnit rgr c dSrdrres rrz Fill.title rgr c dSrdrres rrz Fill.title rgr c dSrdrres rrz Fill.title rgr rhc dSrdrres rr"z Fill.type rpr c  btt|jd||||||||| | | | d | dSro)r2rrprqs rrpz Fill.__init__ b #dD" +Y)Zf'*iuU[).THTY`d + +&* + + + + +r )rbr)rKNrbrrr<s@rrr1 s3 __@(-$N  7$bc pv   X (    X (    X  e      T f   X "9Y_hr{FOV_fow@    X    X &i    X 'y     X  4 QR _e   X  s v   X $    X # \et}LUajvHQ^gxAS\r{QZnwCLYbr{HQ]fr{KTen@ I V _ m v E N ] f u ~ P Y c l v  H Q Z c m v C L Z c p y LUgp~GV_oxENbkHU^jsAJR[hqHXanwCL\evQZgpBKZcqzIRYbkt}F    X    X #))9_hqzGP\eqzEN\eluHW`ox@IT]hq{DLU^gnw~G    X    X  d5k f   X  d3i F   X  d4j V   X  d4=) f   X  g78 V   X  gUV ci   X  gab ou   X "y     X %Y    X    X  '#PQ ^d   X  '#qr E   X  '#x y  F L    X  '#O P  ] c    X (yyi    X  s v   X  tCy V   X    X  gNO \b    "+ii]f$Iiy)99++++++++++r rc8eZdZdZdZdZdeddfdZee e fddZ ee e e fddZ ede e j ddfd Z ededdfd Zede eddfd Zedd ZdedddfdZe e e e ffd ZxZS) FillDatuma~FillDatum schema wrapper Mapping(required=[]) Parameters ---------- bandPosition : float Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to ``0``, and at the middle of the band if set to ``0.5``. condition : anyOf(:class:`ConditionalValueDefGradientstringnullExprRef`, List(:class:`ConditionalValueDefGradientstringnullExprRef`)) One or more value definition(s) with `a parameter or a test predicate `__. **Note:** A field definition's ``condition`` property can only contain `conditional value definitions `__ since Vega-Lite only allows at most one encoded field per encoding channel. datum : anyOf(:class:`PrimitiveValue`, :class:`DateTime`, :class:`ExprRef`, :class:`RepeatRef`) A constant value in data domain. title : anyOf(:class:`Text`, None) A title for the field. If ``null``, the title will be removed. **Default value:** derived from the field's name and transformation function ( ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function, the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ). Otherwise, the title is simply the field name. **Notes** : 1) You can customize the default field title format by providing the `fieldTitle `__ property in the `config `__ or `fieldTitle function via the compile function's options `__. 2) If both field definition's ``title`` and axis, header, or legend ``title`` are defined, axis/header/legend title will be used. type : :class:`Type` The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also be a ``"geojson"`` type for encoding `'geoshape' `__. Vega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal scale for a field with ``bin`` or ``timeUnit``. **Default value:** 1) For a data ``field``, ``"nominal"`` is the default data type unless the field encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or ``timeUnit`` that satisfies the following criteria: * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin`` or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a quantitative scale `__. * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit`` or (2) the specified scale type is a time or utc scale * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort order `__, (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is ``order``. 2) For a constant value in data domain ( ``datum`` ): * ``"quantitative"`` if the datum is a number * ``"nominal"`` if the datum is a string * ``"temporal"`` if the datum is `a date time object `__ **Note:** * Data ``type`` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data. * Data values for a temporal field can be either a date-time string (e.g., ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a timestamp number (e.g., ``1552199579097`` ). * When using with `bin `__, the ``type`` property can be either ``"quantitative"`` (for using a linear bin scale) or `"ordinal" (for using an ordinal bin scale) `__. * When using with `timeUnit `__, the ``type`` property can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal" (for using an ordinal scale) `__. * When using with `aggregate `__, the ``type`` property refers to the post-aggregation data type. For example, we can calculate count ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct", "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``. * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have ``type`` as they must have exactly the same type as their primary channels (e.g., ``x``, ``y`` ). **See also:** `type `__ documentation. FrrKrbc dSrdrres rrozFillDatum.bandPosition rpr c dSrdrrs rr@zFillDatum.condition rgr c dSrdrrs rr@zFillDatum.condition$ rgr c dSrdrres rr@zFillDatum.condition( rgr c dSrdrres rrzFillDatum.title, rgr c dSrdrres rrzFillDatum.title0 rgr Nc dSrdrres rrzFillDatum.title4 rgr rc dSrdrres rr"zFillDatum.type8 rpr c Ttt|jd|||||d|dSr)r2rrprs rrpzFillDatum.__init__< T'i' He,Zc.3$ H HBF H H H H Hr )rbr)rKNrbrrr<s@rrr smm\(-$N e     &i    X 'y     X  4 QR _j   X  s {   X  tCy [   X    X  gYZ gr    ,5 QZHHHHHHHHHHr rc VeZdZdZdZdZeeeeeeeeeeeef ddZeeeeeeeefddZeeeeeeeeeeeeef ddZeeeeeeeeefddZeeefdd Zeeeefdd Zed e e j ddfd Zeffd Z xZ S) FillValueaFillValue schema wrapper Mapping(required=[]) Parameters ---------- condition : anyOf(:class:`ConditionalMarkPropFieldOrDatumDef`, :class:`ConditionalValueDefGradientstringnullExprRef`, List(:class:`ConditionalValueDefGradientstringnullExprRef`)) A field definition or one or more value definition(s) with a parameter predicate. value : anyOf(:class:`Gradient`, string, None, :class:`ExprRef`) A constant value in visual domain (e.g., ``"red"`` / ``"#0099ff"`` / `gradient definition `__ for color, values between ``0`` to ``1`` for opacity). Frrbc  dSrdrrs rr@zFillValue.conditionU rgr c dSrdrrs rr@zFillValue.conditionY rgr c  dSrdrrs rr@zFillValue.condition] rgr c  dSrdrrs rr@zFillValue.conditiona rgr c dSrdrrs rr@zFillValue.conditione rgr c dSrdrrs rr@zFillValue.conditioni rgr rKc dSrdrres rr@zFillValue.conditionm rgr c Ntt|jd||d|dSr)r2rrprs rrpzFillValue.__init__r 3'i'QeyQQDQQQQQr )rbrrr<s@rrrB s4  (-$N "+)Zclu~GNW^gr{CLS\    X %.i Ybir{DKT    X "+)Zckt~GOX`ipyDMU^en    X %.iyYbjs|EMV]f    X &i    X 'y     X  4 QR _j   X )2RRRRRRRRRRr rcCeZdZdZdZdZededddfdZee fd4dZee fd4d Zde ddfd Z ede ddfd Z ee e e e e e e e e e f d4d Z ed5dZ ee e fd4dZee e e fd4dZedeejddfdZededdfdZee fd4dZee e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e fBd4dZed5dZee e e e e e e e e e e e e e e e e e e e e e e fd4dZed5dZedee ddfdZedeeddfdZedee ddfdZedeejddfdZededddfdZededddfdZeded ddfd!Zee e e fd4d"Zee e fd4d#Zed5d$Zeded%ddfd&Zeded'ddfd(Zeded)ddfd*Zeded+ddfd,Zee e e e fd4d-Zededdfd.Zedeeddfd/Zed5d0Zded1ddfd2Ze e e e e e e e e e e e f fd3 ZxZS)6 FillOpacitya/FillOpacity schema wrapper Mapping(required=[shorthand]) Parameters ---------- shorthand : string shorthand for field, aggregate, and type aggregate : :class:`Aggregate` Aggregation function for the field (e.g., ``"mean"``, ``"sum"``, ``"median"``, ``"min"``, ``"max"``, ``"count"`` ). **Default value:** ``undefined`` (None) **See also:** `aggregate `__ documentation. bandPosition : float Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to ``0``, and at the middle of the band if set to ``0.5``. bin : anyOf(boolean, :class:`BinParams`, None) A flag for binning a ``quantitative`` field, `an object defining binning parameters `__, or indicating that the data for ``x`` or ``y`` channel are binned before they are imported into Vega-Lite ( ``"binned"`` ). If ``true``, default `binning parameters `__ will be applied. If ``"binned"``, this indicates that the data for the ``x`` (or ``y`` ) channel are already binned. You can map the bin-start field to ``x`` (or ``y`` ) and the bin-end field to ``x2`` (or ``y2`` ). The scale and axis will be formatted similar to binning in Vega-Lite. To adjust the axis ticks based on the bin step, you can also set the axis's `tickMinStep `__ property. **Default value:** ``false`` **See also:** `bin `__ documentation. condition : anyOf(:class:`ConditionalValueDefnumberExprRef`, List(:class:`ConditionalValueDefnumberExprRef`)) One or more value definition(s) with `a parameter or a test predicate `__. **Note:** A field definition's ``condition`` property can only contain `conditional value definitions `__ since Vega-Lite only allows at most one encoded field per encoding channel. field : :class:`Field` **Required.** A string defining the name of the field from which to pull a data value or an object defining iterated values from the `repeat `__ operator. **See also:** `field `__ documentation. **Notes:** 1) Dots ( ``.`` ) and brackets ( ``[`` and ``]`` ) can be used to access nested objects (e.g., ``"field": "foo.bar"`` and ``"field": "foo['bar']"`` ). If field names contain dots or brackets but are not nested, you can use ``\`` to escape dots and brackets (e.g., ``"a\.b"`` and ``"a\[0\]"`` ). See more details about escaping in the `field documentation `__. 2) ``field`` is not required if ``aggregate`` is ``count``. legend : anyOf(:class:`Legend`, None) An object defining properties of the legend. If ``null``, the legend for the encoding channel will be removed. **Default value:** If undefined, default `legend properties `__ are applied. **See also:** `legend `__ documentation. scale : anyOf(:class:`Scale`, None) An object defining properties of the channel's scale, which is the function that transforms values in the data domain (numbers, dates, strings, etc) to visual values (pixels, colors, sizes) of the encoding channels. If ``null``, the scale will be `disabled and the data value will be directly encoded `__. **Default value:** If undefined, default `scale properties `__ are applied. **See also:** `scale `__ documentation. sort : :class:`Sort` Sort order for the encoded field. For continuous fields (quantitative or temporal), ``sort`` can be either ``"ascending"`` or ``"descending"``. For discrete fields, ``sort`` can be one of the following: * ``"ascending"`` or ``"descending"`` -- for sorting by the values' natural order in JavaScript. * `A string indicating an encoding channel name to sort by `__ (e.g., ``"x"`` or ``"y"`` ) with an optional minus prefix for descending sort (e.g., ``"-x"`` to sort by x-field, descending). This channel string is short-form of `a sort-by-encoding definition `__. For example, ``"sort": "-x"`` is equivalent to ``"sort": {"encoding": "x", "order": "descending"}``. * `A sort field definition `__ for sorting by another field. * `An array specifying the field values in preferred order `__. In this case, the sort order will obey the values in the array, followed by any unspecified values in their original order. For discrete time field, values in the sort array can be `date-time definition objects `__. In addition, for time units ``"month"`` and ``"day"``, the values can be the month or day names (case insensitive) or their 3-letter initials (e.g., ``"Mon"``, ``"Tue"`` ). * ``null`` indicating no sort. **Default value:** ``"ascending"`` **Note:** ``null`` and sorting by another channel is not supported for ``row`` and ``column``. **See also:** `sort `__ documentation. timeUnit : anyOf(:class:`TimeUnit`, :class:`TimeUnitParams`) Time unit (e.g., ``year``, ``yearmonth``, ``month``, ``hours`` ) for a temporal field. or `a temporal field that gets casted as ordinal `__. **Default value:** ``undefined`` (None) **See also:** `timeUnit `__ documentation. title : anyOf(:class:`Text`, None) A title for the field. If ``null``, the title will be removed. **Default value:** derived from the field's name and transformation function ( ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function, the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ). Otherwise, the title is simply the field name. **Notes** : 1) You can customize the default field title format by providing the `fieldTitle `__ property in the `config `__ or `fieldTitle function via the compile function's options `__. 2) If both field definition's ``title`` and axis, header, or legend ``title`` are defined, axis/header/legend title will be used. type : :class:`StandardType` The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also be a ``"geojson"`` type for encoding `'geoshape' `__. Vega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal scale for a field with ``bin`` or ``timeUnit``. **Default value:** 1) For a data ``field``, ``"nominal"`` is the default data type unless the field encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or ``timeUnit`` that satisfies the following criteria: * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin`` or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a quantitative scale `__. * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit`` or (2) the specified scale type is a time or utc scale * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort order `__, (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is ``order``. 2) For a constant value in data domain ( ``datum`` ): * ``"quantitative"`` if the datum is a number * ``"nominal"`` if the datum is a string * ``"temporal"`` if the datum is `a date time object `__ **Note:** * Data ``type`` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data. * Data values for a temporal field can be either a date-time string (e.g., ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a timestamp number (e.g., ``1552199579097`` ). * When using with `bin `__, the ``type`` property can be either ``"quantitative"`` (for using a linear bin scale) or `"ordinal" (for using an ordinal bin scale) `__. * When using with `timeUnit `__, the ``type`` property can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal" (for using an ordinal scale) `__. * When using with `aggregate `__, the ``type`` property refers to the post-aggregation data type. For example, we can calculate count ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct", "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``. * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have ``type`` as they must have exactly the same type as their primary channels (e.g., ``x``, ``y`` ). **See also:** `type `__ documentation. FrrKrLrbc dSrdrres rrfzFillOpacity.aggregate[ rgr c dSrdrris rrfzFillOpacity.aggregate_ rgr c dSrdrrls rrfzFillOpacity.aggregatec rgr c dSrdrres rrozFillOpacity.bandPositiong rpr c dSrdrres rrrzFillOpacity.binj rgr c  dSrdrrts rrrzFillOpacity.binn rgr Nc dSrdrres rrrzFillOpacity.binr rgr c dSrdrrs rr@zFillOpacity.conditionv rgr c dSrdrrs rr@zFillOpacity.conditionz rgr c dSrdrres rr@zFillOpacity.condition~ rgr c dSrdrres rrzFillOpacity.field rgr c dSrdrrs rrzFillOpacity.field rgr cC dSrdrrsD rrzFillOpacity.legend rgr c dSrdrres rrzFillOpacity.legend rgr c dSrdrrs rrzFillOpacity.scale rgr c dSrdrres rrzFillOpacity.scale rgr c dSrdrres rrzFillOpacity.sort rgr c dSrdrres rrzFillOpacity.sort rgr c dSrdrres rrzFillOpacity.sort rgr c dSrdrres rrzFillOpacity.sort rgr rc dSrdrres rrzFillOpacity.sort rgr rc dSrdrres rrzFillOpacity.sort rgr rc dSrdrres rrzFillOpacity.sort rgr c dSrdrrs rrzFillOpacity.sort rgr c dSrdrrs rrzFillOpacity.sort rgr c dSrdrres rrzFillOpacity.sort rgr rc dSrdrres rrzFillOpacity.timeUnit rgr rc dSrdrres rrzFillOpacity.timeUnit rgr r#c dSrdrres rrzFillOpacity.timeUnit rgr rBc dSrdrres rrzFillOpacity.timeUnit rgr c dSrdrrbs rrzFillOpacity.timeUnit rgr c dSrdrres rrzFillOpacity.title rgr c dSrdrres rrzFillOpacity.title rgr c dSrdrres rrzFillOpacity.title rgr rhc dSrdrres rr"zFillOpacity.type rpr c  btt|jd||||||||| | | | d | dSro)r2rrprqs rrpzFillOpacity.__init__ k *k4  ) ]I7CXa05fEX\3;5t ] ]X\ ] ] ] ] ]r )rbr)rKNrbrrsr<s@rrrv = __@(-$"N  7$bc p}   X (    X (    X  e      T m   X "9Y_hr{FOV_fow@    X    X &i    X 'y     X  4 EF S`   X  s }   X $    X # \et}LUajvHQ^gxAS\r{QZnwCLYbr{HQ]fr{KTen@ I V _ m v E N ] f u ~ P Y c l v  H Q Z c m v C L Z c p y LUgp~GV_oxENbkHU^jsAJR[hqHXanwCL\evQZgpBKZcqzIRYbkt}F    X    X #))9_hqzGP\eqzEN\eluHW`ox@IT]hq{DLU^gnw~G    X    X  d5k m   X  d3i M   X  d4j ]   X  d4=) m   X  g78 ]   X  gUV cp   X  gab o|   X "y     X %Y    X    X  '#PQ ^k   X  '#qr L   X  '#x y  F S    X  '#O P  ] j    X (yyi    X  s }   X  tCy ]   X    X  gNO \i    "+ii]f$Iiy)99]]]]]]]]]]r rc8eZdZdZdZdZdeddfdZee e fddZ ee e e fddZ ede e j ddfd Z ededdfd Zede eddfd Zedd ZdedddfdZe e e e ffd ZxZS)FillOpacityDatumamFillOpacityDatum schema wrapper Mapping(required=[]) Parameters ---------- bandPosition : float Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to ``0``, and at the middle of the band if set to ``0.5``. condition : anyOf(:class:`ConditionalValueDefnumberExprRef`, List(:class:`ConditionalValueDefnumberExprRef`)) One or more value definition(s) with `a parameter or a test predicate `__. **Note:** A field definition's ``condition`` property can only contain `conditional value definitions `__ since Vega-Lite only allows at most one encoded field per encoding channel. datum : anyOf(:class:`PrimitiveValue`, :class:`DateTime`, :class:`ExprRef`, :class:`RepeatRef`) A constant value in data domain. title : anyOf(:class:`Text`, None) A title for the field. If ``null``, the title will be removed. **Default value:** derived from the field's name and transformation function ( ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function, the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ). Otherwise, the title is simply the field name. **Notes** : 1) You can customize the default field title format by providing the `fieldTitle `__ property in the `config `__ or `fieldTitle function via the compile function's options `__. 2) If both field definition's ``title`` and axis, header, or legend ``title`` are defined, axis/header/legend title will be used. type : :class:`Type` The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also be a ``"geojson"`` type for encoding `'geoshape' `__. Vega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal scale for a field with ``bin`` or ``timeUnit``. **Default value:** 1) For a data ``field``, ``"nominal"`` is the default data type unless the field encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or ``timeUnit`` that satisfies the following criteria: * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin`` or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a quantitative scale `__. * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit`` or (2) the specified scale type is a time or utc scale * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort order `__, (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is ``order``. 2) For a constant value in data domain ( ``datum`` ): * ``"quantitative"`` if the datum is a number * ``"nominal"`` if the datum is a string * ``"temporal"`` if the datum is `a date time object `__ **Note:** * Data ``type`` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data. * Data values for a temporal field can be either a date-time string (e.g., ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a timestamp number (e.g., ``1552199579097`` ). * When using with `bin `__, the ``type`` property can be either ``"quantitative"`` (for using a linear bin scale) or `"ordinal" (for using an ordinal bin scale) `__. * When using with `timeUnit `__, the ``type`` property can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal" (for using an ordinal scale) `__. * When using with `aggregate `__, the ``type`` property refers to the post-aggregation data type. For example, we can calculate count ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct", "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``. * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have ``type`` as they must have exactly the same type as their primary channels (e.g., ``x``, ``y`` ). **See also:** `type `__ documentation. FrrKrbc dSrdrres rrozFillOpacityDatum.bandPositionbrpr c dSrdrrs rr@zFillOpacityDatum.conditionergr c dSrdrrs rr@zFillOpacityDatum.conditionirgr c dSrdrres rr@zFillOpacityDatum.conditionmrgr c dSrdrres rrzFillOpacityDatum.titleqrgr c dSrdrres rrzFillOpacityDatum.titleurgr Nc dSrdrres rrzFillOpacityDatum.titleyrgr rc dSrdrres rr"zFillOpacityDatum.type}rpr c Ttt|jd|||||d|dSr)r2rrprs rrpzFillOpacityDatum.__init__U.%%. dU9B%VZ d d^b d d d d dr )rbr)rKNrbrrr<s@rrr mm\(-$"N e 0B    &i    X 'y     X  4 EF Se   X  s '9   X  tCy -?   X    X  gYZ gy    ,5 QZddddddddddr rc VeZdZdZdZdZeeeeeeeeeeeef ddZeeeeeeeefddZeeeeeeeeeeeeef ddZeeeeeeeeefddZeeefdd Zeeeefdd Zed e e j ddfd Zeffd Z xZ S)FillOpacityValueajFillOpacityValue schema wrapper Mapping(required=[]) Parameters ---------- condition : anyOf(:class:`ConditionalMarkPropFieldOrDatumDef`, :class:`ConditionalValueDefnumberExprRef`, List(:class:`ConditionalValueDefnumberExprRef`)) A field definition or one or more value definition(s) with a parameter predicate. value : anyOf(float, :class:`ExprRef`) A constant value in visual domain (e.g., ``"red"`` / ``"#0099ff"`` / `gradient definition `__ for color, values between ``0`` to ``1`` for opacity). Frrbc  dSrdrrs rr@zFillOpacityValue.conditionrgr c dSrdrrs rr@zFillOpacityValue.conditionrgr c  dSrdrrs rr@zFillOpacityValue.conditionrgr c  dSrdrrs rr@zFillOpacityValue.conditionrgr c dSrdrrs rr@zFillOpacityValue.conditionrgr c dSrdrrs rr@zFillOpacityValue.conditionrgr rKc dSrdrres rr@zFillOpacityValue.conditionrgr c Ntt|jd||d|dSr)r2rrprs rrpzFillOpacityValue.__init__r;r )rbrrr<s@rrr4  (-$"N "+)Zclu~GNW^gr{CLS\    X %.i Ybir{DKT    X "+)Zckt~GOX`ipyDMU^en    X %.iyYbjs|EMV]f    X &i    X 'y     X  4 EF Se   X )2YYYYYYYYYYr rc eZdZdZdZdZededddfdZee fd'dZee fd'd Zde ddfd Z ede ddfd Z ee e e e e e e e e e f d'd Z ededdfd Z ed(dZ ee e fd'dZee e e fd'dZedeejddfdZededdfdZee fd'dZededdfdZededdfdZdeddfdZededddfdZededddfdZededddfdZededddfdZee e e e fd'd Zededdfd!Zedeeddfd"Zed(d#Zded$ddfd%Ze e e e e e e e e e e f fd& ZxZS))Hrefa)Href schema wrapper Mapping(required=[shorthand]) Parameters ---------- shorthand : string shorthand for field, aggregate, and type aggregate : :class:`Aggregate` Aggregation function for the field (e.g., ``"mean"``, ``"sum"``, ``"median"``, ``"min"``, ``"max"``, ``"count"`` ). **Default value:** ``undefined`` (None) **See also:** `aggregate `__ documentation. bandPosition : float Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to ``0``, and at the middle of the band if set to ``0.5``. bin : anyOf(boolean, :class:`BinParams`, string, None) A flag for binning a ``quantitative`` field, `an object defining binning parameters `__, or indicating that the data for ``x`` or ``y`` channel are binned before they are imported into Vega-Lite ( ``"binned"`` ). If ``true``, default `binning parameters `__ will be applied. If ``"binned"``, this indicates that the data for the ``x`` (or ``y`` ) channel are already binned. You can map the bin-start field to ``x`` (or ``y`` ) and the bin-end field to ``x2`` (or ``y2`` ). The scale and axis will be formatted similar to binning in Vega-Lite. To adjust the axis ticks based on the bin step, you can also set the axis's `tickMinStep `__ property. **Default value:** ``false`` **See also:** `bin `__ documentation. condition : anyOf(:class:`ConditionalValueDefstringExprRef`, List(:class:`ConditionalValueDefstringExprRef`)) One or more value definition(s) with `a parameter or a test predicate `__. **Note:** A field definition's ``condition`` property can only contain `conditional value definitions `__ since Vega-Lite only allows at most one encoded field per encoding channel. field : :class:`Field` **Required.** A string defining the name of the field from which to pull a data value or an object defining iterated values from the `repeat `__ operator. **See also:** `field `__ documentation. **Notes:** 1) Dots ( ``.`` ) and brackets ( ``[`` and ``]`` ) can be used to access nested objects (e.g., ``"field": "foo.bar"`` and ``"field": "foo['bar']"`` ). If field names contain dots or brackets but are not nested, you can use ``\`` to escape dots and brackets (e.g., ``"a\.b"`` and ``"a\[0\]"`` ). See more details about escaping in the `field documentation `__. 2) ``field`` is not required if ``aggregate`` is ``count``. format : anyOf(string, :class:`Dict`) When used with the default ``"number"`` and ``"time"`` format type, the text formatting pattern for labels of guides (axes, legends, headers) and text marks. * If the format type is ``"number"`` (e.g., for quantitative fields), this is D3's `number format pattern `__. * If the format type is ``"time"`` (e.g., for temporal fields), this is D3's `time format pattern `__. See the `format documentation `__ for more examples. When used with a `custom formatType `__, this value will be passed as ``format`` alongside ``datum.value`` to the registered function. **Default value:** Derived from `numberFormat `__ config for number format and from `timeFormat `__ config for time format. formatType : string The format type for labels. One of ``"number"``, ``"time"``, or a `registered custom format type `__. **Default value:** * ``"time"`` for temporal fields and ordinal and nominal fields with ``timeUnit``. * ``"number"`` for quantitative fields as well as ordinal and nominal fields without ``timeUnit``. timeUnit : anyOf(:class:`TimeUnit`, :class:`TimeUnitParams`) Time unit (e.g., ``year``, ``yearmonth``, ``month``, ``hours`` ) for a temporal field. or `a temporal field that gets casted as ordinal `__. **Default value:** ``undefined`` (None) **See also:** `timeUnit `__ documentation. title : anyOf(:class:`Text`, None) A title for the field. If ``null``, the title will be removed. **Default value:** derived from the field's name and transformation function ( ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function, the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ). Otherwise, the title is simply the field name. **Notes** : 1) You can customize the default field title format by providing the `fieldTitle `__ property in the `config `__ or `fieldTitle function via the compile function's options `__. 2) If both field definition's ``title`` and axis, header, or legend ``title`` are defined, axis/header/legend title will be used. type : :class:`StandardType` The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also be a ``"geojson"`` type for encoding `'geoshape' `__. Vega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal scale for a field with ``bin`` or ``timeUnit``. **Default value:** 1) For a data ``field``, ``"nominal"`` is the default data type unless the field encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or ``timeUnit`` that satisfies the following criteria: * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin`` or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a quantitative scale `__. * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit`` or (2) the specified scale type is a time or utc scale * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort order `__, (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is ``order``. 2) For a constant value in data domain ( ``datum`` ): * ``"quantitative"`` if the datum is a number * ``"nominal"`` if the datum is a string * ``"temporal"`` if the datum is `a date time object `__ **Note:** * Data ``type`` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data. * Data values for a temporal field can be either a date-time string (e.g., ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a timestamp number (e.g., ``1552199579097`` ). * When using with `bin `__, the ``type`` property can be either ``"quantitative"`` (for using a linear bin scale) or `"ordinal" (for using an ordinal bin scale) `__. * When using with `timeUnit `__, the ``type`` property can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal" (for using an ordinal scale) `__. * When using with `aggregate `__, the ``type`` property refers to the post-aggregation data type. For example, we can calculate count ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct", "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``. * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have ``type`` as they must have exactly the same type as their primary channels (e.g., ``x``, ``y`` ). **See also:** `type `__ documentation. FhrefrKrLrbc dSrdrres rrfzHref.aggregatergr c dSrdrris rrfzHref.aggregatergr c dSrdrrls rrfzHref.aggregatergr c dSrdrres rrozHref.bandPositionrpr c dSrdrres rrrzHref.binrgr c  dSrdrrts rrrzHref.binrgr c dSrdrres rrrzHref.binrgr Nc dSrdrres rrrzHref.binrgr c dSrdrrs rr@zHref.conditionrgr c dSrdrrs rr@zHref.conditionrgr c dSrdrres rr@zHref.conditionrgr c dSrdrres rrz Href.fieldrgr c dSrdrrs rrz Href.fieldrgr c dSrdrres rr&z Href.formatrgr c dSrdrres rr&z Href.formatrgr c dSrdrres rrzHref.formatTyperpr rc dSrdrres rrz Href.timeUnitrgr rc dSrdrres rrz Href.timeUnitrgr r#c dSrdrres rrz Href.timeUnitrgr rBc dSrdrres rrz Href.timeUnitrgr c dSrdrrbs rrz Href.timeUnitrgr c dSrdrres rrz Href.titlergr c dSrdrres rrz Href.titlergr c dSrdrres rrz Href.titlergr rhc dSrdrres rr"z Href.typerpr c  `tt|jd||||||||| | | d | dSr,)r2rrpr-s rrpz Href.__init__` #dD" +Y)Zf'*iuU[.88SX_c + +&* + + + + +r )rbr)rKNrbrr.r<s@rrrs#DDJ(-$N  7$bc pv   X (    X (    X  e      T f   X "9Y_hr{FOV_fow@    X  S V   X    X &i    X 'y     X  4 EF SY   X  s v   X $    X      X      X  C F     '#PQ ^d   X  '#qr E   X  '#x y  F L    X  '#O P  ] c    X (yyi    X  s v   X  tCy V   X    X  gNO \b    "+ii]f$IiT]#99++++++++++r rc VeZdZdZdZdZeeeeeeeeeeeef ddZeeeeeeeefddZeeeeeeeeeeeeef ddZeeeeeeeeefddZeeefdd Zeeeefdd Zed e e j ddfd Zeffd Z xZ S) HrefValuearHrefValue schema wrapper Mapping(required=[]) Parameters ---------- condition : anyOf(:class:`ConditionalMarkPropFieldOrDatumDef`, :class:`ConditionalValueDefstringnullExprRef`, List(:class:`ConditionalValueDefstringnullExprRef`)) A field definition or one or more value definition(s) with a parameter predicate. value : anyOf(string, None, :class:`ExprRef`) A constant value in visual domain (e.g., ``"red"`` / ``"#0099ff"`` / `gradient definition `__ for color, values between ``0`` to ``1`` for opacity). Frrbc  dSrdrrs rr@zHrefValue.conditionrgr c dSrdrrs rr@zHrefValue.conditionrgr c  dSrdrrs rr@zHrefValue.condition rgr c  dSrdrrs rr@zHrefValue.conditionrgr c dSrdrrs rr@zHrefValue.conditionrgr c dSrdrrs rr@zHrefValue.conditionrgr rKc dSrdrres rr@zHrefValue.conditionrgr c Ntt|jd||d|dSr)r2r!rprs rrpzHrefValue.__init__ rr )rbr!r<r<s@rr!r!s4  (-$N "+)Zclu~GNW^gr{CLS\    X %.i Ybir{DKT    X "+)Zckt~GOX`ipyDMU^en    X %.iyYbjs|EMV]f    X &i    X 'y     X  4 IJ Wb   X )2RRRRRRRRRRr r!c eZdZdZdZdZededddfdZee fd!dZee fd!d Zde ddfd Z ede ddfd Z ee e e e e e e e e e f d!d Z ededdfd Z ed"dZ ededdfdZee fd!dZededddfdZededddfdZededddfdZededddfdZee e e e fd!dZededdfdZedeeddfdZed"dZdedddfdZe e e e e e e e ffd ZxZS)#Keyar!Key schema wrapper Mapping(required=[shorthand]) Definition object for a data field, its type and transformation of an encoding channel. Parameters ---------- shorthand : string shorthand for field, aggregate, and type aggregate : :class:`Aggregate` Aggregation function for the field (e.g., ``"mean"``, ``"sum"``, ``"median"``, ``"min"``, ``"max"``, ``"count"`` ). **Default value:** ``undefined`` (None) **See also:** `aggregate `__ documentation. bandPosition : float Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to ``0``, and at the middle of the band if set to ``0.5``. bin : anyOf(boolean, :class:`BinParams`, string, None) A flag for binning a ``quantitative`` field, `an object defining binning parameters `__, or indicating that the data for ``x`` or ``y`` channel are binned before they are imported into Vega-Lite ( ``"binned"`` ). If ``true``, default `binning parameters `__ will be applied. If ``"binned"``, this indicates that the data for the ``x`` (or ``y`` ) channel are already binned. You can map the bin-start field to ``x`` (or ``y`` ) and the bin-end field to ``x2`` (or ``y2`` ). The scale and axis will be formatted similar to binning in Vega-Lite. To adjust the axis ticks based on the bin step, you can also set the axis's `tickMinStep `__ property. **Default value:** ``false`` **See also:** `bin `__ documentation. field : :class:`Field` **Required.** A string defining the name of the field from which to pull a data value or an object defining iterated values from the `repeat `__ operator. **See also:** `field `__ documentation. **Notes:** 1) Dots ( ``.`` ) and brackets ( ``[`` and ``]`` ) can be used to access nested objects (e.g., ``"field": "foo.bar"`` and ``"field": "foo['bar']"`` ). If field names contain dots or brackets but are not nested, you can use ``\`` to escape dots and brackets (e.g., ``"a\.b"`` and ``"a\[0\]"`` ). See more details about escaping in the `field documentation `__. 2) ``field`` is not required if ``aggregate`` is ``count``. timeUnit : anyOf(:class:`TimeUnit`, :class:`TimeUnitParams`) Time unit (e.g., ``year``, ``yearmonth``, ``month``, ``hours`` ) for a temporal field. or `a temporal field that gets casted as ordinal `__. **Default value:** ``undefined`` (None) **See also:** `timeUnit `__ documentation. title : anyOf(:class:`Text`, None) A title for the field. If ``null``, the title will be removed. **Default value:** derived from the field's name and transformation function ( ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function, the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ). Otherwise, the title is simply the field name. **Notes** : 1) You can customize the default field title format by providing the `fieldTitle `__ property in the `config `__ or `fieldTitle function via the compile function's options `__. 2) If both field definition's ``title`` and axis, header, or legend ``title`` are defined, axis/header/legend title will be used. type : :class:`StandardType` The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also be a ``"geojson"`` type for encoding `'geoshape' `__. Vega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal scale for a field with ``bin`` or ``timeUnit``. **Default value:** 1) For a data ``field``, ``"nominal"`` is the default data type unless the field encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or ``timeUnit`` that satisfies the following criteria: * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin`` or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a quantitative scale `__. * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit`` or (2) the specified scale type is a time or utc scale * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort order `__, (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is ``order``. 2) For a constant value in data domain ( ``datum`` ): * ``"quantitative"`` if the datum is a number * ``"nominal"`` if the datum is a string * ``"temporal"`` if the datum is `a date time object `__ **Note:** * Data ``type`` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data. * Data values for a temporal field can be either a date-time string (e.g., ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a timestamp number (e.g., ``1552199579097`` ). * When using with `bin `__, the ``type`` property can be either ``"quantitative"`` (for using a linear bin scale) or `"ordinal" (for using an ordinal bin scale) `__. * When using with `timeUnit `__, the ``type`` property can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal" (for using an ordinal scale) `__. * When using with `aggregate `__, the ``type`` property refers to the post-aggregation data type. For example, we can calculate count ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct", "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``. * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have ``type`` as they must have exactly the same type as their primary channels (e.g., ``x``, ``y`` ). **See also:** `type `__ documentation. FkeyrKrLrbc dSrdrres rrfz Key.aggregatergr c dSrdrris rrfz Key.aggregatergr c dSrdrrls rrfz Key.aggregatergr c dSrdrres rrozKey.bandPositionrpr c dSrdrres rrrzKey.binrgr c  dSrdrrts rrrzKey.binrgr c dSrdrres rrrzKey.binrgr Nc dSrdrres rrrzKey.binrgr c dSrdrres rrz Key.fieldrgr c dSrdrrs rrz Key.fieldrgr rc dSrdrres rrz Key.timeUnitrgr rc dSrdrres rrz Key.timeUnitrgr r#c dSrdrres rrz Key.timeUnitrgr rBc dSrdrres rrz Key.timeUnitrgr c dSrdrrbs rrz Key.timeUnitrgr c dSrdrres rrz Key.titlergr c dSrdrres rrz Key.titlergr c dSrdrres rrz Key.title rgr rhc dSrdrres rr"zKey.type rpr c Ztt|jd||||||||d| dSrU)r2r+rprVs rrpz Key.__init__sT!c4! *IYe&)QV]a * *$( * * * * *r )rbr+)rKNrbr+rWr<s@rr+r+$s\\z(-$N  7$bc pu   X (    X (    X  e      T e   X "9Y_hr{FOV_fow@    X  S U   X    X  s u   X $    X  '#PQ ^c   X  '#qr D   X  '#x y  F K    X  '#O P  ] b    X (yyi    X  s u   X  tCy U   X    X  gNO \a    "+ii]f 9II**********r r+c:eZdZdZdZdZededddfdZee fddZee fdd Zde ddfd Z dd Z ede ddfd Zee fddZededddfdZededddfdZededddfdZededddfdZee e e e fddZede ddfdZedee ddfdZeddZde ddfdZe e e e e e e e ffd ZxZS)Latitudea Latitude schema wrapper Mapping(required=[shorthand]) Parameters ---------- shorthand : string shorthand for field, aggregate, and type aggregate : :class:`Aggregate` Aggregation function for the field (e.g., ``"mean"``, ``"sum"``, ``"median"``, ``"min"``, ``"max"``, ``"count"`` ). **Default value:** ``undefined`` (None) **See also:** `aggregate `__ documentation. bandPosition : float Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to ``0``, and at the middle of the band if set to ``0.5``. bin : None A flag for binning a ``quantitative`` field, `an object defining binning parameters `__, or indicating that the data for ``x`` or ``y`` channel are binned before they are imported into Vega-Lite ( ``"binned"`` ). If ``true``, default `binning parameters `__ will be applied. If ``"binned"``, this indicates that the data for the ``x`` (or ``y`` ) channel are already binned. You can map the bin-start field to ``x`` (or ``y`` ) and the bin-end field to ``x2`` (or ``y2`` ). The scale and axis will be formatted similar to binning in Vega-Lite. To adjust the axis ticks based on the bin step, you can also set the axis's `tickMinStep `__ property. **Default value:** ``false`` **See also:** `bin `__ documentation. field : :class:`Field` **Required.** A string defining the name of the field from which to pull a data value or an object defining iterated values from the `repeat `__ operator. **See also:** `field `__ documentation. **Notes:** 1) Dots ( ``.`` ) and brackets ( ``[`` and ``]`` ) can be used to access nested objects (e.g., ``"field": "foo.bar"`` and ``"field": "foo['bar']"`` ). If field names contain dots or brackets but are not nested, you can use ``\`` to escape dots and brackets (e.g., ``"a\.b"`` and ``"a\[0\]"`` ). See more details about escaping in the `field documentation `__. 2) ``field`` is not required if ``aggregate`` is ``count``. timeUnit : anyOf(:class:`TimeUnit`, :class:`TimeUnitParams`) Time unit (e.g., ``year``, ``yearmonth``, ``month``, ``hours`` ) for a temporal field. or `a temporal field that gets casted as ordinal `__. **Default value:** ``undefined`` (None) **See also:** `timeUnit `__ documentation. title : anyOf(:class:`Text`, None) A title for the field. If ``null``, the title will be removed. **Default value:** derived from the field's name and transformation function ( ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function, the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ). Otherwise, the title is simply the field name. **Notes** : 1) You can customize the default field title format by providing the `fieldTitle `__ property in the `config `__ or `fieldTitle function via the compile function's options `__. 2) If both field definition's ``title`` and axis, header, or legend ``title`` are defined, axis/header/legend title will be used. type : string The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also be a ``"geojson"`` type for encoding `'geoshape' `__. Vega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal scale for a field with ``bin`` or ``timeUnit``. **Default value:** 1) For a data ``field``, ``"nominal"`` is the default data type unless the field encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or ``timeUnit`` that satisfies the following criteria: * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin`` or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a quantitative scale `__. * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit`` or (2) the specified scale type is a time or utc scale * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort order `__, (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is ``order``. 2) For a constant value in data domain ( ``datum`` ): * ``"quantitative"`` if the datum is a number * ``"nominal"`` if the datum is a string * ``"temporal"`` if the datum is `a date time object `__ **Note:** * Data ``type`` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data. * Data values for a temporal field can be either a date-time string (e.g., ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a timestamp number (e.g., ``1552199579097`` ). * When using with `bin `__, the ``type`` property can be either ``"quantitative"`` (for using a linear bin scale) or `"ordinal" (for using an ordinal bin scale) `__. * When using with `timeUnit `__, the ``type`` property can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal" (for using an ordinal scale) `__. * When using with `aggregate `__, the ``type`` property refers to the post-aggregation data type. For example, we can calculate count ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct", "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``. * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have ``type`` as they must have exactly the same type as their primary channels (e.g., ``x``, ``y`` ). **See also:** `type `__ documentation. FlatituderKrLrbc dSrdrres rrfzLatitude.aggregatergr c dSrdrris rrfzLatitude.aggregatergr c dSrdrrls rrfzLatitude.aggregatergr c dSrdrres rrozLatitude.bandPositionrpr Nc dSrdrres rrrz Latitude.binrpr c dSrdrres rrzLatitude.fieldrgr c dSrdrrs rrzLatitude.fieldrgr rc dSrdrres rrzLatitude.timeUnitrgr rc dSrdrres rrzLatitude.timeUnitrgr r#c dSrdrres rrzLatitude.timeUnitrgr rBc dSrdrres rrzLatitude.timeUnitrgr c dSrdrrbs rrzLatitude.timeUnitrgr c dSrdrres rrzLatitude.titlergr c dSrdrres rrzLatitude.titlergr c dSrdrres rrzLatitude.titlergr c dSrdrres rr"z Latitude.typerpr c Ztt|jd||||||||d| dSrU)r2rBrprVs rrpzLatitude.__init__s[&h& Zi4@cQV08D Z ZTX Z Z Z Z Zr )rbrB)rKNrbrBr'r9r:rtrurvrr rfrrwrorrr.rrrr r"rpr;r<s@rrBrBs[[[x(-$N  7$bc pz   X (    X (    X  e          s z   X $    X  '#PQ ^h   X  '#qr I   X  '#x y  F P    X  '#O P  ] g    X (yyi    X  s z   X  tCy Z   X    X  c j    "+ii]f 9IIZZZZZZZZZZr rBceZdZdZdZdZdeddfdZede ddfdZ ede e ddfdZ edd Z de d ddfd Z eeeffd ZxZS) LatitudeDatuma\LatitudeDatum schema wrapper Mapping(required=[]) Parameters ---------- bandPosition : float Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to ``0``, and at the middle of the band if set to ``0.5``. datum : anyOf(:class:`PrimitiveValue`, :class:`DateTime`, :class:`ExprRef`, :class:`RepeatRef`) A constant value in data domain. title : anyOf(:class:`Text`, None) A title for the field. If ``null``, the title will be removed. **Default value:** derived from the field's name and transformation function ( ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function, the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ). Otherwise, the title is simply the field name. **Notes** : 1) You can customize the default field title format by providing the `fieldTitle `__ property in the `config `__ or `fieldTitle function via the compile function's options `__. 2) If both field definition's ``title`` and axis, header, or legend ``title`` are defined, axis/header/legend title will be used. type : :class:`Type` The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also be a ``"geojson"`` type for encoding `'geoshape' `__. Vega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal scale for a field with ``bin`` or ``timeUnit``. **Default value:** 1) For a data ``field``, ``"nominal"`` is the default data type unless the field encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or ``timeUnit`` that satisfies the following criteria: * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin`` or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a quantitative scale `__. * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit`` or (2) the specified scale type is a time or utc scale * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort order `__, (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is ``order``. 2) For a constant value in data domain ( ``datum`` ): * ``"quantitative"`` if the datum is a number * ``"nominal"`` if the datum is a string * ``"temporal"`` if the datum is `a date time object `__ **Note:** * Data ``type`` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data. * Data values for a temporal field can be either a date-time string (e.g., ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a timestamp number (e.g., ``1552199579097`` ). * When using with `bin `__, the ``type`` property can be either ``"quantitative"`` (for using a linear bin scale) or `"ordinal" (for using an ordinal bin scale) `__. * When using with `timeUnit `__, the ``type`` property can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal" (for using an ordinal scale) `__. * When using with `aggregate `__, the ``type`` property refers to the post-aggregation data type. For example, we can calculate count ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct", "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``. * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have ``type`` as they must have exactly the same type as their primary channels (e.g., ``x``, ``y`` ). **See also:** `type `__ documentation. FrCrKrbc dSrdrres rrozLatitudeDatum.bandPositionjrpr c dSrdrres rrzLatitudeDatum.titlemrgr c dSrdrres rrzLatitudeDatum.titleqrgr Nc dSrdrres rrzLatitudeDatum.titleurgr rc dSrdrres rr"zLatitudeDatum.typeyrpr c Rtt|jd||||d|dSN)rGrorr"r)r2rWrprrGrorr"rrs rrpzLatitudeDatum.__init__}sJ+mT""+ ?%lZ_15 ? ?9= ? ? ? ? ?r )rKNrbrWr'r9r:rtrurvrwrorr.rr r r"rrpr;r<s@rrWrWs+ffN(-$N e      s    X  tCy _   X    X  gYZ gv    ,5II??????????r rWc(eZdZdZdZdZededddfdZee fddZee fdd Zde ddfd Z dd Z ede ddfd Zee fddZededddfdZededddfdZededddfdZededddfdZee e e e fddZede ddfdZedee ddfdZeddZe e e e e e e ffd ZxZS) Latitude2aLatitude2 schema wrapper Mapping(required=[shorthand]) A field definition of a secondary channel that shares a scale with another primary channel. For example, ``x2``, ``xError`` and ``xError2`` share the same scale with ``x``. Parameters ---------- shorthand : string shorthand for field, aggregate, and type aggregate : :class:`Aggregate` Aggregation function for the field (e.g., ``"mean"``, ``"sum"``, ``"median"``, ``"min"``, ``"max"``, ``"count"`` ). **Default value:** ``undefined`` (None) **See also:** `aggregate `__ documentation. bandPosition : float Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to ``0``, and at the middle of the band if set to ``0.5``. bin : None A flag for binning a ``quantitative`` field, `an object defining binning parameters `__, or indicating that the data for ``x`` or ``y`` channel are binned before they are imported into Vega-Lite ( ``"binned"`` ). If ``true``, default `binning parameters `__ will be applied. If ``"binned"``, this indicates that the data for the ``x`` (or ``y`` ) channel are already binned. You can map the bin-start field to ``x`` (or ``y`` ) and the bin-end field to ``x2`` (or ``y2`` ). The scale and axis will be formatted similar to binning in Vega-Lite. To adjust the axis ticks based on the bin step, you can also set the axis's `tickMinStep `__ property. **Default value:** ``false`` **See also:** `bin `__ documentation. field : :class:`Field` **Required.** A string defining the name of the field from which to pull a data value or an object defining iterated values from the `repeat `__ operator. **See also:** `field `__ documentation. **Notes:** 1) Dots ( ``.`` ) and brackets ( ``[`` and ``]`` ) can be used to access nested objects (e.g., ``"field": "foo.bar"`` and ``"field": "foo['bar']"`` ). If field names contain dots or brackets but are not nested, you can use ``\`` to escape dots and brackets (e.g., ``"a\.b"`` and ``"a\[0\]"`` ). See more details about escaping in the `field documentation `__. 2) ``field`` is not required if ``aggregate`` is ``count``. timeUnit : anyOf(:class:`TimeUnit`, :class:`TimeUnitParams`) Time unit (e.g., ``year``, ``yearmonth``, ``month``, ``hours`` ) for a temporal field. or `a temporal field that gets casted as ordinal `__. **Default value:** ``undefined`` (None) **See also:** `timeUnit `__ documentation. title : anyOf(:class:`Text`, None) A title for the field. If ``null``, the title will be removed. **Default value:** derived from the field's name and transformation function ( ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function, the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ). Otherwise, the title is simply the field name. **Notes** : 1) You can customize the default field title format by providing the `fieldTitle `__ property in the `config `__ or `fieldTitle function via the compile function's options `__. 2) If both field definition's ``title`` and axis, header, or legend ``title`` are defined, axis/header/legend title will be used. F latitude2rKrLrbc dSrdrres rrfzLatitude2.aggregatergr c dSrdrris rrfzLatitude2.aggregatergr c dSrdrrls rrfzLatitude2.aggregatergr c dSrdrres rrozLatitude2.bandPositionrpr Nc dSrdrres rrrz Latitude2.binrpr c dSrdrres rrzLatitude2.fieldrgr c dSrdrrs rrzLatitude2.fieldrgr rc dSrdrres rrzLatitude2.timeUnitrgr rc dSrdrres rrzLatitude2.timeUnitrgr r#c dSrdrres rrzLatitude2.timeUnitrgr rBc dSrdrres rrzLatitude2.timeUnitrgr c dSrdrrbs rrzLatitude2.timeUnit rgr c dSrdrres rrzLatitude2.titlergr c dSrdrres rrzLatitude2.titlergr c dSrdrres rrzLatitude2.titlergr c Xtt|jd|||||||d|dSN)rrfrorrrrrr)r2rbrp rrrfrorrrrrrrs rrpzLatitude2.__init__sY'i' P)y5AsRW19 P PJN P P P P Pr )rbrb)rKNrbrbr'r9r:rtrurvrr rfrrwrorrr.rrrr rpr;r<s@rrbrbs7XXr(-$ N  7$bc p{   X (    X (    X  e          s {   X $    X  '#PQ ^i   X  '#qr J   X  '#x y  F Q    X  '#O P  ] h    X (yyi    X  s {   X  tCy [   X    X "+ii]f 9IPPPPPPPPPPr rbceZdZdZdZdZdeddfdZede ddfdZ ede e ddfdZ edd Z de d ddfd Z eeeffd ZxZS)Latitude2Datuma]Latitude2Datum schema wrapper Mapping(required=[]) Parameters ---------- bandPosition : float Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to ``0``, and at the middle of the band if set to ``0.5``. datum : anyOf(:class:`PrimitiveValue`, :class:`DateTime`, :class:`ExprRef`, :class:`RepeatRef`) A constant value in data domain. title : anyOf(:class:`Text`, None) A title for the field. If ``null``, the title will be removed. **Default value:** derived from the field's name and transformation function ( ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function, the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ). Otherwise, the title is simply the field name. **Notes** : 1) You can customize the default field title format by providing the `fieldTitle `__ property in the `config `__ or `fieldTitle function via the compile function's options `__. 2) If both field definition's ``title`` and axis, header, or legend ``title`` are defined, axis/header/legend title will be used. type : :class:`Type` The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also be a ``"geojson"`` type for encoding `'geoshape' `__. Vega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal scale for a field with ``bin`` or ``timeUnit``. **Default value:** 1) For a data ``field``, ``"nominal"`` is the default data type unless the field encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or ``timeUnit`` that satisfies the following criteria: * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin`` or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a quantitative scale `__. * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit`` or (2) the specified scale type is a time or utc scale * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort order `__, (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is ``order``. 2) For a constant value in data domain ( ``datum`` ): * ``"quantitative"`` if the datum is a number * ``"nominal"`` if the datum is a string * ``"temporal"`` if the datum is `a date time object `__ **Note:** * Data ``type`` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data. * Data values for a temporal field can be either a date-time string (e.g., ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a timestamp number (e.g., ``1552199579097`` ). * When using with `bin `__, the ``type`` property can be either ``"quantitative"`` (for using a linear bin scale) or `"ordinal" (for using an ordinal bin scale) `__. * When using with `timeUnit `__, the ``type`` property can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal" (for using an ordinal scale) `__. * When using with `aggregate `__, the ``type`` property refers to the post-aggregation data type. For example, we can calculate count ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct", "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``. * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have ``type`` as they must have exactly the same type as their primary channels (e.g., ``x``, ``y`` ). **See also:** `type `__ documentation. FrcrKrbc dSrdrres rrozLatitude2Datum.bandPositionrpr c dSrdrres rrzLatitude2Datum.titlergr c dSrdrres rrzLatitude2Datum.titlergr Nc dSrdrres rrzLatitude2Datum.titlergr rc dSrdrres rr"zLatitude2Datum.typerpr c Rtt|jd||||d|dSr^)r2rxrpr_s rrpzLatitude2Datum.__init__R,nd##, @5|[`26 @ @:> @ @ @ @ @r )rKNrbrxr`r<s@rrxrx"8ffN(-$ N e 0@     s '7   X  tCy -=   X    X  gYZ gw    ,5II@@@@@@@@@@r rxc*eZdZdZdZdZfdZxZS)Latitude2ValueaLatitude2Value schema wrapper Mapping(required=[value]) Definition object for a constant value (primitive value or gradient definition) of an encoding channel. Parameters ---------- value : anyOf(float, string, string, :class:`ExprRef`) A constant value in visual domain (e.g., ``"red"`` / ``"#0099ff"`` / `gradient definition `__ for color, values between ``0`` to ``1`` for opacity). Frcc Ltt|jdd|i|dSNrr)r2rrprrrrs rrpzLatitude2Value.__init__s1,nd##,AA5ADAAAAAr r'r9r:rtrurvrpr;r<s@rrrsX  (-$ NBBBBBBBBBr rc:eZdZdZdZdZededddfdZee fddZee fdd Zde ddfd Z dd Z ede ddfd Zee fddZededddfdZededddfdZededddfdZededddfdZee e e e fddZede ddfdZedee ddfdZeddZde ddfdZe e e e e e e e ffd ZxZS) Longitudea Longitude schema wrapper Mapping(required=[shorthand]) Parameters ---------- shorthand : string shorthand for field, aggregate, and type aggregate : :class:`Aggregate` Aggregation function for the field (e.g., ``"mean"``, ``"sum"``, ``"median"``, ``"min"``, ``"max"``, ``"count"`` ). **Default value:** ``undefined`` (None) **See also:** `aggregate `__ documentation. bandPosition : float Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to ``0``, and at the middle of the band if set to ``0.5``. bin : None A flag for binning a ``quantitative`` field, `an object defining binning parameters `__, or indicating that the data for ``x`` or ``y`` channel are binned before they are imported into Vega-Lite ( ``"binned"`` ). If ``true``, default `binning parameters `__ will be applied. If ``"binned"``, this indicates that the data for the ``x`` (or ``y`` ) channel are already binned. You can map the bin-start field to ``x`` (or ``y`` ) and the bin-end field to ``x2`` (or ``y2`` ). The scale and axis will be formatted similar to binning in Vega-Lite. To adjust the axis ticks based on the bin step, you can also set the axis's `tickMinStep `__ property. **Default value:** ``false`` **See also:** `bin `__ documentation. field : :class:`Field` **Required.** A string defining the name of the field from which to pull a data value or an object defining iterated values from the `repeat `__ operator. **See also:** `field `__ documentation. **Notes:** 1) Dots ( ``.`` ) and brackets ( ``[`` and ``]`` ) can be used to access nested objects (e.g., ``"field": "foo.bar"`` and ``"field": "foo['bar']"`` ). If field names contain dots or brackets but are not nested, you can use ``\`` to escape dots and brackets (e.g., ``"a\.b"`` and ``"a\[0\]"`` ). See more details about escaping in the `field documentation `__. 2) ``field`` is not required if ``aggregate`` is ``count``. timeUnit : anyOf(:class:`TimeUnit`, :class:`TimeUnitParams`) Time unit (e.g., ``year``, ``yearmonth``, ``month``, ``hours`` ) for a temporal field. or `a temporal field that gets casted as ordinal `__. **Default value:** ``undefined`` (None) **See also:** `timeUnit `__ documentation. title : anyOf(:class:`Text`, None) A title for the field. If ``null``, the title will be removed. **Default value:** derived from the field's name and transformation function ( ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function, the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ). Otherwise, the title is simply the field name. **Notes** : 1) You can customize the default field title format by providing the `fieldTitle `__ property in the `config `__ or `fieldTitle function via the compile function's options `__. 2) If both field definition's ``title`` and axis, header, or legend ``title`` are defined, axis/header/legend title will be used. type : string The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also be a ``"geojson"`` type for encoding `'geoshape' `__. Vega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal scale for a field with ``bin`` or ``timeUnit``. **Default value:** 1) For a data ``field``, ``"nominal"`` is the default data type unless the field encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or ``timeUnit`` that satisfies the following criteria: * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin`` or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a quantitative scale `__. * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit`` or (2) the specified scale type is a time or utc scale * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort order `__, (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is ``order``. 2) For a constant value in data domain ( ``datum`` ): * ``"quantitative"`` if the datum is a number * ``"nominal"`` if the datum is a string * ``"temporal"`` if the datum is `a date time object `__ **Note:** * Data ``type`` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data. * Data values for a temporal field can be either a date-time string (e.g., ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a timestamp number (e.g., ``1552199579097`` ). * When using with `bin `__, the ``type`` property can be either ``"quantitative"`` (for using a linear bin scale) or `"ordinal" (for using an ordinal bin scale) `__. * When using with `timeUnit `__, the ``type`` property can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal" (for using an ordinal scale) `__. * When using with `aggregate `__, the ``type`` property refers to the post-aggregation data type. For example, we can calculate count ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct", "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``. * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have ``type`` as they must have exactly the same type as their primary channels (e.g., ``x``, ``y`` ). **See also:** `type `__ documentation. F longituderKrLrbc dSrdrres rrfzLongitude.aggregate`rgr c dSrdrris rrfzLongitude.aggregatedrgr c dSrdrrls rrfzLongitude.aggregatehrgr c dSrdrres rrozLongitude.bandPositionlrpr Nc dSrdrres rrrz Longitude.binorpr c dSrdrres rrzLongitude.fieldrrgr c dSrdrrs rrzLongitude.fieldvrgr rc dSrdrres rrzLongitude.timeUnitzrgr rc dSrdrres rrzLongitude.timeUnit~rgr r#c dSrdrres rrzLongitude.timeUnitrgr rBc dSrdrres rrzLongitude.timeUnitrgr c dSrdrrbs rrzLongitude.timeUnitrgr c dSrdrres rrzLongitude.titlergr c dSrdrres rrzLongitude.titlergr c dSrdrres rrzLongitude.titlergr c dSrdrres rr"zLongitude.typerpr c Ztt|jd||||||||d| dSrU)r2rrprVs rrpzLongitude.__init__s['i' [)y5AsRW19T [ [UY [ [ [ [ [r )rbr)rKNrbrrUr<s@rrrs[[[x(-$ N  7$bc p{   X (    X (    X  e          s {   X $    X  '#PQ ^i   X  '#qr J   X  '#x y  F Q    X  '#O P  ] h    X (yyi    X  s {   X  tCy [   X    X  c k    "+ii]f 9II[[[[[[[[[[r rceZdZdZdZdZdeddfdZede ddfdZ ede e ddfdZ edd Z de d ddfd Z eeeffd ZxZS)LongitudeDatuma]LongitudeDatum schema wrapper Mapping(required=[]) Parameters ---------- bandPosition : float Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to ``0``, and at the middle of the band if set to ``0.5``. datum : anyOf(:class:`PrimitiveValue`, :class:`DateTime`, :class:`ExprRef`, :class:`RepeatRef`) A constant value in data domain. title : anyOf(:class:`Text`, None) A title for the field. If ``null``, the title will be removed. **Default value:** derived from the field's name and transformation function ( ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function, the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ). Otherwise, the title is simply the field name. **Notes** : 1) You can customize the default field title format by providing the `fieldTitle `__ property in the `config `__ or `fieldTitle function via the compile function's options `__. 2) If both field definition's ``title`` and axis, header, or legend ``title`` are defined, axis/header/legend title will be used. type : :class:`Type` The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also be a ``"geojson"`` type for encoding `'geoshape' `__. Vega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal scale for a field with ``bin`` or ``timeUnit``. **Default value:** 1) For a data ``field``, ``"nominal"`` is the default data type unless the field encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or ``timeUnit`` that satisfies the following criteria: * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin`` or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a quantitative scale `__. * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit`` or (2) the specified scale type is a time or utc scale * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort order `__, (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is ``order``. 2) For a constant value in data domain ( ``datum`` ): * ``"quantitative"`` if the datum is a number * ``"nominal"`` if the datum is a string * ``"temporal"`` if the datum is `a date time object `__ **Note:** * Data ``type`` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data. * Data values for a temporal field can be either a date-time string (e.g., ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a timestamp number (e.g., ``1552199579097`` ). * When using with `bin `__, the ``type`` property can be either ``"quantitative"`` (for using a linear bin scale) or `"ordinal" (for using an ordinal bin scale) `__. * When using with `timeUnit `__, the ``type`` property can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal" (for using an ordinal scale) `__. * When using with `aggregate `__, the ``type`` property refers to the post-aggregation data type. For example, we can calculate count ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct", "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``. * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have ``type`` as they must have exactly the same type as their primary channels (e.g., ``x``, ``y`` ). **See also:** `type `__ documentation. FrrKrbc dSrdrres rrozLongitudeDatum.bandPositionrpr c dSrdrres rrzLongitudeDatum.titlergr c dSrdrres rrzLongitudeDatum.titlergr Nc dSrdrres rrzLongitudeDatum.titlergr rc dSrdrres rr"zLongitudeDatum.type rpr c Rtt|jd||||d|dSr^)r2rrpr_s rrpzLongitudeDatum.__init__$rr )rKNrbrr`r<s@rrrrr rc(eZdZdZdZdZededddfdZee fddZee fdd Zde ddfd Z dd Z ede ddfd Zee fddZededddfdZededddfdZededddfdZededddfdZee e e e fddZede ddfdZedee ddfdZeddZe e e e e e e ffd ZxZS) Longitude2aLongitude2 schema wrapper Mapping(required=[shorthand]) A field definition of a secondary channel that shares a scale with another primary channel. For example, ``x2``, ``xError`` and ``xError2`` share the same scale with ``x``. Parameters ---------- shorthand : string shorthand for field, aggregate, and type aggregate : :class:`Aggregate` Aggregation function for the field (e.g., ``"mean"``, ``"sum"``, ``"median"``, ``"min"``, ``"max"``, ``"count"`` ). **Default value:** ``undefined`` (None) **See also:** `aggregate `__ documentation. bandPosition : float Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to ``0``, and at the middle of the band if set to ``0.5``. bin : None A flag for binning a ``quantitative`` field, `an object defining binning parameters `__, or indicating that the data for ``x`` or ``y`` channel are binned before they are imported into Vega-Lite ( ``"binned"`` ). If ``true``, default `binning parameters `__ will be applied. If ``"binned"``, this indicates that the data for the ``x`` (or ``y`` ) channel are already binned. You can map the bin-start field to ``x`` (or ``y`` ) and the bin-end field to ``x2`` (or ``y2`` ). The scale and axis will be formatted similar to binning in Vega-Lite. To adjust the axis ticks based on the bin step, you can also set the axis's `tickMinStep `__ property. **Default value:** ``false`` **See also:** `bin `__ documentation. field : :class:`Field` **Required.** A string defining the name of the field from which to pull a data value or an object defining iterated values from the `repeat `__ operator. **See also:** `field `__ documentation. **Notes:** 1) Dots ( ``.`` ) and brackets ( ``[`` and ``]`` ) can be used to access nested objects (e.g., ``"field": "foo.bar"`` and ``"field": "foo['bar']"`` ). If field names contain dots or brackets but are not nested, you can use ``\`` to escape dots and brackets (e.g., ``"a\.b"`` and ``"a\[0\]"`` ). See more details about escaping in the `field documentation `__. 2) ``field`` is not required if ``aggregate`` is ``count``. timeUnit : anyOf(:class:`TimeUnit`, :class:`TimeUnitParams`) Time unit (e.g., ``year``, ``yearmonth``, ``month``, ``hours`` ) for a temporal field. or `a temporal field that gets casted as ordinal `__. **Default value:** ``undefined`` (None) **See also:** `timeUnit `__ documentation. title : anyOf(:class:`Text`, None) A title for the field. If ``null``, the title will be removed. **Default value:** derived from the field's name and transformation function ( ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function, the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ). Otherwise, the title is simply the field name. **Notes** : 1) You can customize the default field title format by providing the `fieldTitle `__ property in the `config `__ or `fieldTitle function via the compile function's options `__. 2) If both field definition's ``title`` and axis, header, or legend ``title`` are defined, axis/header/legend title will be used. F longitude2rKrLrbc dSrdrres rrfzLongitude2.aggregatergr c dSrdrris rrfzLongitude2.aggregatergr c dSrdrrls rrfzLongitude2.aggregatergr c dSrdrres rrozLongitude2.bandPositionrpr Nc dSrdrres rrrzLongitude2.binrpr c dSrdrres rrzLongitude2.fieldrgr c dSrdrrs rrzLongitude2.fieldrgr rc dSrdrres rrzLongitude2.timeUnitrgr rc dSrdrres rrzLongitude2.timeUnitrgr r#c dSrdrres rrzLongitude2.timeUnitrgr rBc dSrdrres rrzLongitude2.timeUnitrgr c dSrdrrbs rrzLongitude2.timeUnitrgr c dSrdrres rrzLongitude2.titlergr c dSrdrres rrzLongitude2.titlergr c dSrdrres rrzLongitude2.titlergr c Xtt|jd|||||||d|dSrt)r2rrprus rrpzLongitude2.__init__sY(j$( Q9 6BSX2:% Q QKO Q Q Q Q Qr )rbr)rKNrbrrvr<s@rrr)s7XXr(-$!N  7$bc p|   X (    X (    X  e          s |   X $    X  '#PQ ^j   X  '#qr K   X  '#x y  F R    X  '#O P  ] i    X (yyi    X  s |   X  tCy \   X    X "+ii]f 9IQQQQQQQQQQr rceZdZdZdZdZdeddfdZede ddfdZ ede e ddfdZ edd Z de d ddfd Z eeeffd ZxZS)Longitude2Datuma^Longitude2Datum schema wrapper Mapping(required=[]) Parameters ---------- bandPosition : float Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to ``0``, and at the middle of the band if set to ``0.5``. datum : anyOf(:class:`PrimitiveValue`, :class:`DateTime`, :class:`ExprRef`, :class:`RepeatRef`) A constant value in data domain. title : anyOf(:class:`Text`, None) A title for the field. If ``null``, the title will be removed. **Default value:** derived from the field's name and transformation function ( ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function, the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ). Otherwise, the title is simply the field name. **Notes** : 1) You can customize the default field title format by providing the `fieldTitle `__ property in the `config `__ or `fieldTitle function via the compile function's options `__. 2) If both field definition's ``title`` and axis, header, or legend ``title`` are defined, axis/header/legend title will be used. type : :class:`Type` The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also be a ``"geojson"`` type for encoding `'geoshape' `__. Vega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal scale for a field with ``bin`` or ``timeUnit``. **Default value:** 1) For a data ``field``, ``"nominal"`` is the default data type unless the field encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or ``timeUnit`` that satisfies the following criteria: * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin`` or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a quantitative scale `__. * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit`` or (2) the specified scale type is a time or utc scale * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort order `__, (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is ``order``. 2) For a constant value in data domain ( ``datum`` ): * ``"quantitative"`` if the datum is a number * ``"nominal"`` if the datum is a string * ``"temporal"`` if the datum is `a date time object `__ **Note:** * Data ``type`` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data. * Data values for a temporal field can be either a date-time string (e.g., ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a timestamp number (e.g., ``1552199579097`` ). * When using with `bin `__, the ``type`` property can be either ``"quantitative"`` (for using a linear bin scale) or `"ordinal" (for using an ordinal bin scale) `__. * When using with `timeUnit `__, the ``type`` property can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal" (for using an ordinal scale) `__. * When using with `aggregate `__, the ``type`` property refers to the post-aggregation data type. For example, we can calculate count ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct", "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``. * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have ``type`` as they must have exactly the same type as their primary channels (e.g., ``x``, ``y`` ). **See also:** `type `__ documentation. FrrKrbc dSrdrres rrozLongitude2Datum.bandPosition5rpr c dSrdrres rrzLongitude2Datum.title8rgr c dSrdrres rrzLongitude2Datum.title<rgr Nc dSrdrres rrzLongitude2Datum.title@rgr rc dSrdrres rr"zLongitude2Datum.typeDrpr c Rtt|jd||||d|dSr^)r2rrpr_s rrpzLongitude2Datum.__init__HsR-ot$$- AE \a37 A A;? A A A A Ar )rKNrbrr`r<s@rrrs8ffN(-$!N e 0A     s '8   X  tCy ->   X    X  gYZ gx    ,5IIAAAAAAAAAAr rc*eZdZdZdZdZfdZxZS)Longitude2ValueaLongitude2Value schema wrapper Mapping(required=[value]) Definition object for a constant value (primitive value or gradient definition) of an encoding channel. Parameters ---------- value : anyOf(float, string, string, :class:`ExprRef`) A constant value in visual domain (e.g., ``"red"`` / ``"#0099ff"`` / `gradient definition `__ for color, values between ``0`` to ``1`` for opacity). Frc Ltt|jdd|i|dSr)r2rrprs rrpzLongitude2Value.__init__bs1-ot$$-BBEBTBBBBBr rr<s@rrrMsX  (-$!NCCCCCCCCCr rcCeZdZdZdZdZededddfdZee fd4dZee fd4d Zde ddfd Z ede ddfd Z ee e e e e e e e e e f d4d Z ed5dZ ee e fd4dZee e e fd4dZedeejddfdZededdfdZee fd4dZee e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e fBd4dZed5dZee e e e e e e e e e e e e e e e e e e e e e e fd4dZed5dZedee ddfdZedeeddfdZedee ddfdZedeejddfdZededddfdZededddfdZeded ddfd!Zee e e fd4d"Zee e fd4d#Zed5d$Zeded%ddfd&Zeded'ddfd(Zeded)ddfd*Zeded+ddfd,Zee e e e fd4d-Zededdfd.Zedeeddfd/Zed5d0Zded1ddfd2Ze e e e e e e e e e e e f fd3 ZxZS)6Opacitya|/Opacity schema wrapper Mapping(required=[shorthand]) Parameters ---------- shorthand : string shorthand for field, aggregate, and type aggregate : :class:`Aggregate` Aggregation function for the field (e.g., ``"mean"``, ``"sum"``, ``"median"``, ``"min"``, ``"max"``, ``"count"`` ). **Default value:** ``undefined`` (None) **See also:** `aggregate `__ documentation. bandPosition : float Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to ``0``, and at the middle of the band if set to ``0.5``. bin : anyOf(boolean, :class:`BinParams`, None) A flag for binning a ``quantitative`` field, `an object defining binning parameters `__, or indicating that the data for ``x`` or ``y`` channel are binned before they are imported into Vega-Lite ( ``"binned"`` ). If ``true``, default `binning parameters `__ will be applied. If ``"binned"``, this indicates that the data for the ``x`` (or ``y`` ) channel are already binned. You can map the bin-start field to ``x`` (or ``y`` ) and the bin-end field to ``x2`` (or ``y2`` ). The scale and axis will be formatted similar to binning in Vega-Lite. To adjust the axis ticks based on the bin step, you can also set the axis's `tickMinStep `__ property. **Default value:** ``false`` **See also:** `bin `__ documentation. condition : anyOf(:class:`ConditionalValueDefnumberExprRef`, List(:class:`ConditionalValueDefnumberExprRef`)) One or more value definition(s) with `a parameter or a test predicate `__. **Note:** A field definition's ``condition`` property can only contain `conditional value definitions `__ since Vega-Lite only allows at most one encoded field per encoding channel. field : :class:`Field` **Required.** A string defining the name of the field from which to pull a data value or an object defining iterated values from the `repeat `__ operator. **See also:** `field `__ documentation. **Notes:** 1) Dots ( ``.`` ) and brackets ( ``[`` and ``]`` ) can be used to access nested objects (e.g., ``"field": "foo.bar"`` and ``"field": "foo['bar']"`` ). If field names contain dots or brackets but are not nested, you can use ``\`` to escape dots and brackets (e.g., ``"a\.b"`` and ``"a\[0\]"`` ). See more details about escaping in the `field documentation `__. 2) ``field`` is not required if ``aggregate`` is ``count``. legend : anyOf(:class:`Legend`, None) An object defining properties of the legend. If ``null``, the legend for the encoding channel will be removed. **Default value:** If undefined, default `legend properties `__ are applied. **See also:** `legend `__ documentation. scale : anyOf(:class:`Scale`, None) An object defining properties of the channel's scale, which is the function that transforms values in the data domain (numbers, dates, strings, etc) to visual values (pixels, colors, sizes) of the encoding channels. If ``null``, the scale will be `disabled and the data value will be directly encoded `__. **Default value:** If undefined, default `scale properties `__ are applied. **See also:** `scale `__ documentation. sort : :class:`Sort` Sort order for the encoded field. For continuous fields (quantitative or temporal), ``sort`` can be either ``"ascending"`` or ``"descending"``. For discrete fields, ``sort`` can be one of the following: * ``"ascending"`` or ``"descending"`` -- for sorting by the values' natural order in JavaScript. * `A string indicating an encoding channel name to sort by `__ (e.g., ``"x"`` or ``"y"`` ) with an optional minus prefix for descending sort (e.g., ``"-x"`` to sort by x-field, descending). This channel string is short-form of `a sort-by-encoding definition `__. For example, ``"sort": "-x"`` is equivalent to ``"sort": {"encoding": "x", "order": "descending"}``. * `A sort field definition `__ for sorting by another field. * `An array specifying the field values in preferred order `__. In this case, the sort order will obey the values in the array, followed by any unspecified values in their original order. For discrete time field, values in the sort array can be `date-time definition objects `__. In addition, for time units ``"month"`` and ``"day"``, the values can be the month or day names (case insensitive) or their 3-letter initials (e.g., ``"Mon"``, ``"Tue"`` ). * ``null`` indicating no sort. **Default value:** ``"ascending"`` **Note:** ``null`` and sorting by another channel is not supported for ``row`` and ``column``. **See also:** `sort `__ documentation. timeUnit : anyOf(:class:`TimeUnit`, :class:`TimeUnitParams`) Time unit (e.g., ``year``, ``yearmonth``, ``month``, ``hours`` ) for a temporal field. or `a temporal field that gets casted as ordinal `__. **Default value:** ``undefined`` (None) **See also:** `timeUnit `__ documentation. title : anyOf(:class:`Text`, None) A title for the field. If ``null``, the title will be removed. **Default value:** derived from the field's name and transformation function ( ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function, the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ). Otherwise, the title is simply the field name. **Notes** : 1) You can customize the default field title format by providing the `fieldTitle `__ property in the `config `__ or `fieldTitle function via the compile function's options `__. 2) If both field definition's ``title`` and axis, header, or legend ``title`` are defined, axis/header/legend title will be used. type : :class:`StandardType` The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also be a ``"geojson"`` type for encoding `'geoshape' `__. Vega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal scale for a field with ``bin`` or ``timeUnit``. **Default value:** 1) For a data ``field``, ``"nominal"`` is the default data type unless the field encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or ``timeUnit`` that satisfies the following criteria: * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin`` or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a quantitative scale `__. * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit`` or (2) the specified scale type is a time or utc scale * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort order `__, (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is ``order``. 2) For a constant value in data domain ( ``datum`` ): * ``"quantitative"`` if the datum is a number * ``"nominal"`` if the datum is a string * ``"temporal"`` if the datum is `a date time object `__ **Note:** * Data ``type`` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data. * Data values for a temporal field can be either a date-time string (e.g., ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a timestamp number (e.g., ``1552199579097`` ). * When using with `bin `__, the ``type`` property can be either ``"quantitative"`` (for using a linear bin scale) or `"ordinal" (for using an ordinal bin scale) `__. * When using with `timeUnit `__, the ``type`` property can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal" (for using an ordinal scale) `__. * When using with `aggregate `__, the ``type`` property refers to the post-aggregation data type. For example, we can calculate count ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct", "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``. * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have ``type`` as they must have exactly the same type as their primary channels (e.g., ``x``, ``y`` ). **See also:** `type `__ documentation. FrrKrLrbc dSrdrres rrfzOpacity.aggregateKrgr c dSrdrris rrfzOpacity.aggregateOrgr c dSrdrrls rrfzOpacity.aggregateSrgr c dSrdrres rrozOpacity.bandPositionWrpr c dSrdrres rrrz Opacity.binZrgr c  dSrdrrts rrrz Opacity.bin^rgr Nc dSrdrres rrrz Opacity.binbrgr c dSrdrrs rr@zOpacity.conditionfrgr c dSrdrrs rr@zOpacity.conditionjrgr c dSrdrres rr@zOpacity.conditionnrgr c dSrdrres rrz Opacity.fieldrrgr c dSrdrrs rrz Opacity.fieldvrgr cC dSrdrrsD rrzOpacity.legendzrgr c dSrdrres rrzOpacity.legend~rgr c dSrdrrs rrz Opacity.scalergr c dSrdrres rrz Opacity.scalergr c dSrdrres rrz Opacity.sortrgr c dSrdrres rrz Opacity.sortrgr c dSrdrres rrz Opacity.sortrgr c dSrdrres rrz Opacity.sortrgr rc dSrdrres rrz Opacity.sortrgr rc dSrdrres rrz Opacity.sortrgr rc dSrdrres rrz Opacity.sortrgr c dSrdrrs rrz Opacity.sortrgr c dSrdrrs rrz Opacity.sortrgr c dSrdrres rrz Opacity.sortrgr rc dSrdrres rrzOpacity.timeUnitrgr rc dSrdrres rrzOpacity.timeUnitrgr r#c dSrdrres rrzOpacity.timeUnitrgr rBc dSrdrres rrzOpacity.timeUnitrgr c dSrdrrbs rrzOpacity.timeUnitrgr c dSrdrres rrz Opacity.titlergr c dSrdrres rrz Opacity.titlergr c dSrdrres rrz Opacity.titlergr rhc dSrdrres rr"z Opacity.typerpr c  btt|jd||||||||| | | | d | dSro)r2rrprqs rrpzOpacity.__init__sk &gt% Y Y3?ST],1&TX/7u4 Y YTX Y Y Y Y Yr )rbr)rKNrbrrsr<s@rrrfs= __@(-$N  7$bc py   X (    X (    X  e      T i   X "9Y_hr{FOV_fow@    X    X &i    X 'y     X  4 EF S\   X  s y   X $    X # \et}LUajvHQ^gxAS\r{QZnwCLYbr{HQ]fr{KTen@ I V _ m v E N ] f u ~ P Y c l v  H Q Z c m v C L Z c p y LUgp~GV_oxENbkHU^jsAJR[hqHXanwCL\evQZgpBKZcqzIRYbkt}F    X    X #))9_hqzGP\eqzEN\eluHW`ox@IT]hq{DLU^gnw~G    X    X  d5k i   X  d3i I   X  d4j Y   X  d4=) i   X  g78 Y   X  gUV cl   X  gab ox   X "y     X %Y    X    X  '#PQ ^g   X  '#qr H   X  '#x y  F O    X  '#O P  ] f    X (yyi    X  s y   X  tCy Y   X    X  gNO \e    "+ii]f$Iiy)99YYYYYYYYYYr rc8eZdZdZdZdZdeddfdZee e fddZ ee e e fddZ ede e j ddfd Z ededdfd Zede eddfd Zedd ZdedddfdZe e e e ffd ZxZS) OpacityDatumaiOpacityDatum schema wrapper Mapping(required=[]) Parameters ---------- bandPosition : float Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to ``0``, and at the middle of the band if set to ``0.5``. condition : anyOf(:class:`ConditionalValueDefnumberExprRef`, List(:class:`ConditionalValueDefnumberExprRef`)) One or more value definition(s) with `a parameter or a test predicate `__. **Note:** A field definition's ``condition`` property can only contain `conditional value definitions `__ since Vega-Lite only allows at most one encoded field per encoding channel. datum : anyOf(:class:`PrimitiveValue`, :class:`DateTime`, :class:`ExprRef`, :class:`RepeatRef`) A constant value in data domain. title : anyOf(:class:`Text`, None) A title for the field. If ``null``, the title will be removed. **Default value:** derived from the field's name and transformation function ( ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function, the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ). Otherwise, the title is simply the field name. **Notes** : 1) You can customize the default field title format by providing the `fieldTitle `__ property in the `config `__ or `fieldTitle function via the compile function's options `__. 2) If both field definition's ``title`` and axis, header, or legend ``title`` are defined, axis/header/legend title will be used. type : :class:`Type` The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also be a ``"geojson"`` type for encoding `'geoshape' `__. Vega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal scale for a field with ``bin`` or ``timeUnit``. **Default value:** 1) For a data ``field``, ``"nominal"`` is the default data type unless the field encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or ``timeUnit`` that satisfies the following criteria: * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin`` or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a quantitative scale `__. * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit`` or (2) the specified scale type is a time or utc scale * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort order `__, (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is ``order``. 2) For a constant value in data domain ( ``datum`` ): * ``"quantitative"`` if the datum is a number * ``"nominal"`` if the datum is a string * ``"temporal"`` if the datum is `a date time object `__ **Note:** * Data ``type`` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data. * Data values for a temporal field can be either a date-time string (e.g., ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a timestamp number (e.g., ``1552199579097`` ). * When using with `bin `__, the ``type`` property can be either ``"quantitative"`` (for using a linear bin scale) or `"ordinal" (for using an ordinal bin scale) `__. * When using with `timeUnit `__, the ``type`` property can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal" (for using an ordinal scale) `__. * When using with `aggregate `__, the ``type`` property refers to the post-aggregation data type. For example, we can calculate count ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct", "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``. * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have ``type`` as they must have exactly the same type as their primary channels (e.g., ``x``, ``y`` ). **See also:** `type `__ documentation. FrrKrbc dSrdrres rrozOpacityDatum.bandPositionRrpr c dSrdrrs rr@zOpacityDatum.conditionUrgr c dSrdrrs rr@zOpacityDatum.conditionYrgr c dSrdrres rr@zOpacityDatum.condition]rgr c dSrdrres rrzOpacityDatum.titleargr c dSrdrres rrzOpacityDatum.titleergr Nc dSrdrres rrzOpacityDatum.titleirgr rc dSrdrres rr"zOpacityDatum.typemrpr c Ttt|jd|||||d|dSr)r2rrprs rrpzOpacityDatum.__init__qsT*lD!!* K\]f16T K KEI K K K K Kr )rbr)rKNrbrrr<s@rrrsmm\(-$N e     &i    X 'y     X  4 EF Sa   X  s ~   X  tCy ^   X    X  gYZ gu    ,5 QZKKKKKKKKKKr rc VeZdZdZdZdZeeeeeeeeeeeef ddZeeeeeeeefddZeeeeeeeeeeeeef ddZeeeeeeeeefddZeeefdd Zeeeefdd Zed e e j ddfd Zeffd Z xZ S) OpacityValueafOpacityValue schema wrapper Mapping(required=[]) Parameters ---------- condition : anyOf(:class:`ConditionalMarkPropFieldOrDatumDef`, :class:`ConditionalValueDefnumberExprRef`, List(:class:`ConditionalValueDefnumberExprRef`)) A field definition or one or more value definition(s) with a parameter predicate. value : anyOf(float, :class:`ExprRef`) A constant value in visual domain (e.g., ``"red"`` / ``"#0099ff"`` / `gradient definition `__ for color, values between ``0`` to ``1`` for opacity). Frrbc  dSrdrrs rr@zOpacityValue.conditionrgr c dSrdrrs rr@zOpacityValue.conditionrgr c  dSrdrrs rr@zOpacityValue.conditionrgr c  dSrdrrs rr@zOpacityValue.conditionrgr c dSrdrrs rr@zOpacityValue.conditionrgr c dSrdrrs rr@zOpacityValue.conditionrgr rKc dSrdrres rr@zOpacityValue.conditionrgr c Ntt|jd||d|dSr)r2rrprs rrpzOpacityValue.__init__3*lD!!*T)TTtTTTTTr )rbrrr<s@rrrws4  (-$N "+)Zclu~GNW^gr{CLS\    X %.i Ybir{DKT    X "+)Zckt~GOX`ipyDMU^en    X %.iyYbjs|EMV]f    X &i    X 'y     X  4 EF Sa   X )2UUUUUUUUUUr rc eZdZdZdZdZededddfdZee fd#dZee fd#d Zde ddfd Z ede ddfd Z ee e e e e e e e e e f d#d Z ededdfd Z ed$dZ ededdfdZee fd#dZdedddfdZededddfdZededddfdZededddfdZededddfdZee e e e fd#dZededdfdZedeeddfdZed$dZded ddfd!Ze e e e e e e e e f fd" ZxZS)%Ordera!Order schema wrapper Mapping(required=[shorthand]) Parameters ---------- shorthand : string shorthand for field, aggregate, and type aggregate : :class:`Aggregate` Aggregation function for the field (e.g., ``"mean"``, ``"sum"``, ``"median"``, ``"min"``, ``"max"``, ``"count"`` ). **Default value:** ``undefined`` (None) **See also:** `aggregate `__ documentation. bandPosition : float Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to ``0``, and at the middle of the band if set to ``0.5``. bin : anyOf(boolean, :class:`BinParams`, string, None) A flag for binning a ``quantitative`` field, `an object defining binning parameters `__, or indicating that the data for ``x`` or ``y`` channel are binned before they are imported into Vega-Lite ( ``"binned"`` ). If ``true``, default `binning parameters `__ will be applied. If ``"binned"``, this indicates that the data for the ``x`` (or ``y`` ) channel are already binned. You can map the bin-start field to ``x`` (or ``y`` ) and the bin-end field to ``x2`` (or ``y2`` ). The scale and axis will be formatted similar to binning in Vega-Lite. To adjust the axis ticks based on the bin step, you can also set the axis's `tickMinStep `__ property. **Default value:** ``false`` **See also:** `bin `__ documentation. field : :class:`Field` **Required.** A string defining the name of the field from which to pull a data value or an object defining iterated values from the `repeat `__ operator. **See also:** `field `__ documentation. **Notes:** 1) Dots ( ``.`` ) and brackets ( ``[`` and ``]`` ) can be used to access nested objects (e.g., ``"field": "foo.bar"`` and ``"field": "foo['bar']"`` ). If field names contain dots or brackets but are not nested, you can use ``\`` to escape dots and brackets (e.g., ``"a\.b"`` and ``"a\[0\]"`` ). See more details about escaping in the `field documentation `__. 2) ``field`` is not required if ``aggregate`` is ``count``. sort : :class:`SortOrder` The sort order. One of ``"ascending"`` (default) or ``"descending"``. timeUnit : anyOf(:class:`TimeUnit`, :class:`TimeUnitParams`) Time unit (e.g., ``year``, ``yearmonth``, ``month``, ``hours`` ) for a temporal field. or `a temporal field that gets casted as ordinal `__. **Default value:** ``undefined`` (None) **See also:** `timeUnit `__ documentation. title : anyOf(:class:`Text`, None) A title for the field. If ``null``, the title will be removed. **Default value:** derived from the field's name and transformation function ( ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function, the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ). Otherwise, the title is simply the field name. **Notes** : 1) You can customize the default field title format by providing the `fieldTitle `__ property in the `config `__ or `fieldTitle function via the compile function's options `__. 2) If both field definition's ``title`` and axis, header, or legend ``title`` are defined, axis/header/legend title will be used. type : :class:`StandardType` The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also be a ``"geojson"`` type for encoding `'geoshape' `__. Vega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal scale for a field with ``bin`` or ``timeUnit``. **Default value:** 1) For a data ``field``, ``"nominal"`` is the default data type unless the field encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or ``timeUnit`` that satisfies the following criteria: * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin`` or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a quantitative scale `__. * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit`` or (2) the specified scale type is a time or utc scale * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort order `__, (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is ``order``. 2) For a constant value in data domain ( ``datum`` ): * ``"quantitative"`` if the datum is a number * ``"nominal"`` if the datum is a string * ``"temporal"`` if the datum is `a date time object `__ **Note:** * Data ``type`` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data. * Data values for a temporal field can be either a date-time string (e.g., ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a timestamp number (e.g., ``1552199579097`` ). * When using with `bin `__, the ``type`` property can be either ``"quantitative"`` (for using a linear bin scale) or `"ordinal" (for using an ordinal bin scale) `__. * When using with `timeUnit `__, the ``type`` property can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal" (for using an ordinal scale) `__. * When using with `aggregate `__, the ``type`` property refers to the post-aggregation data type. For example, we can calculate count ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct", "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``. * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have ``type`` as they must have exactly the same type as their primary channels (e.g., ``x``, ``y`` ). **See also:** `type `__ documentation. FrrKrLrbc dSrdrres rrfzOrder.aggregateNrgr c dSrdrris rrfzOrder.aggregateRrgr c dSrdrrls rrfzOrder.aggregateVrgr c dSrdrres rrozOrder.bandPositionZrpr c dSrdrres rrrz Order.bin]rgr c  dSrdrrts rrrz Order.binargr c dSrdrres rrrz Order.binergr Nc dSrdrres rrrz Order.binirgr c dSrdrres rrz Order.fieldmrgr c dSrdrrs rrz Order.fieldqrgr rc dSrdrres rrz Order.sorturpr rc dSrdrres rrzOrder.timeUnitxrgr rc dSrdrres rrzOrder.timeUnit|rgr r#c dSrdrres rrzOrder.timeUnitrgr rBc dSrdrres rrzOrder.timeUnitrgr c dSrdrrbs rrzOrder.timeUnitrgr c dSrdrres rrz Order.titlergr c dSrdrres rrz Order.titlergr c dSrdrres rrz Order.titlergr rhc dSrdrres rr"z Order.typerpr c \tt|jd||||||||| d | dS)N) rrfrorrrrrrr"r)r2rrp) rrrfrorrrrrrr"rrs rrpzOrder.__init__sX $eT# 7i9[g(+5th^c)- 7 715 7 7 7 7 7r )rbr)rKNrbr)r'r9r:rtrurvrr rfrrwrorxrrr.rrrrr r"rpr;r<s@rrrs;]]|(-$N  7$bc pw   X (    X (    X  e      T g   X "9Y_hr{FOV_fow@    X  S W   X    X  s w   X $    X  g78 W     '#PQ ^e   X  '#qr F   X  '#x y  F M    X  '#O P  ] d    X (yyi    X  s w   X  tCy W   X    X  gNO \c    "+ii]f y9I\e7777777777r rceZdZdZdZdZeeefd dZeeeefd dZede e j ddfdZeffd Z xZ S) OrderValueapOrderValue schema wrapper Mapping(required=[value]) Parameters ---------- value : anyOf(float, :class:`ExprRef`) A constant value in visual domain (e.g., ``"red"`` / ``"#0099ff"`` / `gradient definition `__ for color, values between ``0`` to ``1`` for opacity). condition : anyOf(:class:`ConditionalValueDefnumber`, List(:class:`ConditionalValueDefnumber`)) One or more value definition(s) with `a parameter or a test predicate `__. **Note:** A field definition's ``condition`` property can only contain `conditional value definitions `__ since Vega-Lite only allows at most one encoded field per encoding channel. Frrbc dSrdrrs rr@zOrderValue.conditionrgr c dSrdrrs rr@zOrderValue.conditionrgr rKc dSrdrres rr@zOrderValue.conditionrgr c Ntt|jd||d|dSr)r2rrprs rrpzOrderValue.__init__rr )rbr)r'r9r:rtrurvrrr@r rConditionalValueDefnumberrpr;r<s@rrrs&(-$N &i    X 'y     X  4 >? L   X )2SSSSSSSSSSr rc"eZdZdZdZdZededddfdZee fd4dZee fd4d Zde ddfd Z ede ddfd Z ee e e e e e e e e e f d4d Z ededdfd Z ed5dZ ededdfdZee fd4dZee e e e e e e e e e e e e e e e e e e e e e e fd4dZed5dZedee ddfdZedeeddfdZedee ddfdZedeejddfdZededddfdZededddfdZededddfdZee e e fd4dZee e fd4dZed5d Zeded!ddfd"Zed5d#Zede ddfd$Zeded%ddfd&Zeded'ddfd(Zeded)ddfd*Zeded+ddfd,Zee e e e fd4d-Zededdfd.Zedeeddfd/Zed5d0Zded1ddfd2Ze e e e e e e e e e e f fd3 ZxZS)6Radiusa2Radius schema wrapper Mapping(required=[shorthand]) Parameters ---------- shorthand : string shorthand for field, aggregate, and type aggregate : :class:`Aggregate` Aggregation function for the field (e.g., ``"mean"``, ``"sum"``, ``"median"``, ``"min"``, ``"max"``, ``"count"`` ). **Default value:** ``undefined`` (None) **See also:** `aggregate `__ documentation. bandPosition : float Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to ``0``, and at the middle of the band if set to ``0.5``. bin : anyOf(boolean, :class:`BinParams`, string, None) A flag for binning a ``quantitative`` field, `an object defining binning parameters `__, or indicating that the data for ``x`` or ``y`` channel are binned before they are imported into Vega-Lite ( ``"binned"`` ). If ``true``, default `binning parameters `__ will be applied. If ``"binned"``, this indicates that the data for the ``x`` (or ``y`` ) channel are already binned. You can map the bin-start field to ``x`` (or ``y`` ) and the bin-end field to ``x2`` (or ``y2`` ). The scale and axis will be formatted similar to binning in Vega-Lite. To adjust the axis ticks based on the bin step, you can also set the axis's `tickMinStep `__ property. **Default value:** ``false`` **See also:** `bin `__ documentation. field : :class:`Field` **Required.** A string defining the name of the field from which to pull a data value or an object defining iterated values from the `repeat `__ operator. **See also:** `field `__ documentation. **Notes:** 1) Dots ( ``.`` ) and brackets ( ``[`` and ``]`` ) can be used to access nested objects (e.g., ``"field": "foo.bar"`` and ``"field": "foo['bar']"`` ). If field names contain dots or brackets but are not nested, you can use ``\`` to escape dots and brackets (e.g., ``"a\.b"`` and ``"a\[0\]"`` ). See more details about escaping in the `field documentation `__. 2) ``field`` is not required if ``aggregate`` is ``count``. scale : anyOf(:class:`Scale`, None) An object defining properties of the channel's scale, which is the function that transforms values in the data domain (numbers, dates, strings, etc) to visual values (pixels, colors, sizes) of the encoding channels. If ``null``, the scale will be `disabled and the data value will be directly encoded `__. **Default value:** If undefined, default `scale properties `__ are applied. **See also:** `scale `__ documentation. sort : :class:`Sort` Sort order for the encoded field. For continuous fields (quantitative or temporal), ``sort`` can be either ``"ascending"`` or ``"descending"``. For discrete fields, ``sort`` can be one of the following: * ``"ascending"`` or ``"descending"`` -- for sorting by the values' natural order in JavaScript. * `A string indicating an encoding channel name to sort by `__ (e.g., ``"x"`` or ``"y"`` ) with an optional minus prefix for descending sort (e.g., ``"-x"`` to sort by x-field, descending). This channel string is short-form of `a sort-by-encoding definition `__. For example, ``"sort": "-x"`` is equivalent to ``"sort": {"encoding": "x", "order": "descending"}``. * `A sort field definition `__ for sorting by another field. * `An array specifying the field values in preferred order `__. In this case, the sort order will obey the values in the array, followed by any unspecified values in their original order. For discrete time field, values in the sort array can be `date-time definition objects `__. In addition, for time units ``"month"`` and ``"day"``, the values can be the month or day names (case insensitive) or their 3-letter initials (e.g., ``"Mon"``, ``"Tue"`` ). * ``null`` indicating no sort. **Default value:** ``"ascending"`` **Note:** ``null`` and sorting by another channel is not supported for ``row`` and ``column``. **See also:** `sort `__ documentation. stack : anyOf(:class:`StackOffset`, None, boolean) Type of stacking offset if the field should be stacked. ``stack`` is only applicable for ``x``, ``y``, ``theta``, and ``radius`` channels with continuous domains. For example, ``stack`` of ``y`` can be used to customize stacking for a vertical bar chart. ``stack`` can be one of the following values: * ``"zero"`` or `true`: stacking with baseline offset at zero value of the scale (for creating typical stacked [bar](https://vega.github.io/vega-lite/docs/stack.html#bar) and `area `__ chart). * ``"normalize"`` - stacking with normalized domain (for creating `normalized stacked bar and area charts `__ and pie charts `with percentage tooltip `__ ). :raw-html:`
` * ``"center"`` - stacking with center baseline (for `streamgraph `__ ). * ``null`` or ``false`` - No-stacking. This will produce layered `bar `__ and area chart. **Default value:** ``zero`` for plots with all of the following conditions are true: (1) the mark is ``bar``, ``area``, or ``arc`` ; (2) the stacked measure channel (x or y) has a linear scale; (3) At least one of non-position channels mapped to an unaggregated field that is different from x and y. Otherwise, ``null`` by default. **See also:** `stack `__ documentation. timeUnit : anyOf(:class:`TimeUnit`, :class:`TimeUnitParams`) Time unit (e.g., ``year``, ``yearmonth``, ``month``, ``hours`` ) for a temporal field. or `a temporal field that gets casted as ordinal `__. **Default value:** ``undefined`` (None) **See also:** `timeUnit `__ documentation. title : anyOf(:class:`Text`, None) A title for the field. If ``null``, the title will be removed. **Default value:** derived from the field's name and transformation function ( ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function, the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ). Otherwise, the title is simply the field name. **Notes** : 1) You can customize the default field title format by providing the `fieldTitle `__ property in the `config `__ or `fieldTitle function via the compile function's options `__. 2) If both field definition's ``title`` and axis, header, or legend ``title`` are defined, axis/header/legend title will be used. type : :class:`StandardType` The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also be a ``"geojson"`` type for encoding `'geoshape' `__. Vega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal scale for a field with ``bin`` or ``timeUnit``. **Default value:** 1) For a data ``field``, ``"nominal"`` is the default data type unless the field encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or ``timeUnit`` that satisfies the following criteria: * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin`` or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a quantitative scale `__. * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit`` or (2) the specified scale type is a time or utc scale * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort order `__, (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is ``order``. 2) For a constant value in data domain ( ``datum`` ): * ``"quantitative"`` if the datum is a number * ``"nominal"`` if the datum is a string * ``"temporal"`` if the datum is `a date time object `__ **Note:** * Data ``type`` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data. * Data values for a temporal field can be either a date-time string (e.g., ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a timestamp number (e.g., ``1552199579097`` ). * When using with `bin `__, the ``type`` property can be either ``"quantitative"`` (for using a linear bin scale) or `"ordinal" (for using an ordinal bin scale) `__. * When using with `timeUnit `__, the ``type`` property can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal" (for using an ordinal scale) `__. * When using with `aggregate `__, the ``type`` property refers to the post-aggregation data type. For example, we can calculate count ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct", "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``. * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have ``type`` as they must have exactly the same type as their primary channels (e.g., ``x``, ``y`` ). **See also:** `type `__ documentation. FradiusrKrLrbc dSrdrres rrfzRadius.aggregatergr c dSrdrris rrfzRadius.aggregatergr c dSrdrrls rrfzRadius.aggregatergr c dSrdrres rrozRadius.bandPositionrpr c dSrdrres rrrz Radius.binrgr c  dSrdrrts rrrz Radius.binrgr c dSrdrres rrrz Radius.binrgr Nc dSrdrres rrrz Radius.binrgr c dSrdrres rrz Radius.fieldrgr c dSrdrrs rrz Radius.fieldrgr c dSrdrrs rrz Radius.scalergr c dSrdrres rrz Radius.scalergr c dSrdrres rrz Radius.sortrgr c dSrdrres rrz Radius.sortrgr c dSrdrres rrz Radius.sortrgr c dSrdrres rrz Radius.sortrgr rc dSrdrres rrz Radius.sortrgr rc dSrdrres rrz Radius.sortrgr rc dSrdrres rrz Radius.sortrgr c dSrdrrs rrz Radius.sort rgr c dSrdrrs rrz Radius.sortrgr c dSrdrres rrz Radius.sortrgr rr normalizec dSrdrres rstackz Radius.stackrgr c dSrdrres rr7z Radius.stackrgr c dSrdrres rr7z Radius.stack rgr rc dSrdrres rrzRadius.timeUnit$rgr rc dSrdrres rrzRadius.timeUnit(rgr r#c dSrdrres rrzRadius.timeUnit,rgr rBc dSrdrres rrzRadius.timeUnit0rgr c dSrdrrbs rrzRadius.timeUnit4rgr c dSrdrres rrz Radius.title8rgr c dSrdrres rrz Radius.title<rgr c dSrdrres rrz Radius.title@rgr rhc dSrdrres rr"z Radius.typeDrpr c  `tt|jd||||||||| | | d | dSN) rrfrorrrrrr7rrr"r)r2rrprrrfrorrrrrr7rrr"rrs rrpzRadius.__init__Hs_ %fd$ -yI2>Cu\a*.ehV[bf - -(, - - - - -r )rbr)rKNrbrr'r9r:rtrurvrr rfrrwrorxrrr.rrr rrrzr7rrr"rpr;r<s@rrrsXnn^(-$N  7$bc px   X (    X (    X  e      T h   X "9Y_hr{FOV_fow@    X  S X   X    X  s x   X $    X #))9_hqzGP\eqzEN\eluHW`ox@IT]hq{DLU^gnw~G    X    X  d5k h   X  d3i H   X  d4j X   X  d4=) h   X  g78 X   X  gUV ck   X  gab ow   X "y     X %Y    X    X  w<= (   X    X  t    X  '#PQ ^f   X  '#qr G   X  '#x y  F N    X  '#O P  ] e    X (yyi    X  s x   X  tCy X   X    X  gNO \d    "+ii]f ]f y----------r rceZdZdZdZdZdeddfdZee e e e e e e e e e e e e e e e e e e e e e e fddZ edd Z ede d ddfd Z edd Z ede ddfd Z ededdfdZedeeddfdZeddZde dddfdZe e e e e ffd ZxZS) RadiusDatuma< RadiusDatum schema wrapper Mapping(required=[]) Parameters ---------- bandPosition : float Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to ``0``, and at the middle of the band if set to ``0.5``. datum : anyOf(:class:`PrimitiveValue`, :class:`DateTime`, :class:`ExprRef`, :class:`RepeatRef`) A constant value in data domain. scale : anyOf(:class:`Scale`, None) An object defining properties of the channel's scale, which is the function that transforms values in the data domain (numbers, dates, strings, etc) to visual values (pixels, colors, sizes) of the encoding channels. If ``null``, the scale will be `disabled and the data value will be directly encoded `__. **Default value:** If undefined, default `scale properties `__ are applied. **See also:** `scale `__ documentation. stack : anyOf(:class:`StackOffset`, None, boolean) Type of stacking offset if the field should be stacked. ``stack`` is only applicable for ``x``, ``y``, ``theta``, and ``radius`` channels with continuous domains. For example, ``stack`` of ``y`` can be used to customize stacking for a vertical bar chart. ``stack`` can be one of the following values: * ``"zero"`` or `true`: stacking with baseline offset at zero value of the scale (for creating typical stacked [bar](https://vega.github.io/vega-lite/docs/stack.html#bar) and `area `__ chart). * ``"normalize"`` - stacking with normalized domain (for creating `normalized stacked bar and area charts `__ and pie charts `with percentage tooltip `__ ). :raw-html:`
` * ``"center"`` - stacking with center baseline (for `streamgraph `__ ). * ``null`` or ``false`` - No-stacking. This will produce layered `bar `__ and area chart. **Default value:** ``zero`` for plots with all of the following conditions are true: (1) the mark is ``bar``, ``area``, or ``arc`` ; (2) the stacked measure channel (x or y) has a linear scale; (3) At least one of non-position channels mapped to an unaggregated field that is different from x and y. Otherwise, ``null`` by default. **See also:** `stack `__ documentation. title : anyOf(:class:`Text`, None) A title for the field. If ``null``, the title will be removed. **Default value:** derived from the field's name and transformation function ( ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function, the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ). Otherwise, the title is simply the field name. **Notes** : 1) You can customize the default field title format by providing the `fieldTitle `__ property in the `config `__ or `fieldTitle function via the compile function's options `__. 2) If both field definition's ``title`` and axis, header, or legend ``title`` are defined, axis/header/legend title will be used. type : :class:`Type` The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also be a ``"geojson"`` type for encoding `'geoshape' `__. Vega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal scale for a field with ``bin`` or ``timeUnit``. **Default value:** 1) For a data ``field``, ``"nominal"`` is the default data type unless the field encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or ``timeUnit`` that satisfies the following criteria: * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin`` or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a quantitative scale `__. * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit`` or (2) the specified scale type is a time or utc scale * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort order `__, (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is ``order``. 2) For a constant value in data domain ( ``datum`` ): * ``"quantitative"`` if the datum is a number * ``"nominal"`` if the datum is a string * ``"temporal"`` if the datum is `a date time object `__ **Note:** * Data ``type`` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data. * Data values for a temporal field can be either a date-time string (e.g., ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a timestamp number (e.g., ``1552199579097`` ). * When using with `bin `__, the ``type`` property can be either ``"quantitative"`` (for using a linear bin scale) or `"ordinal" (for using an ordinal bin scale) `__. * When using with `timeUnit `__, the ``type`` property can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal" (for using an ordinal scale) `__. * When using with `aggregate `__, the ``type`` property refers to the post-aggregation data type. For example, we can calculate count ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct", "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``. * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have ``type`` as they must have exactly the same type as their primary channels (e.g., ``x``, ``y`` ). **See also:** `type `__ documentation. FrrKrbc dSrdrres rrozRadiusDatum.bandPositionrpr c dSrdrrs rrzRadiusDatum.scalergr Nc dSrdrres rrzRadiusDatum.scalergr r4c dSrdrres rr7zRadiusDatum.stackrgr c dSrdrres rr7zRadiusDatum.stackrgr c dSrdrres rr7zRadiusDatum.stackrgr c dSrdrres rrzRadiusDatum.titlergr c dSrdrres rrzRadiusDatum.titlergr c dSrdrres rrzRadiusDatum.titlergr rc dSrdrres rr"zRadiusDatum.type rpr c Vtt|jd||||||d|dSN)rGrorr7rr"r)r2rHrp rrGrorr7rr"rrs rrpzRadiusDatum.__init__sV)k4  ) WLX]05U W WQU W W W W Wr )rbrH)rKNrbrHr'r9r:rtrurvrwrorrrr r7rxr.rr r"rpr;r<s@rrHrHQsRRf(-$N e     #))9_hqzGP\eqzEN\eluHW`ox@IT]hq{DLU^gnw~G    X    X  w<= -   X    X  t    X  s }   X  tCy ]   X    X  gYZ gt    ,5IY^gWWWWWWWWWWr rHc*eZdZdZdZdZfdZxZS) RadiusValueaRadiusValue schema wrapper Mapping(required=[value]) Definition object for a constant value (primitive value or gradient definition) of an encoding channel. Parameters ---------- value : anyOf(float, string, string, :class:`ExprRef`) A constant value in visual domain (e.g., ``"red"`` / ``"#0099ff"`` / `gradient definition `__ for color, values between ``0`` to ``1`` for opacity). Frc Ltt|jdd|i|dSr)r2rXrprs rrpzRadiusValue.__init__+1)k4  )>>>>>>>>r rr<s@rrXrXO  (-$N?????????r rXc(eZdZdZdZdZededddfdZee fddZee fdd Zde ddfd Z dd Z ede ddfd Zee fddZededddfdZededddfdZededddfdZededddfdZee e e e fddZede ddfdZedee ddfdZeddZe e e e e e e ffd ZxZS)Radius2aRadius2 schema wrapper Mapping(required=[shorthand]) A field definition of a secondary channel that shares a scale with another primary channel. For example, ``x2``, ``xError`` and ``xError2`` share the same scale with ``x``. Parameters ---------- shorthand : string shorthand for field, aggregate, and type aggregate : :class:`Aggregate` Aggregation function for the field (e.g., ``"mean"``, ``"sum"``, ``"median"``, ``"min"``, ``"max"``, ``"count"`` ). **Default value:** ``undefined`` (None) **See also:** `aggregate `__ documentation. bandPosition : float Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to ``0``, and at the middle of the band if set to ``0.5``. bin : None A flag for binning a ``quantitative`` field, `an object defining binning parameters `__, or indicating that the data for ``x`` or ``y`` channel are binned before they are imported into Vega-Lite ( ``"binned"`` ). If ``true``, default `binning parameters `__ will be applied. If ``"binned"``, this indicates that the data for the ``x`` (or ``y`` ) channel are already binned. You can map the bin-start field to ``x`` (or ``y`` ) and the bin-end field to ``x2`` (or ``y2`` ). The scale and axis will be formatted similar to binning in Vega-Lite. To adjust the axis ticks based on the bin step, you can also set the axis's `tickMinStep `__ property. **Default value:** ``false`` **See also:** `bin `__ documentation. field : :class:`Field` **Required.** A string defining the name of the field from which to pull a data value or an object defining iterated values from the `repeat `__ operator. **See also:** `field `__ documentation. **Notes:** 1) Dots ( ``.`` ) and brackets ( ``[`` and ``]`` ) can be used to access nested objects (e.g., ``"field": "foo.bar"`` and ``"field": "foo['bar']"`` ). If field names contain dots or brackets but are not nested, you can use ``\`` to escape dots and brackets (e.g., ``"a\.b"`` and ``"a\[0\]"`` ). See more details about escaping in the `field documentation `__. 2) ``field`` is not required if ``aggregate`` is ``count``. timeUnit : anyOf(:class:`TimeUnit`, :class:`TimeUnitParams`) Time unit (e.g., ``year``, ``yearmonth``, ``month``, ``hours`` ) for a temporal field. or `a temporal field that gets casted as ordinal `__. **Default value:** ``undefined`` (None) **See also:** `timeUnit `__ documentation. title : anyOf(:class:`Text`, None) A title for the field. If ``null``, the title will be removed. **Default value:** derived from the field's name and transformation function ( ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function, the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ). Otherwise, the title is simply the field name. **Notes** : 1) You can customize the default field title format by providing the `fieldTitle `__ property in the `config `__ or `fieldTitle function via the compile function's options `__. 2) If both field definition's ``title`` and axis, header, or legend ``title`` are defined, axis/header/legend title will be used. Fradius2rKrLrbc dSrdrres rrfzRadius2.aggregatergr c dSrdrris rrfzRadius2.aggregatergr c dSrdrrls rrfzRadius2.aggregatergr c dSrdrres rrozRadius2.bandPositionrpr Nc dSrdrres rrrz Radius2.binrpr c dSrdrres rrz Radius2.fieldrgr c dSrdrrs rrz Radius2.fieldrgr rc dSrdrres rrzRadius2.timeUnitrgr rc dSrdrres rrzRadius2.timeUnitrgr r#c dSrdrres rrzRadius2.timeUnitrgr rBc dSrdrres rrzRadius2.timeUnitrgr c dSrdrrbs rrzRadius2.timeUnitrgr c dSrdrres rrz Radius2.titlergr c dSrdrres rrz Radius2.titlergr c dSrdrres rrz Radius2.titlergr c Xtt|jd|||||||d|dSrt)r2r]rprus rrpzRadius2.__init__Y%gt% N Y3?SPU/7u N NHL N N N N Nr )rbr])rKNrbr]rvr<s@rr]r]/7XXr(-$N  7$bc py   X (    X (    X  e          s y   X $    X  '#PQ ^g   X  '#qr H   X  '#x y  F O    X  '#O P  ] f    X (yyi    X  s y   X  tCy Y   X    X "+ii]f 9INNNNNNNNNNr r]ceZdZdZdZdZdeddfdZede ddfdZ ede e ddfdZ edd Z de d ddfd Z eeeffd ZxZS) Radius2Datuma[Radius2Datum schema wrapper Mapping(required=[]) Parameters ---------- bandPosition : float Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to ``0``, and at the middle of the band if set to ``0.5``. datum : anyOf(:class:`PrimitiveValue`, :class:`DateTime`, :class:`ExprRef`, :class:`RepeatRef`) A constant value in data domain. title : anyOf(:class:`Text`, None) A title for the field. If ``null``, the title will be removed. **Default value:** derived from the field's name and transformation function ( ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function, the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ). Otherwise, the title is simply the field name. **Notes** : 1) You can customize the default field title format by providing the `fieldTitle `__ property in the `config `__ or `fieldTitle function via the compile function's options `__. 2) If both field definition's ``title`` and axis, header, or legend ``title`` are defined, axis/header/legend title will be used. type : :class:`Type` The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also be a ``"geojson"`` type for encoding `'geoshape' `__. Vega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal scale for a field with ``bin`` or ``timeUnit``. **Default value:** 1) For a data ``field``, ``"nominal"`` is the default data type unless the field encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or ``timeUnit`` that satisfies the following criteria: * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin`` or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a quantitative scale `__. * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit`` or (2) the specified scale type is a time or utc scale * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort order `__, (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is ``order``. 2) For a constant value in data domain ( ``datum`` ): * ``"quantitative"`` if the datum is a number * ``"nominal"`` if the datum is a string * ``"temporal"`` if the datum is `a date time object `__ **Note:** * Data ``type`` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data. * Data values for a temporal field can be either a date-time string (e.g., ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a timestamp number (e.g., ``1552199579097`` ). * When using with `bin `__, the ``type`` property can be either ``"quantitative"`` (for using a linear bin scale) or `"ordinal" (for using an ordinal bin scale) `__. * When using with `timeUnit `__, the ``type`` property can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal" (for using an ordinal scale) `__. * When using with `aggregate `__, the ``type`` property refers to the post-aggregation data type. For example, we can calculate count ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct", "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``. * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have ``type`` as they must have exactly the same type as their primary channels (e.g., ``x``, ``y`` ). **See also:** `type `__ documentation. Fr^rKrbc dSrdrres rrozRadius2Datum.bandPosition;rpr c dSrdrres rrzRadius2Datum.title>rgr c dSrdrres rrzRadius2Datum.titleBrgr Nc dSrdrres rrzRadius2Datum.titleFrgr rc dSrdrres rr"zRadius2Datum.typeJrpr c Rtt|jd||||d|dSr^)r2rrrpr_s rrpzRadius2Datum.__init__NsJ*lD!!* >\Y^04 > >8< > > > > >r )rKNrbrrr`r<s@rrrrrs+ffN(-$N e      s ~   X  tCy ^   X    X  gYZ gu    ,5II>>>>>>>>>>r rrc*eZdZdZdZdZfdZxZS) Radius2ValueaRadius2Value schema wrapper Mapping(required=[value]) Definition object for a constant value (primitive value or gradient definition) of an encoding channel. Parameters ---------- value : anyOf(float, string, string, :class:`ExprRef`) A constant value in visual domain (e.g., ``"red"`` / ``"#0099ff"`` / `gradient definition `__ for color, values between ``0`` to ``1`` for opacity). Fr^c Ltt|jdd|i|dSr)r2rzrprs rrpzRadius2Value.__init__h1*lD!!*???$?????r rr<s@rrzrzSX  (-$N@@@@@@@@@r rzc!zeZdZdZdZdZededddfdZee fd.dZee fd.d Zded ddfd Z de ddfd Z ede ddfd Zee e e e e e e e e e f d.dZed/dZde ddfdZededdfdZee fd.dZee e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e f d.dZed/dZedee ddfdZedeeddfdZedee ddfdZedeejddfdZededddfdZee e e fd.dZed/dZde ddfdZededddfd Zeded!ddfd"Zeded#ddfd$Zeded%ddfd&Zee e e e fd.d'Zededdfd(Zedeeddfd)Zed/d*Zded+ddfd,Ze e e e e e e e e e e e e f fd- ZxZS)0Rowa+Row schema wrapper Mapping(required=[shorthand]) Parameters ---------- shorthand : string shorthand for field, aggregate, and type aggregate : :class:`Aggregate` Aggregation function for the field (e.g., ``"mean"``, ``"sum"``, ``"median"``, ``"min"``, ``"max"``, ``"count"`` ). **Default value:** ``undefined`` (None) **See also:** `aggregate `__ documentation. align : :class:`LayoutAlign` The alignment to apply to row/column facet's subplot. The supported string values are ``"all"``, ``"each"``, and ``"none"``. * For ``"none"``, a flow layout will be used, in which adjacent subviews are simply placed one after the other. * For ``"each"``, subviews will be aligned into a clean grid structure, but each row or column may be of variable size. * For ``"all"``, subviews will be aligned and each row or column will be sized identically based on the maximum observed size. String values for this property will be applied to both grid rows and columns. **Default value:** ``"all"``. bandPosition : float Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to ``0``, and at the middle of the band if set to ``0.5``. bin : anyOf(boolean, :class:`BinParams`, None) A flag for binning a ``quantitative`` field, `an object defining binning parameters `__, or indicating that the data for ``x`` or ``y`` channel are binned before they are imported into Vega-Lite ( ``"binned"`` ). If ``true``, default `binning parameters `__ will be applied. If ``"binned"``, this indicates that the data for the ``x`` (or ``y`` ) channel are already binned. You can map the bin-start field to ``x`` (or ``y`` ) and the bin-end field to ``x2`` (or ``y2`` ). The scale and axis will be formatted similar to binning in Vega-Lite. To adjust the axis ticks based on the bin step, you can also set the axis's `tickMinStep `__ property. **Default value:** ``false`` **See also:** `bin `__ documentation. center : boolean Boolean flag indicating if facet's subviews should be centered relative to their respective rows or columns. **Default value:** ``false`` field : :class:`Field` **Required.** A string defining the name of the field from which to pull a data value or an object defining iterated values from the `repeat `__ operator. **See also:** `field `__ documentation. **Notes:** 1) Dots ( ``.`` ) and brackets ( ``[`` and ``]`` ) can be used to access nested objects (e.g., ``"field": "foo.bar"`` and ``"field": "foo['bar']"`` ). If field names contain dots or brackets but are not nested, you can use ``\`` to escape dots and brackets (e.g., ``"a\.b"`` and ``"a\[0\]"`` ). See more details about escaping in the `field documentation `__. 2) ``field`` is not required if ``aggregate`` is ``count``. header : anyOf(:class:`Header`, None) An object defining properties of a facet's header. sort : anyOf(:class:`SortArray`, :class:`SortOrder`, :class:`EncodingSortField`, None) Sort order for the encoded field. For continuous fields (quantitative or temporal), ``sort`` can be either ``"ascending"`` or ``"descending"``. For discrete fields, ``sort`` can be one of the following: * ``"ascending"`` or ``"descending"`` -- for sorting by the values' natural order in JavaScript. * `A sort field definition `__ for sorting by another field. * `An array specifying the field values in preferred order `__. In this case, the sort order will obey the values in the array, followed by any unspecified values in their original order. For discrete time field, values in the sort array can be `date-time definition objects `__. In addition, for time units ``"month"`` and ``"day"``, the values can be the month or day names (case insensitive) or their 3-letter initials (e.g., ``"Mon"``, ``"Tue"`` ). * ``null`` indicating no sort. **Default value:** ``"ascending"`` **Note:** ``null`` is not supported for ``row`` and ``column``. spacing : float The spacing in pixels between facet's sub-views. **Default value** : Depends on ``"spacing"`` property of `the view composition configuration `__ ( ``20`` by default) timeUnit : anyOf(:class:`TimeUnit`, :class:`TimeUnitParams`) Time unit (e.g., ``year``, ``yearmonth``, ``month``, ``hours`` ) for a temporal field. or `a temporal field that gets casted as ordinal `__. **Default value:** ``undefined`` (None) **See also:** `timeUnit `__ documentation. title : anyOf(:class:`Text`, None) A title for the field. If ``null``, the title will be removed. **Default value:** derived from the field's name and transformation function ( ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function, the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ). Otherwise, the title is simply the field name. **Notes** : 1) You can customize the default field title format by providing the `fieldTitle `__ property in the `config `__ or `fieldTitle function via the compile function's options `__. 2) If both field definition's ``title`` and axis, header, or legend ``title`` are defined, axis/header/legend title will be used. type : :class:`StandardType` The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also be a ``"geojson"`` type for encoding `'geoshape' `__. Vega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal scale for a field with ``bin`` or ``timeUnit``. **Default value:** 1) For a data ``field``, ``"nominal"`` is the default data type unless the field encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or ``timeUnit`` that satisfies the following criteria: * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin`` or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a quantitative scale `__. * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit`` or (2) the specified scale type is a time or utc scale * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort order `__, (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is ``order``. 2) For a constant value in data domain ( ``datum`` ): * ``"quantitative"`` if the datum is a number * ``"nominal"`` if the datum is a string * ``"temporal"`` if the datum is `a date time object `__ **Note:** * Data ``type`` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data. * Data values for a temporal field can be either a date-time string (e.g., ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a timestamp number (e.g., ``1552199579097`` ). * When using with `bin `__, the ``type`` property can be either ``"quantitative"`` (for using a linear bin scale) or `"ordinal" (for using an ordinal bin scale) `__. * When using with `timeUnit `__, the ``type`` property can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal" (for using an ordinal scale) `__. * When using with `aggregate `__, the ``type`` property refers to the post-aggregation data type. For example, we can calculate count ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct", "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``. * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have ``type`` as they must have exactly the same type as their primary channels (e.g., ``x``, ``y`` ). **See also:** `type `__ documentation. FrarKrLrbc dSrdrres rrfz Row.aggregateCrgr c dSrdrris rrfz Row.aggregateGrgr c dSrdrrls rrfz Row.aggregateKrgr rc dSrdrres rrz Row.alignOrpr c dSrdrres rrozRow.bandPositionRrpr c dSrdrres rrrzRow.binUrgr c  dSrdrrts rrrzRow.binYrgr Nc dSrdrres rrrzRow.bin]rgr c dSrdrres rrz Row.centerarpr c dSrdrres rrz Row.fielddrgr c dSrdrrs rrz Row.fieldhrgr c! dSrdrrs" rrz Row.headerlrgr c dSrdrres rrz Row.headerprgr c dSrdrres rrzRow.sorttrgr c dSrdrres rrzRow.sortxrgr c dSrdrres rrzRow.sort|rgr c dSrdrres rrzRow.sortrgr rc dSrdrres rrzRow.sortrgr c dSrdrrs rrzRow.sortrgr c dSrdrres rrzRow.sortrgr c dSrdrres rrz Row.spacingrpr rc dSrdrres rrz Row.timeUnitrgr rc dSrdrres rrz Row.timeUnitrgr r#c dSrdrres rrz Row.timeUnitrgr rBc dSrdrres rrz Row.timeUnitrgr c dSrdrrbs rrz Row.timeUnitrgr c dSrdrres rrz Row.titlergr c dSrdrres rrz Row.titlergr c dSrdrres rrz Row.titlergr rhc dSrdrres rr"zRow.typerpr c dtt|jd||||||||| | | | | d |dSr )r2rrprs rrpz Row.__init__sm "c4! BIRW/;V[`)/dGV^(-D B B=A B B B B Br )rbr)rKNrbrrr<s@rrrlsQQd(-$N  7$bc pu   X (    X (    X  w45 %     e      T e   X "9Y_hr{FOV_fow@    X    X        s u   X $    X %) _hu~OXenzCOXhqBK]fs|NWen}FOXajr{HQ_hu~NWdmyB R [ l u G P ] f x A O X g p     X    X  d5k e   X  d3i E   X  d4j U   X  d4=) e   X  g78 U   X "y     X    X   5     '#PQ ^c   X  '#qr D   X  '#x y  F K    X  '#O P  ] b    X (yyi    X  s u   X  tCy U   X    X  gNO \a    "+iy'YyPY! 9y yBBBBBBBBBBr rcCeZdZdZdZdZededddfdZee fd4dZee fd4d Zde ddfd Z ede ddfd Z ee e e e e e e e e e f d4d Z ed5dZ ee e fd4dZee e e fd4dZedeejddfdZededdfdZee fd4dZee e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e fBd4dZed5dZee e e e e e e e e e e e e e e e e e e e e e e fd4dZed5dZedee ddfdZedeeddfdZedee ddfdZedeejddfdZededddfdZededddfdZeded ddfd!Zee e e fd4d"Zee e fd4d#Zed5d$Zeded%ddfd&Zeded'ddfd(Zeded)ddfd*Zeded+ddfd,Zee e e e fd4d-Zededdfd.Zedeeddfd/Zed5d0Zded1ddfd2Ze e e e e e e e e e e e f fd3 ZxZS)6Shapea/Shape schema wrapper Mapping(required=[shorthand]) Parameters ---------- shorthand : string shorthand for field, aggregate, and type aggregate : :class:`Aggregate` Aggregation function for the field (e.g., ``"mean"``, ``"sum"``, ``"median"``, ``"min"``, ``"max"``, ``"count"`` ). **Default value:** ``undefined`` (None) **See also:** `aggregate `__ documentation. bandPosition : float Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to ``0``, and at the middle of the band if set to ``0.5``. bin : anyOf(boolean, :class:`BinParams`, None) A flag for binning a ``quantitative`` field, `an object defining binning parameters `__, or indicating that the data for ``x`` or ``y`` channel are binned before they are imported into Vega-Lite ( ``"binned"`` ). If ``true``, default `binning parameters `__ will be applied. If ``"binned"``, this indicates that the data for the ``x`` (or ``y`` ) channel are already binned. You can map the bin-start field to ``x`` (or ``y`` ) and the bin-end field to ``x2`` (or ``y2`` ). The scale and axis will be formatted similar to binning in Vega-Lite. To adjust the axis ticks based on the bin step, you can also set the axis's `tickMinStep `__ property. **Default value:** ``false`` **See also:** `bin `__ documentation. condition : anyOf(:class:`ConditionalValueDefstringnullExprRef`, List(:class:`ConditionalValueDefstringnullExprRef`)) One or more value definition(s) with `a parameter or a test predicate `__. **Note:** A field definition's ``condition`` property can only contain `conditional value definitions `__ since Vega-Lite only allows at most one encoded field per encoding channel. field : :class:`Field` **Required.** A string defining the name of the field from which to pull a data value or an object defining iterated values from the `repeat `__ operator. **See also:** `field `__ documentation. **Notes:** 1) Dots ( ``.`` ) and brackets ( ``[`` and ``]`` ) can be used to access nested objects (e.g., ``"field": "foo.bar"`` and ``"field": "foo['bar']"`` ). If field names contain dots or brackets but are not nested, you can use ``\`` to escape dots and brackets (e.g., ``"a\.b"`` and ``"a\[0\]"`` ). See more details about escaping in the `field documentation `__. 2) ``field`` is not required if ``aggregate`` is ``count``. legend : anyOf(:class:`Legend`, None) An object defining properties of the legend. If ``null``, the legend for the encoding channel will be removed. **Default value:** If undefined, default `legend properties `__ are applied. **See also:** `legend `__ documentation. scale : anyOf(:class:`Scale`, None) An object defining properties of the channel's scale, which is the function that transforms values in the data domain (numbers, dates, strings, etc) to visual values (pixels, colors, sizes) of the encoding channels. If ``null``, the scale will be `disabled and the data value will be directly encoded `__. **Default value:** If undefined, default `scale properties `__ are applied. **See also:** `scale `__ documentation. sort : :class:`Sort` Sort order for the encoded field. For continuous fields (quantitative or temporal), ``sort`` can be either ``"ascending"`` or ``"descending"``. For discrete fields, ``sort`` can be one of the following: * ``"ascending"`` or ``"descending"`` -- for sorting by the values' natural order in JavaScript. * `A string indicating an encoding channel name to sort by `__ (e.g., ``"x"`` or ``"y"`` ) with an optional minus prefix for descending sort (e.g., ``"-x"`` to sort by x-field, descending). This channel string is short-form of `a sort-by-encoding definition `__. For example, ``"sort": "-x"`` is equivalent to ``"sort": {"encoding": "x", "order": "descending"}``. * `A sort field definition `__ for sorting by another field. * `An array specifying the field values in preferred order `__. In this case, the sort order will obey the values in the array, followed by any unspecified values in their original order. For discrete time field, values in the sort array can be `date-time definition objects `__. In addition, for time units ``"month"`` and ``"day"``, the values can be the month or day names (case insensitive) or their 3-letter initials (e.g., ``"Mon"``, ``"Tue"`` ). * ``null`` indicating no sort. **Default value:** ``"ascending"`` **Note:** ``null`` and sorting by another channel is not supported for ``row`` and ``column``. **See also:** `sort `__ documentation. timeUnit : anyOf(:class:`TimeUnit`, :class:`TimeUnitParams`) Time unit (e.g., ``year``, ``yearmonth``, ``month``, ``hours`` ) for a temporal field. or `a temporal field that gets casted as ordinal `__. **Default value:** ``undefined`` (None) **See also:** `timeUnit `__ documentation. title : anyOf(:class:`Text`, None) A title for the field. If ``null``, the title will be removed. **Default value:** derived from the field's name and transformation function ( ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function, the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ). Otherwise, the title is simply the field name. **Notes** : 1) You can customize the default field title format by providing the `fieldTitle `__ property in the `config `__ or `fieldTitle function via the compile function's options `__. 2) If both field definition's ``title`` and axis, header, or legend ``title`` are defined, axis/header/legend title will be used. type : :class:`TypeForShape` The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also be a ``"geojson"`` type for encoding `'geoshape' `__. Vega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal scale for a field with ``bin`` or ``timeUnit``. **Default value:** 1) For a data ``field``, ``"nominal"`` is the default data type unless the field encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or ``timeUnit`` that satisfies the following criteria: * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin`` or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a quantitative scale `__. * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit`` or (2) the specified scale type is a time or utc scale * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort order `__, (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is ``order``. 2) For a constant value in data domain ( ``datum`` ): * ``"quantitative"`` if the datum is a number * ``"nominal"`` if the datum is a string * ``"temporal"`` if the datum is `a date time object `__ **Note:** * Data ``type`` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data. * Data values for a temporal field can be either a date-time string (e.g., ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a timestamp number (e.g., ``1552199579097`` ). * When using with `bin `__, the ``type`` property can be either ``"quantitative"`` (for using a linear bin scale) or `"ordinal" (for using an ordinal bin scale) `__. * When using with `timeUnit `__, the ``type`` property can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal" (for using an ordinal scale) `__. * When using with `aggregate `__, the ``type`` property refers to the post-aggregation data type. For example, we can calculate count ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct", "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``. * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have ``type`` as they must have exactly the same type as their primary channels (e.g., ``x``, ``y`` ). **See also:** `type `__ documentation. FrrKrLrbc dSrdrres rrfzShape.aggregatergr c dSrdrris rrfzShape.aggregatergr c dSrdrrls rrfzShape.aggregatergr c dSrdrres rrozShape.bandPositionrpr c dSrdrres rrrz Shape.binrgr c  dSrdrrts rrrz Shape.binrgr Nc dSrdrres rrrz Shape.binrgr c dSrdrrs rr@zShape.conditionrgr c dSrdrrs rr@zShape.conditionrgr c dSrdrres rr@zShape.conditionrgr c dSrdrres rrz Shape.fieldrgr c dSrdrrs rrz Shape.fieldrgr cC dSrdrrsD rrz Shape.legendrgr c dSrdrres rrz Shape.legendrgr c dSrdrrs rrz Shape.scalergr c dSrdrres rrz Shape.scalergr c dSrdrres rrz Shape.sortrgr c dSrdrres rrz Shape.sortrgr c dSrdrres rrz Shape.sortrgr c dSrdrres rrz Shape.sortrgr rc dSrdrres rrz Shape.sortrgr rc dSrdrres rrz Shape.sortrgr rc dSrdrres rrz Shape.sortrgr c dSrdrrs rrz Shape.sort rgr c dSrdrrs rrz Shape.sort rgr c dSrdrres rrz Shape.sort rgr rc dSrdrres rrzShape.timeUnit rgr rc dSrdrres rrzShape.timeUnit rgr r#c dSrdrres rrzShape.timeUnit rgr rBc dSrdrres rrzShape.timeUnit rgr c dSrdrrbs rrzShape.timeUnit rgr c dSrdrres rrz Shape.title! rgr c dSrdrres rrz Shape.title% rgr c dSrdrres rrz Shape.title) rgr )rlrjrc dSrdrres rr"z Shape.type- rpr c  btt|jd||||||||| | | | d | dSro)r2rrprqs rrpzShape.__init__1 rrr )rbr)rKNrbr)r'r9r:rtrurvrr rfrrwrorxrrr@r rr=r.rrrrrzrrr"rpr;r<s@rrrs2 __@(-$N  7$bc pw   X (    X (    X  e      T g   X "9Y_hr{FOV_fow@    X    X &i    X 'y     X  4 IJ W^   X  s w   X $    X # \et}LUajvHQ^gxAS\r{QZnwCLYbr{HQ]fr{KTen@ I V _ m v E N ] f u ~ P Y c l v  H Q Z c m v C L Z c p y LUgp~GV_oxENbkHU^jsAJR[hqHXanwCL\evQZgpBKZcqzIRYbkt}F    X    X #))9_hqzGP\eqzEN\eluHW`ox@IT]hq{DLU^gnw~G    X    X  d5k g   X  d3i G   X  d4j W   X  d4=) g   X  g78 W   X  gUV cj   X  gab ov   X "y     X %Y    X    X  '#PQ ^e   X  '#qr F   X  '#x y  F M    X  '#O P  ] d    X (yyi    X  s w   X  tCy W   X    X  g=> 7    "+ii]f$Iiy)99,,,,,,,,,,r rc8eZdZdZdZdZdeddfdZee e fddZ ee e e fddZ ede e j ddfd Z ededdfd Zede eddfd Zedd ZdedddfdZe e e e ffd ZxZS) ShapeDatumaoShapeDatum schema wrapper Mapping(required=[]) Parameters ---------- bandPosition : float Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to ``0``, and at the middle of the band if set to ``0.5``. condition : anyOf(:class:`ConditionalValueDefstringnullExprRef`, List(:class:`ConditionalValueDefstringnullExprRef`)) One or more value definition(s) with `a parameter or a test predicate `__. **Note:** A field definition's ``condition`` property can only contain `conditional value definitions `__ since Vega-Lite only allows at most one encoded field per encoding channel. datum : anyOf(:class:`PrimitiveValue`, :class:`DateTime`, :class:`ExprRef`, :class:`RepeatRef`) A constant value in data domain. title : anyOf(:class:`Text`, None) A title for the field. If ``null``, the title will be removed. **Default value:** derived from the field's name and transformation function ( ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function, the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ). Otherwise, the title is simply the field name. **Notes** : 1) You can customize the default field title format by providing the `fieldTitle `__ property in the `config `__ or `fieldTitle function via the compile function's options `__. 2) If both field definition's ``title`` and axis, header, or legend ``title`` are defined, axis/header/legend title will be used. type : :class:`Type` The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also be a ``"geojson"`` type for encoding `'geoshape' `__. Vega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal scale for a field with ``bin`` or ``timeUnit``. **Default value:** 1) For a data ``field``, ``"nominal"`` is the default data type unless the field encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or ``timeUnit`` that satisfies the following criteria: * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin`` or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a quantitative scale `__. * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit`` or (2) the specified scale type is a time or utc scale * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort order `__, (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is ``order``. 2) For a constant value in data domain ( ``datum`` ): * ``"quantitative"`` if the datum is a number * ``"nominal"`` if the datum is a string * ``"temporal"`` if the datum is `a date time object `__ **Note:** * Data ``type`` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data. * Data values for a temporal field can be either a date-time string (e.g., ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a timestamp number (e.g., ``1552199579097`` ). * When using with `bin `__, the ``type`` property can be either ``"quantitative"`` (for using a linear bin scale) or `"ordinal" (for using an ordinal bin scale) `__. * When using with `timeUnit `__, the ``type`` property can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal" (for using an ordinal scale) `__. * When using with `aggregate `__, the ``type`` property refers to the post-aggregation data type. For example, we can calculate count ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct", "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``. * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have ``type`` as they must have exactly the same type as their primary channels (e.g., ``x``, ``y`` ). **See also:** `type `__ documentation. FrrKrbc dSrdrres rrozShapeDatum.bandPosition rpr c dSrdrrs rr@zShapeDatum.condition rgr c dSrdrrs rr@zShapeDatum.condition rgr c dSrdrres rr@zShapeDatum.condition rgr c dSrdrres rrzShapeDatum.title rgr c dSrdrres rrzShapeDatum.title rgr Nc dSrdrres rrzShapeDatum.title rgr rc dSrdrres rr"zShapeDatum.type rpr c Ttt|jd|||||d|dSr)r2rrprs rrpzShapeDatum.__init__ rr )rbr)rKNrbr)r'r9r:rtrurvrwrorrr@r rr=r.rr r"rpr;r<s@rrr: smm\(-$N e     &i    X 'y     X  4 IJ Wc   X  s |   X  tCy \   X    X  gYZ gs    ,5 QZIIIIIIIIIIr rc VeZdZdZdZdZeeeeeeeeeeeef ddZeeeeeeeefddZeeeeeeeeeeeeef ddZeeeeeeeeefddZeeefdd Zeeeefdd Zed e e j ddfd Zeffd Z xZ S) ShapeValueaShapeValue schema wrapper Mapping(required=[]) Parameters ---------- condition : anyOf(:class:`ConditionalMarkPropFieldOrDatumDefTypeForShape`, :class:`ConditionalValueDefstringnullExprRef`, List(:class:`ConditionalValueDefstringnullExprRef`)) A field definition or one or more value definition(s) with a parameter predicate. value : anyOf(string, None, :class:`ExprRef`) A constant value in visual domain (e.g., ``"red"`` / ``"#0099ff"`` / `gradient definition `__ for color, values between ``0`` to ``1`` for opacity). Frrbc  dSrdrrs rr@zShapeValue.condition rgr c dSrdrrs rr@zShapeValue.condition rgr c  dSrdrrs rr@zShapeValue.condition rgr c  dSrdrrs rr@zShapeValue.condition rgr c dSrdrrs rr@zShapeValue.condition rgr c dSrdrrs rr@zShapeValue.condition rgr rKc dSrdrres rr@zShapeValue.condition rgr c Ntt|jd||d|dSr)r2rrprs rrpzShapeValue.__init__!rr )rbrr<r<s@rrr s4  (-$N "+)Zclu~GNW^gr{CLS\    X %.i Ybir{DKT    X "+)Zckt~GOX`ipyDMU^en    X %.iyYbjs|EMV]f    X &i    X 'y     X  4 IJ Wc   X )2SSSSSSSSSSr rcCeZdZdZdZdZededddfdZee fd4dZee fd4d Zde ddfd Z ede ddfd Z ee e e e e e e e e e f d4d Z ed5dZ ee e fd4dZee e e fd4dZedeejddfdZededdfdZee fd4dZee e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e fBd4dZed5dZee e e e e e e e e e e e e e e e e e e e e e e fd4dZed5dZedee ddfdZedeeddfdZedee ddfdZedeejddfdZededddfdZededddfdZeded ddfd!Zee e e fd4d"Zee e fd4d#Zed5d$Zeded%ddfd&Zeded'ddfd(Zeded)ddfd*Zeded+ddfd,Zee e e e fd4d-Zededdfd.Zedeeddfd/Zed5d0Zded1ddfd2Ze e e e e e e e e e e e f fd3 ZxZS)6Sizeay/Size schema wrapper Mapping(required=[shorthand]) Parameters ---------- shorthand : string shorthand for field, aggregate, and type aggregate : :class:`Aggregate` Aggregation function for the field (e.g., ``"mean"``, ``"sum"``, ``"median"``, ``"min"``, ``"max"``, ``"count"`` ). **Default value:** ``undefined`` (None) **See also:** `aggregate `__ documentation. bandPosition : float Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to ``0``, and at the middle of the band if set to ``0.5``. bin : anyOf(boolean, :class:`BinParams`, None) A flag for binning a ``quantitative`` field, `an object defining binning parameters `__, or indicating that the data for ``x`` or ``y`` channel are binned before they are imported into Vega-Lite ( ``"binned"`` ). If ``true``, default `binning parameters `__ will be applied. If ``"binned"``, this indicates that the data for the ``x`` (or ``y`` ) channel are already binned. You can map the bin-start field to ``x`` (or ``y`` ) and the bin-end field to ``x2`` (or ``y2`` ). The scale and axis will be formatted similar to binning in Vega-Lite. To adjust the axis ticks based on the bin step, you can also set the axis's `tickMinStep `__ property. **Default value:** ``false`` **See also:** `bin `__ documentation. condition : anyOf(:class:`ConditionalValueDefnumberExprRef`, List(:class:`ConditionalValueDefnumberExprRef`)) One or more value definition(s) with `a parameter or a test predicate `__. **Note:** A field definition's ``condition`` property can only contain `conditional value definitions `__ since Vega-Lite only allows at most one encoded field per encoding channel. field : :class:`Field` **Required.** A string defining the name of the field from which to pull a data value or an object defining iterated values from the `repeat `__ operator. **See also:** `field `__ documentation. **Notes:** 1) Dots ( ``.`` ) and brackets ( ``[`` and ``]`` ) can be used to access nested objects (e.g., ``"field": "foo.bar"`` and ``"field": "foo['bar']"`` ). If field names contain dots or brackets but are not nested, you can use ``\`` to escape dots and brackets (e.g., ``"a\.b"`` and ``"a\[0\]"`` ). See more details about escaping in the `field documentation `__. 2) ``field`` is not required if ``aggregate`` is ``count``. legend : anyOf(:class:`Legend`, None) An object defining properties of the legend. If ``null``, the legend for the encoding channel will be removed. **Default value:** If undefined, default `legend properties `__ are applied. **See also:** `legend `__ documentation. scale : anyOf(:class:`Scale`, None) An object defining properties of the channel's scale, which is the function that transforms values in the data domain (numbers, dates, strings, etc) to visual values (pixels, colors, sizes) of the encoding channels. If ``null``, the scale will be `disabled and the data value will be directly encoded `__. **Default value:** If undefined, default `scale properties `__ are applied. **See also:** `scale `__ documentation. sort : :class:`Sort` Sort order for the encoded field. For continuous fields (quantitative or temporal), ``sort`` can be either ``"ascending"`` or ``"descending"``. For discrete fields, ``sort`` can be one of the following: * ``"ascending"`` or ``"descending"`` -- for sorting by the values' natural order in JavaScript. * `A string indicating an encoding channel name to sort by `__ (e.g., ``"x"`` or ``"y"`` ) with an optional minus prefix for descending sort (e.g., ``"-x"`` to sort by x-field, descending). This channel string is short-form of `a sort-by-encoding definition `__. For example, ``"sort": "-x"`` is equivalent to ``"sort": {"encoding": "x", "order": "descending"}``. * `A sort field definition `__ for sorting by another field. * `An array specifying the field values in preferred order `__. In this case, the sort order will obey the values in the array, followed by any unspecified values in their original order. For discrete time field, values in the sort array can be `date-time definition objects `__. In addition, for time units ``"month"`` and ``"day"``, the values can be the month or day names (case insensitive) or their 3-letter initials (e.g., ``"Mon"``, ``"Tue"`` ). * ``null`` indicating no sort. **Default value:** ``"ascending"`` **Note:** ``null`` and sorting by another channel is not supported for ``row`` and ``column``. **See also:** `sort `__ documentation. timeUnit : anyOf(:class:`TimeUnit`, :class:`TimeUnitParams`) Time unit (e.g., ``year``, ``yearmonth``, ``month``, ``hours`` ) for a temporal field. or `a temporal field that gets casted as ordinal `__. **Default value:** ``undefined`` (None) **See also:** `timeUnit `__ documentation. title : anyOf(:class:`Text`, None) A title for the field. If ``null``, the title will be removed. **Default value:** derived from the field's name and transformation function ( ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function, the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ). Otherwise, the title is simply the field name. **Notes** : 1) You can customize the default field title format by providing the `fieldTitle `__ property in the `config `__ or `fieldTitle function via the compile function's options `__. 2) If both field definition's ``title`` and axis, header, or legend ``title`` are defined, axis/header/legend title will be used. type : :class:`StandardType` The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also be a ``"geojson"`` type for encoding `'geoshape' `__. Vega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal scale for a field with ``bin`` or ``timeUnit``. **Default value:** 1) For a data ``field``, ``"nominal"`` is the default data type unless the field encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or ``timeUnit`` that satisfies the following criteria: * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin`` or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a quantitative scale `__. * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit`` or (2) the specified scale type is a time or utc scale * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort order `__, (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is ``order``. 2) For a constant value in data domain ( ``datum`` ): * ``"quantitative"`` if the datum is a number * ``"nominal"`` if the datum is a string * ``"temporal"`` if the datum is `a date time object `__ **Note:** * Data ``type`` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data. * Data values for a temporal field can be either a date-time string (e.g., ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a timestamp number (e.g., ``1552199579097`` ). * When using with `bin `__, the ``type`` property can be either ``"quantitative"`` (for using a linear bin scale) or `"ordinal" (for using an ordinal bin scale) `__. * When using with `timeUnit `__, the ``type`` property can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal" (for using an ordinal scale) `__. * When using with `aggregate `__, the ``type`` property refers to the post-aggregation data type. For example, we can calculate count ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct", "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``. * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have ``type`` as they must have exactly the same type as their primary channels (e.g., ``x``, ``y`` ). **See also:** `type `__ documentation. FrrKrLrbc dSrdrres rrfzSize.aggregate!rgr c dSrdrris rrfzSize.aggregate!rgr c dSrdrrls rrfzSize.aggregate!rgr c dSrdrres rrozSize.bandPosition!rpr c dSrdrres rrrzSize.bin!rgr c  dSrdrrts rrrzSize.bin!rgr Nc dSrdrres rrrzSize.bin"rgr c dSrdrrs rr@zSize.condition"rgr c dSrdrrs rr@zSize.condition "rgr c dSrdrres rr@zSize.condition"rgr c dSrdrres rrz Size.field"rgr c dSrdrrs rrz Size.field"rgr cC dSrdrrsD rrz Size.legend"rgr c dSrdrres rrz Size.legend"rgr c dSrdrrs rrz Size.scale""rgr c dSrdrres rrz Size.scale&"rgr c dSrdrres rrz Size.sort*"rgr c dSrdrres rrz Size.sort."rgr c dSrdrres rrz Size.sort2"rgr c dSrdrres rrz Size.sort6"rgr rc dSrdrres rrz Size.sort:"rgr rc dSrdrres rrz Size.sort>"rgr rc dSrdrres rrz Size.sortB"rgr c dSrdrrs rrz Size.sortF"rgr c dSrdrrs rrz Size.sortJ"rgr c dSrdrres rrz Size.sortN"rgr rc dSrdrres rrz Size.timeUnitR"rgr rc dSrdrres rrz Size.timeUnitV"rgr r#c dSrdrres rrz Size.timeUnitZ"rgr rBc dSrdrres rrz Size.timeUnit^"rgr c dSrdrrbs rrz Size.timeUnitb"rgr c dSrdrres rrz Size.titlef"rgr c dSrdrres rrz Size.titlej"rgr c dSrdrres rrz Size.titlen"rgr rhc dSrdrres rr"z Size.typer"rpr c  btt|jd||||||||| | | | d | dSro)r2rrprqs rrpz Size.__init__v"rr )rbr)rKNrbrrsr<s@rrr!s3 __@(-$N  7$bc pv   X (    X (    X  e      T f   X "9Y_hr{FOV_fow@    X    X &i    X 'y     X  4 EF SY   X  s v   X $    X # \et}LUajvHQ^gxAS\r{QZnwCLYbr{HQ]fr{KTen@ I V _ m v E N ] f u ~ P Y c l v  H Q Z c m v C L Z c p y LUgp~GV_oxENbkHU^jsAJR[hqHXanwCL\evQZgpBKZcqzIRYbkt}F    X    X #))9_hqzGP\eqzEN\eluHW`ox@IT]hq{DLU^gnw~G    X    X  d5k f   X  d3i F   X  d4j V   X  d4=) f   X  g78 V   X  gUV ci   X  gab ou   X "y     X %Y    X    X  '#PQ ^d   X  '#qr E   X  '#x y  F L    X  '#O P  ] c    X (yyi    X  s v   X  tCy V   X    X  gNO \b    "+ii]f$Iiy)99++++++++++r rc8eZdZdZdZdZdeddfdZee e fddZ ee e e fddZ ede e j ddfd Z ededdfd Zede eddfd Zedd ZdedddfdZe e e e ffd ZxZS) SizeDatumafSizeDatum schema wrapper Mapping(required=[]) Parameters ---------- bandPosition : float Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to ``0``, and at the middle of the band if set to ``0.5``. condition : anyOf(:class:`ConditionalValueDefnumberExprRef`, List(:class:`ConditionalValueDefnumberExprRef`)) One or more value definition(s) with `a parameter or a test predicate `__. **Note:** A field definition's ``condition`` property can only contain `conditional value definitions `__ since Vega-Lite only allows at most one encoded field per encoding channel. datum : anyOf(:class:`PrimitiveValue`, :class:`DateTime`, :class:`ExprRef`, :class:`RepeatRef`) A constant value in data domain. title : anyOf(:class:`Text`, None) A title for the field. If ``null``, the title will be removed. **Default value:** derived from the field's name and transformation function ( ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function, the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ). Otherwise, the title is simply the field name. **Notes** : 1) You can customize the default field title format by providing the `fieldTitle `__ property in the `config `__ or `fieldTitle function via the compile function's options `__. 2) If both field definition's ``title`` and axis, header, or legend ``title`` are defined, axis/header/legend title will be used. type : :class:`Type` The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also be a ``"geojson"`` type for encoding `'geoshape' `__. Vega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal scale for a field with ``bin`` or ``timeUnit``. **Default value:** 1) For a data ``field``, ``"nominal"`` is the default data type unless the field encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or ``timeUnit`` that satisfies the following criteria: * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin`` or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a quantitative scale `__. * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit`` or (2) the specified scale type is a time or utc scale * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort order `__, (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is ``order``. 2) For a constant value in data domain ( ``datum`` ): * ``"quantitative"`` if the datum is a number * ``"nominal"`` if the datum is a string * ``"temporal"`` if the datum is `a date time object `__ **Note:** * Data ``type`` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data. * Data values for a temporal field can be either a date-time string (e.g., ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a timestamp number (e.g., ``1552199579097`` ). * When using with `bin `__, the ``type`` property can be either ``"quantitative"`` (for using a linear bin scale) or `"ordinal" (for using an ordinal bin scale) `__. * When using with `timeUnit `__, the ``type`` property can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal" (for using an ordinal scale) `__. * When using with `aggregate `__, the ``type`` property refers to the post-aggregation data type. For example, we can calculate count ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct", "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``. * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have ``type`` as they must have exactly the same type as their primary channels (e.g., ``x``, ``y`` ). **See also:** `type `__ documentation. FrrKrbc dSrdrres rrozSizeDatum.bandPosition"rpr c dSrdrrs rr@zSizeDatum.condition"rgr c dSrdrrs rr@zSizeDatum.condition"rgr c dSrdrres rr@zSizeDatum.condition"rgr c dSrdrres rrzSizeDatum.title#rgr c dSrdrres rrzSizeDatum.title#rgr Nc dSrdrres rrzSizeDatum.title #rgr rc dSrdrres rr"zSizeDatum.type #rpr c Ttt|jd|||||d|dSr)r2rrprs rrpzSizeDatum.__init__#rr )rbr)rKNrbrrr<s@rrr"smm\(-$N e     &i    X 'y     X  4 EF S^   X  s {   X  tCy [   X    X  gYZ gr    ,5 QZHHHHHHHHHHr rc VeZdZdZdZdZeeeeeeeeeeeef ddZeeeeeeeefddZeeeeeeeeeeeeef ddZeeeeeeeeefddZeeefdd Zeeeefdd Zed e e j ddfd Zeffd Z xZ S) SizeValueacSizeValue schema wrapper Mapping(required=[]) Parameters ---------- condition : anyOf(:class:`ConditionalMarkPropFieldOrDatumDef`, :class:`ConditionalValueDefnumberExprRef`, List(:class:`ConditionalValueDefnumberExprRef`)) A field definition or one or more value definition(s) with a parameter predicate. value : anyOf(float, :class:`ExprRef`) A constant value in visual domain (e.g., ``"red"`` / ``"#0099ff"`` / `gradient definition `__ for color, values between ``0`` to ``1`` for opacity). Frrbc  dSrdrrs rr@zSizeValue.condition*#rgr c dSrdrrs rr@zSizeValue.condition.#rgr c  dSrdrrs rr@zSizeValue.condition2#rgr c  dSrdrrs rr@zSizeValue.condition6#rgr c dSrdrrs rr@zSizeValue.condition:#rgr c dSrdrrs rr@zSizeValue.condition>#rgr rKc dSrdrres rr@zSizeValue.conditionB#rgr c Ntt|jd||d|dSr)r2r rprs rrpzSizeValue.__init__G#rr )rbr rr<s@rr r #s4  (-$N "+)Zclu~GNW^gr{CLS\    X %.i Ybir{DKT    X "+)Zckt~GOX`ipyDMU^en    X %.iyYbjs|EMV]f    X &i    X 'y     X  4 EF S^   X )2RRRRRRRRRRr r cCeZdZdZdZdZededddfdZee fd4dZee fd4d Zde ddfd Z ede ddfd Z ee e e e e e e e e e f d4d Z ed5dZ ee e fd4dZee e e fd4dZedeejddfdZededdfdZee fd4dZee e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e fBd4dZed5dZee e e e e e e e e e e e e e e e e e e e e e e fd4dZed5dZedee ddfdZedeeddfdZedee ddfdZedeejddfdZededddfdZededddfdZeded ddfd!Zee e e fd4d"Zee e fd4d#Zed5d$Zeded%ddfd&Zeded'ddfd(Zeded)ddfd*Zeded+ddfd,Zee e e e fd4d-Zededdfd.Zedeeddfd/Zed5d0Zded1ddfd2Ze e e e e e e e e e e e f fd3 ZxZS)6Strokea/Stroke schema wrapper Mapping(required=[shorthand]) Parameters ---------- shorthand : string shorthand for field, aggregate, and type aggregate : :class:`Aggregate` Aggregation function for the field (e.g., ``"mean"``, ``"sum"``, ``"median"``, ``"min"``, ``"max"``, ``"count"`` ). **Default value:** ``undefined`` (None) **See also:** `aggregate `__ documentation. bandPosition : float Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to ``0``, and at the middle of the band if set to ``0.5``. bin : anyOf(boolean, :class:`BinParams`, None) A flag for binning a ``quantitative`` field, `an object defining binning parameters `__, or indicating that the data for ``x`` or ``y`` channel are binned before they are imported into Vega-Lite ( ``"binned"`` ). If ``true``, default `binning parameters `__ will be applied. If ``"binned"``, this indicates that the data for the ``x`` (or ``y`` ) channel are already binned. You can map the bin-start field to ``x`` (or ``y`` ) and the bin-end field to ``x2`` (or ``y2`` ). The scale and axis will be formatted similar to binning in Vega-Lite. To adjust the axis ticks based on the bin step, you can also set the axis's `tickMinStep `__ property. **Default value:** ``false`` **See also:** `bin `__ documentation. condition : anyOf(:class:`ConditionalValueDefGradientstringnullExprRef`, List(:class:`ConditionalValueDefGradientstringnullExprRef`)) One or more value definition(s) with `a parameter or a test predicate `__. **Note:** A field definition's ``condition`` property can only contain `conditional value definitions `__ since Vega-Lite only allows at most one encoded field per encoding channel. field : :class:`Field` **Required.** A string defining the name of the field from which to pull a data value or an object defining iterated values from the `repeat `__ operator. **See also:** `field `__ documentation. **Notes:** 1) Dots ( ``.`` ) and brackets ( ``[`` and ``]`` ) can be used to access nested objects (e.g., ``"field": "foo.bar"`` and ``"field": "foo['bar']"`` ). If field names contain dots or brackets but are not nested, you can use ``\`` to escape dots and brackets (e.g., ``"a\.b"`` and ``"a\[0\]"`` ). See more details about escaping in the `field documentation `__. 2) ``field`` is not required if ``aggregate`` is ``count``. legend : anyOf(:class:`Legend`, None) An object defining properties of the legend. If ``null``, the legend for the encoding channel will be removed. **Default value:** If undefined, default `legend properties `__ are applied. **See also:** `legend `__ documentation. scale : anyOf(:class:`Scale`, None) An object defining properties of the channel's scale, which is the function that transforms values in the data domain (numbers, dates, strings, etc) to visual values (pixels, colors, sizes) of the encoding channels. If ``null``, the scale will be `disabled and the data value will be directly encoded `__. **Default value:** If undefined, default `scale properties `__ are applied. **See also:** `scale `__ documentation. sort : :class:`Sort` Sort order for the encoded field. For continuous fields (quantitative or temporal), ``sort`` can be either ``"ascending"`` or ``"descending"``. For discrete fields, ``sort`` can be one of the following: * ``"ascending"`` or ``"descending"`` -- for sorting by the values' natural order in JavaScript. * `A string indicating an encoding channel name to sort by `__ (e.g., ``"x"`` or ``"y"`` ) with an optional minus prefix for descending sort (e.g., ``"-x"`` to sort by x-field, descending). This channel string is short-form of `a sort-by-encoding definition `__. For example, ``"sort": "-x"`` is equivalent to ``"sort": {"encoding": "x", "order": "descending"}``. * `A sort field definition `__ for sorting by another field. * `An array specifying the field values in preferred order `__. In this case, the sort order will obey the values in the array, followed by any unspecified values in their original order. For discrete time field, values in the sort array can be `date-time definition objects `__. In addition, for time units ``"month"`` and ``"day"``, the values can be the month or day names (case insensitive) or their 3-letter initials (e.g., ``"Mon"``, ``"Tue"`` ). * ``null`` indicating no sort. **Default value:** ``"ascending"`` **Note:** ``null`` and sorting by another channel is not supported for ``row`` and ``column``. **See also:** `sort `__ documentation. timeUnit : anyOf(:class:`TimeUnit`, :class:`TimeUnitParams`) Time unit (e.g., ``year``, ``yearmonth``, ``month``, ``hours`` ) for a temporal field. or `a temporal field that gets casted as ordinal `__. **Default value:** ``undefined`` (None) **See also:** `timeUnit `__ documentation. title : anyOf(:class:`Text`, None) A title for the field. If ``null``, the title will be removed. **Default value:** derived from the field's name and transformation function ( ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function, the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ). Otherwise, the title is simply the field name. **Notes** : 1) You can customize the default field title format by providing the `fieldTitle `__ property in the `config `__ or `fieldTitle function via the compile function's options `__. 2) If both field definition's ``title`` and axis, header, or legend ``title`` are defined, axis/header/legend title will be used. type : :class:`StandardType` The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also be a ``"geojson"`` type for encoding `'geoshape' `__. Vega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal scale for a field with ``bin`` or ``timeUnit``. **Default value:** 1) For a data ``field``, ``"nominal"`` is the default data type unless the field encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or ``timeUnit`` that satisfies the following criteria: * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin`` or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a quantitative scale `__. * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit`` or (2) the specified scale type is a time or utc scale * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort order `__, (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is ``order``. 2) For a constant value in data domain ( ``datum`` ): * ``"quantitative"`` if the datum is a number * ``"nominal"`` if the datum is a string * ``"temporal"`` if the datum is `a date time object `__ **Note:** * Data ``type`` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data. * Data values for a temporal field can be either a date-time string (e.g., ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a timestamp number (e.g., ``1552199579097`` ). * When using with `bin `__, the ``type`` property can be either ``"quantitative"`` (for using a linear bin scale) or `"ordinal" (for using an ordinal bin scale) `__. * When using with `timeUnit `__, the ``type`` property can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal" (for using an ordinal scale) `__. * When using with `aggregate `__, the ``type`` property refers to the post-aggregation data type. For example, we can calculate count ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct", "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``. * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have ``type`` as they must have exactly the same type as their primary channels (e.g., ``x``, ``y`` ). **See also:** `type `__ documentation. FrrKrLrbc dSrdrres rrfzStroke.aggregate0$rgr c dSrdrris rrfzStroke.aggregate4$rgr c dSrdrrls rrfzStroke.aggregate8$rgr c dSrdrres rrozStroke.bandPosition<$rpr c dSrdrres rrrz Stroke.bin?$rgr c  dSrdrrts rrrz Stroke.binC$rgr Nc dSrdrres rrrz Stroke.binG$rgr c dSrdrrs rr@zStroke.conditionK$rgr c dSrdrrs rr@zStroke.conditionO$rgr c dSrdrres rr@zStroke.conditionS$rgr c dSrdrres rrz Stroke.fieldW$rgr c dSrdrrs rrz Stroke.field[$rgr cC dSrdrrsD rrz Stroke.legend_$rgr c dSrdrres rrz Stroke.legendc$rgr c dSrdrrs rrz Stroke.scaleg$rgr c dSrdrres rrz Stroke.scalek$rgr c dSrdrres rrz Stroke.sorto$rgr c dSrdrres rrz Stroke.sorts$rgr c dSrdrres rrz Stroke.sortw$rgr c dSrdrres rrz Stroke.sort{$rgr rc dSrdrres rrz Stroke.sort$rgr rc dSrdrres rrz Stroke.sort$rgr rc dSrdrres rrz Stroke.sort$rgr c dSrdrrs rrz Stroke.sort$rgr c dSrdrrs rrz Stroke.sort$rgr c dSrdrres rrz Stroke.sort$rgr rc dSrdrres rrzStroke.timeUnit$rgr rc dSrdrres rrzStroke.timeUnit$rgr r#c dSrdrres rrzStroke.timeUnit$rgr rBc dSrdrres rrzStroke.timeUnit$rgr c dSrdrrbs rrzStroke.timeUnit$rgr c dSrdrres rrz Stroke.title$rgr c dSrdrres rrz Stroke.title$rgr c dSrdrres rrz Stroke.title$rgr rhc dSrdrres rr"z Stroke.type$rpr c  btt|jd||||||||| | | | d | dSro)r2rrprqs rrpzStroke.__init__$sk %fd$ XyI2>CS\+0uSW.6e$ X XSW X X X X Xr )rbr)rKNrbrrr<s@rrrK#s= __@(-$N  7$bc px   X (    X (    X  e      T h   X "9Y_hr{FOV_fow@    X    X &i    X 'y     X  4 QR _g   X  s x   X $    X # \et}LUajvHQ^gxAS\r{QZnwCLYbr{HQ]fr{KTen@ I V _ m v E N ] f u ~ P Y c l v  H Q Z c m v C L Z c p y LUgp~GV_oxENbkHU^jsAJR[hqHXanwCL\evQZgpBKZcqzIRYbkt}F    X    X #))9_hqzGP\eqzEN\eluHW`ox@IT]hq{DLU^gnw~G    X    X  d5k h   X  d3i H   X  d4j X   X  d4=) h   X  g78 X   X  gUV ck   X  gab ow   X "y     X %Y    X    X  '#PQ ^f   X  '#qr G   X  '#x y  F N    X  '#O P  ] e    X (yyi    X  s x   X  tCy X   X    X  gNO \d    "+ii]f$Iiy)99XXXXXXXXXXr rc8eZdZdZdZdZdeddfdZee e fddZ ee e e fddZ ede e j ddfd Z ededdfd Zede eddfd Zedd ZdedddfdZe e e e ffd ZxZS) StrokeDatumaStrokeDatum schema wrapper Mapping(required=[]) Parameters ---------- bandPosition : float Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to ``0``, and at the middle of the band if set to ``0.5``. condition : anyOf(:class:`ConditionalValueDefGradientstringnullExprRef`, List(:class:`ConditionalValueDefGradientstringnullExprRef`)) One or more value definition(s) with `a parameter or a test predicate `__. **Note:** A field definition's ``condition`` property can only contain `conditional value definitions `__ since Vega-Lite only allows at most one encoded field per encoding channel. datum : anyOf(:class:`PrimitiveValue`, :class:`DateTime`, :class:`ExprRef`, :class:`RepeatRef`) A constant value in data domain. title : anyOf(:class:`Text`, None) A title for the field. If ``null``, the title will be removed. **Default value:** derived from the field's name and transformation function ( ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function, the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ). Otherwise, the title is simply the field name. **Notes** : 1) You can customize the default field title format by providing the `fieldTitle `__ property in the `config `__ or `fieldTitle function via the compile function's options `__. 2) If both field definition's ``title`` and axis, header, or legend ``title`` are defined, axis/header/legend title will be used. type : :class:`Type` The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also be a ``"geojson"`` type for encoding `'geoshape' `__. Vega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal scale for a field with ``bin`` or ``timeUnit``. **Default value:** 1) For a data ``field``, ``"nominal"`` is the default data type unless the field encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or ``timeUnit`` that satisfies the following criteria: * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin`` or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a quantitative scale `__. * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit`` or (2) the specified scale type is a time or utc scale * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort order `__, (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is ``order``. 2) For a constant value in data domain ( ``datum`` ): * ``"quantitative"`` if the datum is a number * ``"nominal"`` if the datum is a string * ``"temporal"`` if the datum is `a date time object `__ **Note:** * Data ``type`` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data. * Data values for a temporal field can be either a date-time string (e.g., ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a timestamp number (e.g., ``1552199579097`` ). * When using with `bin `__, the ``type`` property can be either ``"quantitative"`` (for using a linear bin scale) or `"ordinal" (for using an ordinal bin scale) `__. * When using with `timeUnit `__, the ``type`` property can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal" (for using an ordinal scale) `__. * When using with `aggregate `__, the ``type`` property refers to the post-aggregation data type. For example, we can calculate count ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct", "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``. * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have ``type`` as they must have exactly the same type as their primary channels (e.g., ``x``, ``y`` ). **See also:** `type `__ documentation. FrrKrbc dSrdrres rrozStrokeDatum.bandPosition7%rpr c dSrdrrs rr@zStrokeDatum.condition:%rgr c dSrdrrs rr@zStrokeDatum.condition>%rgr c dSrdrres rr@zStrokeDatum.conditionB%rgr c dSrdrres rrzStrokeDatum.titleF%rgr c dSrdrres rrzStrokeDatum.titleJ%rgr Nc dSrdrres rrzStrokeDatum.titleN%rgr rc dSrdrres rr"zStrokeDatum.typeR%rpr c Ttt|jd|||||d|dSr)r2r<rprs rrpzStrokeDatum.__init__V%sT)k4  ) JL\e05D J JDH J J J J Jr )rbr<)rKNrbr<rr<s@rr<r<$smm\(-$N e     &i    X 'y     X  4 QR _l   X  s }   X  tCy ]   X    X  gYZ gt    ,5 QZJJJJJJJJJJr r<c VeZdZdZdZdZeeeeeeeeeeeef ddZeeeeeeeefddZeeeeeeeeeeeeef ddZeeeeeeeeefddZeeefdd Zeeeefdd Zed e e j ddfd Zeffd Z xZ S) StrokeValueaStrokeValue schema wrapper Mapping(required=[]) Parameters ---------- condition : anyOf(:class:`ConditionalMarkPropFieldOrDatumDef`, :class:`ConditionalValueDefGradientstringnullExprRef`, List(:class:`ConditionalValueDefGradientstringnullExprRef`)) A field definition or one or more value definition(s) with a parameter predicate. value : anyOf(:class:`Gradient`, string, None, :class:`ExprRef`) A constant value in visual domain (e.g., ``"red"`` / ``"#0099ff"`` / `gradient definition `__ for color, values between ``0`` to ``1`` for opacity). Frrbc  dSrdrrs rr@zStrokeValue.conditiono%rgr c dSrdrrs rr@zStrokeValue.conditions%rgr c  dSrdrrs rr@zStrokeValue.conditionw%rgr c  dSrdrrs rr@zStrokeValue.condition{%rgr c dSrdrrs rr@zStrokeValue.condition%rgr c dSrdrrs rr@zStrokeValue.condition%rgr rKc dSrdrres rr@zStrokeValue.condition%rgr c Ntt|jd||d|dSr)r2rGrprs rrpzStrokeValue.__init__%s3)k4  )SSSdSSSSSr )rbrGrr<s@rrGrG\%s4  (-$N "+)Zclu~GNW^gr{CLS\    X %.i Ybir{DKT    X "+)Zckt~GOX`ipyDMU^en    X %.iyYbjs|EMV]f    X &i    X 'y     X  4 QR _l   X )2TTTTTTTTTTr rGcCeZdZdZdZdZededddfdZee fd4dZee fd4d Zde ddfd Z ede ddfd Z ee e e e e e e e e e f d4d Z ed5dZ ee e fd4dZee e e fd4dZedeejddfdZededdfdZee fd4dZee e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e fBd4dZed5dZee e e e e e e e e e e e e e e e e e e e e e e fd4dZed5dZedee ddfdZedeeddfdZedee ddfdZedeejddfdZededddfdZededddfdZeded ddfd!Zee e e fd4d"Zee e fd4d#Zed5d$Zeded%ddfd&Zeded'ddfd(Zeded)ddfd*Zeded+ddfd,Zee e e e fd4d-Zededdfd.Zedeeddfd/Zed5d0Zded1ddfd2Ze e e e e e e e e e e e f fd3 ZxZS)6 StrokeDasha/StrokeDash schema wrapper Mapping(required=[shorthand]) Parameters ---------- shorthand : string shorthand for field, aggregate, and type aggregate : :class:`Aggregate` Aggregation function for the field (e.g., ``"mean"``, ``"sum"``, ``"median"``, ``"min"``, ``"max"``, ``"count"`` ). **Default value:** ``undefined`` (None) **See also:** `aggregate `__ documentation. bandPosition : float Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to ``0``, and at the middle of the band if set to ``0.5``. bin : anyOf(boolean, :class:`BinParams`, None) A flag for binning a ``quantitative`` field, `an object defining binning parameters `__, or indicating that the data for ``x`` or ``y`` channel are binned before they are imported into Vega-Lite ( ``"binned"`` ). If ``true``, default `binning parameters `__ will be applied. If ``"binned"``, this indicates that the data for the ``x`` (or ``y`` ) channel are already binned. You can map the bin-start field to ``x`` (or ``y`` ) and the bin-end field to ``x2`` (or ``y2`` ). The scale and axis will be formatted similar to binning in Vega-Lite. To adjust the axis ticks based on the bin step, you can also set the axis's `tickMinStep `__ property. **Default value:** ``false`` **See also:** `bin `__ documentation. condition : anyOf(:class:`ConditionalValueDefnumberArrayExprRef`, List(:class:`ConditionalValueDefnumberArrayExprRef`)) One or more value definition(s) with `a parameter or a test predicate `__. **Note:** A field definition's ``condition`` property can only contain `conditional value definitions `__ since Vega-Lite only allows at most one encoded field per encoding channel. field : :class:`Field` **Required.** A string defining the name of the field from which to pull a data value or an object defining iterated values from the `repeat `__ operator. **See also:** `field `__ documentation. **Notes:** 1) Dots ( ``.`` ) and brackets ( ``[`` and ``]`` ) can be used to access nested objects (e.g., ``"field": "foo.bar"`` and ``"field": "foo['bar']"`` ). If field names contain dots or brackets but are not nested, you can use ``\`` to escape dots and brackets (e.g., ``"a\.b"`` and ``"a\[0\]"`` ). See more details about escaping in the `field documentation `__. 2) ``field`` is not required if ``aggregate`` is ``count``. legend : anyOf(:class:`Legend`, None) An object defining properties of the legend. If ``null``, the legend for the encoding channel will be removed. **Default value:** If undefined, default `legend properties `__ are applied. **See also:** `legend `__ documentation. scale : anyOf(:class:`Scale`, None) An object defining properties of the channel's scale, which is the function that transforms values in the data domain (numbers, dates, strings, etc) to visual values (pixels, colors, sizes) of the encoding channels. If ``null``, the scale will be `disabled and the data value will be directly encoded `__. **Default value:** If undefined, default `scale properties `__ are applied. **See also:** `scale `__ documentation. sort : :class:`Sort` Sort order for the encoded field. For continuous fields (quantitative or temporal), ``sort`` can be either ``"ascending"`` or ``"descending"``. For discrete fields, ``sort`` can be one of the following: * ``"ascending"`` or ``"descending"`` -- for sorting by the values' natural order in JavaScript. * `A string indicating an encoding channel name to sort by `__ (e.g., ``"x"`` or ``"y"`` ) with an optional minus prefix for descending sort (e.g., ``"-x"`` to sort by x-field, descending). This channel string is short-form of `a sort-by-encoding definition `__. For example, ``"sort": "-x"`` is equivalent to ``"sort": {"encoding": "x", "order": "descending"}``. * `A sort field definition `__ for sorting by another field. * `An array specifying the field values in preferred order `__. In this case, the sort order will obey the values in the array, followed by any unspecified values in their original order. For discrete time field, values in the sort array can be `date-time definition objects `__. In addition, for time units ``"month"`` and ``"day"``, the values can be the month or day names (case insensitive) or their 3-letter initials (e.g., ``"Mon"``, ``"Tue"`` ). * ``null`` indicating no sort. **Default value:** ``"ascending"`` **Note:** ``null`` and sorting by another channel is not supported for ``row`` and ``column``. **See also:** `sort `__ documentation. timeUnit : anyOf(:class:`TimeUnit`, :class:`TimeUnitParams`) Time unit (e.g., ``year``, ``yearmonth``, ``month``, ``hours`` ) for a temporal field. or `a temporal field that gets casted as ordinal `__. **Default value:** ``undefined`` (None) **See also:** `timeUnit `__ documentation. title : anyOf(:class:`Text`, None) A title for the field. If ``null``, the title will be removed. **Default value:** derived from the field's name and transformation function ( ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function, the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ). Otherwise, the title is simply the field name. **Notes** : 1) You can customize the default field title format by providing the `fieldTitle `__ property in the `config `__ or `fieldTitle function via the compile function's options `__. 2) If both field definition's ``title`` and axis, header, or legend ``title`` are defined, axis/header/legend title will be used. type : :class:`StandardType` The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also be a ``"geojson"`` type for encoding `'geoshape' `__. Vega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal scale for a field with ``bin`` or ``timeUnit``. **Default value:** 1) For a data ``field``, ``"nominal"`` is the default data type unless the field encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or ``timeUnit`` that satisfies the following criteria: * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin`` or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a quantitative scale `__. * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit`` or (2) the specified scale type is a time or utc scale * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort order `__, (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is ``order``. 2) For a constant value in data domain ( ``datum`` ): * ``"quantitative"`` if the datum is a number * ``"nominal"`` if the datum is a string * ``"temporal"`` if the datum is `a date time object `__ **Note:** * Data ``type`` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data. * Data values for a temporal field can be either a date-time string (e.g., ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a timestamp number (e.g., ``1552199579097`` ). * When using with `bin `__, the ``type`` property can be either ``"quantitative"`` (for using a linear bin scale) or `"ordinal" (for using an ordinal bin scale) `__. * When using with `timeUnit `__, the ``type`` property can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal" (for using an ordinal scale) `__. * When using with `aggregate `__, the ``type`` property refers to the post-aggregation data type. For example, we can calculate count ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct", "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``. * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have ``type`` as they must have exactly the same type as their primary channels (e.g., ``x``, ``y`` ). **See also:** `type `__ documentation. F strokeDashrKrLrbc dSrdrres rrfzStrokeDash.aggregateu&rgr c dSrdrris rrfzStrokeDash.aggregatey&rgr c dSrdrrls rrfzStrokeDash.aggregate}&rgr c dSrdrres rrozStrokeDash.bandPosition&rpr c dSrdrres rrrzStrokeDash.bin&rgr c  dSrdrrts rrrzStrokeDash.bin&rgr Nc dSrdrres rrrzStrokeDash.bin&rgr c dSrdrrs rr@zStrokeDash.condition&rgr c dSrdrrs rr@zStrokeDash.condition&rgr c dSrdrres rr@zStrokeDash.condition&rgr c dSrdrres rrzStrokeDash.field&rgr c dSrdrrs rrzStrokeDash.field&rgr cC dSrdrrsD rrzStrokeDash.legend&rgr c dSrdrres rrzStrokeDash.legend&rgr c dSrdrrs rrzStrokeDash.scale&rgr c dSrdrres rrzStrokeDash.scale&rgr c dSrdrres rrzStrokeDash.sort&rgr c dSrdrres rrzStrokeDash.sort&rgr c dSrdrres rrzStrokeDash.sort&rgr c dSrdrres rrzStrokeDash.sort&rgr rc dSrdrres rrzStrokeDash.sort&rgr rc dSrdrres rrzStrokeDash.sort&rgr rc dSrdrres rrzStrokeDash.sort&rgr c dSrdrrs rrzStrokeDash.sort&rgr c dSrdrrs rrzStrokeDash.sort&rgr c dSrdrres rrzStrokeDash.sort&rgr rc dSrdrres rrzStrokeDash.timeUnit&rgr rc dSrdrres rrzStrokeDash.timeUnit&rgr r#c dSrdrres rrzStrokeDash.timeUnit&rgr rBc dSrdrres rrzStrokeDash.timeUnit&rgr c dSrdrrbs rrzStrokeDash.timeUnit&rgr c dSrdrres rrzStrokeDash.title&rgr c dSrdrres rrzStrokeDash.title&rgr c dSrdrres rrzStrokeDash.title&rgr rhc dSrdrres rr"zStrokeDash.type&rpr c  btt|jd||||||||| | | | d | dSro)r2rQrprqs rrpzStrokeDash.__init__'sk )j$( \9 6BW`/4V5W[2:%d \ \W[ \ \ \ \ \r )rbrQ)rKNrbrQ)r'r9r:rtrurvrr rfrrwrorxrrr@r r%ConditionalValueDefnumberArrayExprRefr.rrrrrzrrr"rpr;r<s@rrQrQ%s= __@(-$!N  7$bc p|   X (    X (    X  e      T l   X "9Y_hr{FOV_fow@    X    X &i    X 'y     X  4 JK Xd   X  s |   X $    X # \et}LUajvHQ^gxAS\r{QZnwCLYbr{HQ]fr{KTen@ I V _ m v E N ] f u ~ P Y c l v  H Q Z c m v C L Z c p y LUgp~GV_oxENbkHU^jsAJR[hqHXanwCL\evQZgpBKZcqzIRYbkt}F    X    X #))9_hqzGP\eqzEN\eluHW`ox@IT]hq{DLU^gnw~G    X    X  d5k l   X  d3i L   X  d4j \   X  d4=) l   X  g78 \   X  gUV co   X  gab o{   X "y     X %Y    X    X  '#PQ ^j   X  '#qr K   X  '#x y  F R    X  '#O P  ] i    X (yyi    X  s |   X  tCy \   X    X  gNO \h    "+ii]f$Iiy)99\\\\\\\\\\r rQc8eZdZdZdZdZdeddfdZee e fddZ ee e e fddZ ede e j ddfd Z ededdfd Zede eddfd Zedd ZdedddfdZe e e e ffd ZxZS)StrokeDashDatumavStrokeDashDatum schema wrapper Mapping(required=[]) Parameters ---------- bandPosition : float Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to ``0``, and at the middle of the band if set to ``0.5``. condition : anyOf(:class:`ConditionalValueDefnumberArrayExprRef`, List(:class:`ConditionalValueDefnumberArrayExprRef`)) One or more value definition(s) with `a parameter or a test predicate `__. **Note:** A field definition's ``condition`` property can only contain `conditional value definitions `__ since Vega-Lite only allows at most one encoded field per encoding channel. datum : anyOf(:class:`PrimitiveValue`, :class:`DateTime`, :class:`ExprRef`, :class:`RepeatRef`) A constant value in data domain. title : anyOf(:class:`Text`, None) A title for the field. If ``null``, the title will be removed. **Default value:** derived from the field's name and transformation function ( ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function, the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ). Otherwise, the title is simply the field name. **Notes** : 1) You can customize the default field title format by providing the `fieldTitle `__ property in the `config `__ or `fieldTitle function via the compile function's options `__. 2) If both field definition's ``title`` and axis, header, or legend ``title`` are defined, axis/header/legend title will be used. type : :class:`Type` The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also be a ``"geojson"`` type for encoding `'geoshape' `__. Vega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal scale for a field with ``bin`` or ``timeUnit``. **Default value:** 1) For a data ``field``, ``"nominal"`` is the default data type unless the field encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or ``timeUnit`` that satisfies the following criteria: * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin`` or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a quantitative scale `__. * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit`` or (2) the specified scale type is a time or utc scale * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort order `__, (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is ``order``. 2) For a constant value in data domain ( ``datum`` ): * ``"quantitative"`` if the datum is a number * ``"nominal"`` if the datum is a string * ``"temporal"`` if the datum is `a date time object `__ **Note:** * Data ``type`` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data. * Data values for a temporal field can be either a date-time string (e.g., ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a timestamp number (e.g., ``1552199579097`` ). * When using with `bin `__, the ``type`` property can be either ``"quantitative"`` (for using a linear bin scale) or `"ordinal" (for using an ordinal bin scale) `__. * When using with `timeUnit `__, the ``type`` property can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal" (for using an ordinal scale) `__. * When using with `aggregate `__, the ``type`` property refers to the post-aggregation data type. For example, we can calculate count ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct", "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``. * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have ``type`` as they must have exactly the same type as their primary channels (e.g., ``x``, ``y`` ). **See also:** `type `__ documentation. FrRrKrbc dSrdrres rrozStrokeDashDatum.bandPosition|'rpr c dSrdrrs rr@zStrokeDashDatum.condition'rgr c dSrdrrs rr@zStrokeDashDatum.condition'rgr c dSrdrres rr@zStrokeDashDatum.condition'rgr c dSrdrres rrzStrokeDashDatum.title'rgr c dSrdrres rrzStrokeDashDatum.title'rgr Nc dSrdrres rrzStrokeDashDatum.title'rgr rc dSrdrres rr"zStrokeDashDatum.type'rpr c Ttt|jd|||||d|dSr)r2ryrprs rrpzStrokeDashDatum.__init__'sT-ot$$- cE 8AUY c c]a c c c c cr )rbry)rKNrbry)r'r9r:rtrurvrwrorrr@r rrwr.rr r"rpr;r<s@rryry 'smm\(-$!N e 0A    &i    X 'y     X  4 JK Xi   X  s '8   X  tCy ->   X    X  gYZ gx    ,5 QZccccccccccr ryc VeZdZdZdZdZeeeeeeeeeeeef ddZeeeeeeeefddZeeeeeeeeeeeeef ddZeeeeeeeeefddZeeefdd Zeeeefdd Zed e e j ddfd Zeffd Z xZ S)StrokeDashValueayStrokeDashValue schema wrapper Mapping(required=[]) Parameters ---------- condition : anyOf(:class:`ConditionalMarkPropFieldOrDatumDef`, :class:`ConditionalValueDefnumberArrayExprRef`, List(:class:`ConditionalValueDefnumberArrayExprRef`)) A field definition or one or more value definition(s) with a parameter predicate. value : anyOf(List(float), :class:`ExprRef`) A constant value in visual domain (e.g., ``"red"`` / ``"#0099ff"`` / `gradient definition `__ for color, values between ``0`` to ``1`` for opacity). FrRrbc  dSrdrrs rr@zStrokeDashValue.condition'rgr c dSrdrrs rr@zStrokeDashValue.condition'rgr c  dSrdrrs rr@zStrokeDashValue.condition'rgr c  dSrdrrs rr@zStrokeDashValue.condition'rgr c dSrdrrs rr@zStrokeDashValue.condition'rgr c dSrdrrs rr@zStrokeDashValue.condition'rgr rKc dSrdrres rr@zStrokeDashValue.condition'rgr c Ntt|jd||d|dSr)r2rrprs rrpzStrokeDashValue.__init__'s4-ot$$-WEYWWRVWWWWWr )rbr)r'r9r:rtrurvrrr@r rrwrpr;r<s@rrr's4  (-$!N "+)Zclu~GNW^gr{CLS\    X %.i Ybir{DKT    X "+)Zckt~GOX`ipyDMU^en    X %.iyYbjs|EMV]f    X &i    X 'y     X  4 JK Xi   X )2XXXXXXXXXXr rcCeZdZdZdZdZededddfdZee fd4dZee fd4d Zde ddfd Z ede ddfd Z ee e e e e e e e e e f d4d Z ed5dZ ee e fd4dZee e e fd4dZedeejddfdZededdfdZee fd4dZee e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e fBd4dZed5dZee e e e e e e e e e e e e e e e e e e e e e e fd4dZed5dZedee ddfdZedeeddfdZedee ddfdZedeejddfdZededddfdZededddfdZeded ddfd!Zee e e fd4d"Zee e fd4d#Zed5d$Zeded%ddfd&Zeded'ddfd(Zeded)ddfd*Zeded+ddfd,Zee e e e fd4d-Zededdfd.Zedeeddfd/Zed5d0Zded1ddfd2Ze e e e e e e e e e e e f fd3 ZxZS)6 StrokeOpacitya/StrokeOpacity schema wrapper Mapping(required=[shorthand]) Parameters ---------- shorthand : string shorthand for field, aggregate, and type aggregate : :class:`Aggregate` Aggregation function for the field (e.g., ``"mean"``, ``"sum"``, ``"median"``, ``"min"``, ``"max"``, ``"count"`` ). **Default value:** ``undefined`` (None) **See also:** `aggregate `__ documentation. bandPosition : float Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to ``0``, and at the middle of the band if set to ``0.5``. bin : anyOf(boolean, :class:`BinParams`, None) A flag for binning a ``quantitative`` field, `an object defining binning parameters `__, or indicating that the data for ``x`` or ``y`` channel are binned before they are imported into Vega-Lite ( ``"binned"`` ). If ``true``, default `binning parameters `__ will be applied. If ``"binned"``, this indicates that the data for the ``x`` (or ``y`` ) channel are already binned. You can map the bin-start field to ``x`` (or ``y`` ) and the bin-end field to ``x2`` (or ``y2`` ). The scale and axis will be formatted similar to binning in Vega-Lite. To adjust the axis ticks based on the bin step, you can also set the axis's `tickMinStep `__ property. **Default value:** ``false`` **See also:** `bin `__ documentation. condition : anyOf(:class:`ConditionalValueDefnumberExprRef`, List(:class:`ConditionalValueDefnumberExprRef`)) One or more value definition(s) with `a parameter or a test predicate `__. **Note:** A field definition's ``condition`` property can only contain `conditional value definitions `__ since Vega-Lite only allows at most one encoded field per encoding channel. field : :class:`Field` **Required.** A string defining the name of the field from which to pull a data value or an object defining iterated values from the `repeat `__ operator. **See also:** `field `__ documentation. **Notes:** 1) Dots ( ``.`` ) and brackets ( ``[`` and ``]`` ) can be used to access nested objects (e.g., ``"field": "foo.bar"`` and ``"field": "foo['bar']"`` ). If field names contain dots or brackets but are not nested, you can use ``\`` to escape dots and brackets (e.g., ``"a\.b"`` and ``"a\[0\]"`` ). See more details about escaping in the `field documentation `__. 2) ``field`` is not required if ``aggregate`` is ``count``. legend : anyOf(:class:`Legend`, None) An object defining properties of the legend. If ``null``, the legend for the encoding channel will be removed. **Default value:** If undefined, default `legend properties `__ are applied. **See also:** `legend `__ documentation. scale : anyOf(:class:`Scale`, None) An object defining properties of the channel's scale, which is the function that transforms values in the data domain (numbers, dates, strings, etc) to visual values (pixels, colors, sizes) of the encoding channels. If ``null``, the scale will be `disabled and the data value will be directly encoded `__. **Default value:** If undefined, default `scale properties `__ are applied. **See also:** `scale `__ documentation. sort : :class:`Sort` Sort order for the encoded field. For continuous fields (quantitative or temporal), ``sort`` can be either ``"ascending"`` or ``"descending"``. For discrete fields, ``sort`` can be one of the following: * ``"ascending"`` or ``"descending"`` -- for sorting by the values' natural order in JavaScript. * `A string indicating an encoding channel name to sort by `__ (e.g., ``"x"`` or ``"y"`` ) with an optional minus prefix for descending sort (e.g., ``"-x"`` to sort by x-field, descending). This channel string is short-form of `a sort-by-encoding definition `__. For example, ``"sort": "-x"`` is equivalent to ``"sort": {"encoding": "x", "order": "descending"}``. * `A sort field definition `__ for sorting by another field. * `An array specifying the field values in preferred order `__. In this case, the sort order will obey the values in the array, followed by any unspecified values in their original order. For discrete time field, values in the sort array can be `date-time definition objects `__. In addition, for time units ``"month"`` and ``"day"``, the values can be the month or day names (case insensitive) or their 3-letter initials (e.g., ``"Mon"``, ``"Tue"`` ). * ``null`` indicating no sort. **Default value:** ``"ascending"`` **Note:** ``null`` and sorting by another channel is not supported for ``row`` and ``column``. **See also:** `sort `__ documentation. timeUnit : anyOf(:class:`TimeUnit`, :class:`TimeUnitParams`) Time unit (e.g., ``year``, ``yearmonth``, ``month``, ``hours`` ) for a temporal field. or `a temporal field that gets casted as ordinal `__. **Default value:** ``undefined`` (None) **See also:** `timeUnit `__ documentation. title : anyOf(:class:`Text`, None) A title for the field. If ``null``, the title will be removed. **Default value:** derived from the field's name and transformation function ( ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function, the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ). Otherwise, the title is simply the field name. **Notes** : 1) You can customize the default field title format by providing the `fieldTitle `__ property in the `config `__ or `fieldTitle function via the compile function's options `__. 2) If both field definition's ``title`` and axis, header, or legend ``title`` are defined, axis/header/legend title will be used. type : :class:`StandardType` The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also be a ``"geojson"`` type for encoding `'geoshape' `__. Vega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal scale for a field with ``bin`` or ``timeUnit``. **Default value:** 1) For a data ``field``, ``"nominal"`` is the default data type unless the field encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or ``timeUnit`` that satisfies the following criteria: * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin`` or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a quantitative scale `__. * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit`` or (2) the specified scale type is a time or utc scale * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort order `__, (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is ``order``. 2) For a constant value in data domain ( ``datum`` ): * ``"quantitative"`` if the datum is a number * ``"nominal"`` if the datum is a string * ``"temporal"`` if the datum is `a date time object `__ **Note:** * Data ``type`` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data. * Data values for a temporal field can be either a date-time string (e.g., ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a timestamp number (e.g., ``1552199579097`` ). * When using with `bin `__, the ``type`` property can be either ``"quantitative"`` (for using a linear bin scale) or `"ordinal" (for using an ordinal bin scale) `__. * When using with `timeUnit `__, the ``type`` property can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal" (for using an ordinal scale) `__. * When using with `aggregate `__, the ``type`` property refers to the post-aggregation data type. For example, we can calculate count ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct", "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``. * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have ``type`` as they must have exactly the same type as their primary channels (e.g., ``x``, ``y`` ). **See also:** `type `__ documentation. FrrKrLrbc dSrdrres rrfzStrokeOpacity.aggregate(rgr c dSrdrris rrfzStrokeOpacity.aggregate(rgr c dSrdrrls rrfzStrokeOpacity.aggregate(rgr c dSrdrres rrozStrokeOpacity.bandPosition(rpr c dSrdrres rrrzStrokeOpacity.bin(rgr c  dSrdrrts rrrzStrokeOpacity.bin(rgr Nc dSrdrres rrrzStrokeOpacity.bin(rgr c dSrdrrs rr@zStrokeOpacity.condition(rgr c dSrdrrs rr@zStrokeOpacity.condition(rgr c dSrdrres rr@zStrokeOpacity.condition(rgr c dSrdrres rrzStrokeOpacity.field(rgr c dSrdrrs rrzStrokeOpacity.field(rgr cC dSrdrrsD rrzStrokeOpacity.legend(rgr c dSrdrres rrzStrokeOpacity.legend(rgr c dSrdrrs rrzStrokeOpacity.scale(rgr c dSrdrres rrzStrokeOpacity.scale(rgr c dSrdrres rrzStrokeOpacity.sort(rgr c dSrdrres rrzStrokeOpacity.sort(rgr c dSrdrres rrzStrokeOpacity.sort)rgr c dSrdrres rrzStrokeOpacity.sort)rgr rc dSrdrres rrzStrokeOpacity.sort )rgr rc dSrdrres rrzStrokeOpacity.sort )rgr rc dSrdrres rrzStrokeOpacity.sort)rgr c dSrdrrs rrzStrokeOpacity.sort)rgr c dSrdrrs rrzStrokeOpacity.sort)rgr c dSrdrres rrzStrokeOpacity.sort)rgr rc dSrdrres rrzStrokeOpacity.timeUnit!)rgr rc dSrdrres rrzStrokeOpacity.timeUnit%)rgr r#c dSrdrres rrzStrokeOpacity.timeUnit))rgr rBc dSrdrres rrzStrokeOpacity.timeUnit-)rgr c dSrdrrbs rrzStrokeOpacity.timeUnit1)rgr c dSrdrres rrzStrokeOpacity.title5)rgr c dSrdrres rrzStrokeOpacity.title9)rgr c dSrdrres rrzStrokeOpacity.title=)rgr rhc dSrdrres rr"zStrokeOpacity.typeA)rpr c  btt|jd||||||||| | | | d | dSro)r2rrprqs rrpzStrokeOpacity.__init__E)sl ,mT""+ _i99E3Zc27eZ^5=UQU _ _Z^ _ _ _ _ _r )rbr)rKNrbrrsr<s@rrr's= __@(-$$N  7$bc p   X (    X (    X  e      T o   X "9Y_hr{FOV_fow@    X    X &i    X 'y     X  4 EF Sb   X  s    X $    X # \et}LUajvHQ^gxAS\r{QZnwCLYbr{HQ]fr{KTen@ I V _ m v E N ] f u ~ P Y c l v  H Q Z c m v C L Z c p y LUgp~GV_oxENbkHU^jsAJR[hqHXanwCL\evQZgpBKZcqzIRYbkt}F    X    X #))9_hqzGP\eqzEN\eluHW`ox@IT]hq{DLU^gnw~G    X    X  d5k o   X  d3i O   X  d4j _   X  d4=) o   X  g78 _   X  gUV cr   X  gab o~   X "y     X %Y    X    X  '#PQ ^m   X  '#qr N   X  '#x y  F U    X  '#O P  ] l    X (yyi    X  s    X  tCy _   X    X  gNO \k    "+ii]f$Iiy)99__________r rc8eZdZdZdZdZdeddfdZee e fddZ ee e e fddZ ede e j ddfd Z ededdfd Zede eddfd Zedd ZdedddfdZe e e e ffd ZxZS)StrokeOpacityDatumaoStrokeOpacityDatum schema wrapper Mapping(required=[]) Parameters ---------- bandPosition : float Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to ``0``, and at the middle of the band if set to ``0.5``. condition : anyOf(:class:`ConditionalValueDefnumberExprRef`, List(:class:`ConditionalValueDefnumberExprRef`)) One or more value definition(s) with `a parameter or a test predicate `__. **Note:** A field definition's ``condition`` property can only contain `conditional value definitions `__ since Vega-Lite only allows at most one encoded field per encoding channel. datum : anyOf(:class:`PrimitiveValue`, :class:`DateTime`, :class:`ExprRef`, :class:`RepeatRef`) A constant value in data domain. title : anyOf(:class:`Text`, None) A title for the field. If ``null``, the title will be removed. **Default value:** derived from the field's name and transformation function ( ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function, the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ). Otherwise, the title is simply the field name. **Notes** : 1) You can customize the default field title format by providing the `fieldTitle `__ property in the `config `__ or `fieldTitle function via the compile function's options `__. 2) If both field definition's ``title`` and axis, header, or legend ``title`` are defined, axis/header/legend title will be used. type : :class:`Type` The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also be a ``"geojson"`` type for encoding `'geoshape' `__. Vega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal scale for a field with ``bin`` or ``timeUnit``. **Default value:** 1) For a data ``field``, ``"nominal"`` is the default data type unless the field encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or ``timeUnit`` that satisfies the following criteria: * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin`` or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a quantitative scale `__. * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit`` or (2) the specified scale type is a time or utc scale * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort order `__, (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is ``order``. 2) For a constant value in data domain ( ``datum`` ): * ``"quantitative"`` if the datum is a number * ``"nominal"`` if the datum is a string * ``"temporal"`` if the datum is `a date time object `__ **Note:** * Data ``type`` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data. * Data values for a temporal field can be either a date-time string (e.g., ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a timestamp number (e.g., ``1552199579097`` ). * When using with `bin `__, the ``type`` property can be either ``"quantitative"`` (for using a linear bin scale) or `"ordinal" (for using an ordinal bin scale) `__. * When using with `timeUnit `__, the ``type`` property can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal" (for using an ordinal scale) `__. * When using with `aggregate `__, the ``type`` property refers to the post-aggregation data type. For example, we can calculate count ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct", "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``. * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have ``type`` as they must have exactly the same type as their primary channels (e.g., ``x``, ``y`` ). **See also:** `type `__ documentation. FrrKrbc dSrdrres rrozStrokeOpacityDatum.bandPosition)rpr c dSrdrrs rr@zStrokeOpacityDatum.condition)rgr c dSrdrrs rr@zStrokeOpacityDatum.condition)rgr c dSrdrres rr@zStrokeOpacityDatum.condition)rgr c dSrdrres rrzStrokeOpacityDatum.title)rgr c dSrdrres rrzStrokeOpacityDatum.title)rgr Nc dSrdrres rrzStrokeOpacityDatum.title)rgr rc dSrdrres rr"zStrokeOpacityDatum.type)rpr c Ttt|jd|||||d|dSr)r2rrprs rrpzStrokeOpacityDatum.__init__)sU0 $''0 fu<;DEX\ f f`d f f f f fr )rbr)rKNrbrrr<s@rrrN)smm\(-$$N e 0D    &i    X 'y     X  4 EF Sg   X  s ';   X  tCy -A   X    X  gYZ g{    ,5 QZffffffffffr rc VeZdZdZdZdZeeeeeeeeeeeef ddZeeeeeeeefddZeeeeeeeeeeeeef ddZeeeeeeeeefddZeeefdd Zeeeefdd Zed e e j ddfd Zeffd Z xZ S)StrokeOpacityValuealStrokeOpacityValue schema wrapper Mapping(required=[]) Parameters ---------- condition : anyOf(:class:`ConditionalMarkPropFieldOrDatumDef`, :class:`ConditionalValueDefnumberExprRef`, List(:class:`ConditionalValueDefnumberExprRef`)) A field definition or one or more value definition(s) with a parameter predicate. value : anyOf(float, :class:`ExprRef`) A constant value in visual domain (e.g., ``"red"`` / ``"#0099ff"`` / `gradient definition `__ for color, values between ``0`` to ``1`` for opacity). Frrbc  dSrdrrs rr@zStrokeOpacityValue.condition)rgr c dSrdrrs rr@zStrokeOpacityValue.condition)rgr c  dSrdrrs rr@zStrokeOpacityValue.condition*rgr c  dSrdrrs rr@zStrokeOpacityValue.condition*rgr c dSrdrrs rr@zStrokeOpacityValue.condition *rgr c dSrdrrs rr@zStrokeOpacityValue.condition *rgr rKc dSrdrres rr@zStrokeOpacityValue.condition*rgr c Ntt|jd||d|dSr)r2rrprs rrpzStrokeOpacityValue.__init__*s50 $''0Zu ZZUYZZZZZr )rbrrr<s@rrr)s4  (-$$N "+)Zclu~GNW^gr{CLS\    X %.i Ybir{DKT    X "+)Zckt~GOX`ipyDMU^en    X %.iyYbjs|EMV]f    X &i    X 'y     X  4 EF Sg   X )2[[[[[[[[[[r rcCeZdZdZdZdZededddfdZee fd4dZee fd4d Zde ddfd Z ede ddfd Z ee e e e e e e e e e f d4d Z ed5dZ ee e fd4dZee e e fd4dZedeejddfdZededdfdZee fd4dZee e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e fBd4dZed5dZee e e e e e e e e e e e e e e e e e e e e e e fd4dZed5dZedee ddfdZedeeddfdZedee ddfdZedeejddfdZededddfdZededddfdZeded ddfd!Zee e e fd4d"Zee e fd4d#Zed5d$Zeded%ddfd&Zeded'ddfd(Zeded)ddfd*Zeded+ddfd,Zee e e e fd4d-Zededdfd.Zedeeddfd/Zed5d0Zded1ddfd2Ze e e e e e e e e e e e f fd3 ZxZS)6 StrokeWidtha/StrokeWidth schema wrapper Mapping(required=[shorthand]) Parameters ---------- shorthand : string shorthand for field, aggregate, and type aggregate : :class:`Aggregate` Aggregation function for the field (e.g., ``"mean"``, ``"sum"``, ``"median"``, ``"min"``, ``"max"``, ``"count"`` ). **Default value:** ``undefined`` (None) **See also:** `aggregate `__ documentation. bandPosition : float Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to ``0``, and at the middle of the band if set to ``0.5``. bin : anyOf(boolean, :class:`BinParams`, None) A flag for binning a ``quantitative`` field, `an object defining binning parameters `__, or indicating that the data for ``x`` or ``y`` channel are binned before they are imported into Vega-Lite ( ``"binned"`` ). If ``true``, default `binning parameters `__ will be applied. If ``"binned"``, this indicates that the data for the ``x`` (or ``y`` ) channel are already binned. You can map the bin-start field to ``x`` (or ``y`` ) and the bin-end field to ``x2`` (or ``y2`` ). The scale and axis will be formatted similar to binning in Vega-Lite. To adjust the axis ticks based on the bin step, you can also set the axis's `tickMinStep `__ property. **Default value:** ``false`` **See also:** `bin `__ documentation. condition : anyOf(:class:`ConditionalValueDefnumberExprRef`, List(:class:`ConditionalValueDefnumberExprRef`)) One or more value definition(s) with `a parameter or a test predicate `__. **Note:** A field definition's ``condition`` property can only contain `conditional value definitions `__ since Vega-Lite only allows at most one encoded field per encoding channel. field : :class:`Field` **Required.** A string defining the name of the field from which to pull a data value or an object defining iterated values from the `repeat `__ operator. **See also:** `field `__ documentation. **Notes:** 1) Dots ( ``.`` ) and brackets ( ``[`` and ``]`` ) can be used to access nested objects (e.g., ``"field": "foo.bar"`` and ``"field": "foo['bar']"`` ). If field names contain dots or brackets but are not nested, you can use ``\`` to escape dots and brackets (e.g., ``"a\.b"`` and ``"a\[0\]"`` ). See more details about escaping in the `field documentation `__. 2) ``field`` is not required if ``aggregate`` is ``count``. legend : anyOf(:class:`Legend`, None) An object defining properties of the legend. If ``null``, the legend for the encoding channel will be removed. **Default value:** If undefined, default `legend properties `__ are applied. **See also:** `legend `__ documentation. scale : anyOf(:class:`Scale`, None) An object defining properties of the channel's scale, which is the function that transforms values in the data domain (numbers, dates, strings, etc) to visual values (pixels, colors, sizes) of the encoding channels. If ``null``, the scale will be `disabled and the data value will be directly encoded `__. **Default value:** If undefined, default `scale properties `__ are applied. **See also:** `scale `__ documentation. sort : :class:`Sort` Sort order for the encoded field. For continuous fields (quantitative or temporal), ``sort`` can be either ``"ascending"`` or ``"descending"``. For discrete fields, ``sort`` can be one of the following: * ``"ascending"`` or ``"descending"`` -- for sorting by the values' natural order in JavaScript. * `A string indicating an encoding channel name to sort by `__ (e.g., ``"x"`` or ``"y"`` ) with an optional minus prefix for descending sort (e.g., ``"-x"`` to sort by x-field, descending). This channel string is short-form of `a sort-by-encoding definition `__. For example, ``"sort": "-x"`` is equivalent to ``"sort": {"encoding": "x", "order": "descending"}``. * `A sort field definition `__ for sorting by another field. * `An array specifying the field values in preferred order `__. In this case, the sort order will obey the values in the array, followed by any unspecified values in their original order. For discrete time field, values in the sort array can be `date-time definition objects `__. In addition, for time units ``"month"`` and ``"day"``, the values can be the month or day names (case insensitive) or their 3-letter initials (e.g., ``"Mon"``, ``"Tue"`` ). * ``null`` indicating no sort. **Default value:** ``"ascending"`` **Note:** ``null`` and sorting by another channel is not supported for ``row`` and ``column``. **See also:** `sort `__ documentation. timeUnit : anyOf(:class:`TimeUnit`, :class:`TimeUnitParams`) Time unit (e.g., ``year``, ``yearmonth``, ``month``, ``hours`` ) for a temporal field. or `a temporal field that gets casted as ordinal `__. **Default value:** ``undefined`` (None) **See also:** `timeUnit `__ documentation. title : anyOf(:class:`Text`, None) A title for the field. If ``null``, the title will be removed. **Default value:** derived from the field's name and transformation function ( ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function, the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ). Otherwise, the title is simply the field name. **Notes** : 1) You can customize the default field title format by providing the `fieldTitle `__ property in the `config `__ or `fieldTitle function via the compile function's options `__. 2) If both field definition's ``title`` and axis, header, or legend ``title`` are defined, axis/header/legend title will be used. type : :class:`StandardType` The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also be a ``"geojson"`` type for encoding `'geoshape' `__. Vega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal scale for a field with ``bin`` or ``timeUnit``. **Default value:** 1) For a data ``field``, ``"nominal"`` is the default data type unless the field encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or ``timeUnit`` that satisfies the following criteria: * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin`` or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a quantitative scale `__. * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit`` or (2) the specified scale type is a time or utc scale * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort order `__, (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is ``order``. 2) For a constant value in data domain ( ``datum`` ): * ``"quantitative"`` if the datum is a number * ``"nominal"`` if the datum is a string * ``"temporal"`` if the datum is `a date time object `__ **Note:** * Data ``type`` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data. * Data values for a temporal field can be either a date-time string (e.g., ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a timestamp number (e.g., ``1552199579097`` ). * When using with `bin `__, the ``type`` property can be either ``"quantitative"`` (for using a linear bin scale) or `"ordinal" (for using an ordinal bin scale) `__. * When using with `timeUnit `__, the ``type`` property can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal" (for using an ordinal scale) `__. * When using with `aggregate `__, the ``type`` property refers to the post-aggregation data type. For example, we can calculate count ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct", "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``. * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have ``type`` as they must have exactly the same type as their primary channels (e.g., ``x``, ``y`` ). **See also:** `type `__ documentation. FrrKrLrbc dSrdrres rrfzStrokeWidth.aggregate*rgr c dSrdrris rrfzStrokeWidth.aggregate+rgr c dSrdrrls rrfzStrokeWidth.aggregate+rgr c dSrdrres rrozStrokeWidth.bandPosition +rpr c dSrdrres rrrzStrokeWidth.bin+rgr c  dSrdrrts rrrzStrokeWidth.bin+rgr Nc dSrdrres rrrzStrokeWidth.bin+rgr c dSrdrrs rr@zStrokeWidth.condition+rgr c dSrdrrs rr@zStrokeWidth.condition+rgr c dSrdrres rr@zStrokeWidth.condition"+rgr c dSrdrres rrzStrokeWidth.field&+rgr c dSrdrrs rrzStrokeWidth.field*+rgr cC dSrdrrsD rrzStrokeWidth.legend.+rgr c dSrdrres rrzStrokeWidth.legend2+rgr c dSrdrrs rrzStrokeWidth.scale6+rgr c dSrdrres rrzStrokeWidth.scale:+rgr c dSrdrres rrzStrokeWidth.sort>+rgr c dSrdrres rrzStrokeWidth.sortB+rgr c dSrdrres rrzStrokeWidth.sortF+rgr c dSrdrres rrzStrokeWidth.sortJ+rgr rc dSrdrres rrzStrokeWidth.sortN+rgr rc dSrdrres rrzStrokeWidth.sortR+rgr rc dSrdrres rrzStrokeWidth.sortV+rgr c dSrdrrs rrzStrokeWidth.sortZ+rgr c dSrdrrs rrzStrokeWidth.sort^+rgr c dSrdrres rrzStrokeWidth.sortb+rgr rc dSrdrres rrzStrokeWidth.timeUnitf+rgr rc dSrdrres rrzStrokeWidth.timeUnitj+rgr r#c dSrdrres rrzStrokeWidth.timeUnitn+rgr rBc dSrdrres rrzStrokeWidth.timeUnitr+rgr c dSrdrrbs rrzStrokeWidth.timeUnitv+rgr c dSrdrres rrzStrokeWidth.titlez+rgr c dSrdrres rrzStrokeWidth.title~+rgr c dSrdrres rrzStrokeWidth.title+rgr rhc dSrdrres rr"zStrokeWidth.type+rpr c  btt|jd||||||||| | | | d | dSro)r2rrprqs rrpzStrokeWidth.__init__+rr )rbr)rKNrbrrsr<s@rrr*rr rc8eZdZdZdZdZdeddfdZee e fddZ ee e e fddZ ede e j ddfd Z ededdfd Zede eddfd Zedd ZdedddfdZe e e e ffd ZxZS)StrokeWidthDatumamStrokeWidthDatum schema wrapper Mapping(required=[]) Parameters ---------- bandPosition : float Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to ``0``, and at the middle of the band if set to ``0.5``. condition : anyOf(:class:`ConditionalValueDefnumberExprRef`, List(:class:`ConditionalValueDefnumberExprRef`)) One or more value definition(s) with `a parameter or a test predicate `__. **Note:** A field definition's ``condition`` property can only contain `conditional value definitions `__ since Vega-Lite only allows at most one encoded field per encoding channel. datum : anyOf(:class:`PrimitiveValue`, :class:`DateTime`, :class:`ExprRef`, :class:`RepeatRef`) A constant value in data domain. title : anyOf(:class:`Text`, None) A title for the field. If ``null``, the title will be removed. **Default value:** derived from the field's name and transformation function ( ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function, the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ). Otherwise, the title is simply the field name. **Notes** : 1) You can customize the default field title format by providing the `fieldTitle `__ property in the `config `__ or `fieldTitle function via the compile function's options `__. 2) If both field definition's ``title`` and axis, header, or legend ``title`` are defined, axis/header/legend title will be used. type : :class:`Type` The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also be a ``"geojson"`` type for encoding `'geoshape' `__. Vega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal scale for a field with ``bin`` or ``timeUnit``. **Default value:** 1) For a data ``field``, ``"nominal"`` is the default data type unless the field encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or ``timeUnit`` that satisfies the following criteria: * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin`` or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a quantitative scale `__. * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit`` or (2) the specified scale type is a time or utc scale * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort order `__, (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is ``order``. 2) For a constant value in data domain ( ``datum`` ): * ``"quantitative"`` if the datum is a number * ``"nominal"`` if the datum is a string * ``"temporal"`` if the datum is `a date time object `__ **Note:** * Data ``type`` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data. * Data values for a temporal field can be either a date-time string (e.g., ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a timestamp number (e.g., ``1552199579097`` ). * When using with `bin `__, the ``type`` property can be either ``"quantitative"`` (for using a linear bin scale) or `"ordinal" (for using an ordinal bin scale) `__. * When using with `timeUnit `__, the ``type`` property can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal" (for using an ordinal scale) `__. * When using with `aggregate `__, the ``type`` property refers to the post-aggregation data type. For example, we can calculate count ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct", "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``. * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have ``type`` as they must have exactly the same type as their primary channels (e.g., ``x``, ``y`` ). **See also:** `type `__ documentation. FrrKrbc dSrdrres rrozStrokeWidthDatum.bandPosition,rpr c dSrdrrs rr@zStrokeWidthDatum.condition ,rgr c dSrdrrs rr@zStrokeWidthDatum.condition ,rgr c dSrdrres rr@zStrokeWidthDatum.condition,rgr c dSrdrres rrzStrokeWidthDatum.title,rgr c dSrdrres rrzStrokeWidthDatum.title,rgr Nc dSrdrres rrzStrokeWidthDatum.title,rgr rc dSrdrres rr"zStrokeWidthDatum.type!,rpr c Ttt|jd|||||d|dSr)r2rrprs rrpzStrokeWidthDatum.__init__%,rr )rbr)rKNrbrrr<s@rrr+rr rc VeZdZdZdZdZeeeeeeeeeeeef ddZeeeeeeeefddZeeeeeeeeeeeeef ddZeeeeeeeeefddZeeefdd Zeeeefdd Zed e e j ddfd Zeffd Z xZ S)StrokeWidthValueajStrokeWidthValue schema wrapper Mapping(required=[]) Parameters ---------- condition : anyOf(:class:`ConditionalMarkPropFieldOrDatumDef`, :class:`ConditionalValueDefnumberExprRef`, List(:class:`ConditionalValueDefnumberExprRef`)) A field definition or one or more value definition(s) with a parameter predicate. value : anyOf(float, :class:`ExprRef`) A constant value in visual domain (e.g., ``"red"`` / ``"#0099ff"`` / `gradient definition `__ for color, values between ``0`` to ``1`` for opacity). Frrbc  dSrdrrs rr@zStrokeWidthValue.condition>,rgr c dSrdrrs rr@zStrokeWidthValue.conditionB,rgr c  dSrdrrs rr@zStrokeWidthValue.conditionF,rgr c  dSrdrrs rr@zStrokeWidthValue.conditionJ,rgr c dSrdrrs rr@zStrokeWidthValue.conditionN,rgr c dSrdrrs rr@zStrokeWidthValue.conditionR,rgr rKc dSrdrres rr@zStrokeWidthValue.conditionV,rgr c Ntt|jd||d|dSr)r2rrprs rrpzStrokeWidthValue.__init__[,r;r )rbrrr<s@rrr+,rr rc eZdZdZdZdZededddfdZee fd'dZee fd'd Zde ddfd Z ede ddfd Z ee e e e e e e e e e f d'd Z ededdfd Z ed(dZ ee e fd'dZee e e fd'dZedeejddfdZededdfdZee fd'dZededdfdZededdfdZdeddfdZededddfdZededddfdZededddfdZededddfdZee e e e fd'd Zededdfd!Zedeeddfd"Zed(d#Zded$ddfd%Ze e e e e e e e e e e f fd& ZxZS))Texta)Text schema wrapper Mapping(required=[shorthand]) Parameters ---------- shorthand : string shorthand for field, aggregate, and type aggregate : :class:`Aggregate` Aggregation function for the field (e.g., ``"mean"``, ``"sum"``, ``"median"``, ``"min"``, ``"max"``, ``"count"`` ). **Default value:** ``undefined`` (None) **See also:** `aggregate `__ documentation. bandPosition : float Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to ``0``, and at the middle of the band if set to ``0.5``. bin : anyOf(boolean, :class:`BinParams`, string, None) A flag for binning a ``quantitative`` field, `an object defining binning parameters `__, or indicating that the data for ``x`` or ``y`` channel are binned before they are imported into Vega-Lite ( ``"binned"`` ). If ``true``, default `binning parameters `__ will be applied. If ``"binned"``, this indicates that the data for the ``x`` (or ``y`` ) channel are already binned. You can map the bin-start field to ``x`` (or ``y`` ) and the bin-end field to ``x2`` (or ``y2`` ). The scale and axis will be formatted similar to binning in Vega-Lite. To adjust the axis ticks based on the bin step, you can also set the axis's `tickMinStep `__ property. **Default value:** ``false`` **See also:** `bin `__ documentation. condition : anyOf(:class:`ConditionalValueDefTextExprRef`, List(:class:`ConditionalValueDefTextExprRef`)) One or more value definition(s) with `a parameter or a test predicate `__. **Note:** A field definition's ``condition`` property can only contain `conditional value definitions `__ since Vega-Lite only allows at most one encoded field per encoding channel. field : :class:`Field` **Required.** A string defining the name of the field from which to pull a data value or an object defining iterated values from the `repeat `__ operator. **See also:** `field `__ documentation. **Notes:** 1) Dots ( ``.`` ) and brackets ( ``[`` and ``]`` ) can be used to access nested objects (e.g., ``"field": "foo.bar"`` and ``"field": "foo['bar']"`` ). If field names contain dots or brackets but are not nested, you can use ``\`` to escape dots and brackets (e.g., ``"a\.b"`` and ``"a\[0\]"`` ). See more details about escaping in the `field documentation `__. 2) ``field`` is not required if ``aggregate`` is ``count``. format : anyOf(string, :class:`Dict`) When used with the default ``"number"`` and ``"time"`` format type, the text formatting pattern for labels of guides (axes, legends, headers) and text marks. * If the format type is ``"number"`` (e.g., for quantitative fields), this is D3's `number format pattern `__. * If the format type is ``"time"`` (e.g., for temporal fields), this is D3's `time format pattern `__. See the `format documentation `__ for more examples. When used with a `custom formatType `__, this value will be passed as ``format`` alongside ``datum.value`` to the registered function. **Default value:** Derived from `numberFormat `__ config for number format and from `timeFormat `__ config for time format. formatType : string The format type for labels. One of ``"number"``, ``"time"``, or a `registered custom format type `__. **Default value:** * ``"time"`` for temporal fields and ordinal and nominal fields with ``timeUnit``. * ``"number"`` for quantitative fields as well as ordinal and nominal fields without ``timeUnit``. timeUnit : anyOf(:class:`TimeUnit`, :class:`TimeUnitParams`) Time unit (e.g., ``year``, ``yearmonth``, ``month``, ``hours`` ) for a temporal field. or `a temporal field that gets casted as ordinal `__. **Default value:** ``undefined`` (None) **See also:** `timeUnit `__ documentation. title : anyOf(:class:`Text`, None) A title for the field. If ``null``, the title will be removed. **Default value:** derived from the field's name and transformation function ( ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function, the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ). Otherwise, the title is simply the field name. **Notes** : 1) You can customize the default field title format by providing the `fieldTitle `__ property in the `config `__ or `fieldTitle function via the compile function's options `__. 2) If both field definition's ``title`` and axis, header, or legend ``title`` are defined, axis/header/legend title will be used. type : :class:`StandardType` The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also be a ``"geojson"`` type for encoding `'geoshape' `__. Vega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal scale for a field with ``bin`` or ``timeUnit``. **Default value:** 1) For a data ``field``, ``"nominal"`` is the default data type unless the field encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or ``timeUnit`` that satisfies the following criteria: * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin`` or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a quantitative scale `__. * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit`` or (2) the specified scale type is a time or utc scale * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort order `__, (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is ``order``. 2) For a constant value in data domain ( ``datum`` ): * ``"quantitative"`` if the datum is a number * ``"nominal"`` if the datum is a string * ``"temporal"`` if the datum is `a date time object `__ **Note:** * Data ``type`` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data. * Data values for a temporal field can be either a date-time string (e.g., ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a timestamp number (e.g., ``1552199579097`` ). * When using with `bin `__, the ``type`` property can be either ``"quantitative"`` (for using a linear bin scale) or `"ordinal" (for using an ordinal bin scale) `__. * When using with `timeUnit `__, the ``type`` property can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal" (for using an ordinal scale) `__. * When using with `aggregate `__, the ``type`` property refers to the post-aggregation data type. For example, we can calculate count ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct", "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``. * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have ``type`` as they must have exactly the same type as their primary channels (e.g., ``x``, ``y`` ). **See also:** `type `__ documentation. FrrKrLrbc dSrdrres rrfzText.aggregate)-rgr c dSrdrris rrfzText.aggregate--rgr c dSrdrrls rrfzText.aggregate1-rgr c dSrdrres rrozText.bandPosition5-rpr c dSrdrres rrrzText.bin8-rgr c  dSrdrrts rrrzText.bin<-rgr c dSrdrres rrrzText.bin@-rgr Nc dSrdrres rrrzText.binD-rgr c dSrdrrs rr@zText.conditionH-rgr c dSrdrrs rr@zText.conditionL-rgr c dSrdrres rr@zText.conditionP-rgr c dSrdrres rrz Text.fieldT-rgr c dSrdrrs rrz Text.fieldX-rgr c dSrdrres rr&z Text.format\-rgr c dSrdrres rr&z Text.format`-rgr c dSrdrres rrzText.formatTyped-rpr rc dSrdrres rrz Text.timeUnitg-rgr rc dSrdrres rrz Text.timeUnitk-rgr r#c dSrdrres rrz Text.timeUnito-rgr rBc dSrdrres rrz Text.timeUnits-rgr c dSrdrrbs rrz Text.timeUnitw-rgr c dSrdrres rrz Text.title{-rgr c dSrdrres rrz Text.title-rgr c dSrdrres rrz Text.title-rgr rhc dSrdrres rr"z Text.type-rpr c  `tt|jd||||||||| | | d | dSr,)r2rrpr-s rrpz Text.__init__-rr )rbr)rKNrbr)r'r9r:rtrurvrr rfrrwrorxrrr.r@r rConditionalValueDefTextExprRefrr&r0rrrr"rpr;r<s@rrr_,s#DDJ(-$N  7$bc pv   X (    X (    X  e      T f   X "9Y_hr{FOV_fow@    X  S V   X    X &i    X 'y     X  4 CD QW   X  s v   X $    X      X      X  C F     '#PQ ^d   X  '#qr E   X  '#x y  F L    X  '#O P  ] c    X (yyi    X  s v   X  tCy V   X    X  gNO \b    "+ii]f$IiT]#99++++++++++r rceZdZdZdZdZdeddfdZee e fddZ ee e e fddZ ede e j ddfd Z ededdfd Zededdfd Zdeddfd Zededdfd Zede eddfdZeddZdedddfdZe e e e e e ffd ZxZS) TextDatumaTextDatum schema wrapper Mapping(required=[]) Parameters ---------- bandPosition : float Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to ``0``, and at the middle of the band if set to ``0.5``. condition : anyOf(:class:`ConditionalValueDefTextExprRef`, List(:class:`ConditionalValueDefTextExprRef`)) One or more value definition(s) with `a parameter or a test predicate `__. **Note:** A field definition's ``condition`` property can only contain `conditional value definitions `__ since Vega-Lite only allows at most one encoded field per encoding channel. datum : anyOf(:class:`PrimitiveValue`, :class:`DateTime`, :class:`ExprRef`, :class:`RepeatRef`) A constant value in data domain. format : anyOf(string, :class:`Dict`) When used with the default ``"number"`` and ``"time"`` format type, the text formatting pattern for labels of guides (axes, legends, headers) and text marks. * If the format type is ``"number"`` (e.g., for quantitative fields), this is D3's `number format pattern `__. * If the format type is ``"time"`` (e.g., for temporal fields), this is D3's `time format pattern `__. See the `format documentation `__ for more examples. When used with a `custom formatType `__, this value will be passed as ``format`` alongside ``datum.value`` to the registered function. **Default value:** Derived from `numberFormat `__ config for number format and from `timeFormat `__ config for time format. formatType : string The format type for labels. One of ``"number"``, ``"time"``, or a `registered custom format type `__. **Default value:** * ``"time"`` for temporal fields and ordinal and nominal fields with ``timeUnit``. * ``"number"`` for quantitative fields as well as ordinal and nominal fields without ``timeUnit``. title : anyOf(:class:`Text`, None) A title for the field. If ``null``, the title will be removed. **Default value:** derived from the field's name and transformation function ( ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function, the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ). Otherwise, the title is simply the field name. **Notes** : 1) You can customize the default field title format by providing the `fieldTitle `__ property in the `config `__ or `fieldTitle function via the compile function's options `__. 2) If both field definition's ``title`` and axis, header, or legend ``title`` are defined, axis/header/legend title will be used. type : :class:`Type` The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also be a ``"geojson"`` type for encoding `'geoshape' `__. Vega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal scale for a field with ``bin`` or ``timeUnit``. **Default value:** 1) For a data ``field``, ``"nominal"`` is the default data type unless the field encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or ``timeUnit`` that satisfies the following criteria: * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin`` or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a quantitative scale `__. * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit`` or (2) the specified scale type is a time or utc scale * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort order `__, (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is ``order``. 2) For a constant value in data domain ( ``datum`` ): * ``"quantitative"`` if the datum is a number * ``"nominal"`` if the datum is a string * ``"temporal"`` if the datum is `a date time object `__ **Note:** * Data ``type`` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data. * Data values for a temporal field can be either a date-time string (e.g., ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a timestamp number (e.g., ``1552199579097`` ). * When using with `bin `__, the ``type`` property can be either ``"quantitative"`` (for using a linear bin scale) or `"ordinal" (for using an ordinal bin scale) `__. * When using with `timeUnit `__, the ``type`` property can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal" (for using an ordinal scale) `__. * When using with `aggregate `__, the ``type`` property refers to the post-aggregation data type. For example, we can calculate count ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct", "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``. * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have ``type`` as they must have exactly the same type as their primary channels (e.g., ``x``, ``y`` ). **See also:** `type `__ documentation. FrrKrbc dSrdrres rrozTextDatum.bandPosition).rpr c dSrdrrs rr@zTextDatum.condition,.rgr c dSrdrrs rr@zTextDatum.condition0.rgr c dSrdrres rr@zTextDatum.condition4.rgr c dSrdrres rr&zTextDatum.format8.rgr c dSrdrres rr&zTextDatum.format<.rgr c dSrdrres rrzTextDatum.formatType@.rpr c dSrdrres rrzTextDatum.titleC.rgr c dSrdrres rrzTextDatum.titleG.rgr Nc dSrdrres rrzTextDatum.titleK.rgr rc dSrdrres rr"zTextDatum.typeO.rpr c Xtt|jd|||||||d|dS)N)rGror@r&rrr"r)r2r!rp) rrGror@r&rrr"rrs rrpzTextDatum.__init__S.sR'i' 0e,Zc/5*TY`d 0 0*. 0 0 0 0 0r )rbr!)rKNrbr!)r'r9r:rtrurvrwrorrr@r rrr.r&r0rrr r"rpr;r<s@rr!r!-s>OO`(-$N e     &i    X 'y     X  4 CD Q\   X      X      X  C K     s {   X  tCy [   X    X  gYZ gr    ,5 R[%YY0000000000r r!c eZdZdZdZdZeeeeeeeeeeef d dZeeeeeeeeeeeef d dZeeefd dZeeeefd dZed e e j ddfd Zeffd Z xZ S) TextValuea^TextValue schema wrapper Mapping(required=[]) Parameters ---------- condition : anyOf(:class:`ConditionalStringFieldDef`, :class:`ConditionalValueDefTextExprRef`, List(:class:`ConditionalValueDefTextExprRef`)) A field definition or one or more value definition(s) with a parameter predicate. value : anyOf(:class:`Text`, :class:`ExprRef`) A constant value in visual domain (e.g., ``"red"`` / ``"#0099ff"`` / `gradient definition `__ for color, values between ``0`` to ``1`` for opacity). Frrbc  dSrdr) rrfrorrrr&rrrrr"rs rr@zTextValue.conditionm.rgr c  dSrdr) rrfrorrrrr&rrrrr"rs rr@zTextValue.conditionq.rgr c dSrdrrs rr@zTextValue.conditionu.rgr c dSrdrrs rr@zTextValue.conditiony.rgr rKc dSrdrres rr@zTextValue.condition}.rgr c Ntt|jd||d|dSr)r2r/rprs rrpzTextValue.__init__.rr )rbr/)r'r9r:rtrurvrrr@r rrrpr;r<s@rr/r/Z.s  (-$N "+)ZcluCLS\gpxAHQ    X "+)Zckt~GT]enyBJSZc    X &i    X 'y     X  4 CD Q\   X )2RRRRRRRRRRr r/c"eZdZdZdZdZededddfdZee fd4dZee fd4d Zde ddfd Z ede ddfd Z ee e e e e e e e e e f d4d Z ededdfd Z ed5dZ ededdfdZee fd4dZee e e e e e e e e e e e e e e e e e e e e e e fd4dZed5dZedee ddfdZedeeddfdZedee ddfdZedeejddfdZededddfdZededddfdZededddfdZee e e fd4dZee e fd4dZed5d Zeded!ddfd"Zed5d#Zede ddfd$Zeded%ddfd&Zeded'ddfd(Zeded)ddfd*Zeded+ddfd,Zee e e e fd4d-Zededdfd.Zedeeddfd/Zed5d0Zded1ddfd2Ze e e e e e e e e e e f fd3 ZxZS)6Thetaa2Theta schema wrapper Mapping(required=[shorthand]) Parameters ---------- shorthand : string shorthand for field, aggregate, and type aggregate : :class:`Aggregate` Aggregation function for the field (e.g., ``"mean"``, ``"sum"``, ``"median"``, ``"min"``, ``"max"``, ``"count"`` ). **Default value:** ``undefined`` (None) **See also:** `aggregate `__ documentation. bandPosition : float Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to ``0``, and at the middle of the band if set to ``0.5``. bin : anyOf(boolean, :class:`BinParams`, string, None) A flag for binning a ``quantitative`` field, `an object defining binning parameters `__, or indicating that the data for ``x`` or ``y`` channel are binned before they are imported into Vega-Lite ( ``"binned"`` ). If ``true``, default `binning parameters `__ will be applied. If ``"binned"``, this indicates that the data for the ``x`` (or ``y`` ) channel are already binned. You can map the bin-start field to ``x`` (or ``y`` ) and the bin-end field to ``x2`` (or ``y2`` ). The scale and axis will be formatted similar to binning in Vega-Lite. To adjust the axis ticks based on the bin step, you can also set the axis's `tickMinStep `__ property. **Default value:** ``false`` **See also:** `bin `__ documentation. field : :class:`Field` **Required.** A string defining the name of the field from which to pull a data value or an object defining iterated values from the `repeat `__ operator. **See also:** `field `__ documentation. **Notes:** 1) Dots ( ``.`` ) and brackets ( ``[`` and ``]`` ) can be used to access nested objects (e.g., ``"field": "foo.bar"`` and ``"field": "foo['bar']"`` ). If field names contain dots or brackets but are not nested, you can use ``\`` to escape dots and brackets (e.g., ``"a\.b"`` and ``"a\[0\]"`` ). See more details about escaping in the `field documentation `__. 2) ``field`` is not required if ``aggregate`` is ``count``. scale : anyOf(:class:`Scale`, None) An object defining properties of the channel's scale, which is the function that transforms values in the data domain (numbers, dates, strings, etc) to visual values (pixels, colors, sizes) of the encoding channels. If ``null``, the scale will be `disabled and the data value will be directly encoded `__. **Default value:** If undefined, default `scale properties `__ are applied. **See also:** `scale `__ documentation. sort : :class:`Sort` Sort order for the encoded field. For continuous fields (quantitative or temporal), ``sort`` can be either ``"ascending"`` or ``"descending"``. For discrete fields, ``sort`` can be one of the following: * ``"ascending"`` or ``"descending"`` -- for sorting by the values' natural order in JavaScript. * `A string indicating an encoding channel name to sort by `__ (e.g., ``"x"`` or ``"y"`` ) with an optional minus prefix for descending sort (e.g., ``"-x"`` to sort by x-field, descending). This channel string is short-form of `a sort-by-encoding definition `__. For example, ``"sort": "-x"`` is equivalent to ``"sort": {"encoding": "x", "order": "descending"}``. * `A sort field definition `__ for sorting by another field. * `An array specifying the field values in preferred order `__. In this case, the sort order will obey the values in the array, followed by any unspecified values in their original order. For discrete time field, values in the sort array can be `date-time definition objects `__. In addition, for time units ``"month"`` and ``"day"``, the values can be the month or day names (case insensitive) or their 3-letter initials (e.g., ``"Mon"``, ``"Tue"`` ). * ``null`` indicating no sort. **Default value:** ``"ascending"`` **Note:** ``null`` and sorting by another channel is not supported for ``row`` and ``column``. **See also:** `sort `__ documentation. stack : anyOf(:class:`StackOffset`, None, boolean) Type of stacking offset if the field should be stacked. ``stack`` is only applicable for ``x``, ``y``, ``theta``, and ``radius`` channels with continuous domains. For example, ``stack`` of ``y`` can be used to customize stacking for a vertical bar chart. ``stack`` can be one of the following values: * ``"zero"`` or `true`: stacking with baseline offset at zero value of the scale (for creating typical stacked [bar](https://vega.github.io/vega-lite/docs/stack.html#bar) and `area `__ chart). * ``"normalize"`` - stacking with normalized domain (for creating `normalized stacked bar and area charts `__ and pie charts `with percentage tooltip `__ ). :raw-html:`
` * ``"center"`` - stacking with center baseline (for `streamgraph `__ ). * ``null`` or ``false`` - No-stacking. This will produce layered `bar `__ and area chart. **Default value:** ``zero`` for plots with all of the following conditions are true: (1) the mark is ``bar``, ``area``, or ``arc`` ; (2) the stacked measure channel (x or y) has a linear scale; (3) At least one of non-position channels mapped to an unaggregated field that is different from x and y. Otherwise, ``null`` by default. **See also:** `stack `__ documentation. timeUnit : anyOf(:class:`TimeUnit`, :class:`TimeUnitParams`) Time unit (e.g., ``year``, ``yearmonth``, ``month``, ``hours`` ) for a temporal field. or `a temporal field that gets casted as ordinal `__. **Default value:** ``undefined`` (None) **See also:** `timeUnit `__ documentation. title : anyOf(:class:`Text`, None) A title for the field. If ``null``, the title will be removed. **Default value:** derived from the field's name and transformation function ( ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function, the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ). Otherwise, the title is simply the field name. **Notes** : 1) You can customize the default field title format by providing the `fieldTitle `__ property in the `config `__ or `fieldTitle function via the compile function's options `__. 2) If both field definition's ``title`` and axis, header, or legend ``title`` are defined, axis/header/legend title will be used. type : :class:`StandardType` The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also be a ``"geojson"`` type for encoding `'geoshape' `__. Vega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal scale for a field with ``bin`` or ``timeUnit``. **Default value:** 1) For a data ``field``, ``"nominal"`` is the default data type unless the field encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or ``timeUnit`` that satisfies the following criteria: * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin`` or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a quantitative scale `__. * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit`` or (2) the specified scale type is a time or utc scale * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort order `__, (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is ``order``. 2) For a constant value in data domain ( ``datum`` ): * ``"quantitative"`` if the datum is a number * ``"nominal"`` if the datum is a string * ``"temporal"`` if the datum is `a date time object `__ **Note:** * Data ``type`` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data. * Data values for a temporal field can be either a date-time string (e.g., ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a timestamp number (e.g., ``1552199579097`` ). * When using with `bin `__, the ``type`` property can be either ``"quantitative"`` (for using a linear bin scale) or `"ordinal" (for using an ordinal bin scale) `__. * When using with `timeUnit `__, the ``type`` property can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal" (for using an ordinal scale) `__. * When using with `aggregate `__, the ``type`` property refers to the post-aggregation data type. For example, we can calculate count ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct", "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``. * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have ``type`` as they must have exactly the same type as their primary channels (e.g., ``x``, ``y`` ). **See also:** `type `__ documentation. FthetarKrLrbc dSrdrres rrfzTheta.aggregatez/rgr c dSrdrris rrfzTheta.aggregate~/rgr c dSrdrrls rrfzTheta.aggregate/rgr c dSrdrres rrozTheta.bandPosition/rpr c dSrdrres rrrz Theta.bin/rgr c  dSrdrrts rrrz Theta.bin/rgr c dSrdrres rrrz Theta.bin/rgr Nc dSrdrres rrrz Theta.bin/rgr c dSrdrres rrz Theta.field/rgr c dSrdrrs rrz Theta.field/rgr c dSrdrrs rrz Theta.scale/rgr c dSrdrres rrz Theta.scale/rgr c dSrdrres rrz Theta.sort/rgr c dSrdrres rrz Theta.sort/rgr c dSrdrres rrz Theta.sort/rgr c dSrdrres rrz Theta.sort/rgr rc dSrdrres rrz Theta.sort/rgr rc dSrdrres rrz Theta.sort/rgr rc dSrdrres rrz Theta.sort/rgr c dSrdrrs rrz Theta.sort/rgr c dSrdrrs rrz Theta.sort/rgr c dSrdrres rrz Theta.sort/rgr r4c dSrdrres rr7z Theta.stack/rgr c dSrdrres rr7z Theta.stack/rgr c dSrdrres rr7z Theta.stack/rgr rc dSrdrres rrzTheta.timeUnit/rgr rc dSrdrres rrzTheta.timeUnit/rgr r#c dSrdrres rrzTheta.timeUnit/rgr rBc dSrdrres rrzTheta.timeUnit/rgr c dSrdrrbs rrzTheta.timeUnit/rgr c dSrdrres rrz Theta.title/rgr c dSrdrres rrz Theta.title/rgr c dSrdrres rrz Theta.title/rgr rhc dSrdrres rr"z Theta.type/rpr c  `tt|jd||||||||| | | d | dSrD)r2r7rprEs rrpzTheta.__init__0sd $eT# Wi9[g(+5DX]-5U W WQU W W W W Wr )rbr7)rKNrbr7rFr<s@rr7r7.sbnn^(-$N  7$bc pw   X (    X (    X  e      T g   X "9Y_hr{FOV_fow@    X  S W   X    X  s w   X $    X #))9_hqzGP\eqzEN\eluHW`ox@IT]hq{DLU^gnw~G    X    X  d5k g   X  d3i G   X  d4j W   X  d4=) g   X  g78 W   X  gUV cj   X  gab ov   X "y     X %Y    X    X  w<= '   X    X  t    X  '#PQ ^e   X  '#qr F   X  '#x y  F M    X  '#O P  ] d    X (yyi    X  s w   X  tCy W   X    X  gNO \c    "+ii]f ]f yWWWWWWWWWWr r7ceZdZdZdZdZdeddfdZee e e e e e e e e e e e e e e e e e e e e e e fddZ edd Z ede d ddfd Z edd Z ede ddfd Z ededdfdZedeeddfdZeddZde dddfdZe e e e e ffd ZxZS) ThetaDatuma; ThetaDatum schema wrapper Mapping(required=[]) Parameters ---------- bandPosition : float Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to ``0``, and at the middle of the band if set to ``0.5``. datum : anyOf(:class:`PrimitiveValue`, :class:`DateTime`, :class:`ExprRef`, :class:`RepeatRef`) A constant value in data domain. scale : anyOf(:class:`Scale`, None) An object defining properties of the channel's scale, which is the function that transforms values in the data domain (numbers, dates, strings, etc) to visual values (pixels, colors, sizes) of the encoding channels. If ``null``, the scale will be `disabled and the data value will be directly encoded `__. **Default value:** If undefined, default `scale properties `__ are applied. **See also:** `scale `__ documentation. stack : anyOf(:class:`StackOffset`, None, boolean) Type of stacking offset if the field should be stacked. ``stack`` is only applicable for ``x``, ``y``, ``theta``, and ``radius`` channels with continuous domains. For example, ``stack`` of ``y`` can be used to customize stacking for a vertical bar chart. ``stack`` can be one of the following values: * ``"zero"`` or `true`: stacking with baseline offset at zero value of the scale (for creating typical stacked [bar](https://vega.github.io/vega-lite/docs/stack.html#bar) and `area `__ chart). * ``"normalize"`` - stacking with normalized domain (for creating `normalized stacked bar and area charts `__ and pie charts `with percentage tooltip `__ ). :raw-html:`
` * ``"center"`` - stacking with center baseline (for `streamgraph `__ ). * ``null`` or ``false`` - No-stacking. This will produce layered `bar `__ and area chart. **Default value:** ``zero`` for plots with all of the following conditions are true: (1) the mark is ``bar``, ``area``, or ``arc`` ; (2) the stacked measure channel (x or y) has a linear scale; (3) At least one of non-position channels mapped to an unaggregated field that is different from x and y. Otherwise, ``null`` by default. **See also:** `stack `__ documentation. title : anyOf(:class:`Text`, None) A title for the field. If ``null``, the title will be removed. **Default value:** derived from the field's name and transformation function ( ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function, the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ). Otherwise, the title is simply the field name. **Notes** : 1) You can customize the default field title format by providing the `fieldTitle `__ property in the `config `__ or `fieldTitle function via the compile function's options `__. 2) If both field definition's ``title`` and axis, header, or legend ``title`` are defined, axis/header/legend title will be used. type : :class:`Type` The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also be a ``"geojson"`` type for encoding `'geoshape' `__. Vega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal scale for a field with ``bin`` or ``timeUnit``. **Default value:** 1) For a data ``field``, ``"nominal"`` is the default data type unless the field encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or ``timeUnit`` that satisfies the following criteria: * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin`` or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a quantitative scale `__. * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit`` or (2) the specified scale type is a time or utc scale * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort order `__, (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is ``order``. 2) For a constant value in data domain ( ``datum`` ): * ``"quantitative"`` if the datum is a number * ``"nominal"`` if the datum is a string * ``"temporal"`` if the datum is `a date time object `__ **Note:** * Data ``type`` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data. * Data values for a temporal field can be either a date-time string (e.g., ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a timestamp number (e.g., ``1552199579097`` ). * When using with `bin `__, the ``type`` property can be either ``"quantitative"`` (for using a linear bin scale) or `"ordinal" (for using an ordinal bin scale) `__. * When using with `timeUnit `__, the ``type`` property can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal" (for using an ordinal scale) `__. * When using with `aggregate `__, the ``type`` property refers to the post-aggregation data type. For example, we can calculate count ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct", "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``. * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have ``type`` as they must have exactly the same type as their primary channels (e.g., ``x``, ``y`` ). **See also:** `type `__ documentation. Fr8rKrbc dSrdrres rrozThetaDatum.bandPosition0rpr c dSrdrrs rrzThetaDatum.scale0rgr Nc dSrdrres rrzThetaDatum.scale0rgr r4c dSrdrres rr7zThetaDatum.stack0rgr c dSrdrres rr7zThetaDatum.stack0rgr c dSrdrres rr7zThetaDatum.stack0rgr c dSrdrres rrzThetaDatum.title0rgr c dSrdrres rrzThetaDatum.title0rgr c dSrdrres rrzThetaDatum.title0rgr rc dSrdrres rr"zThetaDatum.type0rpr c Vtt|jd||||||d|dSrT)r2r]rprUs rrpzThetaDatum.__init__0sV(j$( Vu`__ for color, values between ``0`` to ``1`` for opacity). Fr8c Ltt|jdd|i|dSr)r2rjrprs rrpzThetaValue.__init__0s1(j$(==u======r rr<s@rrjrj0sO  (-$N>>>>>>>>>r rjc(eZdZdZdZdZededddfdZee fddZee fdd Zde ddfd Z dd Z ede ddfd Zee fddZededddfdZededddfdZededddfdZededddfdZee e e e fddZede ddfdZedee ddfdZeddZe e e e e e e ffd ZxZS)Theta2aTheta2 schema wrapper Mapping(required=[shorthand]) A field definition of a secondary channel that shares a scale with another primary channel. For example, ``x2``, ``xError`` and ``xError2`` share the same scale with ``x``. Parameters ---------- shorthand : string shorthand for field, aggregate, and type aggregate : :class:`Aggregate` Aggregation function for the field (e.g., ``"mean"``, ``"sum"``, ``"median"``, ``"min"``, ``"max"``, ``"count"`` ). **Default value:** ``undefined`` (None) **See also:** `aggregate `__ documentation. bandPosition : float Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to ``0``, and at the middle of the band if set to ``0.5``. bin : None A flag for binning a ``quantitative`` field, `an object defining binning parameters `__, or indicating that the data for ``x`` or ``y`` channel are binned before they are imported into Vega-Lite ( ``"binned"`` ). If ``true``, default `binning parameters `__ will be applied. If ``"binned"``, this indicates that the data for the ``x`` (or ``y`` ) channel are already binned. You can map the bin-start field to ``x`` (or ``y`` ) and the bin-end field to ``x2`` (or ``y2`` ). The scale and axis will be formatted similar to binning in Vega-Lite. To adjust the axis ticks based on the bin step, you can also set the axis's `tickMinStep `__ property. **Default value:** ``false`` **See also:** `bin `__ documentation. field : :class:`Field` **Required.** A string defining the name of the field from which to pull a data value or an object defining iterated values from the `repeat `__ operator. **See also:** `field `__ documentation. **Notes:** 1) Dots ( ``.`` ) and brackets ( ``[`` and ``]`` ) can be used to access nested objects (e.g., ``"field": "foo.bar"`` and ``"field": "foo['bar']"`` ). If field names contain dots or brackets but are not nested, you can use ``\`` to escape dots and brackets (e.g., ``"a\.b"`` and ``"a\[0\]"`` ). See more details about escaping in the `field documentation `__. 2) ``field`` is not required if ``aggregate`` is ``count``. timeUnit : anyOf(:class:`TimeUnit`, :class:`TimeUnitParams`) Time unit (e.g., ``year``, ``yearmonth``, ``month``, ``hours`` ) for a temporal field. or `a temporal field that gets casted as ordinal `__. **Default value:** ``undefined`` (None) **See also:** `timeUnit `__ documentation. title : anyOf(:class:`Text`, None) A title for the field. If ``null``, the title will be removed. **Default value:** derived from the field's name and transformation function ( ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function, the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ). Otherwise, the title is simply the field name. **Notes** : 1) You can customize the default field title format by providing the `fieldTitle `__ property in the `config `__ or `fieldTitle function via the compile function's options `__. 2) If both field definition's ``title`` and axis, header, or legend ``title`` are defined, axis/header/legend title will be used. Ftheta2rKrLrbc dSrdrres rrfzTheta2.aggregateE1rgr c dSrdrris rrfzTheta2.aggregateI1rgr c dSrdrrls rrfzTheta2.aggregateM1rgr c dSrdrres rrozTheta2.bandPositionQ1rpr Nc dSrdrres rrrz Theta2.binT1rpr c dSrdrres rrz Theta2.fieldW1rgr c dSrdrrs rrz Theta2.field[1rgr rc dSrdrres rrzTheta2.timeUnit_1rgr rc dSrdrres rrzTheta2.timeUnitc1rgr r#c dSrdrres rrzTheta2.timeUnitg1rgr rBc dSrdrres rrzTheta2.timeUnitk1rgr c dSrdrrbs rrzTheta2.timeUnito1rgr c dSrdrres rrz Theta2.titles1rgr c dSrdrres rrz Theta2.titlew1rgr c dSrdrres rrz Theta2.title{1rgr c Xtt|jd|||||||d|dSrt)r2rmrprus rrpzTheta2.__init__1Q$fd$ :yI2>Cu_g+0 : :48 : : : : :r )rbrm)rKNrbrmrvr<s@rrmrm0-XXr(-$N  7$bc px   X (    X (    X  e          s x   X $    X  '#PQ ^f   X  '#qr G   X  '#x y  F N    X  '#O P  ] e    X (yyi    X  s x   X  tCy X   X    X "+ii]f 9I::::::::::r rmceZdZdZdZdZdeddfdZede ddfdZ ede e ddfdZ edd Z de d ddfd Z eeeffd ZxZS) Theta2DatumaZTheta2Datum schema wrapper Mapping(required=[]) Parameters ---------- bandPosition : float Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to ``0``, and at the middle of the band if set to ``0.5``. datum : anyOf(:class:`PrimitiveValue`, :class:`DateTime`, :class:`ExprRef`, :class:`RepeatRef`) A constant value in data domain. title : anyOf(:class:`Text`, None) A title for the field. If ``null``, the title will be removed. **Default value:** derived from the field's name and transformation function ( ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function, the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ). Otherwise, the title is simply the field name. **Notes** : 1) You can customize the default field title format by providing the `fieldTitle `__ property in the `config `__ or `fieldTitle function via the compile function's options `__. 2) If both field definition's ``title`` and axis, header, or legend ``title`` are defined, axis/header/legend title will be used. type : :class:`Type` The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also be a ``"geojson"`` type for encoding `'geoshape' `__. Vega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal scale for a field with ``bin`` or ``timeUnit``. **Default value:** 1) For a data ``field``, ``"nominal"`` is the default data type unless the field encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or ``timeUnit`` that satisfies the following criteria: * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin`` or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a quantitative scale `__. * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit`` or (2) the specified scale type is a time or utc scale * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort order `__, (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is ``order``. 2) For a constant value in data domain ( ``datum`` ): * ``"quantitative"`` if the datum is a number * ``"nominal"`` if the datum is a string * ``"temporal"`` if the datum is `a date time object `__ **Note:** * Data ``type`` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data. * Data values for a temporal field can be either a date-time string (e.g., ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a timestamp number (e.g., ``1552199579097`` ). * When using with `bin `__, the ``type`` property can be either ``"quantitative"`` (for using a linear bin scale) or `"ordinal" (for using an ordinal bin scale) `__. * When using with `timeUnit `__, the ``type`` property can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal" (for using an ordinal scale) `__. * When using with `aggregate `__, the ``type`` property refers to the post-aggregation data type. For example, we can calculate count ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct", "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``. * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have ``type`` as they must have exactly the same type as their primary channels (e.g., ``x``, ``y`` ). **See also:** `type `__ documentation. FrnrKrbc dSrdrres rrozTheta2Datum.bandPosition1rpr c dSrdrres rrzTheta2Datum.title1rgr c dSrdrres rrzTheta2Datum.title1rgr Nc dSrdrres rrzTheta2Datum.title1rgr rc dSrdrres rr"zTheta2Datum.type2rpr c Rtt|jd||||d|dSr^)r2rrpr_s rrpzTheta2Datum.__init__2sJ)k4  ) =LX]/3 = =7; = = = = =r )rKNrbrr`r<s@rrr1s+ffN(-$N e      s }   X  tCy ]   X    X  gYZ gt    ,5II==========r rc*eZdZdZdZdZfdZxZS) Theta2ValueaTheta2Value schema wrapper Mapping(required=[value]) Definition object for a constant value (primitive value or gradient definition) of an encoding channel. Parameters ---------- value : anyOf(float, string, string, :class:`ExprRef`) A constant value in visual domain (e.g., ``"red"`` / ``"#0099ff"`` / `gradient definition `__ for color, values between ``0`` to ``1`` for opacity). Frnc Ltt|jdd|i|dSr)r2rrprs rrpzTheta2Value.__init__ 2rZr rr<s@rrr 2r[r rc eZdZdZdZdZededddfdZee fd'dZee fd'd Zde ddfd Z ede ddfd Z ee e e e e e e e e e f d'd Z ededdfd Z ed(dZ ee e fd'dZee e e fd'dZedeejddfdZededdfdZee fd'dZededdfdZededdfdZdeddfdZededddfdZededddfdZededddfdZededddfdZee e e e fd'd Zededdfd!Zedeeddfd"Zed(d#Zded$ddfd%Ze e e e e e e e e e e f fd& ZxZS))Tooltipa)Tooltip schema wrapper Mapping(required=[shorthand]) Parameters ---------- shorthand : string shorthand for field, aggregate, and type aggregate : :class:`Aggregate` Aggregation function for the field (e.g., ``"mean"``, ``"sum"``, ``"median"``, ``"min"``, ``"max"``, ``"count"`` ). **Default value:** ``undefined`` (None) **See also:** `aggregate `__ documentation. bandPosition : float Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to ``0``, and at the middle of the band if set to ``0.5``. bin : anyOf(boolean, :class:`BinParams`, string, None) A flag for binning a ``quantitative`` field, `an object defining binning parameters `__, or indicating that the data for ``x`` or ``y`` channel are binned before they are imported into Vega-Lite ( ``"binned"`` ). If ``true``, default `binning parameters `__ will be applied. If ``"binned"``, this indicates that the data for the ``x`` (or ``y`` ) channel are already binned. You can map the bin-start field to ``x`` (or ``y`` ) and the bin-end field to ``x2`` (or ``y2`` ). The scale and axis will be formatted similar to binning in Vega-Lite. To adjust the axis ticks based on the bin step, you can also set the axis's `tickMinStep `__ property. **Default value:** ``false`` **See also:** `bin `__ documentation. condition : anyOf(:class:`ConditionalValueDefstringExprRef`, List(:class:`ConditionalValueDefstringExprRef`)) One or more value definition(s) with `a parameter or a test predicate `__. **Note:** A field definition's ``condition`` property can only contain `conditional value definitions `__ since Vega-Lite only allows at most one encoded field per encoding channel. field : :class:`Field` **Required.** A string defining the name of the field from which to pull a data value or an object defining iterated values from the `repeat `__ operator. **See also:** `field `__ documentation. **Notes:** 1) Dots ( ``.`` ) and brackets ( ``[`` and ``]`` ) can be used to access nested objects (e.g., ``"field": "foo.bar"`` and ``"field": "foo['bar']"`` ). If field names contain dots or brackets but are not nested, you can use ``\`` to escape dots and brackets (e.g., ``"a\.b"`` and ``"a\[0\]"`` ). See more details about escaping in the `field documentation `__. 2) ``field`` is not required if ``aggregate`` is ``count``. format : anyOf(string, :class:`Dict`) When used with the default ``"number"`` and ``"time"`` format type, the text formatting pattern for labels of guides (axes, legends, headers) and text marks. * If the format type is ``"number"`` (e.g., for quantitative fields), this is D3's `number format pattern `__. * If the format type is ``"time"`` (e.g., for temporal fields), this is D3's `time format pattern `__. See the `format documentation `__ for more examples. When used with a `custom formatType `__, this value will be passed as ``format`` alongside ``datum.value`` to the registered function. **Default value:** Derived from `numberFormat `__ config for number format and from `timeFormat `__ config for time format. formatType : string The format type for labels. One of ``"number"``, ``"time"``, or a `registered custom format type `__. **Default value:** * ``"time"`` for temporal fields and ordinal and nominal fields with ``timeUnit``. * ``"number"`` for quantitative fields as well as ordinal and nominal fields without ``timeUnit``. timeUnit : anyOf(:class:`TimeUnit`, :class:`TimeUnitParams`) Time unit (e.g., ``year``, ``yearmonth``, ``month``, ``hours`` ) for a temporal field. or `a temporal field that gets casted as ordinal `__. **Default value:** ``undefined`` (None) **See also:** `timeUnit `__ documentation. title : anyOf(:class:`Text`, None) A title for the field. If ``null``, the title will be removed. **Default value:** derived from the field's name and transformation function ( ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function, the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ). Otherwise, the title is simply the field name. **Notes** : 1) You can customize the default field title format by providing the `fieldTitle `__ property in the `config `__ or `fieldTitle function via the compile function's options `__. 2) If both field definition's ``title`` and axis, header, or legend ``title`` are defined, axis/header/legend title will be used. type : :class:`StandardType` The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also be a ``"geojson"`` type for encoding `'geoshape' `__. Vega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal scale for a field with ``bin`` or ``timeUnit``. **Default value:** 1) For a data ``field``, ``"nominal"`` is the default data type unless the field encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or ``timeUnit`` that satisfies the following criteria: * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin`` or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a quantitative scale `__. * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit`` or (2) the specified scale type is a time or utc scale * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort order `__, (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is ``order``. 2) For a constant value in data domain ( ``datum`` ): * ``"quantitative"`` if the datum is a number * ``"nominal"`` if the datum is a string * ``"temporal"`` if the datum is `a date time object `__ **Note:** * Data ``type`` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data. * Data values for a temporal field can be either a date-time string (e.g., ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a timestamp number (e.g., ``1552199579097`` ). * When using with `bin `__, the ``type`` property can be either ``"quantitative"`` (for using a linear bin scale) or `"ordinal" (for using an ordinal bin scale) `__. * When using with `timeUnit `__, the ``type`` property can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal" (for using an ordinal scale) `__. * When using with `aggregate `__, the ``type`` property refers to the post-aggregation data type. For example, we can calculate count ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct", "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``. * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have ``type`` as they must have exactly the same type as their primary channels (e.g., ``x``, ``y`` ). **See also:** `type `__ documentation. FtooltiprKrLrbc dSrdrres rrfzTooltip.aggregate2rgr c dSrdrris rrfzTooltip.aggregate2rgr c dSrdrrls rrfzTooltip.aggregate2rgr c dSrdrres rrozTooltip.bandPosition2rpr c dSrdrres rrrz Tooltip.bin2rgr c  dSrdrrts rrrz Tooltip.bin3rgr c dSrdrres rrrz Tooltip.bin3rgr Nc dSrdrres rrrz Tooltip.bin 3rgr c dSrdrrs rr@zTooltip.condition 3rgr c dSrdrrs rr@zTooltip.condition3rgr c dSrdrres rr@zTooltip.condition3rgr c dSrdrres rrz Tooltip.field3rgr c dSrdrrs rrz Tooltip.field3rgr c dSrdrres rr&zTooltip.format!3rgr c dSrdrres rr&zTooltip.format%3rgr c dSrdrres rrzTooltip.formatType)3rpr rc dSrdrres rrzTooltip.timeUnit,3rgr rc dSrdrres rrzTooltip.timeUnit03rgr r#c dSrdrres rrzTooltip.timeUnit43rgr rBc dSrdrres rrzTooltip.timeUnit83rgr c dSrdrrbs rrzTooltip.timeUnit<3rgr c dSrdrres rrz Tooltip.title@3rgr c dSrdrres rrz Tooltip.titleD3rgr c dSrdrres rrz Tooltip.titleH3rgr rhc dSrdrres rr"z Tooltip.typeL3rpr c  `tt|jd||||||||| | | d | dSr,)r2rrpr-s rrpzTooltip.__init__P3sh &gt% Y Y3?ST],1&Z/7u4 Y YTX Y Y Y Y Yr )rbr)rKNrbrr.r<s@rrr$2s-DDJ(-$N  7$bc py   X (    X (    X  e      T i   X "9Y_hr{FOV_fow@    X  S Y   X    X &i    X 'y     X  4 EF S\   X  s y   X $    X      X      X  C I     '#PQ ^g   X  '#qr H   X  '#x y  F O    X  '#O P  ] f    X (yyi    X  s y   X  tCy Y   X    X  gNO \e    "+ii]f$IiT]#99YYYYYYYYYYr rc VeZdZdZdZdZeeeeeeeeeeeef ddZeeeeeeeefddZeeeeeeeeeeeeef ddZeeeeeeeeefddZeeefdd Zeeeefdd Zed e e j ddfd Zeffd Z xZ S) TooltipValueauTooltipValue schema wrapper Mapping(required=[]) Parameters ---------- condition : anyOf(:class:`ConditionalMarkPropFieldOrDatumDef`, :class:`ConditionalValueDefstringnullExprRef`, List(:class:`ConditionalValueDefstringnullExprRef`)) A field definition or one or more value definition(s) with a parameter predicate. value : anyOf(string, None, :class:`ExprRef`) A constant value in visual domain (e.g., ``"red"`` / ``"#0099ff"`` / `gradient definition `__ for color, values between ``0`` to ``1`` for opacity). Frrbc  dSrdrrs rr@zTooltipValue.conditionl3rgr c dSrdrrs rr@zTooltipValue.conditionp3rgr c  dSrdrrs rr@zTooltipValue.conditiont3rgr c  dSrdrrs rr@zTooltipValue.conditionx3rgr c dSrdrrs rr@zTooltipValue.condition|3rgr c dSrdrrs rr@zTooltipValue.condition3rgr rKc dSrdrres rr@zTooltipValue.condition3rgr c Ntt|jd||d|dSr)r2rrprs rrpzTooltipValue.__init__3rr )rbrr<r<s@rrrY3s4  (-$N "+)Zclu~GNW^gr{CLS\    X %.i Ybir{DKT    X "+)Zckt~GOX`ipyDMU^en    X %.iyYbjs|EMV]f    X &i    X 'y     X  4 IJ We   X )2UUUUUUUUUUr rc eZdZdZdZdZededddfdZee fd'dZee fd'd Zde ddfd Z ede ddfd Z ee e e e e e e e e e f d'd Z ededdfd Z ed(dZ ee e fd'dZee e e fd'dZedeejddfdZededdfdZee fd'dZededdfdZededdfdZdeddfdZededddfdZededddfdZededddfdZededddfdZee e e e fd'd Zededdfd!Zedeeddfd"Zed(d#Zded$ddfd%Ze e e e e e e e e e e f fd& ZxZS))Urla)Url schema wrapper Mapping(required=[shorthand]) Parameters ---------- shorthand : string shorthand for field, aggregate, and type aggregate : :class:`Aggregate` Aggregation function for the field (e.g., ``"mean"``, ``"sum"``, ``"median"``, ``"min"``, ``"max"``, ``"count"`` ). **Default value:** ``undefined`` (None) **See also:** `aggregate `__ documentation. bandPosition : float Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to ``0``, and at the middle of the band if set to ``0.5``. bin : anyOf(boolean, :class:`BinParams`, string, None) A flag for binning a ``quantitative`` field, `an object defining binning parameters `__, or indicating that the data for ``x`` or ``y`` channel are binned before they are imported into Vega-Lite ( ``"binned"`` ). If ``true``, default `binning parameters `__ will be applied. If ``"binned"``, this indicates that the data for the ``x`` (or ``y`` ) channel are already binned. You can map the bin-start field to ``x`` (or ``y`` ) and the bin-end field to ``x2`` (or ``y2`` ). The scale and axis will be formatted similar to binning in Vega-Lite. To adjust the axis ticks based on the bin step, you can also set the axis's `tickMinStep `__ property. **Default value:** ``false`` **See also:** `bin `__ documentation. condition : anyOf(:class:`ConditionalValueDefstringExprRef`, List(:class:`ConditionalValueDefstringExprRef`)) One or more value definition(s) with `a parameter or a test predicate `__. **Note:** A field definition's ``condition`` property can only contain `conditional value definitions `__ since Vega-Lite only allows at most one encoded field per encoding channel. field : :class:`Field` **Required.** A string defining the name of the field from which to pull a data value or an object defining iterated values from the `repeat `__ operator. **See also:** `field `__ documentation. **Notes:** 1) Dots ( ``.`` ) and brackets ( ``[`` and ``]`` ) can be used to access nested objects (e.g., ``"field": "foo.bar"`` and ``"field": "foo['bar']"`` ). If field names contain dots or brackets but are not nested, you can use ``\`` to escape dots and brackets (e.g., ``"a\.b"`` and ``"a\[0\]"`` ). See more details about escaping in the `field documentation `__. 2) ``field`` is not required if ``aggregate`` is ``count``. format : anyOf(string, :class:`Dict`) When used with the default ``"number"`` and ``"time"`` format type, the text formatting pattern for labels of guides (axes, legends, headers) and text marks. * If the format type is ``"number"`` (e.g., for quantitative fields), this is D3's `number format pattern `__. * If the format type is ``"time"`` (e.g., for temporal fields), this is D3's `time format pattern `__. See the `format documentation `__ for more examples. When used with a `custom formatType `__, this value will be passed as ``format`` alongside ``datum.value`` to the registered function. **Default value:** Derived from `numberFormat `__ config for number format and from `timeFormat `__ config for time format. formatType : string The format type for labels. One of ``"number"``, ``"time"``, or a `registered custom format type `__. **Default value:** * ``"time"`` for temporal fields and ordinal and nominal fields with ``timeUnit``. * ``"number"`` for quantitative fields as well as ordinal and nominal fields without ``timeUnit``. timeUnit : anyOf(:class:`TimeUnit`, :class:`TimeUnitParams`) Time unit (e.g., ``year``, ``yearmonth``, ``month``, ``hours`` ) for a temporal field. or `a temporal field that gets casted as ordinal `__. **Default value:** ``undefined`` (None) **See also:** `timeUnit `__ documentation. title : anyOf(:class:`Text`, None) A title for the field. If ``null``, the title will be removed. **Default value:** derived from the field's name and transformation function ( ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function, the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ). Otherwise, the title is simply the field name. **Notes** : 1) You can customize the default field title format by providing the `fieldTitle `__ property in the `config `__ or `fieldTitle function via the compile function's options `__. 2) If both field definition's ``title`` and axis, header, or legend ``title`` are defined, axis/header/legend title will be used. type : :class:`StandardType` The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also be a ``"geojson"`` type for encoding `'geoshape' `__. Vega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal scale for a field with ``bin`` or ``timeUnit``. **Default value:** 1) For a data ``field``, ``"nominal"`` is the default data type unless the field encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or ``timeUnit`` that satisfies the following criteria: * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin`` or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a quantitative scale `__. * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit`` or (2) the specified scale type is a time or utc scale * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort order `__, (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is ``order``. 2) For a constant value in data domain ( ``datum`` ): * ``"quantitative"`` if the datum is a number * ``"nominal"`` if the datum is a string * ``"temporal"`` if the datum is `a date time object `__ **Note:** * Data ``type`` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data. * Data values for a temporal field can be either a date-time string (e.g., ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a timestamp number (e.g., ``1552199579097`` ). * When using with `bin `__, the ``type`` property can be either ``"quantitative"`` (for using a linear bin scale) or `"ordinal" (for using an ordinal bin scale) `__. * When using with `timeUnit `__, the ``type`` property can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal" (for using an ordinal scale) `__. * When using with `aggregate `__, the ``type`` property refers to the post-aggregation data type. For example, we can calculate count ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct", "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``. * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have ``type`` as they must have exactly the same type as their primary channels (e.g., ``x``, ``y`` ). **See also:** `type `__ documentation. FurlrKrLrbc dSrdrres rrfz Url.aggregateW4rgr c dSrdrris rrfz Url.aggregate[4rgr c dSrdrrls rrfz Url.aggregate_4rgr c dSrdrres rrozUrl.bandPositionc4rpr c dSrdrres rrrzUrl.binf4rgr c  dSrdrrts rrrzUrl.binj4rgr c dSrdrres rrrzUrl.binn4rgr Nc dSrdrres rrrzUrl.binr4rgr c dSrdrrs rr@z Url.conditionv4rgr c dSrdrrs rr@z Url.conditionz4rgr c dSrdrres rr@z Url.condition~4rgr c dSrdrres rrz Url.field4rgr c dSrdrrs rrz Url.field4rgr c dSrdrres rr&z Url.format4rgr c dSrdrres rr&z Url.format4rgr c dSrdrres rrzUrl.formatType4rpr rc dSrdrres rrz Url.timeUnit4rgr rc dSrdrres rrz Url.timeUnit4rgr r#c dSrdrres rrz Url.timeUnit4rgr rBc dSrdrres rrz Url.timeUnit4rgr c dSrdrrbs rrz Url.timeUnit4rgr c dSrdrres rrz Url.title4rgr c dSrdrres rrz Url.title4rgr c dSrdrres rrz Url.title4rgr rhc dSrdrres rr"zUrl.type4rpr c  `tt|jd||||||||| | | d | dSr,)r2rrpr-s rrpz Url.__init__4s` "c4! *IYe&)YeTZ-7(RW^b * *%) * * * * *r )rbr)rKNrbrr.r<s@rrr3s#DDJ(-$N  7$bc pu   X (    X (    X  e      T e   X "9Y_hr{FOV_fow@    X  S U   X    X &i    X 'y     X  4 EF SX   X  s u   X $    X      X      X  C E     '#PQ ^c   X  '#qr D   X  '#x y  F K    X  '#O P  ] b    X (yyi    X  s u   X  tCy U   X    X  gNO \a    "+ii]f$IiT]#99**********r rc VeZdZdZdZdZeeeeeeeeeeeef ddZeeeeeeeefddZeeeeeeeeeeeeef ddZeeeeeeeeefddZeeefdd Zeeeefdd Zed e e j ddfd Zeffd Z xZ S)UrlValueaqUrlValue schema wrapper Mapping(required=[]) Parameters ---------- condition : anyOf(:class:`ConditionalMarkPropFieldOrDatumDef`, :class:`ConditionalValueDefstringnullExprRef`, List(:class:`ConditionalValueDefstringnullExprRef`)) A field definition or one or more value definition(s) with a parameter predicate. value : anyOf(string, None, :class:`ExprRef`) A constant value in visual domain (e.g., ``"red"`` / ``"#0099ff"`` / `gradient definition `__ for color, values between ``0`` to ``1`` for opacity). Frrbc  dSrdrrs rr@zUrlValue.condition4rgr c dSrdrrs rr@zUrlValue.condition4rgr c  dSrdrrs rr@zUrlValue.condition4rgr c  dSrdrrs rr@zUrlValue.condition4rgr c dSrdrrs rr@zUrlValue.condition4rgr c dSrdrrs rr@zUrlValue.condition4rgr rKc dSrdrres rr@zUrlValue.condition4rgr c Ntt|jd||d|dSr)r2rrprs rrpzUrlValue.__init__4s3&h&PUiPP4PPPPPr )rbrr<r<s@rrr4s4  (-$N "+)Zclu~GNW^gr{CLS\    X %.i Ybir{DKT    X "+)Zckt~GOX`ipyDMU^en    X %.iyYbjs|EMV]f    X &i    X 'y     X  4 IJ Wa   X )2QQQQQQQQQQr rcO.eZdZdZdZdZededddfdZee fd8dZee fd8d Zee e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e fNd8d Z ed9d Z de ddfd Z ede ddfdZee e e e e e e e e e f d8dZededdfdZed9dZededdfdZee fd8dZee e e e fd8dZed9dZee e e e e e e e e e e e e e e e e e e e e e e fd8dZed9dZedee ddfdZedeeddfdZedee ddfdZedeejddfdZededddfdZededddfdZeded ddfd!Zee e e fd8d"Zee e fd8d#Zed9d$Zeded%ddfd&Zed9d'Zede ddfd(Zeded)ddfd*Zeded+ddfd,Zeded-ddfd.Zeded/ddfd0Zee e e e fd8d1Zededdfd2Zedeeddfd3Zed9d4Zded5ddfd6Ze e e e e e e e e e e e e f fd7 ZxZS):Xap6X schema wrapper Mapping(required=[shorthand]) Parameters ---------- shorthand : string shorthand for field, aggregate, and type aggregate : :class:`Aggregate` Aggregation function for the field (e.g., ``"mean"``, ``"sum"``, ``"median"``, ``"min"``, ``"max"``, ``"count"`` ). **Default value:** ``undefined`` (None) **See also:** `aggregate `__ documentation. axis : anyOf(:class:`Axis`, None) An object defining properties of axis's gridlines, ticks and labels. If ``null``, the axis for the encoding channel will be removed. **Default value:** If undefined, default `axis properties `__ are applied. **See also:** `axis `__ documentation. bandPosition : float Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to ``0``, and at the middle of the band if set to ``0.5``. bin : anyOf(boolean, :class:`BinParams`, string, None) A flag for binning a ``quantitative`` field, `an object defining binning parameters `__, or indicating that the data for ``x`` or ``y`` channel are binned before they are imported into Vega-Lite ( ``"binned"`` ). If ``true``, default `binning parameters `__ will be applied. If ``"binned"``, this indicates that the data for the ``x`` (or ``y`` ) channel are already binned. You can map the bin-start field to ``x`` (or ``y`` ) and the bin-end field to ``x2`` (or ``y2`` ). The scale and axis will be formatted similar to binning in Vega-Lite. To adjust the axis ticks based on the bin step, you can also set the axis's `tickMinStep `__ property. **Default value:** ``false`` **See also:** `bin `__ documentation. field : :class:`Field` **Required.** A string defining the name of the field from which to pull a data value or an object defining iterated values from the `repeat `__ operator. **See also:** `field `__ documentation. **Notes:** 1) Dots ( ``.`` ) and brackets ( ``[`` and ``]`` ) can be used to access nested objects (e.g., ``"field": "foo.bar"`` and ``"field": "foo['bar']"`` ). If field names contain dots or brackets but are not nested, you can use ``\`` to escape dots and brackets (e.g., ``"a\.b"`` and ``"a\[0\]"`` ). See more details about escaping in the `field documentation `__. 2) ``field`` is not required if ``aggregate`` is ``count``. impute : anyOf(:class:`ImputeParams`, None) An object defining the properties of the Impute Operation to be applied. The field value of the other positional channel is taken as ``key`` of the ``Impute`` Operation. The field of the ``color`` channel if specified is used as ``groupby`` of the ``Impute`` Operation. **See also:** `impute `__ documentation. scale : anyOf(:class:`Scale`, None) An object defining properties of the channel's scale, which is the function that transforms values in the data domain (numbers, dates, strings, etc) to visual values (pixels, colors, sizes) of the encoding channels. If ``null``, the scale will be `disabled and the data value will be directly encoded `__. **Default value:** If undefined, default `scale properties `__ are applied. **See also:** `scale `__ documentation. sort : :class:`Sort` Sort order for the encoded field. For continuous fields (quantitative or temporal), ``sort`` can be either ``"ascending"`` or ``"descending"``. For discrete fields, ``sort`` can be one of the following: * ``"ascending"`` or ``"descending"`` -- for sorting by the values' natural order in JavaScript. * `A string indicating an encoding channel name to sort by `__ (e.g., ``"x"`` or ``"y"`` ) with an optional minus prefix for descending sort (e.g., ``"-x"`` to sort by x-field, descending). This channel string is short-form of `a sort-by-encoding definition `__. For example, ``"sort": "-x"`` is equivalent to ``"sort": {"encoding": "x", "order": "descending"}``. * `A sort field definition `__ for sorting by another field. * `An array specifying the field values in preferred order `__. In this case, the sort order will obey the values in the array, followed by any unspecified values in their original order. For discrete time field, values in the sort array can be `date-time definition objects `__. In addition, for time units ``"month"`` and ``"day"``, the values can be the month or day names (case insensitive) or their 3-letter initials (e.g., ``"Mon"``, ``"Tue"`` ). * ``null`` indicating no sort. **Default value:** ``"ascending"`` **Note:** ``null`` and sorting by another channel is not supported for ``row`` and ``column``. **See also:** `sort `__ documentation. stack : anyOf(:class:`StackOffset`, None, boolean) Type of stacking offset if the field should be stacked. ``stack`` is only applicable for ``x``, ``y``, ``theta``, and ``radius`` channels with continuous domains. For example, ``stack`` of ``y`` can be used to customize stacking for a vertical bar chart. ``stack`` can be one of the following values: * ``"zero"`` or `true`: stacking with baseline offset at zero value of the scale (for creating typical stacked [bar](https://vega.github.io/vega-lite/docs/stack.html#bar) and `area `__ chart). * ``"normalize"`` - stacking with normalized domain (for creating `normalized stacked bar and area charts `__ and pie charts `with percentage tooltip `__ ). :raw-html:`
` * ``"center"`` - stacking with center baseline (for `streamgraph `__ ). * ``null`` or ``false`` - No-stacking. This will produce layered `bar `__ and area chart. **Default value:** ``zero`` for plots with all of the following conditions are true: (1) the mark is ``bar``, ``area``, or ``arc`` ; (2) the stacked measure channel (x or y) has a linear scale; (3) At least one of non-position channels mapped to an unaggregated field that is different from x and y. Otherwise, ``null`` by default. **See also:** `stack `__ documentation. timeUnit : anyOf(:class:`TimeUnit`, :class:`TimeUnitParams`) Time unit (e.g., ``year``, ``yearmonth``, ``month``, ``hours`` ) for a temporal field. or `a temporal field that gets casted as ordinal `__. **Default value:** ``undefined`` (None) **See also:** `timeUnit `__ documentation. title : anyOf(:class:`Text`, None) A title for the field. If ``null``, the title will be removed. **Default value:** derived from the field's name and transformation function ( ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function, the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ). Otherwise, the title is simply the field name. **Notes** : 1) You can customize the default field title format by providing the `fieldTitle `__ property in the `config `__ or `fieldTitle function via the compile function's options `__. 2) If both field definition's ``title`` and axis, header, or legend ``title`` are defined, axis/header/legend title will be used. type : :class:`StandardType` The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also be a ``"geojson"`` type for encoding `'geoshape' `__. Vega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal scale for a field with ``bin`` or ``timeUnit``. **Default value:** 1) For a data ``field``, ``"nominal"`` is the default data type unless the field encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or ``timeUnit`` that satisfies the following criteria: * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin`` or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a quantitative scale `__. * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit`` or (2) the specified scale type is a time or utc scale * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort order `__, (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is ``order``. 2) For a constant value in data domain ( ``datum`` ): * ``"quantitative"`` if the datum is a number * ``"nominal"`` if the datum is a string * ``"temporal"`` if the datum is `a date time object `__ **Note:** * Data ``type`` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data. * Data values for a temporal field can be either a date-time string (e.g., ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a timestamp number (e.g., ``1552199579097`` ). * When using with `bin `__, the ``type`` property can be either ``"quantitative"`` (for using a linear bin scale) or `"ordinal" (for using an ordinal bin scale) `__. * When using with `timeUnit `__, the ``type`` property can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal" (for using an ordinal scale) `__. * When using with `aggregate `__, the ``type`` property refers to the post-aggregation data type. For example, we can calculate count ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct", "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``. * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have ``type`` as they must have exactly the same type as their primary channels (e.g., ``x``, ``y`` ). **See also:** `type `__ documentation. FrrKrLrbc dSrdrres rrfz X.aggregate5rgr c dSrdrris rrfz X.aggregate5rgr c dSrdrrls rrfz X.aggregate6rgr cO dSrdrPrrrorr domainCap domainColor domainDashdomainDashOffset domainOpacity domainWidthr&rgridgridCap gridColorgridDashgridDashOffset gridOpacity gridWidthrrr labelBoundrr labelFlushlabelFlushOffsetrrrrrrrrrrrr maxExtent minExtentrrpositionstyletickBandtickCap tickColorrtickDashtickDashOffset tickExtrar tickOffset tickOpacity tickRoundtickSize tickWidthticksrrrrrrrrrrrrrrtitleXtitleY translater_rrsP raxiszX.axis6rgr Nc dSrdrres rrzX.axis 6rgr c dSrdrres rrozX.bandPosition6rpr c dSrdrres rrrzX.bin6rgr c  dSrdrrts rrrzX.bin6rgr c dSrdrres rrrzX.bin6rgr c dSrdrres rrrzX.bin6rgr c dSrdrres rrzX.field"6rgr c dSrdrrs rrzX.field&6rgr c dSrdrrframekeyvalsmethodrrs rimputezX.impute*6rgr c dSrdrres rrzX.impute.6rgr c dSrdrrs rrzX.scale26rgr c dSrdrres rrzX.scale66rgr c dSrdrres rrzX.sort:6rgr c dSrdrres rrzX.sort>6rgr c dSrdrres rrzX.sortB6rgr c dSrdrres rrzX.sortF6rgr rc dSrdrres rrzX.sortJ6rgr rc dSrdrres rrzX.sortN6rgr rc dSrdrres rrzX.sortR6rgr c dSrdrrs rrzX.sortV6rgr c dSrdrrs rrzX.sortZ6rgr c dSrdrres rrzX.sort^6rgr r4c dSrdrres rr7zX.stackb6rgr c dSrdrres rr7zX.stackf6rgr c dSrdrres rr7zX.stackj6rgr rc dSrdrres rrz X.timeUnitn6rgr rc dSrdrres rrz X.timeUnitr6rgr r#c dSrdrres rrz X.timeUnitv6rgr rBc dSrdrres rrz X.timeUnitz6rgr c dSrdrrbs rrz X.timeUnit~6rgr c dSrdrres rrzX.title6rgr c dSrdrres rrzX.title6rgr c dSrdrres rrzX.title6rgr rhc dSrdrres rr"zX.type6rpr c dtt|jd||||||||| | | | | d |dSN) rrfrrorrrrrrr7rrr"r)r2rrprrrfrrorrrrrrr7rrr"rrs rrpz X.__init__6a a 3)yt-9s%X^&+$eh^c%) 3 3.2 3 3 3 3 3r )rbr)rKNrbrr'r9r:rtrurvrr rfrrrwrorxrrr.rrrr rrrzr7rrr"rpr;r<s@rrr4 @(-$N  7$bc ps   X (    X (    X ! yYbnwFO\exAQZhqzCPY`is|HQ\evMVbkxANWgp}FS\hq~G Z c o x H Q b k } F S \ n w E N ] f u ~ M V h q z COXdmvHQ\emvAJT]ir~GR[luAJXanwENZcnwCLT]en{DR[hqAJW`luEN_hzCPYktCL[dmvHT]foxA    X    X  e      T c   X "9Y_hr{FOV_fow@    X  S S   X    X  s s   X $    X $i QZ    X    X #))9_hqzGP\eqzEN\eluHW`ox@IT]hq{DLU^gnw~G    X    X  d5k c   X  d3i C   X  d4j S   X  d4=) c   X  g78 S   X  gUV cf   X  gab or   X "y     X %Y    X    X  w<= #   X    X  t    X  '#PQ ^a   X  '#qr B   X  '#x y  F I    X  '#O P  ] `    X (yyi    X  s s   X  tCy S   X    X  gNO \_    "+ii^gi Yb 9II3333333333r rcOeZdZdZdZdZeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeefNddZeddZde ddfd Z eeeeefdd Z edd Z eeeeeeeeeeeeeeeeeeeeeeeefdd Z edd Z ede dddfdZeddZededdfdZededdfdZedeeddfdZeddZde dddfdZeeeeeeeffd ZxZS)XDatuma#XDatum schema wrapper Mapping(required=[]) Parameters ---------- axis : anyOf(:class:`Axis`, None) An object defining properties of axis's gridlines, ticks and labels. If ``null``, the axis for the encoding channel will be removed. **Default value:** If undefined, default `axis properties `__ are applied. **See also:** `axis `__ documentation. bandPosition : float Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to ``0``, and at the middle of the band if set to ``0.5``. datum : anyOf(:class:`PrimitiveValue`, :class:`DateTime`, :class:`ExprRef`, :class:`RepeatRef`) A constant value in data domain. impute : anyOf(:class:`ImputeParams`, None) An object defining the properties of the Impute Operation to be applied. The field value of the other positional channel is taken as ``key`` of the ``Impute`` Operation. The field of the ``color`` channel if specified is used as ``groupby`` of the ``Impute`` Operation. **See also:** `impute `__ documentation. scale : anyOf(:class:`Scale`, None) An object defining properties of the channel's scale, which is the function that transforms values in the data domain (numbers, dates, strings, etc) to visual values (pixels, colors, sizes) of the encoding channels. If ``null``, the scale will be `disabled and the data value will be directly encoded `__. **Default value:** If undefined, default `scale properties `__ are applied. **See also:** `scale `__ documentation. stack : anyOf(:class:`StackOffset`, None, boolean) Type of stacking offset if the field should be stacked. ``stack`` is only applicable for ``x``, ``y``, ``theta``, and ``radius`` channels with continuous domains. For example, ``stack`` of ``y`` can be used to customize stacking for a vertical bar chart. ``stack`` can be one of the following values: * ``"zero"`` or `true`: stacking with baseline offset at zero value of the scale (for creating typical stacked [bar](https://vega.github.io/vega-lite/docs/stack.html#bar) and `area `__ chart). * ``"normalize"`` - stacking with normalized domain (for creating `normalized stacked bar and area charts `__ and pie charts `with percentage tooltip `__ ). :raw-html:`
` * ``"center"`` - stacking with center baseline (for `streamgraph `__ ). * ``null`` or ``false`` - No-stacking. This will produce layered `bar `__ and area chart. **Default value:** ``zero`` for plots with all of the following conditions are true: (1) the mark is ``bar``, ``area``, or ``arc`` ; (2) the stacked measure channel (x or y) has a linear scale; (3) At least one of non-position channels mapped to an unaggregated field that is different from x and y. Otherwise, ``null`` by default. **See also:** `stack `__ documentation. title : anyOf(:class:`Text`, None) A title for the field. If ``null``, the title will be removed. **Default value:** derived from the field's name and transformation function ( ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function, the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ). Otherwise, the title is simply the field name. **Notes** : 1) You can customize the default field title format by providing the `fieldTitle `__ property in the `config `__ or `fieldTitle function via the compile function's options `__. 2) If both field definition's ``title`` and axis, header, or legend ``title`` are defined, axis/header/legend title will be used. type : :class:`Type` The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also be a ``"geojson"`` type for encoding `'geoshape' `__. Vega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal scale for a field with ``bin`` or ``timeUnit``. **Default value:** 1) For a data ``field``, ``"nominal"`` is the default data type unless the field encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or ``timeUnit`` that satisfies the following criteria: * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin`` or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a quantitative scale `__. * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit`` or (2) the specified scale type is a time or utc scale * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort order `__, (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is ``order``. 2) For a constant value in data domain ( ``datum`` ): * ``"quantitative"`` if the datum is a number * ``"nominal"`` if the datum is a string * ``"temporal"`` if the datum is `a date time object `__ **Note:** * Data ``type`` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data. * Data values for a temporal field can be either a date-time string (e.g., ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a timestamp number (e.g., ``1552199579097`` ). * When using with `bin `__, the ``type`` property can be either ``"quantitative"`` (for using a linear bin scale) or `"ordinal" (for using an ordinal bin scale) `__. * When using with `timeUnit `__, the ``type`` property can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal" (for using an ordinal scale) `__. * When using with `aggregate `__, the ``type`` property refers to the post-aggregation data type. For example, we can calculate count ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct", "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``. * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have ``type`` as they must have exactly the same type as their primary channels (e.g., ``x``, ``y`` ). **See also:** `type `__ documentation. FrrbcO dSrdrrsP rrz XDatum.axisD7rgr rKNc dSrdrres rrz XDatum.axisH7rgr c dSrdrres rrozXDatum.bandPositionL7rpr c dSrdrrs rrz XDatum.imputeO7rgr c dSrdrres rrz XDatum.imputeS7rgr c dSrdrrs rrz XDatum.scaleW7rgr c dSrdrres rrz XDatum.scale[7rgr r4c dSrdrres rr7z XDatum.stack_7rgr c dSrdrres rr7z XDatum.stackc7rgr c dSrdrres rr7z XDatum.stackg7rgr c dSrdrres rrz XDatum.titlek7rgr c dSrdrres rrz XDatum.titleo7rgr c dSrdrres rrz XDatum.titles7rgr rc dSrdrres rr"z XDatum.typew7rpr c Ztt|jd||||||||d| dSN)rGrrorrr7rr"r)r2r3rp rrGrrorrr7rr"rrs rrpzXDatum.__init__{7[$fd$ _5t,_e+0UQU _ _Y] _ _ _ _ _r )rbr3)rKNrbr3r'r9r:rtrurvrrrrwrorrr r7rxr.rr r"rpr;r<s@rr3r36*ccH(-$N ! yYbnwFO\exAQZhqzCPY`is|HQ\evMVbkxANWgp}FS\hq~G Z c o x H Q b k } F S \ n w E N ] f u ~ M V h q z COXdmvHQ\emvAJT]ir~GR[luAJXanwENZcnwCLT]en{DR[hqAJW`luEN_hzCPYktCL[dmvHT]foxA    X    X  e     $i QZ    X    X #))9_hqzGP\eqzEN\eluHW`ox@IT]hq{DLU^gnw~G    X    X  w<= (   X    X  t    X  s x   X  tCy X   X    X  gYZ go    $-9Y^g __________r r3c*eZdZdZdZdZfdZxZS)XValueaXValue schema wrapper Mapping(required=[value]) Definition object for a constant value (primitive value or gradient definition) of an encoding channel. Parameters ---------- value : anyOf(float, string, string, :class:`ExprRef`) A constant value in visual domain (e.g., ``"red"`` / ``"#0099ff"`` / `gradient definition `__ for color, values between ``0`` to ``1`` for opacity). Frc Ltt|jdd|i|dSr)r2rIrprs rrpzXValue.__init__71$fd$9959D99999r rr<s@rrIrI7O  (-$N:::::::::r rIc(eZdZdZdZdZededddfdZee fddZee fdd Zde ddfd Z dd Z ede ddfd Zee fddZededddfdZededddfdZededddfdZededddfdZee e e e fddZede ddfdZedee ddfdZeddZe e e e e e e ffd ZxZS)X2aX2 schema wrapper Mapping(required=[shorthand]) A field definition of a secondary channel that shares a scale with another primary channel. For example, ``x2``, ``xError`` and ``xError2`` share the same scale with ``x``. Parameters ---------- shorthand : string shorthand for field, aggregate, and type aggregate : :class:`Aggregate` Aggregation function for the field (e.g., ``"mean"``, ``"sum"``, ``"median"``, ``"min"``, ``"max"``, ``"count"`` ). **Default value:** ``undefined`` (None) **See also:** `aggregate `__ documentation. bandPosition : float Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to ``0``, and at the middle of the band if set to ``0.5``. bin : None A flag for binning a ``quantitative`` field, `an object defining binning parameters `__, or indicating that the data for ``x`` or ``y`` channel are binned before they are imported into Vega-Lite ( ``"binned"`` ). If ``true``, default `binning parameters `__ will be applied. If ``"binned"``, this indicates that the data for the ``x`` (or ``y`` ) channel are already binned. You can map the bin-start field to ``x`` (or ``y`` ) and the bin-end field to ``x2`` (or ``y2`` ). The scale and axis will be formatted similar to binning in Vega-Lite. To adjust the axis ticks based on the bin step, you can also set the axis's `tickMinStep `__ property. **Default value:** ``false`` **See also:** `bin `__ documentation. field : :class:`Field` **Required.** A string defining the name of the field from which to pull a data value or an object defining iterated values from the `repeat `__ operator. **See also:** `field `__ documentation. **Notes:** 1) Dots ( ``.`` ) and brackets ( ``[`` and ``]`` ) can be used to access nested objects (e.g., ``"field": "foo.bar"`` and ``"field": "foo['bar']"`` ). If field names contain dots or brackets but are not nested, you can use ``\`` to escape dots and brackets (e.g., ``"a\.b"`` and ``"a\[0\]"`` ). See more details about escaping in the `field documentation `__. 2) ``field`` is not required if ``aggregate`` is ``count``. timeUnit : anyOf(:class:`TimeUnit`, :class:`TimeUnitParams`) Time unit (e.g., ``year``, ``yearmonth``, ``month``, ``hours`` ) for a temporal field. or `a temporal field that gets casted as ordinal `__. **Default value:** ``undefined`` (None) **See also:** `timeUnit `__ documentation. title : anyOf(:class:`Text`, None) A title for the field. If ``null``, the title will be removed. **Default value:** derived from the field's name and transformation function ( ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function, the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ). Otherwise, the title is simply the field name. **Notes** : 1) You can customize the default field title format by providing the `fieldTitle `__ property in the `config `__ or `fieldTitle function via the compile function's options `__. 2) If both field definition's ``title`` and axis, header, or legend ``title`` are defined, axis/header/legend title will be used. Fx2rKrLrbc dSrdrres rrfz X2.aggregate7rgr c dSrdrris rrfz X2.aggregate7rgr c dSrdrrls rrfz X2.aggregate8rgr c dSrdrres rrozX2.bandPosition8rpr Nc dSrdrres rrrzX2.bin8rpr c dSrdrres rrzX2.field 8rgr c dSrdrrs rrzX2.field8rgr rc dSrdrres rrz X2.timeUnit8rgr rc dSrdrres rrz X2.timeUnit8rgr r#c dSrdrres rrz X2.timeUnit8rgr rBc dSrdrres rrz X2.timeUnit8rgr c dSrdrrbs rrz X2.timeUnit"8rgr c dSrdrres rrzX2.title&8rgr c dSrdrres rrzX2.title*8rgr c dSrdrres rrzX2.title.8rgr c Xtt|jd|||||||d|dSrt)r2rNrprus rrpz X2.__init__38W b$  _9 Xd%(PU _ _Y] _ _ _ _ _r )rbrN)rKNrbrNrvr<s@rrNrN77XXr(-$N  7$bc pt   X (    X (    X  e          s t   X $    X  '#PQ ^b   X  '#qr C   X  '#x y  F J    X  '#O P  ] a    X (yyi    X  s t   X  tCy T   X    X "+ii]f 9I__________r rNceZdZdZdZdZdeddfdZede ddfdZ ede e ddfdZ edd Z de d ddfd Z eeeffd ZxZS)X2DatumaVX2Datum schema wrapper Mapping(required=[]) Parameters ---------- bandPosition : float Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to ``0``, and at the middle of the band if set to ``0.5``. datum : anyOf(:class:`PrimitiveValue`, :class:`DateTime`, :class:`ExprRef`, :class:`RepeatRef`) A constant value in data domain. title : anyOf(:class:`Text`, None) A title for the field. If ``null``, the title will be removed. **Default value:** derived from the field's name and transformation function ( ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function, the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ). Otherwise, the title is simply the field name. **Notes** : 1) You can customize the default field title format by providing the `fieldTitle `__ property in the `config `__ or `fieldTitle function via the compile function's options `__. 2) If both field definition's ``title`` and axis, header, or legend ``title`` are defined, axis/header/legend title will be used. type : :class:`Type` The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also be a ``"geojson"`` type for encoding `'geoshape' `__. Vega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal scale for a field with ``bin`` or ``timeUnit``. **Default value:** 1) For a data ``field``, ``"nominal"`` is the default data type unless the field encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or ``timeUnit`` that satisfies the following criteria: * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin`` or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a quantitative scale `__. * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit`` or (2) the specified scale type is a time or utc scale * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort order `__, (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is ``order``. 2) For a constant value in data domain ( ``datum`` ): * ``"quantitative"`` if the datum is a number * ``"nominal"`` if the datum is a string * ``"temporal"`` if the datum is `a date time object `__ **Note:** * Data ``type`` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data. * Data values for a temporal field can be either a date-time string (e.g., ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a timestamp number (e.g., ``1552199579097`` ). * When using with `bin `__, the ``type`` property can be either ``"quantitative"`` (for using a linear bin scale) or `"ordinal" (for using an ordinal bin scale) `__. * When using with `timeUnit `__, the ``type`` property can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal" (for using an ordinal scale) `__. * When using with `aggregate `__, the ``type`` property refers to the post-aggregation data type. For example, we can calculate count ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct", "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``. * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have ``type`` as they must have exactly the same type as their primary channels (e.g., ``x``, ``y`` ). **See also:** `type `__ documentation. FrOrKrbc dSrdrres rrozX2Datum.bandPosition8rpr c dSrdrres rrz X2Datum.title8rgr c dSrdrres rrz X2Datum.title8rgr Nc dSrdrres rrz X2Datum.title8rgr rc dSrdrres rr"z X2Datum.type8rpr c Rtt|jd||||d|dSr^)r2rcrpr_s rrpzX2Datum.__init__8J%gt% .E TY`d . .(, . . . . .r )rKNrbrcr`r<s@rrcrc98+ffN(-$N e      s y   X  tCy Y   X    X  gYZ gp    ,5II..........r rcc*eZdZdZdZdZfdZxZS)X2ValueaX2Value schema wrapper Mapping(required=[value]) Definition object for a constant value (primitive value or gradient definition) of an encoding channel. Parameters ---------- value : anyOf(float, string, string, :class:`ExprRef`) A constant value in visual domain (e.g., ``"red"`` / ``"#0099ff"`` / `gradient definition `__ for color, values between ``0`` to ``1`` for opacity). FrOc Ltt|jdd|i|dSr)r2rmrprs rrpzX2Value.__init__81%gt%::E:T:::::r rr<s@rrmrm8O  (-$N;;;;;;;;;r rmc(eZdZdZdZdZededddfdZee fddZee fdd Zde ddfd Z dd Z ede ddfd Zee fddZededddfdZededddfdZededddfdZededddfdZee e e e fddZede ddfdZedee ddfdZeddZe e e e e e e ffd ZxZS)XErroraXError schema wrapper Mapping(required=[shorthand]) A field definition of a secondary channel that shares a scale with another primary channel. For example, ``x2``, ``xError`` and ``xError2`` share the same scale with ``x``. Parameters ---------- shorthand : string shorthand for field, aggregate, and type aggregate : :class:`Aggregate` Aggregation function for the field (e.g., ``"mean"``, ``"sum"``, ``"median"``, ``"min"``, ``"max"``, ``"count"`` ). **Default value:** ``undefined`` (None) **See also:** `aggregate `__ documentation. bandPosition : float Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to ``0``, and at the middle of the band if set to ``0.5``. bin : None A flag for binning a ``quantitative`` field, `an object defining binning parameters `__, or indicating that the data for ``x`` or ``y`` channel are binned before they are imported into Vega-Lite ( ``"binned"`` ). If ``true``, default `binning parameters `__ will be applied. If ``"binned"``, this indicates that the data for the ``x`` (or ``y`` ) channel are already binned. You can map the bin-start field to ``x`` (or ``y`` ) and the bin-end field to ``x2`` (or ``y2`` ). The scale and axis will be formatted similar to binning in Vega-Lite. To adjust the axis ticks based on the bin step, you can also set the axis's `tickMinStep `__ property. **Default value:** ``false`` **See also:** `bin `__ documentation. field : :class:`Field` **Required.** A string defining the name of the field from which to pull a data value or an object defining iterated values from the `repeat `__ operator. **See also:** `field `__ documentation. **Notes:** 1) Dots ( ``.`` ) and brackets ( ``[`` and ``]`` ) can be used to access nested objects (e.g., ``"field": "foo.bar"`` and ``"field": "foo['bar']"`` ). If field names contain dots or brackets but are not nested, you can use ``\`` to escape dots and brackets (e.g., ``"a\.b"`` and ``"a\[0\]"`` ). See more details about escaping in the `field documentation `__. 2) ``field`` is not required if ``aggregate`` is ``count``. timeUnit : anyOf(:class:`TimeUnit`, :class:`TimeUnitParams`) Time unit (e.g., ``year``, ``yearmonth``, ``month``, ``hours`` ) for a temporal field. or `a temporal field that gets casted as ordinal `__. **Default value:** ``undefined`` (None) **See also:** `timeUnit `__ documentation. title : anyOf(:class:`Text`, None) A title for the field. If ``null``, the title will be removed. **Default value:** derived from the field's name and transformation function ( ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function, the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ). Otherwise, the title is simply the field name. **Notes** : 1) You can customize the default field title format by providing the `fieldTitle `__ property in the `config `__ or `fieldTitle function via the compile function's options `__. 2) If both field definition's ``title`` and axis, header, or legend ``title`` are defined, axis/header/legend title will be used. FxErrorrKrLrbc dSrdrres rrfzXError.aggregate49rgr c dSrdrris rrfzXError.aggregate89rgr c dSrdrrls rrfzXError.aggregate<9rgr c dSrdrres rrozXError.bandPosition@9rpr Nc dSrdrres rrrz XError.binC9rpr c dSrdrres rrz XError.fieldF9rgr c dSrdrrs rrz XError.fieldJ9rgr rc dSrdrres rrzXError.timeUnitN9rgr rc dSrdrres rrzXError.timeUnitR9rgr r#c dSrdrres rrzXError.timeUnitV9rgr rBc dSrdrres rrzXError.timeUnitZ9rgr c dSrdrrbs rrzXError.timeUnit^9rgr c dSrdrres rrz XError.titleb9rgr c dSrdrres rrz XError.titlef9rgr c dSrdrres rrz XError.titlej9rgr c Xtt|jd|||||||d|dSrt)r2rrrprus rrpzXError.__init__o9rr )rbrr)rKNrbrrrvr<s@rrrrr8rr rrc*eZdZdZdZdZfdZxZS) XErrorValueaXErrorValue schema wrapper Mapping(required=[value]) Definition object for a constant value (primitive value or gradient definition) of an encoding channel. Parameters ---------- value : float A constant value in visual domain (e.g., ``"red"`` / ``"#0099ff"`` / `gradient definition `__ for color, values between ``0`` to ``1`` for opacity). Frsc Ltt|jdd|i|dSr)r2rrprs rrpzXErrorValue.__init__9rZr rr<s@rrrv9r[r rc(eZdZdZdZdZededddfdZee fddZee fdd Zde ddfd Z dd Z ede ddfd Zee fddZededddfdZededddfdZededddfdZededddfdZee e e e fddZede ddfdZedee ddfdZeddZe e e e e e e ffd ZxZS)XError2aXError2 schema wrapper Mapping(required=[shorthand]) A field definition of a secondary channel that shares a scale with another primary channel. For example, ``x2``, ``xError`` and ``xError2`` share the same scale with ``x``. Parameters ---------- shorthand : string shorthand for field, aggregate, and type aggregate : :class:`Aggregate` Aggregation function for the field (e.g., ``"mean"``, ``"sum"``, ``"median"``, ``"min"``, ``"max"``, ``"count"`` ). **Default value:** ``undefined`` (None) **See also:** `aggregate `__ documentation. bandPosition : float Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to ``0``, and at the middle of the band if set to ``0.5``. bin : None A flag for binning a ``quantitative`` field, `an object defining binning parameters `__, or indicating that the data for ``x`` or ``y`` channel are binned before they are imported into Vega-Lite ( ``"binned"`` ). If ``true``, default `binning parameters `__ will be applied. If ``"binned"``, this indicates that the data for the ``x`` (or ``y`` ) channel are already binned. You can map the bin-start field to ``x`` (or ``y`` ) and the bin-end field to ``x2`` (or ``y2`` ). The scale and axis will be formatted similar to binning in Vega-Lite. To adjust the axis ticks based on the bin step, you can also set the axis's `tickMinStep `__ property. **Default value:** ``false`` **See also:** `bin `__ documentation. field : :class:`Field` **Required.** A string defining the name of the field from which to pull a data value or an object defining iterated values from the `repeat `__ operator. **See also:** `field `__ documentation. **Notes:** 1) Dots ( ``.`` ) and brackets ( ``[`` and ``]`` ) can be used to access nested objects (e.g., ``"field": "foo.bar"`` and ``"field": "foo['bar']"`` ). If field names contain dots or brackets but are not nested, you can use ``\`` to escape dots and brackets (e.g., ``"a\.b"`` and ``"a\[0\]"`` ). See more details about escaping in the `field documentation `__. 2) ``field`` is not required if ``aggregate`` is ``count``. timeUnit : anyOf(:class:`TimeUnit`, :class:`TimeUnitParams`) Time unit (e.g., ``year``, ``yearmonth``, ``month``, ``hours`` ) for a temporal field. or `a temporal field that gets casted as ordinal `__. **Default value:** ``undefined`` (None) **See also:** `timeUnit `__ documentation. title : anyOf(:class:`Text`, None) A title for the field. If ``null``, the title will be removed. **Default value:** derived from the field's name and transformation function ( ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function, the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ). Otherwise, the title is simply the field name. **Notes** : 1) You can customize the default field title format by providing the `fieldTitle `__ property in the `config `__ or `fieldTitle function via the compile function's options `__. 2) If both field definition's ``title`` and axis, header, or legend ``title`` are defined, axis/header/legend title will be used. FxError2rKrLrbc dSrdrres rrfzXError2.aggregate9rgr c dSrdrris rrfzXError2.aggregate9rgr c dSrdrrls rrfzXError2.aggregate9rgr c dSrdrres rrozXError2.bandPosition9rpr Nc dSrdrres rrrz XError2.bin9rpr c dSrdrres rrz XError2.field9rgr c dSrdrrs rrz XError2.field:rgr rc dSrdrres rrzXError2.timeUnit:rgr rc dSrdrres rrzXError2.timeUnit :rgr r#c dSrdrres rrzXError2.timeUnit:rgr rBc dSrdrres rrzXError2.timeUnit:rgr c dSrdrrbs rrzXError2.timeUnit:rgr c dSrdrres rrz XError2.title:rgr c dSrdrres rrz XError2.title:rgr c dSrdrres rrz XError2.title#:rgr c Xtt|jd|||||||d|dSrt)r2rrprus rrpzXError2.__init__(:ror )rbr)rKNrbrrvr<s@rrr9rpr rc*eZdZdZdZdZfdZxZS) XError2ValueaXError2Value schema wrapper Mapping(required=[value]) Definition object for a constant value (primitive value or gradient definition) of an encoding channel. Parameters ---------- value : float A constant value in visual domain (e.g., ``"red"`` / ``"#0099ff"`` / `gradient definition `__ for color, values between ``0`` to ``1`` for opacity). Frc Ltt|jdd|i|dSr)r2rrprs rrpzXError2Value.__init__D:r|r rr<s@rrr/:r}r rceZdZdZdZdZededddfdZee fd/dZee fd/d Zde ddfd Z ede ddfd Z ee e e e e e e e e e f d/d Z ed0dZ ededdfdZee fd/dZee e e e e e e e e e e e e e e e e e e e e e e fd/dZed0dZedee ddfdZedeeddfdZedee ddfdZedeejddfdZededddfdZededddfdZededddfdZee e e fd/dZee e fd/dZed0dZeded ddfd!Zeded"ddfd#Zeded$ddfd%Zeded&ddfd'Zee e e e fd/d(Zededdfd)Zedeeddfd*Zed0d+Zded,ddfd-Ze e e e e e e e e e f fd. ZxZS)1XOffseta+XOffset schema wrapper Mapping(required=[shorthand]) Parameters ---------- shorthand : string shorthand for field, aggregate, and type aggregate : :class:`Aggregate` Aggregation function for the field (e.g., ``"mean"``, ``"sum"``, ``"median"``, ``"min"``, ``"max"``, ``"count"`` ). **Default value:** ``undefined`` (None) **See also:** `aggregate `__ documentation. bandPosition : float Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to ``0``, and at the middle of the band if set to ``0.5``. bin : anyOf(boolean, :class:`BinParams`, None) A flag for binning a ``quantitative`` field, `an object defining binning parameters `__, or indicating that the data for ``x`` or ``y`` channel are binned before they are imported into Vega-Lite ( ``"binned"`` ). If ``true``, default `binning parameters `__ will be applied. If ``"binned"``, this indicates that the data for the ``x`` (or ``y`` ) channel are already binned. You can map the bin-start field to ``x`` (or ``y`` ) and the bin-end field to ``x2`` (or ``y2`` ). The scale and axis will be formatted similar to binning in Vega-Lite. To adjust the axis ticks based on the bin step, you can also set the axis's `tickMinStep `__ property. **Default value:** ``false`` **See also:** `bin `__ documentation. field : :class:`Field` **Required.** A string defining the name of the field from which to pull a data value or an object defining iterated values from the `repeat `__ operator. **See also:** `field `__ documentation. **Notes:** 1) Dots ( ``.`` ) and brackets ( ``[`` and ``]`` ) can be used to access nested objects (e.g., ``"field": "foo.bar"`` and ``"field": "foo['bar']"`` ). If field names contain dots or brackets but are not nested, you can use ``\`` to escape dots and brackets (e.g., ``"a\.b"`` and ``"a\[0\]"`` ). See more details about escaping in the `field documentation `__. 2) ``field`` is not required if ``aggregate`` is ``count``. scale : anyOf(:class:`Scale`, None) An object defining properties of the channel's scale, which is the function that transforms values in the data domain (numbers, dates, strings, etc) to visual values (pixels, colors, sizes) of the encoding channels. If ``null``, the scale will be `disabled and the data value will be directly encoded `__. **Default value:** If undefined, default `scale properties `__ are applied. **See also:** `scale `__ documentation. sort : :class:`Sort` Sort order for the encoded field. For continuous fields (quantitative or temporal), ``sort`` can be either ``"ascending"`` or ``"descending"``. For discrete fields, ``sort`` can be one of the following: * ``"ascending"`` or ``"descending"`` -- for sorting by the values' natural order in JavaScript. * `A string indicating an encoding channel name to sort by `__ (e.g., ``"x"`` or ``"y"`` ) with an optional minus prefix for descending sort (e.g., ``"-x"`` to sort by x-field, descending). This channel string is short-form of `a sort-by-encoding definition `__. For example, ``"sort": "-x"`` is equivalent to ``"sort": {"encoding": "x", "order": "descending"}``. * `A sort field definition `__ for sorting by another field. * `An array specifying the field values in preferred order `__. In this case, the sort order will obey the values in the array, followed by any unspecified values in their original order. For discrete time field, values in the sort array can be `date-time definition objects `__. In addition, for time units ``"month"`` and ``"day"``, the values can be the month or day names (case insensitive) or their 3-letter initials (e.g., ``"Mon"``, ``"Tue"`` ). * ``null`` indicating no sort. **Default value:** ``"ascending"`` **Note:** ``null`` and sorting by another channel is not supported for ``row`` and ``column``. **See also:** `sort `__ documentation. timeUnit : anyOf(:class:`TimeUnit`, :class:`TimeUnitParams`) Time unit (e.g., ``year``, ``yearmonth``, ``month``, ``hours`` ) for a temporal field. or `a temporal field that gets casted as ordinal `__. **Default value:** ``undefined`` (None) **See also:** `timeUnit `__ documentation. title : anyOf(:class:`Text`, None) A title for the field. If ``null``, the title will be removed. **Default value:** derived from the field's name and transformation function ( ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function, the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ). Otherwise, the title is simply the field name. **Notes** : 1) You can customize the default field title format by providing the `fieldTitle `__ property in the `config `__ or `fieldTitle function via the compile function's options `__. 2) If both field definition's ``title`` and axis, header, or legend ``title`` are defined, axis/header/legend title will be used. type : :class:`StandardType` The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also be a ``"geojson"`` type for encoding `'geoshape' `__. Vega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal scale for a field with ``bin`` or ``timeUnit``. **Default value:** 1) For a data ``field``, ``"nominal"`` is the default data type unless the field encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or ``timeUnit`` that satisfies the following criteria: * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin`` or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a quantitative scale `__. * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit`` or (2) the specified scale type is a time or utc scale * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort order `__, (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is ``order``. 2) For a constant value in data domain ( ``datum`` ): * ``"quantitative"`` if the datum is a number * ``"nominal"`` if the datum is a string * ``"temporal"`` if the datum is `a date time object `__ **Note:** * Data ``type`` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data. * Data values for a temporal field can be either a date-time string (e.g., ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a timestamp number (e.g., ``1552199579097`` ). * When using with `bin `__, the ``type`` property can be either ``"quantitative"`` (for using a linear bin scale) or `"ordinal" (for using an ordinal bin scale) `__. * When using with `timeUnit `__, the ``type`` property can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal" (for using an ordinal scale) `__. * When using with `aggregate `__, the ``type`` property refers to the post-aggregation data type. For example, we can calculate count ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct", "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``. * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have ``type`` as they must have exactly the same type as their primary channels (e.g., ``x``, ``y`` ). **See also:** `type `__ documentation. FxOffsetrKrLrbc dSrdrres rrfzXOffset.aggregate;rgr c dSrdrris rrfzXOffset.aggregate!;rgr c dSrdrrls rrfzXOffset.aggregate%;rgr c dSrdrres rrozXOffset.bandPosition);rpr c dSrdrres rrrz XOffset.bin,;rgr c  dSrdrrts rrrz XOffset.bin0;rgr Nc dSrdrres rrrz XOffset.bin4;rgr c dSrdrres rrz XOffset.field8;rgr c dSrdrrs rrz XOffset.field<;rgr c dSrdrrs rrz XOffset.scale@;rgr c dSrdrres rrz XOffset.scaleD;rgr c dSrdrres rrz XOffset.sortH;rgr c dSrdrres rrz XOffset.sortL;rgr c dSrdrres rrz XOffset.sortP;rgr c dSrdrres rrz XOffset.sortT;rgr rc dSrdrres rrz XOffset.sortX;rgr rc dSrdrres rrz XOffset.sort\;rgr rc dSrdrres rrz XOffset.sort`;rgr c dSrdrrs rrz XOffset.sortd;rgr c dSrdrrs rrz XOffset.sorth;rgr c dSrdrres rrz XOffset.sortl;rgr rc dSrdrres rrzXOffset.timeUnitp;rgr rc dSrdrres rrzXOffset.timeUnitt;rgr r#c dSrdrres rrzXOffset.timeUnitx;rgr rBc dSrdrres rrzXOffset.timeUnit|;rgr c dSrdrrbs rrzXOffset.timeUnit;rgr c dSrdrres rrz XOffset.title;rgr c dSrdrres rrz XOffset.title;rgr c dSrdrres rrz XOffset.title;rgr rhc dSrdrres rr"z XOffset.type;rpr c  ^tt|jd||||||||| | d | dSN) rrfrorrrrrrrr"r)r2rrp rrrfrorrrrrrrr"rrs rrpzXOffset.__init__;c &gt% d Y3?SPU]b+/(%VZ d d^b d d d d dr )rbr)rKNrbrr'r9r:rtrurvrr rfrrwrorxrrr.rrr rrrzrrr"rpr;r<s@rrrH:OO`(-$N  7$bc py   X (    X (    X  e      T i   X "9Y_hr{FOV_fow@    X    X  s y   X $    X #))9_hqzGP\eqzEN\eluHW`ox@IT]hq{DLU^gnw~G    X    X  d5k i   X  d3i I   X  d4j Y   X  d4=) i   X  g78 Y   X  gUV cl   X  gab ox   X "y     X %Y    X    X  '#PQ ^g   X  '#qr H   X  '#x y  F O    X  '#O P  ] f    X (yyi    X  s y   X  tCy Y   X    X  gNO \e    "+ii]f I]fddddddddddr rc$eZdZdZdZdZdeddfdZee e e e e e e e e e e e e e e e e e e e e e e fddZ edd Z ede ddfd Z ede e ddfd Z edd Z ded ddfdZe e e e ffd ZxZS) XOffsetDatumaXOffsetDatum schema wrapper Mapping(required=[]) Parameters ---------- bandPosition : float Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to ``0``, and at the middle of the band if set to ``0.5``. datum : anyOf(:class:`PrimitiveValue`, :class:`DateTime`, :class:`ExprRef`, :class:`RepeatRef`) A constant value in data domain. scale : anyOf(:class:`Scale`, None) An object defining properties of the channel's scale, which is the function that transforms values in the data domain (numbers, dates, strings, etc) to visual values (pixels, colors, sizes) of the encoding channels. If ``null``, the scale will be `disabled and the data value will be directly encoded `__. **Default value:** If undefined, default `scale properties `__ are applied. **See also:** `scale `__ documentation. title : anyOf(:class:`Text`, None) A title for the field. If ``null``, the title will be removed. **Default value:** derived from the field's name and transformation function ( ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function, the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ). Otherwise, the title is simply the field name. **Notes** : 1) You can customize the default field title format by providing the `fieldTitle `__ property in the `config `__ or `fieldTitle function via the compile function's options `__. 2) If both field definition's ``title`` and axis, header, or legend ``title`` are defined, axis/header/legend title will be used. type : :class:`Type` The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also be a ``"geojson"`` type for encoding `'geoshape' `__. Vega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal scale for a field with ``bin`` or ``timeUnit``. **Default value:** 1) For a data ``field``, ``"nominal"`` is the default data type unless the field encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or ``timeUnit`` that satisfies the following criteria: * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin`` or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a quantitative scale `__. * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit`` or (2) the specified scale type is a time or utc scale * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort order `__, (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is ``order``. 2) For a constant value in data domain ( ``datum`` ): * ``"quantitative"`` if the datum is a number * ``"nominal"`` if the datum is a string * ``"temporal"`` if the datum is `a date time object `__ **Note:** * Data ``type`` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data. * Data values for a temporal field can be either a date-time string (e.g., ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a timestamp number (e.g., ``1552199579097`` ). * When using with `bin `__, the ``type`` property can be either ``"quantitative"`` (for using a linear bin scale) or `"ordinal" (for using an ordinal bin scale) `__. * When using with `timeUnit `__, the ``type`` property can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal" (for using an ordinal scale) `__. * When using with `aggregate `__, the ``type`` property refers to the post-aggregation data type. For example, we can calculate count ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct", "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``. * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have ``type`` as they must have exactly the same type as their primary channels (e.g., ``x``, ``y`` ). **See also:** `type `__ documentation. FrrKrbc dSrdrres rrozXOffsetDatum.bandPosition<rpr c dSrdrrs rrzXOffsetDatum.scale<rgr Nc dSrdrres rrzXOffsetDatum.scale<rgr c dSrdrres rrzXOffsetDatum.title <rgr c dSrdrres rrzXOffsetDatum.title$<rgr c dSrdrres rrzXOffsetDatum.title(<rgr rc dSrdrres rr"zXOffsetDatum.type,<rpr c Ttt|jd|||||d|dSN)rGrorrr"r)r2rrprrGrorrr"rrs rrpzXOffsetDatum.__init__0<T*lD!!* K\Y^16T K KEI K K K K Kr )rbr)rKNrbrr'r9r:rtrurvrwrorrrr.rr r r"rpr;r<s@rrr;ssh(-$N e     #))9_hqzGP\eqzEN\eluHW`ox@IT]hq{DLU^gnw~G    X    X  s ~   X  tCy ^   X    X  gYZ gu    ,5IY]fKKKKKKKKKKr rc*eZdZdZdZdZfdZxZS) XOffsetValueaXOffsetValue schema wrapper Mapping(required=[value]) Definition object for a constant value (primitive value or gradient definition) of an encoding channel. Parameters ---------- value : float A constant value in visual domain (e.g., ``"red"`` / ``"#0099ff"`` / `gradient definition `__ for color, values between ``0`` to ``1`` for opacity). Frc Ltt|jdd|i|dSr)r2rrprs rrpzXOffsetValue.__init__K<r|r rr<s@rrr6<r}r rcO.eZdZdZdZdZededddfdZee fd8dZee fd8d Zee e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e fNd8d Z ed9d Z de ddfd Z ede ddfdZee e e e e e e e e e f d8dZededdfdZed9dZededdfdZee fd8dZee e e e fd8dZed9dZee e e e e e e e e e e e e e e e e e e e e e e fd8dZed9dZedee ddfdZedeeddfdZedee ddfdZedeejddfdZededddfdZededddfdZeded ddfd!Zee e e fd8d"Zee e fd8d#Zed9d$Zeded%ddfd&Zed9d'Zede ddfd(Zeded)ddfd*Zeded+ddfd,Zeded-ddfd.Zeded/ddfd0Zee e e e fd8d1Zededdfd2Zedeeddfd3Zed9d4Zded5ddfd6Ze e e e e e e e e e e e e f fd7 ZxZS):Yap6Y schema wrapper Mapping(required=[shorthand]) Parameters ---------- shorthand : string shorthand for field, aggregate, and type aggregate : :class:`Aggregate` Aggregation function for the field (e.g., ``"mean"``, ``"sum"``, ``"median"``, ``"min"``, ``"max"``, ``"count"`` ). **Default value:** ``undefined`` (None) **See also:** `aggregate `__ documentation. axis : anyOf(:class:`Axis`, None) An object defining properties of axis's gridlines, ticks and labels. If ``null``, the axis for the encoding channel will be removed. **Default value:** If undefined, default `axis properties `__ are applied. **See also:** `axis `__ documentation. bandPosition : float Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to ``0``, and at the middle of the band if set to ``0.5``. bin : anyOf(boolean, :class:`BinParams`, string, None) A flag for binning a ``quantitative`` field, `an object defining binning parameters `__, or indicating that the data for ``x`` or ``y`` channel are binned before they are imported into Vega-Lite ( ``"binned"`` ). If ``true``, default `binning parameters `__ will be applied. If ``"binned"``, this indicates that the data for the ``x`` (or ``y`` ) channel are already binned. You can map the bin-start field to ``x`` (or ``y`` ) and the bin-end field to ``x2`` (or ``y2`` ). The scale and axis will be formatted similar to binning in Vega-Lite. To adjust the axis ticks based on the bin step, you can also set the axis's `tickMinStep `__ property. **Default value:** ``false`` **See also:** `bin `__ documentation. field : :class:`Field` **Required.** A string defining the name of the field from which to pull a data value or an object defining iterated values from the `repeat `__ operator. **See also:** `field `__ documentation. **Notes:** 1) Dots ( ``.`` ) and brackets ( ``[`` and ``]`` ) can be used to access nested objects (e.g., ``"field": "foo.bar"`` and ``"field": "foo['bar']"`` ). If field names contain dots or brackets but are not nested, you can use ``\`` to escape dots and brackets (e.g., ``"a\.b"`` and ``"a\[0\]"`` ). See more details about escaping in the `field documentation `__. 2) ``field`` is not required if ``aggregate`` is ``count``. impute : anyOf(:class:`ImputeParams`, None) An object defining the properties of the Impute Operation to be applied. The field value of the other positional channel is taken as ``key`` of the ``Impute`` Operation. The field of the ``color`` channel if specified is used as ``groupby`` of the ``Impute`` Operation. **See also:** `impute `__ documentation. scale : anyOf(:class:`Scale`, None) An object defining properties of the channel's scale, which is the function that transforms values in the data domain (numbers, dates, strings, etc) to visual values (pixels, colors, sizes) of the encoding channels. If ``null``, the scale will be `disabled and the data value will be directly encoded `__. **Default value:** If undefined, default `scale properties `__ are applied. **See also:** `scale `__ documentation. sort : :class:`Sort` Sort order for the encoded field. For continuous fields (quantitative or temporal), ``sort`` can be either ``"ascending"`` or ``"descending"``. For discrete fields, ``sort`` can be one of the following: * ``"ascending"`` or ``"descending"`` -- for sorting by the values' natural order in JavaScript. * `A string indicating an encoding channel name to sort by `__ (e.g., ``"x"`` or ``"y"`` ) with an optional minus prefix for descending sort (e.g., ``"-x"`` to sort by x-field, descending). This channel string is short-form of `a sort-by-encoding definition `__. For example, ``"sort": "-x"`` is equivalent to ``"sort": {"encoding": "x", "order": "descending"}``. * `A sort field definition `__ for sorting by another field. * `An array specifying the field values in preferred order `__. In this case, the sort order will obey the values in the array, followed by any unspecified values in their original order. For discrete time field, values in the sort array can be `date-time definition objects `__. In addition, for time units ``"month"`` and ``"day"``, the values can be the month or day names (case insensitive) or their 3-letter initials (e.g., ``"Mon"``, ``"Tue"`` ). * ``null`` indicating no sort. **Default value:** ``"ascending"`` **Note:** ``null`` and sorting by another channel is not supported for ``row`` and ``column``. **See also:** `sort `__ documentation. stack : anyOf(:class:`StackOffset`, None, boolean) Type of stacking offset if the field should be stacked. ``stack`` is only applicable for ``x``, ``y``, ``theta``, and ``radius`` channels with continuous domains. For example, ``stack`` of ``y`` can be used to customize stacking for a vertical bar chart. ``stack`` can be one of the following values: * ``"zero"`` or `true`: stacking with baseline offset at zero value of the scale (for creating typical stacked [bar](https://vega.github.io/vega-lite/docs/stack.html#bar) and `area `__ chart). * ``"normalize"`` - stacking with normalized domain (for creating `normalized stacked bar and area charts `__ and pie charts `with percentage tooltip `__ ). :raw-html:`
` * ``"center"`` - stacking with center baseline (for `streamgraph `__ ). * ``null`` or ``false`` - No-stacking. This will produce layered `bar `__ and area chart. **Default value:** ``zero`` for plots with all of the following conditions are true: (1) the mark is ``bar``, ``area``, or ``arc`` ; (2) the stacked measure channel (x or y) has a linear scale; (3) At least one of non-position channels mapped to an unaggregated field that is different from x and y. Otherwise, ``null`` by default. **See also:** `stack `__ documentation. timeUnit : anyOf(:class:`TimeUnit`, :class:`TimeUnitParams`) Time unit (e.g., ``year``, ``yearmonth``, ``month``, ``hours`` ) for a temporal field. or `a temporal field that gets casted as ordinal `__. **Default value:** ``undefined`` (None) **See also:** `timeUnit `__ documentation. title : anyOf(:class:`Text`, None) A title for the field. If ``null``, the title will be removed. **Default value:** derived from the field's name and transformation function ( ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function, the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ). Otherwise, the title is simply the field name. **Notes** : 1) You can customize the default field title format by providing the `fieldTitle `__ property in the `config `__ or `fieldTitle function via the compile function's options `__. 2) If both field definition's ``title`` and axis, header, or legend ``title`` are defined, axis/header/legend title will be used. type : :class:`StandardType` The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also be a ``"geojson"`` type for encoding `'geoshape' `__. Vega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal scale for a field with ``bin`` or ``timeUnit``. **Default value:** 1) For a data ``field``, ``"nominal"`` is the default data type unless the field encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or ``timeUnit`` that satisfies the following criteria: * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin`` or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a quantitative scale `__. * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit`` or (2) the specified scale type is a time or utc scale * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort order `__, (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is ``order``. 2) For a constant value in data domain ( ``datum`` ): * ``"quantitative"`` if the datum is a number * ``"nominal"`` if the datum is a string * ``"temporal"`` if the datum is `a date time object `__ **Note:** * Data ``type`` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data. * Data values for a temporal field can be either a date-time string (e.g., ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a timestamp number (e.g., ``1552199579097`` ). * When using with `bin `__, the ``type`` property can be either ``"quantitative"`` (for using a linear bin scale) or `"ordinal" (for using an ordinal bin scale) `__. * When using with `timeUnit `__, the ``type`` property can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal" (for using an ordinal scale) `__. * When using with `aggregate `__, the ``type`` property refers to the post-aggregation data type. For example, we can calculate count ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct", "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``. * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have ``type`` as they must have exactly the same type as their primary channels (e.g., ``x``, ``y`` ). **See also:** `type `__ documentation. FrrKrLrbc dSrdrres rrfz Y.aggregateT=rgr c dSrdrris rrfz Y.aggregateX=rgr c dSrdrrls rrfz Y.aggregate\=rgr cO dSrdrrsP rrzY.axis`=rgr Nc dSrdrres rrzY.axisd=rgr c dSrdrres rrozY.bandPositionh=rpr c dSrdrres rrrzY.bink=rgr c  dSrdrrts rrrzY.bino=rgr c dSrdrres rrrzY.bins=rgr c dSrdrres rrrzY.binw=rgr c dSrdrres rrzY.field{=rgr c dSrdrrs rrzY.field=rgr c dSrdrrs rrzY.impute=rgr c dSrdrres rrzY.impute=rgr c dSrdrrs rrzY.scale=rgr c dSrdrres rrzY.scale=rgr c dSrdrres rrzY.sort=rgr c dSrdrres rrzY.sort=rgr c dSrdrres rrzY.sort=rgr c dSrdrres rrzY.sort=rgr rc dSrdrres rrzY.sort=rgr rc dSrdrres rrzY.sort=rgr rc dSrdrres rrzY.sort=rgr c dSrdrrs rrzY.sort=rgr c dSrdrrs rrzY.sort=rgr c dSrdrres rrzY.sort=rgr r4c dSrdrres rr7zY.stack=rgr c dSrdrres rr7zY.stack=rgr c dSrdrres rr7zY.stack=rgr rc dSrdrres rrz Y.timeUnit=rgr rc dSrdrres rrz Y.timeUnit=rgr r#c dSrdrres rrz Y.timeUnit=rgr rBc dSrdrres rrz Y.timeUnit=rgr c dSrdrrbs rrz Y.timeUnit=rgr c dSrdrres rrzY.title=rgr c dSrdrres rrzY.title=rgr c dSrdrres rrzY.title=rgr rhc dSrdrres rr"zY.type=rpr c dtt|jd||||||||| | | | | d |dSr-)r2rrpr.s rrpz Y.__init__=r/r )rbr)rKNrbrr0r<s@rrrO<r1r rcOeZdZdZdZdZeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeefNddZeddZde ddfd Z eeeeefdd Z edd Z eeeeeeeeeeeeeeeeeeeeeeeefdd Z edd Z ede dddfdZeddZededdfdZededdfdZedeeddfdZeddZde dddfdZeeeeeeeffd ZxZS)YDatuma#YDatum schema wrapper Mapping(required=[]) Parameters ---------- axis : anyOf(:class:`Axis`, None) An object defining properties of axis's gridlines, ticks and labels. If ``null``, the axis for the encoding channel will be removed. **Default value:** If undefined, default `axis properties `__ are applied. **See also:** `axis `__ documentation. bandPosition : float Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to ``0``, and at the middle of the band if set to ``0.5``. datum : anyOf(:class:`PrimitiveValue`, :class:`DateTime`, :class:`ExprRef`, :class:`RepeatRef`) A constant value in data domain. impute : anyOf(:class:`ImputeParams`, None) An object defining the properties of the Impute Operation to be applied. The field value of the other positional channel is taken as ``key`` of the ``Impute`` Operation. The field of the ``color`` channel if specified is used as ``groupby`` of the ``Impute`` Operation. **See also:** `impute `__ documentation. scale : anyOf(:class:`Scale`, None) An object defining properties of the channel's scale, which is the function that transforms values in the data domain (numbers, dates, strings, etc) to visual values (pixels, colors, sizes) of the encoding channels. If ``null``, the scale will be `disabled and the data value will be directly encoded `__. **Default value:** If undefined, default `scale properties `__ are applied. **See also:** `scale `__ documentation. stack : anyOf(:class:`StackOffset`, None, boolean) Type of stacking offset if the field should be stacked. ``stack`` is only applicable for ``x``, ``y``, ``theta``, and ``radius`` channels with continuous domains. For example, ``stack`` of ``y`` can be used to customize stacking for a vertical bar chart. ``stack`` can be one of the following values: * ``"zero"`` or `true`: stacking with baseline offset at zero value of the scale (for creating typical stacked [bar](https://vega.github.io/vega-lite/docs/stack.html#bar) and `area `__ chart). * ``"normalize"`` - stacking with normalized domain (for creating `normalized stacked bar and area charts `__ and pie charts `with percentage tooltip `__ ). :raw-html:`
` * ``"center"`` - stacking with center baseline (for `streamgraph `__ ). * ``null`` or ``false`` - No-stacking. This will produce layered `bar `__ and area chart. **Default value:** ``zero`` for plots with all of the following conditions are true: (1) the mark is ``bar``, ``area``, or ``arc`` ; (2) the stacked measure channel (x or y) has a linear scale; (3) At least one of non-position channels mapped to an unaggregated field that is different from x and y. Otherwise, ``null`` by default. **See also:** `stack `__ documentation. title : anyOf(:class:`Text`, None) A title for the field. If ``null``, the title will be removed. **Default value:** derived from the field's name and transformation function ( ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function, the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ). Otherwise, the title is simply the field name. **Notes** : 1) You can customize the default field title format by providing the `fieldTitle `__ property in the `config `__ or `fieldTitle function via the compile function's options `__. 2) If both field definition's ``title`` and axis, header, or legend ``title`` are defined, axis/header/legend title will be used. type : :class:`Type` The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also be a ``"geojson"`` type for encoding `'geoshape' `__. Vega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal scale for a field with ``bin`` or ``timeUnit``. **Default value:** 1) For a data ``field``, ``"nominal"`` is the default data type unless the field encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or ``timeUnit`` that satisfies the following criteria: * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin`` or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a quantitative scale `__. * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit`` or (2) the specified scale type is a time or utc scale * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort order `__, (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is ``order``. 2) For a constant value in data domain ( ``datum`` ): * ``"quantitative"`` if the datum is a number * ``"nominal"`` if the datum is a string * ``"temporal"`` if the datum is `a date time object `__ **Note:** * Data ``type`` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data. * Data values for a temporal field can be either a date-time string (e.g., ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a timestamp number (e.g., ``1552199579097`` ). * When using with `bin `__, the ``type`` property can be either ``"quantitative"`` (for using a linear bin scale) or `"ordinal" (for using an ordinal bin scale) `__. * When using with `timeUnit `__, the ``type`` property can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal" (for using an ordinal scale) `__. * When using with `aggregate `__, the ``type`` property refers to the post-aggregation data type. For example, we can calculate count ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct", "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``. * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have ``type`` as they must have exactly the same type as their primary channels (e.g., ``x``, ``y`` ). **See also:** `type `__ documentation. FrrbcO dSrdrrsP rrz YDatum.axis>rgr rKNc dSrdrres rrz YDatum.axis>rgr c dSrdrres rrozYDatum.bandPosition>rpr c dSrdrrs rrz YDatum.impute>rgr c dSrdrres rrz YDatum.impute>rgr c dSrdrrs rrz YDatum.scale>rgr c dSrdrres rrz YDatum.scale>rgr r4c dSrdrres rr7z YDatum.stack>rgr c dSrdrres rr7z YDatum.stack>rgr c dSrdrres rr7z YDatum.stack>rgr c dSrdrres rrz YDatum.title>rgr c dSrdrres rrz YDatum.title>rgr c dSrdrres rrz YDatum.title>rgr rc dSrdrres rr"z YDatum.type>rpr c Ztt|jd||||||||d| dSrC)r2rrprDs rrpzYDatum.__init__>rEr )rbr)rKNrbrrFr<s@rrr=rGr rc*eZdZdZdZdZfdZxZS)YValueaYValue schema wrapper Mapping(required=[value]) Definition object for a constant value (primitive value or gradient definition) of an encoding channel. Parameters ---------- value : anyOf(float, string, string, :class:`ExprRef`) A constant value in visual domain (e.g., ``"red"`` / ``"#0099ff"`` / `gradient definition `__ for color, values between ``0`` to ``1`` for opacity). Frc Ltt|jdd|i|dSr)r2rrprs rrpzYValue.__init__>rKr rr<s@rrr>rLr rc(eZdZdZdZdZededddfdZee fddZee fdd Zde ddfd Z dd Z ede ddfd Zee fddZededddfdZededddfdZededddfdZededddfdZee e e e fddZede ddfdZedee ddfdZeddZe e e e e e e ffd ZxZS)Y2aY2 schema wrapper Mapping(required=[shorthand]) A field definition of a secondary channel that shares a scale with another primary channel. For example, ``x2``, ``xError`` and ``xError2`` share the same scale with ``x``. Parameters ---------- shorthand : string shorthand for field, aggregate, and type aggregate : :class:`Aggregate` Aggregation function for the field (e.g., ``"mean"``, ``"sum"``, ``"median"``, ``"min"``, ``"max"``, ``"count"`` ). **Default value:** ``undefined`` (None) **See also:** `aggregate `__ documentation. bandPosition : float Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to ``0``, and at the middle of the band if set to ``0.5``. bin : None A flag for binning a ``quantitative`` field, `an object defining binning parameters `__, or indicating that the data for ``x`` or ``y`` channel are binned before they are imported into Vega-Lite ( ``"binned"`` ). If ``true``, default `binning parameters `__ will be applied. If ``"binned"``, this indicates that the data for the ``x`` (or ``y`` ) channel are already binned. You can map the bin-start field to ``x`` (or ``y`` ) and the bin-end field to ``x2`` (or ``y2`` ). The scale and axis will be formatted similar to binning in Vega-Lite. To adjust the axis ticks based on the bin step, you can also set the axis's `tickMinStep `__ property. **Default value:** ``false`` **See also:** `bin `__ documentation. field : :class:`Field` **Required.** A string defining the name of the field from which to pull a data value or an object defining iterated values from the `repeat `__ operator. **See also:** `field `__ documentation. **Notes:** 1) Dots ( ``.`` ) and brackets ( ``[`` and ``]`` ) can be used to access nested objects (e.g., ``"field": "foo.bar"`` and ``"field": "foo['bar']"`` ). If field names contain dots or brackets but are not nested, you can use ``\`` to escape dots and brackets (e.g., ``"a\.b"`` and ``"a\[0\]"`` ). See more details about escaping in the `field documentation `__. 2) ``field`` is not required if ``aggregate`` is ``count``. timeUnit : anyOf(:class:`TimeUnit`, :class:`TimeUnitParams`) Time unit (e.g., ``year``, ``yearmonth``, ``month``, ``hours`` ) for a temporal field. or `a temporal field that gets casted as ordinal `__. **Default value:** ``undefined`` (None) **See also:** `timeUnit `__ documentation. title : anyOf(:class:`Text`, None) A title for the field. If ``null``, the title will be removed. **Default value:** derived from the field's name and transformation function ( ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function, the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ). Otherwise, the title is simply the field name. **Notes** : 1) You can customize the default field title format by providing the `fieldTitle `__ property in the `config `__ or `fieldTitle function via the compile function's options `__. 2) If both field definition's ``title`` and axis, header, or legend ``title`` are defined, axis/header/legend title will be used. Fy2rKrLrbc dSrdrres rrfz Y2.aggregateQ?rgr c dSrdrris rrfz Y2.aggregateU?rgr c dSrdrrls rrfz Y2.aggregateY?rgr c dSrdrres rrozY2.bandPosition]?rpr Nc dSrdrres rrrzY2.bin`?rpr c dSrdrres rrzY2.fieldc?rgr c dSrdrrs rrzY2.fieldg?rgr rc dSrdrres rrz Y2.timeUnitk?rgr rc dSrdrres rrz Y2.timeUnito?rgr r#c dSrdrres rrz Y2.timeUnits?rgr rBc dSrdrres rrz Y2.timeUnitw?rgr c dSrdrrbs rrz Y2.timeUnit{?rgr c dSrdrres rrzY2.title?rgr c dSrdrres rrzY2.title?rgr c dSrdrres rrzY2.title?rgr c Xtt|jd|||||||d|dSrt)r2rrprus rrpz Y2.__init__?r`r )rbr)rKNrbrrvr<s@rrr>rar rceZdZdZdZdZdeddfdZede ddfdZ ede e ddfdZ edd Z de d ddfd Z eeeffd ZxZS)Y2DatumaVY2Datum schema wrapper Mapping(required=[]) Parameters ---------- bandPosition : float Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to ``0``, and at the middle of the band if set to ``0.5``. datum : anyOf(:class:`PrimitiveValue`, :class:`DateTime`, :class:`ExprRef`, :class:`RepeatRef`) A constant value in data domain. title : anyOf(:class:`Text`, None) A title for the field. If ``null``, the title will be removed. **Default value:** derived from the field's name and transformation function ( ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function, the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ). Otherwise, the title is simply the field name. **Notes** : 1) You can customize the default field title format by providing the `fieldTitle `__ property in the `config `__ or `fieldTitle function via the compile function's options `__. 2) If both field definition's ``title`` and axis, header, or legend ``title`` are defined, axis/header/legend title will be used. type : :class:`Type` The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also be a ``"geojson"`` type for encoding `'geoshape' `__. Vega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal scale for a field with ``bin`` or ``timeUnit``. **Default value:** 1) For a data ``field``, ``"nominal"`` is the default data type unless the field encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or ``timeUnit`` that satisfies the following criteria: * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin`` or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a quantitative scale `__. * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit`` or (2) the specified scale type is a time or utc scale * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort order `__, (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is ``order``. 2) For a constant value in data domain ( ``datum`` ): * ``"quantitative"`` if the datum is a number * ``"nominal"`` if the datum is a string * ``"temporal"`` if the datum is `a date time object `__ **Note:** * Data ``type`` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data. * Data values for a temporal field can be either a date-time string (e.g., ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a timestamp number (e.g., ``1552199579097`` ). * When using with `bin `__, the ``type`` property can be either ``"quantitative"`` (for using a linear bin scale) or `"ordinal" (for using an ordinal bin scale) `__. * When using with `timeUnit `__, the ``type`` property can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal" (for using an ordinal scale) `__. * When using with `aggregate `__, the ``type`` property refers to the post-aggregation data type. For example, we can calculate count ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct", "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``. * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have ``type`` as they must have exactly the same type as their primary channels (e.g., ``x``, ``y`` ). **See also:** `type `__ documentation. FrrKrbc dSrdrres rrozY2Datum.bandPosition?rpr c dSrdrres rrz Y2Datum.title@rgr c dSrdrres rrz Y2Datum.title@rgr Nc dSrdrres rrz Y2Datum.title @rgr rc dSrdrres rr"z Y2Datum.type @rpr c Rtt|jd||||d|dSr^)r2r'rpr_s rrpzY2Datum.__init__@rjr )rKNrbr'r`r<s@rr'r'?rkr r'c*eZdZdZdZdZfdZxZS)Y2ValueaY2Value schema wrapper Mapping(required=[value]) Definition object for a constant value (primitive value or gradient definition) of an encoding channel. Parameters ---------- value : anyOf(float, string, string, :class:`ExprRef`) A constant value in visual domain (e.g., ``"red"`` / ``"#0099ff"`` / `gradient definition `__ for color, values between ``0`` to ``1`` for opacity). Frc Ltt|jdd|i|dSr)r2r/rprs rrpzY2Value.__init__+@ror rr<s@rr/r/@rpr r/c(eZdZdZdZdZededddfdZee fddZee fdd Zde ddfd Z dd Z ede ddfd Zee fddZededddfdZededddfdZededddfdZededddfdZee e e e fddZede ddfdZedee ddfdZeddZe e e e e e e ffd ZxZS)YErroraYError schema wrapper Mapping(required=[shorthand]) A field definition of a secondary channel that shares a scale with another primary channel. For example, ``x2``, ``xError`` and ``xError2`` share the same scale with ``x``. Parameters ---------- shorthand : string shorthand for field, aggregate, and type aggregate : :class:`Aggregate` Aggregation function for the field (e.g., ``"mean"``, ``"sum"``, ``"median"``, ``"min"``, ``"max"``, ``"count"`` ). **Default value:** ``undefined`` (None) **See also:** `aggregate `__ documentation. bandPosition : float Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to ``0``, and at the middle of the band if set to ``0.5``. bin : None A flag for binning a ``quantitative`` field, `an object defining binning parameters `__, or indicating that the data for ``x`` or ``y`` channel are binned before they are imported into Vega-Lite ( ``"binned"`` ). If ``true``, default `binning parameters `__ will be applied. If ``"binned"``, this indicates that the data for the ``x`` (or ``y`` ) channel are already binned. You can map the bin-start field to ``x`` (or ``y`` ) and the bin-end field to ``x2`` (or ``y2`` ). The scale and axis will be formatted similar to binning in Vega-Lite. To adjust the axis ticks based on the bin step, you can also set the axis's `tickMinStep `__ property. **Default value:** ``false`` **See also:** `bin `__ documentation. field : :class:`Field` **Required.** A string defining the name of the field from which to pull a data value or an object defining iterated values from the `repeat `__ operator. **See also:** `field `__ documentation. **Notes:** 1) Dots ( ``.`` ) and brackets ( ``[`` and ``]`` ) can be used to access nested objects (e.g., ``"field": "foo.bar"`` and ``"field": "foo['bar']"`` ). If field names contain dots or brackets but are not nested, you can use ``\`` to escape dots and brackets (e.g., ``"a\.b"`` and ``"a\[0\]"`` ). See more details about escaping in the `field documentation `__. 2) ``field`` is not required if ``aggregate`` is ``count``. timeUnit : anyOf(:class:`TimeUnit`, :class:`TimeUnitParams`) Time unit (e.g., ``year``, ``yearmonth``, ``month``, ``hours`` ) for a temporal field. or `a temporal field that gets casted as ordinal `__. **Default value:** ``undefined`` (None) **See also:** `timeUnit `__ documentation. title : anyOf(:class:`Text`, None) A title for the field. If ``null``, the title will be removed. **Default value:** derived from the field's name and transformation function ( ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function, the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ). Otherwise, the title is simply the field name. **Notes** : 1) You can customize the default field title format by providing the `fieldTitle `__ property in the `config `__ or `fieldTitle function via the compile function's options `__. 2) If both field definition's ``title`` and axis, header, or legend ``title`` are defined, axis/header/legend title will be used. FyErrorrKrLrbc dSrdrres rrfzYError.aggregate@rgr c dSrdrris rrfzYError.aggregate@rgr c dSrdrrls rrfzYError.aggregate@rgr c dSrdrres rrozYError.bandPosition@rpr Nc dSrdrres rrrz YError.bin@rpr c dSrdrres rrz YError.field@rgr c dSrdrrs rrz YError.field@rgr rc dSrdrres rrzYError.timeUnit@rgr rc dSrdrres rrzYError.timeUnit@rgr r#c dSrdrres rrzYError.timeUnit@rgr rBc dSrdrres rrzYError.timeUnit@rgr c dSrdrrbs rrzYError.timeUnit@rgr c dSrdrres rrz YError.title@rgr c dSrdrres rrz YError.title@rgr c dSrdrres rrz YError.title@rgr c Xtt|jd|||||||d|dSrt)r2r2rprus rrpzYError.__init__@rr )rbr2)rKNrbr2rvr<s@rr2r2/@rr r2c*eZdZdZdZdZfdZxZS) YErrorValueaYErrorValue schema wrapper Mapping(required=[value]) Definition object for a constant value (primitive value or gradient definition) of an encoding channel. Parameters ---------- value : float A constant value in visual domain (e.g., ``"red"`` / ``"#0099ff"`` / `gradient definition `__ for color, values between ``0`` to ``1`` for opacity). Fr3c Ltt|jdd|i|dSr)r2rErprs rrpzYErrorValue.__init__@rZr rr<s@rrErE@r[r rEc(eZdZdZdZdZededddfdZee fddZee fdd Zde ddfd Z dd Z ede ddfd Zee fddZededddfdZededddfdZededddfdZededddfdZee e e e fddZede ddfdZedee ddfdZeddZe e e e e e e ffd ZxZS)YError2aYError2 schema wrapper Mapping(required=[shorthand]) A field definition of a secondary channel that shares a scale with another primary channel. For example, ``x2``, ``xError`` and ``xError2`` share the same scale with ``x``. Parameters ---------- shorthand : string shorthand for field, aggregate, and type aggregate : :class:`Aggregate` Aggregation function for the field (e.g., ``"mean"``, ``"sum"``, ``"median"``, ``"min"``, ``"max"``, ``"count"`` ). **Default value:** ``undefined`` (None) **See also:** `aggregate `__ documentation. bandPosition : float Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to ``0``, and at the middle of the band if set to ``0.5``. bin : None A flag for binning a ``quantitative`` field, `an object defining binning parameters `__, or indicating that the data for ``x`` or ``y`` channel are binned before they are imported into Vega-Lite ( ``"binned"`` ). If ``true``, default `binning parameters `__ will be applied. If ``"binned"``, this indicates that the data for the ``x`` (or ``y`` ) channel are already binned. You can map the bin-start field to ``x`` (or ``y`` ) and the bin-end field to ``x2`` (or ``y2`` ). The scale and axis will be formatted similar to binning in Vega-Lite. To adjust the axis ticks based on the bin step, you can also set the axis's `tickMinStep `__ property. **Default value:** ``false`` **See also:** `bin `__ documentation. field : :class:`Field` **Required.** A string defining the name of the field from which to pull a data value or an object defining iterated values from the `repeat `__ operator. **See also:** `field `__ documentation. **Notes:** 1) Dots ( ``.`` ) and brackets ( ``[`` and ``]`` ) can be used to access nested objects (e.g., ``"field": "foo.bar"`` and ``"field": "foo['bar']"`` ). If field names contain dots or brackets but are not nested, you can use ``\`` to escape dots and brackets (e.g., ``"a\.b"`` and ``"a\[0\]"`` ). See more details about escaping in the `field documentation `__. 2) ``field`` is not required if ``aggregate`` is ``count``. timeUnit : anyOf(:class:`TimeUnit`, :class:`TimeUnitParams`) Time unit (e.g., ``year``, ``yearmonth``, ``month``, ``hours`` ) for a temporal field. or `a temporal field that gets casted as ordinal `__. **Default value:** ``undefined`` (None) **See also:** `timeUnit `__ documentation. title : anyOf(:class:`Text`, None) A title for the field. If ``null``, the title will be removed. **Default value:** derived from the field's name and transformation function ( ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function, the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ). Otherwise, the title is simply the field name. **Notes** : 1) You can customize the default field title format by providing the `fieldTitle `__ property in the `config `__ or `fieldTitle function via the compile function's options `__. 2) If both field definition's ``title`` and axis, header, or legend ``title`` are defined, axis/header/legend title will be used. FyError2rKrLrbc dSrdrres rrfzYError2.aggregateFArgr c dSrdrris rrfzYError2.aggregateJArgr c dSrdrrls rrfzYError2.aggregateNArgr c dSrdrres rrozYError2.bandPositionRArpr Nc dSrdrres rrrz YError2.binUArpr c dSrdrres rrz YError2.fieldXArgr c dSrdrrs rrz YError2.field\Argr rc dSrdrres rrzYError2.timeUnit`Argr rc dSrdrres rrzYError2.timeUnitdArgr r#c dSrdrres rrzYError2.timeUnithArgr rBc dSrdrres rrzYError2.timeUnitlArgr c dSrdrrbs rrzYError2.timeUnitpArgr c dSrdrres rrz YError2.titletArgr c dSrdrres rrz YError2.titlexArgr c dSrdrres rrz YError2.title|Argr c Xtt|jd|||||||d|dSrt)r2rHrprus rrpzYError2.__init__Aror )rbrH)rKNrbrHrvr<s@rrHrH@rpr rHc*eZdZdZdZdZfdZxZS) YError2ValueaYError2Value schema wrapper Mapping(required=[value]) Definition object for a constant value (primitive value or gradient definition) of an encoding channel. Parameters ---------- value : float A constant value in visual domain (e.g., ``"red"`` / ``"#0099ff"`` / `gradient definition `__ for color, values between ``0`` to ``1`` for opacity). FrIc Ltt|jdd|i|dSr)r2r[rprs rrpzYError2Value.__init__Ar|r rr<s@rr[r[Ar}r r[ceZdZdZdZdZededddfdZee fd/dZee fd/d Zde ddfd Z ede ddfd Z ee e e e e e e e e e f d/d Z ed0dZ ededdfdZee fd/dZee e e e e e e e e e e e e e e e e e e e e e e fd/dZed0dZedee ddfdZedeeddfdZedee ddfdZedeejddfdZededddfdZededddfdZededddfdZee e e fd/dZee e fd/dZed0dZeded ddfd!Zeded"ddfd#Zeded$ddfd%Zeded&ddfd'Zee e e e fd/d(Zededdfd)Zedeeddfd*Zed0d+Zded,ddfd-Ze e e e e e e e e e f fd. ZxZS)1YOffseta+YOffset schema wrapper Mapping(required=[shorthand]) Parameters ---------- shorthand : string shorthand for field, aggregate, and type aggregate : :class:`Aggregate` Aggregation function for the field (e.g., ``"mean"``, ``"sum"``, ``"median"``, ``"min"``, ``"max"``, ``"count"`` ). **Default value:** ``undefined`` (None) **See also:** `aggregate `__ documentation. bandPosition : float Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to ``0``, and at the middle of the band if set to ``0.5``. bin : anyOf(boolean, :class:`BinParams`, None) A flag for binning a ``quantitative`` field, `an object defining binning parameters `__, or indicating that the data for ``x`` or ``y`` channel are binned before they are imported into Vega-Lite ( ``"binned"`` ). If ``true``, default `binning parameters `__ will be applied. If ``"binned"``, this indicates that the data for the ``x`` (or ``y`` ) channel are already binned. You can map the bin-start field to ``x`` (or ``y`` ) and the bin-end field to ``x2`` (or ``y2`` ). The scale and axis will be formatted similar to binning in Vega-Lite. To adjust the axis ticks based on the bin step, you can also set the axis's `tickMinStep `__ property. **Default value:** ``false`` **See also:** `bin `__ documentation. field : :class:`Field` **Required.** A string defining the name of the field from which to pull a data value or an object defining iterated values from the `repeat `__ operator. **See also:** `field `__ documentation. **Notes:** 1) Dots ( ``.`` ) and brackets ( ``[`` and ``]`` ) can be used to access nested objects (e.g., ``"field": "foo.bar"`` and ``"field": "foo['bar']"`` ). If field names contain dots or brackets but are not nested, you can use ``\`` to escape dots and brackets (e.g., ``"a\.b"`` and ``"a\[0\]"`` ). See more details about escaping in the `field documentation `__. 2) ``field`` is not required if ``aggregate`` is ``count``. scale : anyOf(:class:`Scale`, None) An object defining properties of the channel's scale, which is the function that transforms values in the data domain (numbers, dates, strings, etc) to visual values (pixels, colors, sizes) of the encoding channels. If ``null``, the scale will be `disabled and the data value will be directly encoded `__. **Default value:** If undefined, default `scale properties `__ are applied. **See also:** `scale `__ documentation. sort : :class:`Sort` Sort order for the encoded field. For continuous fields (quantitative or temporal), ``sort`` can be either ``"ascending"`` or ``"descending"``. For discrete fields, ``sort`` can be one of the following: * ``"ascending"`` or ``"descending"`` -- for sorting by the values' natural order in JavaScript. * `A string indicating an encoding channel name to sort by `__ (e.g., ``"x"`` or ``"y"`` ) with an optional minus prefix for descending sort (e.g., ``"-x"`` to sort by x-field, descending). This channel string is short-form of `a sort-by-encoding definition `__. For example, ``"sort": "-x"`` is equivalent to ``"sort": {"encoding": "x", "order": "descending"}``. * `A sort field definition `__ for sorting by another field. * `An array specifying the field values in preferred order `__. In this case, the sort order will obey the values in the array, followed by any unspecified values in their original order. For discrete time field, values in the sort array can be `date-time definition objects `__. In addition, for time units ``"month"`` and ``"day"``, the values can be the month or day names (case insensitive) or their 3-letter initials (e.g., ``"Mon"``, ``"Tue"`` ). * ``null`` indicating no sort. **Default value:** ``"ascending"`` **Note:** ``null`` and sorting by another channel is not supported for ``row`` and ``column``. **See also:** `sort `__ documentation. timeUnit : anyOf(:class:`TimeUnit`, :class:`TimeUnitParams`) Time unit (e.g., ``year``, ``yearmonth``, ``month``, ``hours`` ) for a temporal field. or `a temporal field that gets casted as ordinal `__. **Default value:** ``undefined`` (None) **See also:** `timeUnit `__ documentation. title : anyOf(:class:`Text`, None) A title for the field. If ``null``, the title will be removed. **Default value:** derived from the field's name and transformation function ( ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function, the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ). Otherwise, the title is simply the field name. **Notes** : 1) You can customize the default field title format by providing the `fieldTitle `__ property in the `config `__ or `fieldTitle function via the compile function's options `__. 2) If both field definition's ``title`` and axis, header, or legend ``title`` are defined, axis/header/legend title will be used. type : :class:`StandardType` The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also be a ``"geojson"`` type for encoding `'geoshape' `__. Vega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal scale for a field with ``bin`` or ``timeUnit``. **Default value:** 1) For a data ``field``, ``"nominal"`` is the default data type unless the field encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or ``timeUnit`` that satisfies the following criteria: * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin`` or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a quantitative scale `__. * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit`` or (2) the specified scale type is a time or utc scale * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort order `__, (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is ``order``. 2) For a constant value in data domain ( ``datum`` ): * ``"quantitative"`` if the datum is a number * ``"nominal"`` if the datum is a string * ``"temporal"`` if the datum is `a date time object `__ **Note:** * Data ``type`` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data. * Data values for a temporal field can be either a date-time string (e.g., ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a timestamp number (e.g., ``1552199579097`` ). * When using with `bin `__, the ``type`` property can be either ``"quantitative"`` (for using a linear bin scale) or `"ordinal" (for using an ordinal bin scale) `__. * When using with `timeUnit `__, the ``type`` property can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal" (for using an ordinal scale) `__. * When using with `aggregate `__, the ``type`` property refers to the post-aggregation data type. For example, we can calculate count ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct", "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``. * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have ``type`` as they must have exactly the same type as their primary channels (e.g., ``x``, ``y`` ). **See also:** `type `__ documentation. FyOffsetrKrLrbc dSrdrres rrfzYOffset.aggregatevBrgr c dSrdrris rrfzYOffset.aggregatezBrgr c dSrdrrls rrfzYOffset.aggregate~Brgr c dSrdrres rrozYOffset.bandPositionBrpr c dSrdrres rrrz YOffset.binBrgr c  dSrdrrts rrrz YOffset.binBrgr Nc dSrdrres rrrz YOffset.binBrgr c dSrdrres rrz YOffset.fieldBrgr c dSrdrrs rrz YOffset.fieldBrgr c dSrdrrs rrz YOffset.scaleBrgr c dSrdrres rrz YOffset.scaleBrgr c dSrdrres rrz YOffset.sortBrgr c dSrdrres rrz YOffset.sortBrgr c dSrdrres rrz YOffset.sortBrgr c dSrdrres rrz YOffset.sortBrgr rc dSrdrres rrz YOffset.sortBrgr rc dSrdrres rrz YOffset.sortBrgr rc dSrdrres rrz YOffset.sortBrgr c dSrdrrs rrz YOffset.sortBrgr c dSrdrrs rrz YOffset.sortBrgr c dSrdrres rrz YOffset.sortBrgr rc dSrdrres rrzYOffset.timeUnitBrgr rc dSrdrres rrzYOffset.timeUnitBrgr r#c dSrdrres rrzYOffset.timeUnitBrgr rBc dSrdrres rrzYOffset.timeUnitBrgr c dSrdrrbs rrzYOffset.timeUnitBrgr c dSrdrres rrz YOffset.titleBrgr c dSrdrres rrz YOffset.titleBrgr c dSrdrres rrz YOffset.titleBrgr rhc dSrdrres rr"z YOffset.typeBrpr c  ^tt|jd||||||||| | d | dSr)r2r^rprs rrpzYOffset.__init__Brr )rbr^)rKNrbr^rr<s@rr^r^Arr r^c$eZdZdZdZdZdeddfdZee e e e e e e e e e e e e e e e e e e e e e e fddZ edd Z ede ddfd Z ede e ddfd Z edd Z ded ddfdZe e e e ffd ZxZS) YOffsetDatumaYOffsetDatum schema wrapper Mapping(required=[]) Parameters ---------- bandPosition : float Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to ``0``, and at the middle of the band if set to ``0.5``. datum : anyOf(:class:`PrimitiveValue`, :class:`DateTime`, :class:`ExprRef`, :class:`RepeatRef`) A constant value in data domain. scale : anyOf(:class:`Scale`, None) An object defining properties of the channel's scale, which is the function that transforms values in the data domain (numbers, dates, strings, etc) to visual values (pixels, colors, sizes) of the encoding channels. If ``null``, the scale will be `disabled and the data value will be directly encoded `__. **Default value:** If undefined, default `scale properties `__ are applied. **See also:** `scale `__ documentation. title : anyOf(:class:`Text`, None) A title for the field. If ``null``, the title will be removed. **Default value:** derived from the field's name and transformation function ( ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function, the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ). Otherwise, the title is simply the field name. **Notes** : 1) You can customize the default field title format by providing the `fieldTitle `__ property in the `config `__ or `fieldTitle function via the compile function's options `__. 2) If both field definition's ``title`` and axis, header, or legend ``title`` are defined, axis/header/legend title will be used. type : :class:`Type` The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also be a ``"geojson"`` type for encoding `'geoshape' `__. Vega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal scale for a field with ``bin`` or ``timeUnit``. **Default value:** 1) For a data ``field``, ``"nominal"`` is the default data type unless the field encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or ``timeUnit`` that satisfies the following criteria: * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin`` or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a quantitative scale `__. * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit`` or (2) the specified scale type is a time or utc scale * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort order `__, (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is ``order``. 2) For a constant value in data domain ( ``datum`` ): * ``"quantitative"`` if the datum is a number * ``"nominal"`` if the datum is a string * ``"temporal"`` if the datum is `a date time object `__ **Note:** * Data ``type`` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data. * Data values for a temporal field can be either a date-time string (e.g., ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a timestamp number (e.g., ``1552199579097`` ). * When using with `bin `__, the ``type`` property can be either ``"quantitative"`` (for using a linear bin scale) or `"ordinal" (for using an ordinal bin scale) `__. * When using with `timeUnit `__, the ``type`` property can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal" (for using an ordinal scale) `__. * When using with `aggregate `__, the ``type`` property refers to the post-aggregation data type. For example, we can calculate count ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct", "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``. * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have ``type`` as they must have exactly the same type as their primary channels (e.g., ``x``, ``y`` ). **See also:** `type `__ documentation. Fr_rKrbc dSrdrres rrozYOffsetDatum.bandPositionnCrpr c dSrdrrs rrzYOffsetDatum.scaleqCrgr Nc dSrdrres rrzYOffsetDatum.scaleuCrgr c dSrdrres rrzYOffsetDatum.titleyCrgr c dSrdrres rrzYOffsetDatum.title}Crgr c dSrdrres rrzYOffsetDatum.titleCrgr rc dSrdrres rr"zYOffsetDatum.typeCrpr c Ttt|jd|||||d|dSr)r2rrprs rrpzYOffsetDatum.__init__Crr )rbr)rKNrbrrr<s@rrrBrr rc*eZdZdZdZdZfdZxZS) YOffsetValueaYOffsetValue schema wrapper Mapping(required=[value]) Definition object for a constant value (primitive value or gradient definition) of an encoding channel. Parameters ---------- value : float A constant value in visual domain (e.g., ``"red"`` / ``"#0099ff"`` / `gradient definition `__ for color, values between ``0`` to ``1`` for opacity). Fr_c Ltt|jdd|i|dSr)r2rrprs rrpzYOffsetValue.__init__Cr|r rr<s@rrrCr}r r)sysrpandasr0altair.utils.schemapirr altair.utilsrtypingrr version_infor typing_extensionsrr>rE2FieldOrDatumDefWithConditionMarkPropFieldDefnumberrI*FieldOrDatumDefWithConditionDatumDefnumberr|2ValueDefWithConditionMarkPropFieldOrDatumDefnumberr>FieldOrDatumDefWithConditionMarkPropFieldDefGradientstringnullr6FieldOrDatumDefWithConditionDatumDefGradientstringnullr>ValueDefWithConditionMarkPropFieldOrDatumDefGradientstringnullrRowColumnEncodingFieldDefrStringFieldDefWithConditionrStringValueDefWithConditionr2FieldDefWithoutScaler?FacetEncodingFieldDefrYrrrrrrrr!r+LatLongFieldDefrBDatumDefrWSecondaryFieldDefrbrxPositionValueDefrrrrrrrrr OrderFieldDefr OrderValueDefrPositionFieldDefBaserPositionDatumDefBaserHrXr]rrrzrBFieldOrDatumDefWithConditionMarkPropFieldDefTypeForShapestringnullr.FieldOrDatumDefWithConditionDatumDefstringnullrBValueDefWithConditionMarkPropFieldOrDatumDefTypeForShapestringnullrrrr rr<rG7FieldOrDatumDefWithConditionMarkPropFieldDefnumberArrayrQ/FieldOrDatumDefWithConditionDatumDefnumberArrayry7ValueDefWithConditionMarkPropFieldOrDatumDefnumberArrayrrrrrrr.FieldOrDatumDefWithConditionStringFieldDefTextr.FieldOrDatumDefWithConditionStringDatumDefTextr!'ValueDefWithConditionStringFieldDefTextr/r7r]rjrmrrrrrrPositionFieldDefrPositionDatumDefr3rIrNrcrmrrValueDefnumberrrr ScaleFieldDefr ScaleDatumDefrrrrrrr'r/r2rErHr[r^rrrr rrsL BBBBBBBB((((((!!!!!!!!v))))))3 3 3 3 3 3 3 3 lGGGGGGGG" G G G G G G G Gu,u,u,u,u, tVu,u,u,p TITITITITI"D$STITITIn0S0S0S0S0S"D$[0S0S0Sfu,u,u,u,u, tbu,u,u,p TITITITITI"D$_TITITIn0S0S0S0S0S"D$g0S0S0SfQEQEQEQEQE  >QEQEQEh q]q]q]q]q]#T%Eq]q]q]h 0Y0Y0Y0Y0Y($*J0Y0Y0YfpEpEpEpEpE  9pEpEpEfLhLhLhLhLh t9LhLhLh^ u+u+u+u+u+ dau+u+u+p THTHTHTHTH!4#^THTHTHn0R0R0R0R0R!4#f0R0R0Rfu]u]u]u]u]#T%\u]u]u]p TdTdTdTdTd($*YTdTdTdn0Y0Y0Y0Y0Y($*a0Y0Y0Yfq+q+q+q+q+ d>q+q+q+h 0R0R0R0R0R!4#C0R0R0Rfp*p*p*p*p* T6p*p*p*fbZbZbZbZbZ $"6bZbZbZJ@?@?@?@?@?%t}@?@?@?F\P\P\P\P\P!4#9\P\P\P~@@@@@@@@@@& @@@@@@FBBBBB&(=BBB0b[b[b[b[b[!4#7b[b[b[J@@@@@@@@@@& @@@@@@F\Q\Q\Q\Q\Q"D$:\Q\Q\Q~@A@A@A@A@A'@A@A@AFCCCCC')>CCC0uYuYuYuYuY!XuYuYuYp TKTKTKTKTK$d&UTKTKTKn0U0U0U0U0U$d&]0U0U0Ufu7u7u7u7u7 t1u7u7u7p%S%S%S%S%S"D$6%S%S%SP@-@-@-@-@-  9@-@-@-F AWAWAWAWAW#T%>AWAWAWH?????#T%:???0\N\N\N\N\N!7\N\N\N~@>@>@>@>@>$dm@>@>@>F@@@@@$d&;@@@0QBQBQBQBQB T;QBQBQBh u,u,u,u,u, tfu,u,u,p TITITITITI"D$WTITITIn0S0S0S0S0S"D$k0S0S0Sfu+u+u+u+u+ dUu+u+u+p THTHTHTHTH!4#RTHTHTHn0R0R0R0R0R!4#Z0R0R0RfuXuXuXuXuX  cuXuXuXp TJTJTJTJTJ#T%`TJTJTJn0T0T0T0T0T#T%h0T0T0Tfu\u\u\u\u\"D$`u\u\u\p TcTcTcTcTc')]TcTcTcn0X0X0X0X0X')e0X0X0Xfu_u_u_u_u_%t'^u_u_u_p TfTfTfTfTf*D,[TfTfTfn0[0[0[0[0[*D,c0[0[0[fu]u]u]u]u]#T%\u]u]u]p TdTdTdTdTd($*YTdTdTdn0Y0Y0Y0Y0Y($*a0Y0Y0Yfq+q+q+q+q+ dQq+q+q+h B0B0B0B0B0!4#VB0B0B0J(R(R(R(R(R!4#O(R(R(RVWWWWW t8WWWD AVAVAVAVAV"D$=AVAVAVH>>>>>"D$9>>>0\:\:\:\:\:  6\:\:\:~@=@=@=@=@=#T]@=@=@=F?????#T%:???0qYqYqYqYqY!AqYqYqYh 0U0U0U0U0U$d&F0U0U0Ufq*q*q*q*q* T=q*q*q*h 0Q0Q0Q0Q0Q $"B0Q0Q0Qfa3a3a3a3a340a3a3a3H b_b_b_b_b_  5b_b_b_J:::::  5:::0[_[_[_[_[_ D2[_[_[_|@.@.@.@.@.@.@.@.F;;;;;!6;;;0\:\:\:\:\:  6\:\:\:~?????#T%8???0\N\N\N\N\N!7\N\N\N~@@@@@$d&9@@@0PdPdPdPdPd!3PdPdPdf VKVKVKVKVK$d&8VKVKVKr@@@@@$d&9@@@0a3a3a3a3a340a3a3a3H b_b_b_b_b_  5b_b_b_J:::::  5:::0[_[_[_[_[_ D2[_[_[_|@.@.@.@.@.@.@.@.F;;;;;!6;;;0\:\:\:\:\:  6\:\:\:~?????#T%8???0\N\N\N\N\N!7\N\N\N~@@@@@$d&9@@@0PdPdPdPdPd!3PdPdPdf VKVKVKVKVK$d&8VKVKVKr@@@@@$d&9@@@@@r