[FEATURE]: Make Plotly Express dataframe implementation-agnostic
Ninguém assumiu esta issue ainda.
Avaliação
- Dificuldade
- 4/5
- Tempo estimado
- 3-5 dias
- Facilidade para iniciantes
- 58/100
- Tipo de issue
- Funcionalidade
- Clareza
- Razoavelmente clara
- Status de atividade
- Pouca atividade
- Stack de tecnologia
- pandas, python
- Domínio
- data-visualization
Direção de pesquisa
Comece em plotly/express/_core.py lendo to_named_series() e process_args_into_dataframe() e, em seguida, revise como o Narwhals recebe o namespace nativo do dataframe. Execute o exemplo de barras do Getting Started com pandas indisponível e Polars instalado e verifique se o exemplo funciona, enquanto o erro de provedor ausente permanece informativo quando nenhum dos dois provedores está disponível.
Escrita pelo modelo de indexação a partir do texto da issue.
Descrição
[FEATURE]: Make Plotly Express dataframe implementation-agnostic
Description
For a long time, there's been questions around how tightly Plotly Express depends on pandas. For example, here's a program from the Getting Started page that's supposed to show how easy it is to make a simple plot with Plotly Express:
import plotly.express as px
fig = px.bar(x=["a", "b", "c"], y=[1, 3, 2])
fig.show()
But if you run this with only plotly[express] installed, you get an error stating that pandas is required:
Traceback (most recent call last):
File "/.../plotly/express/_core.py", line 1210, in to_named_series
import pandas as pd
ModuleNotFoundError: No module named 'pandas'
...
NotImplementedError: Pandas installation is required if no dataframe is provided.
I think I understand this error; Plotly doesn't want to require pandas, when there are other dataframe-based libraries that people are choosing such as Polars. However, this message appears even if you have Polars installed. I think we can make Plotly Express more agnostic toward dataframe providers by looking for an available provider, rather than exiting if pandas is not found.
Why should this feature be added?
Plotly claims to not require pandas, but it still requires pandas in places where other dataframe implementations seem to work.
Mocks/ designs
I made some small changes to plotly/express/_core.py, which allows the above example to work with Polars installed. First, add a new function to look for an existing library that supports dataframes through narwhals:
def get_df_implementation():
"""Get an installed dataframe implementation."""
for df_implementation in ("pandas", "polars"):
try:
return import_module(df_implementation)
except ImportError:
pass
msg = (
"A dataframe implementation such as Pandas or Polars is required if "
"no dataframe is provided."
)
raise NotImplementedError(msg)
This POC version looks for pandas first, and then Polars.
The only change in the function to_named_series() is to call get_df_implemenation() in the else block, instead of doing its own check for pandas:
def to_named_series(x, name=None, native_namespace=None):
...
if isinstance(x, nw.Series):
return x.rename(name)
elif native_namespace is not None:
return nw.new_series(name=name, values=x, native_namespace=native_namespace)
else:
df_implementation = get_df_implementation()
return nw.new_series(name=name, values=x, native_namespace=df_implementation)
The existing function process_args_into_dataframe() needs one call to get_df_implemenation() as well:
def process_args_into_dataframe(
args, wide_mode, var_name, value_name, is_pd_like, native_namespace
):
...
length = len(df_output[next(iter(df_output))]) if len(df_output) else 0
if native_namespace is None:
native_namespace = get_df_implementation()
if ranges:
import numpy as np
...
With these changes, the above example runs without errors when Polars is installed. When pandas and Polars are both unavailable, the error states that one of these libraries must be installed.
Notes
I'm not tied to this particular implementation in any way, this was just a proof of concept to see if we could make Plotly more agnostic about the dataframe provider.
Is this a direction that's worth pursuing? I'm happy to work on a PR if it is, or happy to see others more versed in Plotly's internals implement it.
- Linguagem predominante
- Python
- Estrelas
- 18.8k
- Forks
- 2.8k
- Merge médio
- 16h 26min
- PRs com merge (30d)
- 21
Guia de contribuição
Primeiros passos
- Leia a issue inteira e depois o guia de contribuição do projeto.
- Comente na issue dizendo que vai assumir — evita que duas pessoas façam o mesmo trabalho.
- Faça um fork do repositório e trabalhe em uma branch.
- Abra um pull request que referencie o número da issue.
Mais de plotly/plotly.py
-
P3 size: 1 task
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 72/100
-
bug P1
Dificuldade 1/5 Menos de uma hora Facilidade para iniciantes 68/100
-
feature P3
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 62/100
-
feature P3
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 72/100
-
Dificuldade 3/5 1-2 dias Facilidade para iniciantes 35/100
Todas as issues de plotly/plotly.py
Issues semelhantes
-
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 65/100
qgis/QGIS-Documentation#11275 ·
-
bug priority:normal ready-for-dev
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 88/100
OpenHands/extensions#626 · 1 comentário ·
-
Dificuldade 1/5 Menos de uma hora Facilidade para iniciantes 90/100
CSCfi/sd-search-api#39 ·
-
Dificuldade 1/5 Menos de uma hora Facilidade para iniciantes 90/100
-
please add to porn list Aberta
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 68/100
StevenBlack/hosts#3255 ·