APToolBox 1.1.0

A scientific computing toolbox

ADVANCED PROGRAMMING HOMEWORK 3: Extension of the scientific computing Toolbox

All files and folders for the third assignment of the Advanced Programming course at UniTS, A.2024/45.

Group Members

• Giovanni Billo: [e-mail]
• Tommaso Piscitelli: [e-mail]

Project Description

Original project

Python bindings were added for both modules, allowing for seamless use of C++ functions in python. On the other hand, less performance-intensive functions like those generating random vectors to generate a graph of interpolation errors were implemented in oython.

Some functionalities were added and extended:

• Better structure, modularization and code organisation.
• Possibility to build the entire unified ToolBox with setuptools.
• more getter and setter methods for DataFrameWrapper
• python function with C++ callback to reduce the size of the dataframe
• Enhance functor which polimorphically allows classes from both modules to use some magic methods and plot data.
• Easy installation with pip

Individual contributions

Giovanni Billo

• Python bindings for the DataFrameWrapper module
• improved project structure
• added methods and functionalities to DataFrameWrapper in both languages
• Enhance functor
• comparison file
• pip packaging

Tommaso Piscitelli

• Python bindings for the DataFrameWrapper module
• Interpolation part of the Enhance functor
• python tests for interpolation

Performance comparison

The file comparison.py leverages decorators and the functor Compare() to time the speed of our C++ bindings against some popular python libraries like NumPy and SciPy. As the DataFrame, our implementation lags behind pandas when it also has to format the file the right way. However, once a file is in the right format, it performs just as good and sometimes even slightly faster than Pandas.

This is also the case with the InterpolateWrapper module, which is tested against SciPy implementations of the linear, Lahgrange and Cubic splines.

Testing

All tests available for the C++ module were implemented also for python bindings. There is the possibility to enable automated testing frameworks when building the project (see BUILD INSTRUCTIONS below)

BUILD INSTRUCTIONS

The library can be directly installed via pip from here:

pip install APToolBox

Various other build options are also available:

• using setuptools, after cloning the repository, run the following commands in the main folder:

python3 setup.py build_ext

It is also possible to enable continuous integration by enabling automated tests via pytest and pytest-watch:

python3 setup.py build_ext watch_tests

This setup will run all of the tests again each time a change is made in any part of the code, ensuring continuous integration and early catching of bugs.

• using Cmake:

cmake -B build

You can find some usage examples here.