Skip to main content

Correlation analysis tool with smart interpretation

Project description

🧠 CorrPY – Correlation Made Easy

PyPI version Downloads License Python


CorrPY is your lightweight buddy for fast, smart correlation analysis.
Forget just numbers — CorrPY tells you what they mean. 📊✨

Built for data scientists who want insights, not just values.


🚀 Install

pip install corrpy

📦 Quickstart

from corrpy import Corrpy

corrpy = Corrpy()
corrpy.getTotalCorrRelation(df)

✅ Analyze correlation across features
✅ Get trends + easy-to-read interpretations
✅ Go deeper with AI explanations (optional)


🔥 Key Features

  • Numerical vs Numerical — Classic correlations + strength.
  • Object vs Numerical — Category impacts, clear trends.
  • Object vs Object — Categorical association (Chi2).
  • Transitive Trap Alerts — Detect hidden indirect links. 🚨
  • AI-Generated Insights — Explain data like a boss 🧠📜

Methods

  1. getTotalCorrRelation(df, features = ["Correlation", "Pearson", "Distance"], feature = "Correlation", short = False): Pass a pandas DataFrame to get correlation analysis across all columns and get trends, interpretations and score with respect to feature u added in parameter.
  2. getGroupInf(objColumn, numColumn, df): Compute the correlation between the given object column and the given numeric column.
  3. getAllGroupInf(df): Compute the correlation between all object columns and all numeric columns.
  4. checkTransit(firstFeature, secondFeature, ThirdFeature): Check for transitive correlation between three features.
  5. checkTransitForColumn(column, df): Check for transitive correlation between a column and all other columns.

AI-Generated Insights

  1. explainTC(df, feature="Correlation", prompt="null"): Get AI insights for correlation analysis.
  2. explainShift(num1, num2, shiftValue, df, prompt="Explain like a stand-up comedian"): An AI analyst explains the output of shift() like you're in a meeting with your CEO.
  3. explainTransit(num1, num2, df, prompt="Explain like Angry Professor"): Get AI insights for transitive correlation analysis.
  4. explainTransitForcolumn(column, df, prompt="Explain like Oppenheimer"): An AI analyst explains the output of checkTransitForColumn() like you're in a meeting with your CEO.
  5. explainAI(result, prompt="Explain like angry professor"): Get AI insights for any result.
  6. makeReport(self, method="null", df=None, column=None, feature=None, target=None, prompt="Null", size="short", constant=None, first=None, second=None, third=None): Generate a human-like, well-written paragraph suitable for direct pasting into a PowerPoint slide, based on the output of other methods.

🧠 Example Insights

"Age and Fare have a moderate positive correlation.
Pclass has a strong inverse relation with Fare."

✨ Plus visual trends, interpretation tags, and more!


👨‍💻 Author

YellowForest
🔗 GitHub


📄 License

BSD 3-Clause License


⚡ TL;DR

# What CorrPY Gives You
🚀 Quick, meaningful correlation analysis
🤖 AI-driven explanations
🧩 Find hidden patterns
🔥 Detect transitive traps
🎯 Ideal for both beginners and pros

📢 FINAL NOTE:

CorrPY isn't just another EDA tool...
It's your data's best storyteller. 📚🚀


🧹 How to use:

  • README for Quick Start 📑
  • Full GUIDE.md for Deep Dive 📚

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

corrpy-0.4.11.tar.gz (13.4 kB view details)

Uploaded Source

Built Distribution

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

corrpy-0.4.11-py3-none-any.whl (13.6 kB view details)

Uploaded Python 3

File details

Details for the file corrpy-0.4.11.tar.gz.

File metadata

  • Download URL: corrpy-0.4.11.tar.gz
  • Upload date:
  • Size: 13.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.10.11

File hashes

Hashes for corrpy-0.4.11.tar.gz
Algorithm Hash digest
SHA256 cec4d3ef15256bb2c933acfd0357877117a1d3584aa14f98a1d5c239d2ab717f
MD5 fa4f9c4e4a99004ca2d5b64ec1ab8928
BLAKE2b-256 3243523c460ba13dab854b1fef1bc0b67aaaa2028ee0f07e7471f62f4183f9c4

See more details on using hashes here.

File details

Details for the file corrpy-0.4.11-py3-none-any.whl.

File metadata

  • Download URL: corrpy-0.4.11-py3-none-any.whl
  • Upload date:
  • Size: 13.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.10.11

File hashes

Hashes for corrpy-0.4.11-py3-none-any.whl
Algorithm Hash digest
SHA256 be0329c4cf5b08957c5e5dd00b632a3016a5af1d46c174bb93f2d2a8bdadee93
MD5 648630d913d976f503629346574a915b
BLAKE2b-256 f1a289b1a6e1fd61fc7f599073740231014f64b3169236b1301985b83c1ece3e

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