mathematica 1.0.1

Python package for performing complex mathematical operations, statistical distributions and visualization

Elxsi is a python package for performing advanced mathematical operations, distributions, and visualizations, and is licensed under the GNU General Public License v3.0. It includes modules for calculating mean, standard deviation & probability distribution function of various statistical distributions. The latest released stable version of elxsi is v1.0.4

This project was started in 2021 by Ashwin Raj, as an academic project. The resources for this package, and the pull requests are maintained, and reviewed by a team of volunteers from Workspace. Learn more about elxsi v1.0.4 here

SubDirectories and Dependencies

Dependencies

• Python (>= 3.9.0) - Learn more about the python programming from here, and download the latest version here
• NumPy (>=1.20.3) - Learn about the NumPy package here, and install the package following the guidelines here

Note: Elxsi runs on all operating systems, is quick to install, and is available for free use. No versions of Elxsi supports Python 2.7, and Python 3.4. Elxsi's plotting capabiliies requires matplotlib (>= 2.1.1) and seaborn (>= 0.9.0) packages.

Files and Folders

The directories, and subdirectories used, that are of critical importance to the Elxsi python package are as mentioned:

• dist: This sub-directory contains the entire source distribution for the package that needs to be uploaded to PyPi
• elxsi.egg-info: This subdirectory contains the entire package's metadata, including a PKG-INGFO, and the sources
• elxsi: This subdirectory contains the entire code for performing operations and visualizing statistical distributions

Python Package Build Commands

To install the elxsi python package, just run the following command to create an .egg file (python distribution format):

python setup.py bdist_egg

To create raw source distribution file for this package, 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 this command:

python setup.py bdist_wininst

User Installation and Source Code

Latest stable release of elxsi can either be downloaded from the repo or be simply installed from PyPi, using the code:

pip install elxsi

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

Elxsi development takes place on GitHub. Please submit any bugs, that 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                   // GNU General Public License v3.0
├── pyproject.toml
├── README.md                 // Contains base level documentation
├── setup.cfg
├── doc                       // Contains visual graphics (Images/Videos)
│   └── images/Video/gif 
├── example                   // Contains user guide for working with elxsi
│   └── notebook
├── setup.py                  // Packaged & distributed with disutils
├── elxsi/
│   ├── distributions         // Code for statistical distributions
│   └── __init__.py
└── tests/                    // Files for performing various unit tests (To be added)

Contribution Guidelines

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/Elxsi-Mathematical-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

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.

License and Project Status

The package, and other resources are distributed under the GNU General Public License 3. This package is compatible with all operating systems. The latest released stable version of elxsi is v1.0.4 & is available to be installed on any local system for general use through pip installer from PyPi (and other indexes), using requirement specifiers. Checkout the pip documentation v21.1.1 here for any information regarding the installer. The changes are logged in the /changelog