Skip to main content

Exploratory data analysis package for data that is numeric in nature.

Project description

ci-cd

numeric_edahelper

Data scientists often spend alot of time preprocessing data to extract useful parts for their analysis. The numeric_edahelper package is a package that aims to streamline Exploratory Data Analysis, specifically for numeric data in datasets. The goal is to simplify some common and repetitive tasks during EDA and data preprocessing for data analysts, as well as add value to their workflow by presenting some useful insights in a quick manner (just calling our functions), such as displaying highly-correlated variables and outliers.

The package includes functions which can complete the following tasks:

  • Display some useful statistics
  • Detect outliers
  • Deal with missing values
  • Check for correlation between features

Installation

pip install numeric_edahelper

Usage

An example of how to use numeric_edahelper in Python:

import pandas as pd
import numpy as np

from numeric_edahelper.overview import overview
from numeric_edahelper.missing_imputer import missing_imputer
from numeric_edahelper.flag_outliers import flag_outliers
from numeric_edahelper.get_correlated_features import get_correlated_features

df = pd.DataFrame({'col1': [-100,-200, 1,2,3,4,5,6,7,8,9,np.nan, 1000], 
                   'col2': [1,2,3,4,5,6,7,8,9,10,11,12,13],
                   'col3': [-50, 1,2,3,4,5,6,7,8,9,10,11,50000]})
overview(df, quiet=False)
missing_imputer(df, method="median")
flag_outliers(df, threshold=0.2)
get_correlated_features(df, threshold=0.7)

Function descriptions

  • overview: This function calculates common descriptive statistical values of in the input data. Users can choose the extent of information that is returned and have the option to use the function as a means to create statistical variables to be used elsewhere in the environment.
  • flag_outliers: This function helps to display numeric variables which contain outliers that exceed a certain user-specified threshold percentage, using the interquartile range method. Users can then take note of these variables with high percentage of outliers and decide what to do with the variable(s).
  • missing_imputer:This function aims to detect missing values in the numeric data frame and using strategies including drop, mean or median to drop missing values or to replace them with the mean or median of other values in the same column.
  • get_correlated_features:This function will get pairs of features which have correlation above a threshold value. We can specify if we want to check only the magniture of correlation value or we also want to consider sign (positive/ negative).

Documentation

The official documentation is hosted on Read the Docs

Similar Work

In the Python open-source ecosystem, there exists some useful packages that already tackle EDA and preprocessing, but our goal is to make it even more light-weighted, fast and specifically tailored to present numeric EDA insights. One popular and useful package that can generate EDA reports is:

Contributors

We welcome all contributions and the current main contributors are:

  • Anupriya Srivastava
  • Jiwei Hu
  • Michelle Wang
  • Samuel Quist

License

Licensed under the terms of the MIT license.

Credits

numeric_edahelper was created with cookiecutter and the py-pkgs-cookiecutter template.

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

numeric_edahelper-1.0.7.tar.gz (6.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

numeric_edahelper-1.0.7-py3-none-any.whl (7.4 kB view details)

Uploaded Python 3

File details

Details for the file numeric_edahelper-1.0.7.tar.gz.

File metadata

  • Download URL: numeric_edahelper-1.0.7.tar.gz
  • Upload date:
  • Size: 6.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.7.1 importlib_metadata/4.10.1 pkginfo/1.8.2 requests/2.27.1 requests-toolbelt/0.9.1 tqdm/4.62.3 CPython/3.9.10

File hashes

Hashes for numeric_edahelper-1.0.7.tar.gz
Algorithm Hash digest
SHA256 519a7c669c3a005cebfcb9550be2ca07ba06c3df4d6ff231f4c3c215f539becf
MD5 00264287e0b93aba0302a5d7d75af528
BLAKE2b-256 a372cdf0e6582d52e7aa0010dbe6ff7bc7ca28b493029d613252919667bd2f06

See more details on using hashes here.

File details

Details for the file numeric_edahelper-1.0.7-py3-none-any.whl.

File metadata

  • Download URL: numeric_edahelper-1.0.7-py3-none-any.whl
  • Upload date:
  • Size: 7.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.7.1 importlib_metadata/4.10.1 pkginfo/1.8.2 requests/2.27.1 requests-toolbelt/0.9.1 tqdm/4.62.3 CPython/3.9.10

File hashes

Hashes for numeric_edahelper-1.0.7-py3-none-any.whl
Algorithm Hash digest
SHA256 95aa6a3b29dd1f3c421f3cc5f86402ccf2f4fcb3c828ae54ad5859cbe641a180
MD5 5bc95c356e49cfc9f58ba2c6f3eba307
BLAKE2b-256 9da6548d8c96014c254d329a17c406646774ddfcec52c8a74b2060ae268cc2d8

See more details on using hashes here.

Supported by

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