Table of Contents
Viewfinder is a user-friendly tool designed to simplify the analysis and visualization of CSV and Excel datasets. With an intuitive drag-and-drop interface, it offers a comprehensive overview, detailed statistics, and visualizations to help you understand your dataset quickly, the names comes from the viewfinder of cameras where you can get a quick preview useful information before taking the pic, in the same sense Viewfinder aims to help you get a quick preview of your dataset without having to load it on a jupiter notebook or other similar tool.
- Easy Import: Drag and drop CSV or Excel files.
- Data Overview: Quick summary of columns, types, missing values, and sample data.
- Statistics: Descriptive stats for numerical columns.
- Visualizations: Generate histograms to visualize data distributions.
- Export: Export data overview and statistics to Excel.
- Python
- PyQt5
- Pandas
- Matplotlib
To get a local copy up and running follow these simple example steps.
-
Make sure to have python 3.12 installed. (having a venv to run viewfinder is a bit optional, its generally a good practice to keep venvs for projects to prevent littering your local python install, but you be you, if you want to install the requirements.txt directly on your local python config feel free to do so as well)
-
set up a python virtual enviroment:
python -m venv venv
-
activate the virtual enviroment using:
-
-On MacOs & Linux:
source venv/bin/activate -
-On Windows using CMD:
.\venv\Scripts\activate.bat
To install and set up Viewfinder, first ensure you have Python installed on your system. Clone the repository, navigate to the project directory, and install the required dependencies using pip. You can then run the application by executing the main script. Below are the step-by-step instructions:
- Clone the repo
git clone https://github.com/your_username_/Project-Name.git- install the dependencies using the requirements.txt file:
pip install -r requirements.txt- Run the -main.py- file:
Python main.pyJust drag and drop your .csv or .xslx file on the window and see a quick preview of your dataset.
Contributions are what make the open source community such a fantastic place to learn, inspire, and create. Any contributions you make to improve Viewfinder are greatly appreciated.
If you have suggestions for enhancements or new features, please fork the repository and create a pull request. You can also open an issue with the tag "enhancement". Don't forget to give the project a star if you like it! Thanks again for your support!
- Fork the Project
- Create your Feature Branch (
git checkout -b feature/AmazingFeature) - Commit your Changes (
git commit -m 'Add some AmazingFeature') - Push to the Branch (
git push origin feature/AmazingFeature) - Open a Pull Request
Guillermo Taly opensource@guillermotaly.com
Project Link https://github.com/Talyght/viewfinder