Skip to main content

Directions overlay for working with pandas in an analysis environment

Project description

logo dovpanda

pypi Build Status Documentation Status Updates python3 license

Directions OVer PANDAs

Directions are hints and tips for using pandas in an analysis environment. dovpanda is an overlay companion for working with pandas in an analysis environment.
It is an overlay module that tries to understand what you are trying to do with your data, and helps you make you code more concise with readable.
If you think your task is common enough, it probably is, and pandas probably has a built-in solution. dovpanda will help you find them.

Usage

Hints

The main usage of dovpanda is its hints mechanism, which is very easy and works out-of-the-box. Just import it after you import pandas, whether inside a notebook or in a console.

import pandas as pd
import dovpanda

This is it. From now on you can expect dovpanda to come up with helpful hints while you are writing your code.

Notebook

Running dovpanda in a notebook environment will display rendered dismissable html.
random tip

Console

df = pd.DataFrame({'a':list('xxyy'),'b':[40,50,60,70], 'time':['18:02','18:45','20:12','21:50']})
df['time'] = pd.to_datetime(df.time)
df['hour'] = df.time.dt.hour
df.groupby('hour').b.sum()
===== Seems like you are grouping by a column named 'hour', consider setting the your
time column as index and then use df.resample('h') =====
Out[4]:
hour
18    90
20    60
21    70
Name: b, dtype: int64

Installation

pip install dovpanda

Extended Usage

Random Tips

dovpanda.tip() will give you a random pandas tip.
random tip

Change Display

use dovpanda.set_output if you want to change output.

In [14]: dovpanda.set_output('display')
In [15]: df.iterrows()
===== iterrows is not recommended, and in the majority of cases will have better alternatives =====
Out[15]: <generator object DataFrame.iterrows at 0x110fe4318>

In [16]: dovpanda.set_output('print')
In [17]: df.iterrows()
iterrows is not recommended, and in the majority of cases will have better alternatives
Out[17]: <generator object DataFrame.iterrows at 0x112c408b8>

In [18]: dovpanda.set_output('warning')
In [19]: df.iterrows()
WARNING:dovpanda:iterrows is not recommended, and in the majority of cases will have better alternatives
Out[19]: <generator object DataFrame.iterrows at 0x110ee7e58>

In [20]: dovpanda.set_output('off')

In [21]: df.iterrows()
Out[21]: <generator object DataFrame.iterrows at 0x1047c4d68>


BTW

"dov" means bear in Hebrew logo

Documentation

The full documentation is at http://dovpanda.rtfd.org.

History

0.0.5 (2019-11-11) ++++++++++++++++++

  • dovpanda errors don't crash panda

  • Errors in functionality of dovpanda will only tell the user it happened but let them continue the work

  • fix read_csv issue #76

  • fix at/iat issues when calling shape on str #77

0.0.4 (2019-11-09) ++++++++++++++++++

  • fix to import error issue #71

0.0.3 (2019-11-08) ++++++++++++++++++

  • First published release

0.0.2 (2019-10-30) ++++++++++++++++++

  • First release on PyPI.

Project details


Download files

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

Source Distribution

dovpanda-0.0.5.tar.gz (27.1 kB view hashes)

Uploaded Source

Built Distribution

dovpanda-0.0.5-py2.py3-none-any.whl (21.8 kB view hashes)

Uploaded Python 2 Python 3

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