U
ꥡcK$ @ s d dl Z d dlZd dlZd dlZd dlZd dlmZ d dlZd dlZd dl m
Z
d dl m Z d dl
mZ d dlmZ d dlmZ dd lmZmZmZmZ d d
lmZ d d lmZ d Z e d
Z e dZ e dZ dddZ!dd Z"G dd deZ#dd Z$dd Z%dS ) N)
itemgetter)nodes)ViewList) Directive)flag)nested_parse_with_titles )get_docstring_and_restprev_this_nextcreate_thumbnailcreate_generic_image)
eval_block)
iter_exampleszaltair.examplesa
.. This document is auto-generated by the altair-gallery extension. Do not modify directly.
.. _{{ gallery_ref }}:
{{ title }}
{% for char in title %}-{% endfor %}
This gallery contains a selection of examples of the plots Altair can create.
Some may seem fairly complicated at first glance, but they are built by combining a simple set of declarative building blocks.
Many draw upon sample datasets compiled by the `Vega `_ project. To access them yourself, install `vega_datasets `_.
.. code-block:: none
$ pip install vega_datasets
{% for grouper, group in examples %}
.. _gallery-category-{{ grouper }}:
{{ grouper }}
{% for char in grouper %}~{% endfor %}
.. raw:: html
{% for example in group %}
{{ example.title }}
{% endfor %}
.. toctree::
:hidden:
{% for example in group %}
{{ example.name }}
{%- endfor %}
{% endfor %}
a1
.. raw:: html
{% for example in examples %}
{% endfor %}
z
.. This document is auto-generated by the altair-gallery extension. Do not modify directly.
.. _gallery_{{ name }}:
{{ docstring }}
.. altair-plot::
{% if code_below %}:code-below:{% endif %}
{{ code | indent(4) }}
.. toctree::
:hidden:
Tc
C s t j|st | t j|d}t j|rPt|}t|}W 5 Q R X ni }| D ]}|d d }t j||}t |d
} | |d| k}
|
rt j|rt
d| n|t
d| t|d } z| | | ||< W n( tk
r td t| Y nX t|d }t|| W 5 Q R X |rX| d
i } t j||d d }
t||
f| qXt|d }t|| W 5 Q R X d S )
z-Save example pngs and (optionally) thumbnailsz_image_hashes.jsonnamez.pngcode z-> using cached {}z -> saving {}z)Unable to save image: using generic imagewZgalleryParametersz
-thumb.pngN)ospathexistsmakedirsjoinopenjsonloadhashlibmd5encode hexdigestgetprintformatr
save ImportErrorwarningswarnr dumpr )examples image_dirZmake_thumbnails hash_filefhashesexamplefilenameZ
image_fileZ example_hashZ hashes_matchZchartparamsZ
thumb_file r/ B/tmp/pip-unpacked-wheel-y9_o96ar/altair/sphinxext/altairgallery.pysave_example_pngsr s<
r1 c K sr t t tdd}|D ]V}t|d \}}}}|| |dkrDd}||| dd || |d q|S ) z0Iterate through Altair examples and extract coder keyr- Nz other charts
r ) docstringtitler categorylineno)sortedr r r updatestripsplitr6 )kwdsr' r, r5 r7 r r8 r/ r/ r0 populate_examples s
r> c @ s0 e Zd ZdZeedd eeeedZdd Z dS )AltairMiniGalleryDirectiveFc C s t tt| S )N)listmapintr< xr/ r/ r0 z#AltairMiniGalleryDirective.)sizenamesindicesshuffleseedtitleswidthc sh | j dd}dd | j dddD }| j dg }d | j k}| j d
d }| j d d
}| j dd }| jjjj}|j} | jj j
}
t |rt ||k rt
ddd D fdd|D n@|r fdd|D |rt| t |r
d | tjd|
||d} t } | dD ]}
| |
d q.t }| jj|_t| j| | |jS )NrG c S s g | ] }| qS r/ )r; .0r r/ r/ r0
s z2AltairMiniGalleryDirective.run..rH r ,rI rJ rK * rL FrM zValtair-minigallery: if names are specified, the list must be at least as long as size.c S s i | ]}|d |qS )r r/ )rP r, r/ r/ r0
s z2AltairMiniGalleryDirective.run..c s g | ] } | qS r/ r/ rO )mappingr/ r0 rQ s c s g | ] } | qS r/ r/ )rP i)r' r/ r0 rQ s /_static)r( gallery_dirr' rL rM r4 z)optionsr r< statedocumentsettingsenvappbuilderconfigaltair_gallery_dirr> len
ValueErrorrandomrK rJ MINIGALLERY_TEMPLATErenderr appendr Z paragraphr children)selfrG rH rI rJ rK rL rM r] r^ rX includeresultlinenoder/ )r' rU r0 run sN
z AltairMiniGalleryDirective.runN)
__name__
__module__ __qualname__Z has_contentrB strr boolZ option_specrn r/ r/ r/ r0 r? s
r? c C s | j jj}tj| j j|}tj| j jd}| j jj}| j jj}t |dd}tj
|sdt | t |dd d}t
g g g g g g g g g g g d }|D ]}||d | qttj|d d
"} | tj|| d |d W 5 Q R X t|| t|D ]\}
} } |
r d
jf |
| d< | r6d
jf | | d< tj|| d d }
ttj|
d
dd} | t| W 5 Q R X q d S )NZ_imagesT) gallery_refZ
code_belowc S s | d S )Nr6 r/ rC r/ r/ r0 rE rF zmain..r2 ) z
Simple Chartsz
Bar Chartsz Line Chartsz Area ChartszCircular Plotsz
Scatter PlotsZ
HistogramsZMapszInteractive Chartsz Case Studiesz Other Chartsr7 z index.rstr rW )r6 r' r( rt zgallery_{name}Zprev_refZnext_refr z.rstzutf-8)encoding)r_ r` ra r r r srcdiraltair_gallery_refaltair_gallery_titler> r r r9 collections OrderedDictrg r writeGALLERY_TEMPLATErf itemsr1 r
r! EXAMPLE_TEMPLATE)r^ rX
target_dirr( rt Z
gallery_titler' Z examples_tocdr* Zprev_exr, Znext_exZtarget_filenamer/ r/ r0 main sV
r c C sR | dt | d | ddd | ddd | dd d | d
d t d S ) Nzbuilder-initedzaltair-gallery.cssra Zgalleryr] rw zexample-galleryrx zExample Gallerypyzaltair-minigallery)connectr Z add_css_fileZadd_config_valueZadd_directive_to_domainr? )r^ r/ r/ r0 setup1 s
r )T)&r r r rd ry operatorr r$ Zjinja2Zdocutilsr Zdocutils.statemachiner Zdocutils.parsers.rstr Z docutils.parsers.rst.directivesr Zsphinx.util.nodesr utilsr r
r r Zaltair.utils.execevalr
Zaltair.examplesr ZEXAMPLE_MODULETemplater| re r~ r1 r> r? r r r/ r/ r/ r0 s< 1
/A8