gL"UdZddlmZddlZddlmZddlmZmZm Z m Z m Z m Z m Z mZddlmZddlmZddlmZdd lmZdd lmZdd lmZdd lmZdd lmZmZm Z ddl!m"Z"ddl#m$Z%ddl&m'Z'ddl(m)Z)ddl*m+Z+m,Z,erddl-m.Z.ddl/Z/ddl0m1Z2ddl3m4Z4ddl5m6Z6ee dZ7de8d<e e7e9e7e:e;e7fddfZde8d <Gd!d"e d#$Z?Gd%d&e d#$Z@eGd'd(ZA d,d)ZBGd*d+ZCy)-z$Streamlit support for Plotly charts.) annotationsN) dataclass) TYPE_CHECKINGAnyFinalLiteral TypedDictUnioncastoverload) TypeAlias) type_util)show_deprecation_warning)AttributeDictionary)current_form_id)check_widget_policies) configure_streamlit_plotly_theme)Keycompute_and_register_element_idto_key)StreamlitAPIException) PlotlyChart)gather_metrics)get_script_run_ctx)WidgetCallbackregister_widget)Iterable) BaseFigure)DeltaGenerator)z go.Figurezgo.Datar _AtomicFigureOrDatarmatplotlib.figure.Figure FigureOrData)lassopointsbox SelectionMode>r%r#r$zFinal[set[SelectionMode]]_SELECTION_MODESc:eZdZUdZded<ded<ded<ded<y) PlotlySelectionStateat The schema for the Plotly chart selection state. The selection state is stored in a dictionary-like object that supports both key and attribute notation. Selection states cannot be programmatically changed or set through Session State. Attributes ---------- points : list[dict[str, Any]] The selected data points in the chart, including the data points selected by the box and lasso mode. The data includes the values associated to each point and a point index used to populate ``point_indices``. If additional information has been assigned to your points, such as size or legend group, this is also included. point_indices : list[int] The numerical indices of all selected data points in the chart. The details of each identified point are included in ``points``. box : list[dict[str, Any]] The metadata related to the box selection. This includes the coordinates of the selected area. lasso : list[dict[str, Any]] The metadata related to the lasso selection. This includes the coordinates of the selected area. Example ------- When working with more complicated graphs, the ``points`` attribute displays additional information. Try selecting points in the following example: >>> import streamlit as st >>> import plotly.express as px >>> >>> df = px.data.iris() >>> fig = px.scatter( ... df, ... x="sepal_width", ... y="sepal_length", ... color="species", ... size="petal_length", ... hover_data=["petal_width"], ... ) >>> >>> event = st.plotly_chart(fig, key="iris", on_select="rerun") >>> >>> event.selection .. output:: https://doc-chart-events-plotly-selection-state.streamlit.app height: 600px This is an example of the selection state when selecting a single point: >>> { >>> "points": [ >>> { >>> "curve_number": 2, >>> "point_number": 9, >>> "point_index": 9, >>> "x": 3.6, >>> "y": 7.2, >>> "customdata": [ >>> 2.5 >>> ], >>> "marker_size": 6.1, >>> "legendgroup": "virginica" >>> } >>> ], >>> "point_indices": [ >>> 9 >>> ], >>> "box": [], >>> "lasso": [] >>> } zlist[dict[str, Any]]r$z list[int] point_indicesr%r#N__name__ __module__ __qualname____doc____annotations__T/var/www/openai/venv/lib/python3.12/site-packages/streamlit/elements/plotly_chart.pyr)r)Ps#Ob !   r2r)F)totalceZdZUdZded<y) PlotlyStatea The schema for the Plotly chart event state. The event state is stored in a dictionary-like object that supports both key and attribute notation. Event states cannot be programmatically changed or set through Session State. Only selection events are supported at this time. Attributes ---------- selection : dict The state of the ``on_select`` event. This attribute returns a dictionary-like object that supports both key and attribute notation. The attributes are described by the ``PlotlySelectionState`` dictionary schema. Example ------- Try selecting points by any of the three available methods (direct click, box, or lasso). The current selection state is available through Session State or as the output of the chart function. >>> import streamlit as st >>> import plotly.express as px >>> >>> df = px.data.iris() # iris is a pandas DataFrame >>> fig = px.scatter(df, x="sepal_width", y="sepal_length") >>> >>> event = st.plotly_chart(fig, key="iris", on_select="rerun") >>> >>> event .. output:: https://doc-chart-events-plotly-state.streamlit.app height: 600px r) selectionNr+r1r2r3r6r6s%N$#r2r6c"eZdZdZdddZddZy)PlotlyChartSelectionSerdeziPlotlyChartSelectionSerde is used to serialize and deserialize the Plotly Chart selection state. cdggggdi}||n+ttttj|}d|vr|}ttt|S)Nr7)r$r*r%r#)r r6rjsonloads)selfui_value widget_idempty_selection_stateselection_states r3 deserializez%PlotlyChartSelectionSerde.deserializesk !# .  "k#6tzz(7K#LM  o -3OK!4_!EFFr2c8tj|tS)N)default)r;dumpsstr)r=rAs r3 serializez#PlotlyChartSelectionSerde.serializeszz/377r2N))r>z str | Noner?rFreturnr6)rAr6rIrF)r,r-r.r/rBrGr1r2r3r9r9sG*8r2r9ct|tr|h}n t|}|jtst d|dtg}|D]}|dk(r*|j tjj2|dk(r*|j tjja|dk(sg|j tjjt|S)z2Parse and check the user provided selection modes.zInvalid selection mode: z. Valid options are: r$r#r%) isinstancerFsetissubsetr'rappendPlotlyChartProtor&POINTSLASSOBOX)selection_modeselection_mode_setparsed_selection_modess r3parse_selection_moderVs.#&,-!0  & &'7 8#&~&67""2!3 5   , X % " ) )*:*H*H*O*O P w & " ) )*:*H*H*N*N O u $ " ) )*:*H*H*L*L M - % &&r2ceZdZe d dddd ddZe d ddddd ddZed  d ddd dd dd Zedd Zy) PlotlyMixin streamlitN)r$r%r#)themekeyrSc yNr1r=figure_or_datause_container_widthrZr[ on_selectrSkwargss r3 plotly_chartzPlotlyMixin.plotly_chartsr2rerun)rZr[rarSc yr]r1r^s r3rczPlotlyMixin.plotly_chart sr2rcignorec dddl}ddl}d|vr td|dvrtd|d|dvrt |std |d t |}|d k7} | r8t |} t |j|| rtt|nddd | tj|dr|jj|} n|jj|d} t} || _|xsd| _t%|j| _t)|j+di} | j-d|j+dd | j-d|j+dd |j.j1| d | _t5j6| | _t;}t=d|| j&| j2| j8|| || | _| r| j@jCtE|tG}tI| j>t |r|nd|jJ|jL|d}|jjOd| ttP|jRS|jjOd| S)aDisplay an interactive Plotly chart. `Plotly `_ is a charting library for Python. The arguments to this function closely follow the ones for Plotly's ``plot()`` function. To show Plotly charts in Streamlit, call ``st.plotly_chart`` wherever you would call Plotly's ``py.plot`` or ``py.iplot``. .. Important:: You must install ``plotly`` to use this command. Your app's performance may be enhanced by installing ``orjson`` as well. Parameters ---------- figure_or_data : plotly.graph_objs.Figure, plotly.graph_objs.Data, or dict/list of plotly.graph_objs.Figure/Data The Plotly ``Figure`` or ``Data`` object to render. See https://plot.ly/python/ for examples of graph descriptions. use_container_width : bool Whether to override the figure's native width with the width of the parent container. If ``use_container_width`` is ``True`` (default), Streamlit sets the width of the figure to match the width of the parent container. If ``use_container_width`` is ``False``, Streamlit sets the width of the chart to fit its contents according to the plotting library, up to the width of the parent container. theme : "streamlit" or None The theme of the chart. If ``theme`` is ``"streamlit"`` (default), Streamlit uses its own design default. If ``theme`` is ``None``, Streamlit falls back to the default behavior of the library. key : str An optional string to use for giving this element a stable identity. If ``key`` is ``None`` (default), this element's identity will be determined based on the values of the other parameters. Additionally, if selections are activated and ``key`` is provided, Streamlit will register the key in Session State to store the selection state. The selection state is read-only. on_select : "ignore" or "rerun" or callable How the figure should respond to user selection events. This controls whether or not the figure behaves like an input widget. ``on_select`` can be one of the following: - ``"ignore"`` (default): Streamlit will not react to any selection events in the chart. The figure will not behave like an input widget. - ``"rerun"``: Streamlit will rerun the app when the user selects data in the chart. In this case, ``st.plotly_chart`` will return the selection data as a dictionary. - A ``callable``: Streamlit will rerun the app and execute the ``callable`` as a callback function before the rest of the app. In this case, ``st.plotly_chart`` will return the selection data as a dictionary. selection_mode : "points", "box", "lasso" or an Iterable of these The selection mode of the chart. This can be one of the following: - ``"points"``: The chart will allow selections based on individual data points. - ``"box"``: The chart will allow selections based on rectangular areas. - ``"lasso"``: The chart will allow selections based on freeform areas. - An ``Iterable`` of the above options: The chart will allow selections based on the modes specified. All selections modes are activated by default. **kwargs Any argument accepted by Plotly's ``plot()`` function. Returns ------- element or dict If ``on_select`` is ``"ignore"`` (default), this command returns an internal placeholder for the chart element. Otherwise, this command returns a dictionary-like object that supports both key and attribute notation. The attributes are described by the ``PlotlyState`` dictionary schema. Example ------- The example below comes straight from the examples at https://plot.ly/python. Note that ``plotly.figure_factory`` requires ``scipy`` to run. >>> import streamlit as st >>> import numpy as np >>> import plotly.figure_factory as ff >>> >>> # Add histogram data >>> x1 = np.random.randn(200) - 2 >>> x2 = np.random.randn(200) >>> x3 = np.random.randn(200) + 2 >>> >>> # Group data together >>> hist_data = [x1, x2, x3] >>> >>> group_labels = ['Group 1', 'Group 2', 'Group 3'] >>> >>> # Create distplot with custom bin_size >>> fig = ff.create_distplot( ... hist_data, group_labels, bin_size=[.1, .25, .5]) >>> >>> # Plot! >>> st.plotly_chart(fig) .. output:: https://doc-plotly-chart.streamlit.app/ height: 550px rNsharingzThe `sharing` parameter has been deprecated and will be removed in a future release. Plotly charts will always be rendered using Streamlit's offline mode.)rYNzYou set theme="us" while Streamlit charts only support theme=”streamlit” or theme=None to fallback to the default library theme.)rfrdzYou have passed zH to `on_select`. But only 'ignore', 'rerun', or a callable is supported.rfF) on_change default_valuewrites_allowedenable_check_callback_rulesr!T)validate_figurerHconfigshowLink show_linklinkText link_text)validaterc)user_keyform_id plotly_spec plotly_configrSis_selection_activatedrZr` string_value)on_change_handler deserializer serializerctx value_type)* plotly.io plotly.toolsrrcallablerrdgr rris_typetools mpl_to_plotly!return_figure_from_figure_or_datarOr`rZrrudictget setdefaultioto_jsonspecr;rErnrridrSextendrVr9rrBrG_enqueuer6value)r=r_r`rZr[rarSrbplotlyrx is_callbackfigureplotly_chart_protornr}serde widget_states r3rczPlotlyMixin.plotly_chart1sN    $,  + +'!%)!!  / /8K'"9+.77  Sk!*h!6 !#9-K !=H$~y9d"$,7     ^-G H\\//?F\\CCDF./1D.#(;B %4TWW%="fjj2./*fjje&DE*fjje&DE"())"3"3FU"3"K$(JJv$6! " !@ &..*//,33)#9 3 !  "  - - 4 4$^4 ./E*"%%/7 /B)".. ??) L GG  ^-? @ \%7%78 877##N4FG Gr2ctd|S)zGet our DeltaGenerator.r)r )r=s r3rzPlotlyMixin.dgs$d++r2)T)r_r"r`boolrZLiteral['streamlit'] | Noner[ Key | NonerazLiteral['ignore']rS'SelectionMode | Iterable[SelectionMode]rbrrIr)r_r"r`rrZrr[rraz!Literal['rerun'] | WidgetCallbackrSrrbrrIr6)r_r"r`rrZrr[rraz+Literal['rerun', 'ignore'] | WidgetCallbackrSrrbrrIzDeltaGenerator | PlotlyState)rIr)r,r-r.r rcrpropertyrr1r2r3rXrXs %) .9C $" +   %@  %) .97>C $" +   5@  N#%)kH .9AIC kH$kH"kH + kH  kH?kH@kHkH &kH$kHZ,,r2rX)rSrrIz-set[PlotlyChartProto.SelectionMode.ValueType])Dr/ __future__rr; dataclassesrtypingrrrrr r r r typing_extensionsr rYrstreamlit.deprecation_utilr"streamlit.elements.lib.event_utilsr!streamlit.elements.lib.form_utilsrstreamlit.elements.lib.policiesr-streamlit.elements.lib.streamlit_plotly_themerstreamlit.elements.lib.utilsrrrstreamlit.errorsrstreamlit.proto.PlotlyChart_pb2rrOstreamlit.runtime.metrics_utilr7streamlit.runtime.scriptrunner_utils.script_run_contextrstreamlit.runtime.staterrcollections.abcr matplotlibplotly.graph_objs graph_objsgoplotly.basedatatypesrstreamlit.delta_generatorrr r0listrrFr"r&r'r)r6r9rVrXr1r2r3rs6+" !   (?B=AVU2K9VC("/8!"!&"Y   ! !"   i ##;< y<.H+HU 9EU p($)5($V 88 8<';'2'8T,T,r2