Skip to main content

A python package to support exploratory data analysis!

Project description

ci-cd Documentation Status Project Status: Active PyPI - Python Version PyPI - Version

pyeda31

This python package creates an exploratory data analysis utility designed to streamline the initial stages of data exploration and statistic overview. The three core functions are file validation, handling missing values, and generating summary statistics. pyead provided to users a practical toolkit for data preprocessing and exploration, enabling users to work more effectively with csv datasets in various projects.

Contributors

Catherine Meng, Jessie Zhang, Zheng He

Functions

  • check_csv
    Check if the given file is a CSV file by its extension.
  • missing_value_summary
    This function is to provide a summary of missing values in the dataset.
  • get_summary_statistics
    Generate summary statistics for specified columns or all columns if none are provided.

Contributing to the Python Ecosystem

The pyeda31 package complements the Python ecosystem by providing simple and efficient tools for users to implement quick EDA in the first step of their analysis. While there are some other similar Python packages such as Sweetviz (in-depth EDA with a focus on visualization) and perform-eda (providing comprehensive EDA analysis), these tools can be too heavyweight for quick analysis. Instead, our pyeda31 package aims for simplicity and efficiency, enabling users to quickly complete the most basic and important steps, including validating dataset formats, checking for missing values, and generating statistical summaries for columns of interest. It is a lightweight alternative for small-scale tasks or the initial understanding of the dataset for in_depth research. Users can also combine pyeda31 with other visualization packages for deeper insights.

Installation

$ pip install pyeda31

Usage

pyeda31 can be used to verify the format of data files and perform basic exploratory data analysis as follows:

from pyeda31.check_csv import check_csv
from pyeda31.pymissing_values_summary import missing_values_summary
from pyeda31.data_summary import get_summary_statistics

Check if the given data file is in csv format

data_file_path = "docs/sample_data.csv"  # path to your data file
if not check_csv(data_file_path):
    raise TypeError("The given file is not in CSV format. Please check your data file.")

Check if the data file has any missing values

df = pd.read_csv(data_file_path)

missing_summary = missing_values_summary(df)
print("Missing Values Summary:")
print(missing_summary)

Get the data summary for either all columns or the specified columns of our dataset

get_summary_statistics(df)
get_summary_statistics(df, col=["numeric", "categorical"])   

Contributing

Interested in contributing? Check out the contributing guidelines. Please note that this project is released with a Code of Conduct. By contributing to this project, you agree to abide by its terms.

License

pyeda31 was created by Catherine Meng, Jessie Zhang, Zheng He. It is licensed under the terms of the MIT license.

Credits

pyeda31 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

pyeda31-1.3.0.tar.gz (4.4 kB view details)

Uploaded Source

Built Distribution

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

pyeda31-1.3.0-py3-none-any.whl (5.6 kB view details)

Uploaded Python 3

File details

Details for the file pyeda31-1.3.0.tar.gz.

File metadata

  • Download URL: pyeda31-1.3.0.tar.gz
  • Upload date:
  • Size: 4.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.12.8

File hashes

Hashes for pyeda31-1.3.0.tar.gz
Algorithm Hash digest
SHA256 4eca9d44bb04841c5cc71cdae5660f9cd8632b257e661b87b35ffd7fdac1be0d
MD5 dc3d1230529d1119362f1e1c11b47d8e
BLAKE2b-256 cc06f9adb4f22f29cdf199e0607493071a0d1cc4cba81253d0eb64d31fc47eb9

See more details on using hashes here.

File details

Details for the file pyeda31-1.3.0-py3-none-any.whl.

File metadata

  • Download URL: pyeda31-1.3.0-py3-none-any.whl
  • Upload date:
  • Size: 5.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.12.8

File hashes

Hashes for pyeda31-1.3.0-py3-none-any.whl
Algorithm Hash digest
SHA256 f55a5b45bfbae0a5e225c5790e0e0218ba96b3a61eece2fd7e4246be3db3ac27
MD5 6eeabfa8aa94e912488fad5f974c5e1c
BLAKE2b-256 aac276a1515e311620b06d9dd2154a8d903eb9d8512446435e8cba78e939a041

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