bvista 0.1.11

B-Vista: A powerful data visualization and exploration tool for pandas DataFrames.

---

📊 B-vista

Visual, Scalable, and Real-Time Exploratory Data Analysis — Built for modern notebooks and the browser.

---

B-vista

B-vista is a full-stack Exploratory Data Analysis (EDA) interface for pandas DataFrames. It connects a Flask + WebSocket backend to a dynamic React frontend, offering everything from descriptive stats to missing data diagnostics — in real-time.

---

🎯 Designed for:

• Data Scientists, Analysts, Educators
• Teams collaborating over datasets
• Anyone who loves pandas but needs better visuals

🛠️ Built with: Python · Flask · WebSockets · React · Plotly · ECharts · Pandas · NumPy

---

📚 Contents

• ✨ Features
• 🚀 Quickstart
• 📦 Installation
• 🛠️ Environment & Compatibility
• 📘 Documentation
• 📈 Usage Examples
• 💡 In the News
• 🧑‍💻 Developer Setup
• 📂 Project Structure
• 🤝 Contributing
• 🔖 Versioning
• 📄 License

---

✨ Features

• 📈 Descriptive Statistics — Instant stats (mean, std, quantiles) per column
• 📊 Correlation Matrix — Heatmaps for Pearson/Spearman correlations
• 📉 Distribution Analysis — Histograms, KDEs, boxplots by column
• 🧼 Missing Data Detection — Visual analysis (MCAR, MAR, NMAR)
• 🛠️ Data Cleaning — Forward/backward fill, interpolation, median, mode, etc.
• 🔁 Data Transformation — Normalize, standardize, cast, and rename columns
• 📂 CSV Uploads — Drag and drop from your browser
• 🧪 Jupyter Notebook Integration — Launch with bvista.show(df)
• 📡 Real-time Sync — WebSocket-powered updates between sessions
• 🌐 Web-based UI — Modern interface powered by React + Vite

🔍 See full feature breakdown →

---

🚀 Quickstart

The fastest way to get started (in a notebook):

import pandas as pd
import bvista

df = pd.read_csv("your_dataset.csv")
bvista.show(df)

Or from the terminal:

git clone https://github.com/Baci-Ak/b-vista.git
cd b-vista
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
pip install -e .
python backend/app.py

Frontend runs separately:

cd frontend
npm install
npm start

---

📦 Installation

🧪 From Source (Editable Mode)

git clone https://github.com/Baci-Ak/b-vista.git
cd b-vista
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
pip install -e .

💡 You must also start the frontend — see Frontend Setup

---

📦 Conda Environment (Optional)

conda create -n bvista python=3.10
conda activate bvista
pip install -r requirements.txt
pip install -e .

---

🔹 PyPI (coming soon)

pip install bvista

---

🐳 Docker (planned)

Future releases will support Dockerized deployment.

---

🛠️ Environment & Compatibility

Tool	Version
Python	≥ 3.7 (tested on 3.10)
Node.js	^18.x
npm	^9.x

---

🧩 Common Setup Fixes

• npm start fails:

  rm -rf node_modules package-lock.json
  npm install
  

• Flask not reachable: check localhost:5050, free port, or restart backend

• WebSocket not connecting: ensure both backend and frontend are live

---

📘 Documentation

• Getting Started
• Installation
• Web UI Guide
• Notebook Integration
• API Endpoints
• WebSocket Events
• EDA Features
• Dev Architecture

🔗 See /docs folder for all guides

---

📈 Usage Examples

1. Notebook + UI

import pandas as pd
import bvista

df = pd.read_csv("data.csv")
bvista.show(df)

2. API Upload

curl -X POST http://localhost:5050/api/upload \
     -F 'file=@your_file.csv'

3. Trigger WebSocket

socketio.emit("data_update", {"status": "DataFrame updated"})

Full API listed here

---

💡 In the News / Inspiration

"B-vista solves the problem of static pandas outputs — it makes DataFrames interactive, shareable, and explorable."
— Community Contributor, Beta Tester

• Inspired by the gaps in tools like D-Tale, Lux, and pandas-profiling
• Designed for real-world data workflows, not just pretty plots
• UI built from scratch for speed, clarity, and scalability

---

🔗 Related Resources

• pandas
• D-Tale (Comparative Tool)
• Lux (EDA Assistant)
• Flask-SocketIO
• Vite
• Plotly

---

🧑‍💻 Developer Setup & Contributing

Run the Backend

cd backend
python app.py

Run the Frontend

cd frontend
npm install
npm start

---

📂 Project Structure

📦 b-vista
├── backend/            → Flask API, WebSocket, models/
├── frontend/           → React app (Vite)
├── bvista/             → Notebook integration module
├── docs/               → Markdown documentation
├── tests/              → Unit & integration tests
├── datasets/           → Sample CSVs for demos
├── requirements.txt
├── setup.py
└── README.md

---

🤝 Contributing

We welcome PRs and feedback!
Start here → docs/development/contributing.md

• Dev setup instructions
• Code style & linting
• GitHub Actions (planned)
• Test suite guide

---

🔖 Versioning

Follows Semantic Versioning

Current: v0.1.0 (pre-release)

Expect fast iteration and breaking changes until 1.0.0

---

📄 License

B-vista is open-source and released under the GNU LGPL v2.1 License.

Contributions, forks, and usage are welcome — just credit the project 💛

---