Mathematica is a python package for performing advanced mathematical operations, distributions, and visualizations & is licensed under the GNU General Public License v3.0. It includes modules for calculating mean, standard deviation and the probability distribution function of several statistical distributions. The latest stable release can be found here.
The project was started in April 2021 by Ashwin Raj as an academic project. The resources for this package, & the pull requests are maintained, and reviewed by a team of volunteers from Workspace. Learn more about mathematica here
• Python (>= 3.9.0) - Learn more about the python programming from here, & download the latest version from here
• NumPy (>=1.20.3) - Learn about the NumPy package here, & install the package following the guidelines from here
Mathematica runs on all operating systems, is quick to install and is available for free use. No version of mathematica supports Python 2. Mathematica's plotting capabiliies requires matplotlib (>= 2.1.1) and seaborn (>= 0.9.0) packages
The files & directories, that are used are of critical importance to the mathematica python package are as mentioned:
• dist: This directory contains the entire source distribution .tar file for the package that needs to be uploaded to PyPi
• mathematica.egg-info: This sub-directory contains the entire package's metadata including a PKG-INGFO & sources
• mathematica: The directory contains the entire code for performing operations & visualizing statistical distributions
To build mathematica python package, run the following command to create a tar.gz file (python distribution format):
python setup.py sdist
To upload the python package to the pypi repository run the following command in your command prompt/terminal:
python setup.py sdist bdist_wheel
Running this file creates the following sub-directories: dist, and elxsi.egg-info. Executable installer can also be created for installing the package in the Microsoft Windows environment. To create an executable installer, run the command:
python setup.py bdist_wininst
Latest stable release of mathematica can be downloaded from the repo or simply installed from PyPi, using the code:
pip install mathematica
Once this package has succesfully installed, a large array of different statistical distributions can be imported from the package by specifying the name of the distribution (seprated by a ','), with first letter of each word typed in uppercase
Mathematica's development takes place on GitHub. Please submit bugs you may encounter to the issue tracker with a reproducible example demonstrating the problem, in accordance with the issue templates present in ~/.github folder.
├── LICENSE // Licensed under the 'GNU General Public License v3.0'
├── pyproject.toml
├── README.md // Contains the base level documentation of the gh-repo
├── requirements.txt
├── assets // Contains all visual graphics (images, videos & gifs)
│ └── images/Video/gif
├── example // Contains the user guide for working with mathematica
│ └── notebook
├── setup.py // Packaged, & distributed using the disutils py module
├── mathematica/
│ ├── distributions // Code for various different statistical distributions
│ └── __init__.py
└── tests/ // Files for performing several unit test (to be added)
To start contributing to the project, clone the repository into your local system subdirectory using the below git code:
git clone https://github.com/thisisashwinraj/Mathematica-Python-Package.git
Before cloning the repository, make sure to navigate to the working subdirectory of your command line interface and ensure that no folder with same name exists. Other ways to clone the repository includes using a password protected SSH key, or by using Git CLI. The changes may additionally be performed by opening this repo, using GitHub Desktop
gh repo clone thisisashwinraj/Mathematica-Python-Package
Before opening a Pull Request it is recommended to have a look at the full contributing page to make sure your code complies with all the pull request guidelines. Please ensure that you satisfy the ~/checklist before submitting your PR.
Navigate to this sub-directory & check status of all files that were altered (red) by running the below code in GitBash:
git status
Stage all your files that are to be pushed into your pull request. This can be done in two ways - stage all or some files:
git add . // adds every single file that shows up red when running git status
git add <filename> // type in the particular file that you would like to add to the PR
Commit all the changes that you've made and describe in brief the changes that you have made, using the command:
git commit -m "<commit_message>"
Push all of your updated work into this GitHub repo in the form of a Pull Request by running the following command:
git push origin main
All Pull Requests are reviewed on a monthly rolling basis. Your understanding is appreciate during this review process.
The package, and other resources are distributed under the GNU General Public License 3. This package is compatible with all operating systems. The latest stable version release of mathematica v1.0.1 & is available to be installed on any local system for general use through pip installer from PyPi (& other indexes) using requirement specifiers. Check out pip documentation v21.1.1 here for any information regarding the installer. The changes are logged in the changelog