Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/nelsonbittencourt/excel_to_dataframe
A high performance C++ library to convert Excel files to pandas dataframes.
https://github.com/nelsonbittencourt/excel_to_dataframe
converter cplusplus cpp dataframes excel pandas parser performance python worksheets
Last synced: 3 days ago
JSON representation
A high performance C++ library to convert Excel files to pandas dataframes.
- Host: GitHub
- URL: https://github.com/nelsonbittencourt/excel_to_dataframe
- Owner: NelsonBittencourt
- License: mit
- Created: 2022-12-16T20:12:28.000Z (about 2 years ago)
- Default Branch: master
- Last Pushed: 2024-11-21T13:37:05.000Z (3 months ago)
- Last Synced: 2025-02-02T16:51:14.677Z (16 days ago)
- Topics: converter, cplusplus, cpp, dataframes, excel, pandas, parser, performance, python, worksheets
- Language: Python
- Homepage:
- Size: 4.1 MB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# excel_to_dataframe:
A high performance C++ library to convert excel files to pandas dataframes.
The code opens an Excel file, extracts data from selected worksheet and returns a formatted string semicolon separated-values
(future version will include comma separated-values). This string can be easily handled by python/pandas.
This software is in testing phase. Feel free to test it out. If you want to share your experience, send me an email (nbittencourt at hotmail dot com).
# Performance:
On an old processor (Intel Core i7-4510U 2.60 GHz, 4 cores) and with 8Gb RAM, the dll/so was between 5 and 20 times faster than Pandas.
## Windows, Python:
## Linux (Ubuntu), Python:
# Python installation (Windows and Linux):
Python 3.9, 3.10, 3.11 and 3.12 are supported.
## PyPI:
```Python
pip install excel-to-dataframe
```
## Anaconda/Miniconda:
```Python
conda install -c nbittencourt excel_to_dataframe
```
To force specific python version, run one of the following:
```Python
conda install -c nbittencourt excel_to_dataframe=0.2.60=py39_0
conda install -c nbittencourt excel_to_dataframe=0.2.60=py310_0
conda install -c nbittencourt excel_to_dataframe=0.2.60=py311_0
conda install -c nbittencourt excel_to_dataframe=0.2.60=py312_0
```
# Basic usage:
This example uses 'excel_to_pandas.py' to encapsulates library functions.
To access library functions directly, see the code in 'excel_to_pandas.py'.
To a full functional example, see 'example.py'.
```Python
# Including library to our code:
import excel_to_dataframe.excel_to_pandas as etd
# Test access to library printing version:
print(etd.version())
# Opening an Excel Workbook:
# Function 'open_excel' will return:
# 0 - success;
# -1 - file not found or
# -2 - file found, but it isn't a Excel valid file.
ret = etd.open_excel()
# Loading data from worksheet:
# Function 'ws_to_df' will return:
# A Pandas dataframe if success or -1 otherwise
my_pandas_dataframe_1 = etd.ws_to_df()
my_pandas_dataframe_2 = etd.ws_to_df()
# Closing an Excel Workbook. This is mandatory to change from an Excel File to another.
etd.close_excel()
```
# Personal site:
http://www.nrbenergia.somee.com/
or
https://nrbenergia.azurewebsites.net/
# More info:
https://www.linkedin.com/in/nelsonrossibittencourt/