📊 Documentação Oficial do Plotly Python
| # | Comando / Função / Parâmetro | O que faz | Exemplo |
|---|---|---|---|
| 1 | px.scatter() | Gráfico de dispersão interativo | px.scatter(df, x='x', y='y', color='cat') |
| 2 | px.line() | Gráfico de linhas (séries temporais) | px.line(df, x='data', y='valor') |
| 3 | px.area() | Gráfico de área preenchida | px.area(df, x='ano', y='pop') |
| 4 | px.density_contour() | Contornos de densidade 2D | px.density_contour(df, x='x', y='y') |
| 5 | px.density_heatmap() | Mapa de calor de densidade 2D | px.density_heatmap(df, x='x', y='y') |
| 6 | px.histogram() | Histograma com suporte a bins automáticos | px.histogram(df, x='total_bill') |
| 7 | px.box() | Boxplot interativo com outliers visíveis | px.box(df, y='gorjeta', x='dia') |
| 8 | px.violin() | Gráfico de violino (distribuição KDE) | px.violin(df, y='valor', box=True) |
| 9 | px.ecdf() | Função de distribuição cumulativa empírica | px.ecdf(df, x='valor') |
| 10 | px.strip() | Gráfico de tiras (pontos individuais) | px.strip(df, x='cat', y='val') |
| 11 | px.bar() | Gráfico de barras (empilhado ou lado a lado) | px.bar(df, x='mes', y='venda', barmode='group') |
| 12 | px.pie() | Gráfico de pizza | px.pie(df, values='pop', names='pais') |
| 13 | px.sunburst() | Gráfico solar hierárquico | px.sunburst(df, path=['dia', 'hora'], values='venda') |
| 14 | px.treemap() | Mapa de árvore para dados hierárquicos | px.treemap(df, path=['continente', 'pais']) |
| 15 | px.funnel() | Gráfico de funil (etapas de processo) | px.funnel(df, x='etapa', y='usuarios') |
| 16 | px.icicle() | Visualização de hierarquia em cascata | px.icicle(df, path=['A', 'B']) |
| 17 | px.choropleth() | Mapas coropléticos (preenchimento por região) | px.choropleth(df, locations='iso', color='pib') |
| 18 | px.scatter_geo() | Pontos em mapas geográficos | px.scatter_geo(df, locations='iso', size='pop') |
| 19 | px.scatter_mapbox() | Mapas detalhados via Mapbox | px.scatter_mapbox(df, lat='lat', lon='lon', zoom=3) |
| 20 | px.density_mapbox() | Mapa de calor sobre coordenadas geográficas | px.density_mapbox(df, lat='lat', lon='lon', z='val') |
| 21 | px.scatter_3d() | Dispersão em três dimensões | px.scatter_3d(df, x='x', y='y', z='z') |
| 22 | px.line_3d() | Linha em espaço tridimensional | px.line_3d(df, x='x', y='y', z='z') |
| 23 | px.scatter_matrix() | Matriz de dispersão (SPLOM) | px.scatter_matrix(df, dimensions=['a', 'b', 'c']) |
| 24 | px.parallel_coordinates() | Coordenadas paralelas para dados multivariados | px.parallel_coordinates(df, color='classe') |
| 25 | px.parallel_categories() | Visualização de fluxos categóricos | px.parallel_categories(df) |
| 26 | color= | Mapeia uma coluna para a cor dos elementos | color='continente' |
| 27 | symbol= | Mapeia uma coluna para o estilo do marcador | symbol='sexo' |
| 28 | size= | Mapeia uma coluna para o tamanho do marcador | size='populacao' |
| 29 | hover_name= | Define o título do tooltip (balão informativo) | hover_name='nome_cliente' |
| 30 | hover_data= | Adiciona colunas extras ao tooltip | hover_data=['idade', 'cargo'] |
| 31 | text= | Exibe texto diretamente no gráfico | text='sigla' |
| 32 | facet_col= | Cria subplots em colunas baseado em uma variável | facet_col='ano' |
| 33 | facet_row= | Cria subplots em linhas baseado em uma variável | facet_row='regiao' |
| 34 | animation_frame= | Cria animação baseada no tempo ou categoria | animation_frame='ano' |
| 35 | animation_group= | Define consistência dos objetos entre frames | animation_group='pais' |
| 36 | trendline= | Adiciona linha de tendência ('ols' ou 'lowess') | trendline='ols' |
| 37 | marginal_x= | Adiciona gráfico marginal ('box', 'violin', 'rug') | marginal_x='box' |
| 38 | log_x= / log_y= | Ativa escala logarítmica nos eixos | log_x=True |
| 39 | color_discrete_sequence | Define paleta para cores categóricas | color_discrete_sequence=px.colors.qualitative.Plotly |
| 40 | color_continuous_scale | Define escala para cores numéricas | color_continuous_scale='Viridis' |
| 41 | go.Figure() | Cria objeto de figura base | fig = go.Figure() |
| 42 | fig.add_trace() | Adiciona uma nova camada/traço ao gráfico | fig.add_trace(go.Scatter(x=x, y=y)) |
| 43 | go.Bar() | Objeto de barra de baixo nível | go.Bar(name='Vendas', x=meses, y=valores) |
| 44 | go.Heatmap() | Mapa de calor básico | go.Heatmap(z=[[1, 2], [3, 4]]) |
| 45 | go.Candlestick() | Gráfico financeiro de velas | go.Candlestick(open=o, high=h, low=l, close=c) |
| 46 | go.Waterfall() | Gráfico de cascata financeira | go.Waterfall(x=['Venda', 'Custo'], y=[100, -40]) |
| 47 | go.Sankey() | Diagrama de fluxos Sankey | go.Sankey(node=dict(...), link=dict(...)) |
| 48 | go.Indicator() | Exibição de métricas (KPIs) e medidores | go.Indicator(mode='gauge+number', value=450) |
| 49 | fig.update_layout() | Atualiza títulos, legendas e dimensões | fig.update_layout(title='Meu Título', width=800) |
| 50 | fig.update_xaxes() | Customiza eixo X (rótulos, ranges, grades) | fig.update_xaxes(showgrid=False) |
| 51 | fig.update_yaxes() | Customiza eixo Y | fig.update_yaxes(title_text='Valores') |
| 52 | fig.update_traces() | Atualiza propriedades de todos os traços | fig.update_traces(marker_color='red') |
| 53 | fig.add_hline() | Adiciona linha horizontal de referência | fig.add_hline(y=100, line_dash='dash') |
| 54 | fig.add_vrect() | Adiciona um retângulo vertical de destaque | fig.add_vrect(x0=1, x1=2, fillcolor='blue') |
| 55 | fig.show() | Exibe o gráfico no navegador ou notebook | fig.show() |
| 56 | fig.write_html() | Exporta gráfico como arquivo HTML interativo | fig.write_html('grafico.html') |
| 57 | fig.write_image() | Exporta gráfico como imagem estática (PNG/JPG/PDF) | fig.write_image('plot.png') |
| 58 | make_subplots() | Cria grade de múltiplos gráficos (go) | make_subplots(rows=2, cols=2) |
| 59 | template= | Define o tema visual ('plotly_dark', 'seaborn', etc) | template='plotly_dark' |