Skip to main content

Web Client for Visualizing Pandas Objects

Project description

image0


CircleCI PyPI Python Versions PyPI Conda ReadTheDocs codecov Downloads Open in VS Code

What is it?

D-Tale is the combination of a Flask back-end and a React front-end to bring you an easy way to view & analyze Pandas data structures. It integrates seamlessly with ipython notebooks & python/ipython terminals. Currently this tool supports such Pandas objects as DataFrame, Series, MultiIndex, DatetimeIndex & RangeIndex.

Origins

D-Tale was the product of a SAS to Python conversion. What was originally a perl script wrapper on top of SAS’s insight function is now a lightweight web client on top of Pandas data structures.

In The News

Tutorials

## Related Resources

Where To get It

The source code is currently hosted on GitHub at: https://github.com/man-group/dtale

Binary installers for the latest released version are available at the Python package index and on conda using conda-forge.

# conda
conda install dtale -c conda-forge
# if you want to also use "Export to PNG" for charts
conda install -c plotly python-kaleido
# or PyPI
pip install dtale

Getting Started

PyCharm

jupyter

image9

image10

Python Terminal

This comes courtesy of PyCharm image11 Feel free to invoke python or ipython directly and use the commands in the screenshot above and it should work

Issues With Windows Firewall

If you run into issues with viewing D-Tale in your browser on Windows please try making Python public under “Allowed Apps” in your Firewall configuration. Here is a nice article: How to Allow Apps to Communicate Through the Windows Firewall

Additional functions available programmatically

import dtale
import pandas as pd

df = pd.DataFrame([dict(a=1,b=2,c=3)])

# Assigning a reference to a running D-Tale process
d = dtale.show(df)

# Accessing data associated with D-Tale process
tmp = d.data.copy()
tmp['d'] = 4

# Altering data associated with D-Tale process
# FYI: this will clear any front-end settings you have at the time for this process (filter, sorts, formatting)
d.data = tmp

# Shutting down D-Tale process
d.kill()

# using Python's `webbrowser` package it will try and open your server's default browser to this process
d.open_browser()

# There is also some helpful metadata about the process
d._data_id  # the process's data identifier
d._url  # the url to access the process

d2 = dtale.get_instance(d._data_id)  # returns a new reference to the instance running at that data_id

dtale.instances()  # prints a list of all ids & urls of running D-Tale sessions

License

D-Tale is licensed under the GNU LGPL v2.1. A copy of which is included in LICENSE

Additional Documentation

Located on the main github repo

Project details


Release history Release notifications | RSS feed

This version

3.7.0

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

dtale-3.7.0.tar.gz (13.8 MB view details)

Uploaded Source

Built Distribution

dtale-3.7.0-py2.py3-none-any.whl (14.2 MB view details)

Uploaded Python 2 Python 3

File details

Details for the file dtale-3.7.0.tar.gz.

File metadata

  • Download URL: dtale-3.7.0.tar.gz
  • Upload date:
  • Size: 13.8 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.1 CPython/3.8.0

File hashes

Hashes for dtale-3.7.0.tar.gz
Algorithm Hash digest
SHA256 70d6a40bf2691f9fdff704c909e4eea0d73030d8c69b3e821f656e56a3bbbb99
MD5 9eb3538063cae9eae12d4845297bcf5e
BLAKE2b-256 f8cb5f2572e30010b636a87be69465e7ebbc67317b8e288991882c7f6f085d71

See more details on using hashes here.

Provenance

File details

Details for the file dtale-3.7.0-py2.py3-none-any.whl.

File metadata

  • Download URL: dtale-3.7.0-py2.py3-none-any.whl
  • Upload date:
  • Size: 14.2 MB
  • Tags: Python 2, Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.1 CPython/3.8.0

File hashes

Hashes for dtale-3.7.0-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 605ccad5cfeaafb117cdf8e6c216651dd3fdf3e8410da673b093822e442f6dd0
MD5 6274ab16e81b39414760e8ae48444a9d
BLAKE2b-256 87d2d1695b8eabca8d0215f238b0337acab1ed5d57e5f0644c056c6a68ad169d

See more details on using hashes here.

Provenance

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page