autodiffing 0.0.2

A package for Automatic Differentiation

How to Use Package

Installation

To begin, the user has to work in a python environment (preferably version >= 3.7). As an option, the user can choose to create a new virtual environment for automatic differentiation using the following command in the terminal:

conda create -n env_autodiff python=3.7

We have used PyPI to host our package. Users can download our Automatic Differentiation package with the following command in the terminal:

pip install autodiffing

To install the required dependencies, users need to run the following command in the terminal:

pip install -r requirements.txt

Within our requirements.txt, we have the a number of packages that come with the installation of python version 3.7 and our main packages, but the main packages that we require for our Automatic Differentiation package are:

numpy==1.17.4
doctest-cli==0.0.3
pytest==5.2.4 pytest-cov==2.8.1
matplotlib==3.1.1
scipy==1.3.2

numpy is essential for our Automatic Differentiation package as we require it for the calculation of our elementary functions, and for dealing with arrays and matrices when there are vector functions and vector inputs.

doctest-cli is needed for user to run demo case usage of the functions within our package. To do so, the user can run the following commands in the terminal:

python DualNumber.py
python ElementaryFunctions.py

pytest and pytest-cov are packages for the user to test that our code is functional and check for code coverage of our tests.

matplotlib is needed for any potential visualization of our outputs.

scipy is a good package to have for its optimization and linear algebra abilities.

Using the Package

Once users have installed all the dependencies and the package itself, they may begin to use our package to quickly find derivatives of functions. For this section, we walk through three different examples of how users can interact with the package for their purposes. Users should start by importing the DualNumber and ElementaryFunctions modules. As specified in Milestone 1 and in this document, users should start by initializing a DualNumber object:

# DualNumber is a class in module AD, user must initialize the value of the variable in the initialization.
x = DualNumber(5)

Note that when the user initializes a variable, he or she must provide the initial value. For this milestone, the user may only pass in scalar-valued functions of scalars, but in the future we will implement methods and classes for the user to input vector-valued functions of vectors. The initial value of the derivative is set as a default of 1, but the user may overwrite this. To find the derivative of a specific elementary function, users should pass this initialized object into our custom-designed elementary functions as follows:

# ElemFunctions is a class where we define some elementary function derivatives and calculate the derivative function.
func = EF.Sin(x)

# we can get the value and derivative from the attributes "val" and "der". If we did not assign value and derivative direction in the fist
# step, we can do it here. 
print(func.val)
print(func.der)