Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/nelsonbittencourt/excel_to_dataframe
C++ Library to convert Excel worksheets to Pandas or Microsoft dataframes
https://github.com/nelsonbittencourt/excel_to_dataframe
converter cplusplus cpp dataframes excel pandas parser python worksheets
Last synced: 3 months ago
JSON representation
C++ Library to convert Excel worksheets to Pandas or Microsoft 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-05-21T14:31:45.000Z (7 months ago)
- Last Synced: 2024-09-30T00:03:16.864Z (3 months ago)
- Topics: converter, cplusplus, cpp, dataframes, excel, pandas, parser, python, worksheets
- Language: Python
- Homepage:
- Size: 2.65 MB
- Stars: 1
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# excel_to_dataframe:
C++ Library to convert Excel worksheets 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 ([email protected]).
# Performance:
On an old processor (Intel Core i7-4510U 2.60 GHz, 4 cores) and with 8Gb RAM, the dll was between 4 and 30 times faster than Pandas.
## Windows, Python:
## Linux (Ubuntu), Python:
Notice that Linux benchmark was conducted on a virtual environment hosted by Windows. In a pure Linux machine, result must be better.
# Python installation (Windows and Linux):
Python 3.9, 3.10 and 3.11 are supported.
## PyPI:
```Python
pip install excel-to-dataframe
```
## Anaconda/Miniconda (recommended):
```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.58=py39_0
conda install -c nbittencourt excel_to_dataframe=0.2.58=py310_0
conda install -c nbittencourt excel_to_dataframe=0.2.58=py311_0
```
## Manually:
You can copy the files from folder 'python' to your project folder (for Windows : 'excel_to_pandas.py' and 'excel_to_df.dll' , for Linux 'excel_to_pandas.py' and 'excel_to_df.so').
# 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/