akrodger / brams-math-methods

A collection of math computation C libraries written by Abram "Bram" Rodgers.
GNU General Public License v3.0
0 stars 0 forks source link

brams-math-methods

A collection of math computation C/C++ libraries written by Abram "Bram" Rodgers. README by Abram Rodgers

Contact: AKS.Rodgers (at) gmail (dot) com


| Contents: |


| Introduction: |

This library is compatible with C++ as of 24 Nov 2017.

This program was initially the primary content for a school report. When I was a student in MATH 181 History of Mathematics (Winter 2016) at UC Santa Cruz, we all had to do a historical report on a famous mathematician. We also had to showcase some of that mathematician's work. I chose to write about Carl Gauss and showcase Gaussian Elimination, a particular matrix algorithm which can find a solution for systems of linear equations of nth order. Since this is a pretty standard exercise for students in a computer science course, I figured I could probably write my own version of the very famous algorithm for my math course. After approval from the professor, I wrote up the code over the course of a week or so and included it in my historical report with gratuitous comments and documentation (since the professor did not know C). The school project was very successful and writing more in the library has become a long term software project.

Today the library sits on GitHub to show some of my personal coding skills. Since no algorithm in this package was particularly novel, simply my own take on various computational problems, I decided to make it all public domain at first. Plenty of alternate versions of the Linear Algebra algorithms are open source. However, after writing the numerical methods functions, I decided to open source the whole package, since statistical software is a bit more novel than some intro Linear Algebra algorithms.

If you wish to download and use my code in particular, I would be curious to know what it is being used for. If you wish to ask a question, collaborate on some project, or something else, then just shoot me an email.


| Section 1: Library Usage |

Program located in folder bmm. Library Dependencies:

Usage:

InterpolatorPoints.txt formatting:

- Any line starting with a '~' is skipped. Any text after that is not read at all.

- A line starting with a "t:" (colon optional) indicates that the line has an integer which indicates how many terms are in the polynomial you want to approximate. (Terms in a polynomial is equal to the degree plus 1.)

- A line starting with 'x' indicates that the line contains the x coordinates of the array of data points serparated by spaces. There may not be trailing sapces after the last number..

- A line starting with 'y' indicates that the line contains the y coordinates of the array of data points serparated by spaces. There may not be trailing sapces after the last number.

- A line starthing with any other character throws and error and tells you to format the file properly.

- Parser also ignores a line which contains no text. That is, it is just nothing but a "newline" or "line feed". This is treated the same as though it saw a '~'.

- Note: No lines may between 'x' or 'y' and their corresponding coordinates on the next line.

Example of a valid file:

~ First line of file
~ "This text is not read by the parser"
t: 5
x: The colon is not read by the parser, only the x. This text also not read.
1   2   4   6    7
~ As many spaces as you want can be between numbers

~ The above line is ignored completely.
y:
3 4 -6 6     -8
~ Last Line of file

| Section 2: Linear Algebra |

This library contains several algorithms from an introductory Linear Algebra course.

Notable functions are:

Planned Functions:


| Section 3: Calculus and Numerical Methods |

There are several functions here:

Adams-Bashforth is a method for using local polynomial interpolation to find the solutions to n-dimensional ODEs. I implement it here in full generality. Keep note that this function may use a ton of memory if you set the IO step too low.

Mean polynomial approximation takes a set of (x, y) data points and forms a polynomial with them of a specified degree. It makes use of the linear algebra operations defined in the library to do this. Read the header file for more information.

Least Squares is an algorithm commonly used in statistical analysis to find a function which represents a set of measurements. We give the algorithm a linearly independent array of pointers to functions of the form

double foo(double)

We then compute the projection matrix of the x data points with respect to this array, minimizing the error from a linear combination of functions and the y values. The result is a set of coordinates, equivalent to the coeficients of either of polynomial approximation functions mentioned above.

If you know what a Fourier Series is, then consider Least Squares to be generalization of Fourier. Instead of summing up a number of trig functions, we can sum up any set of linearly independent functions. However, the Fourier form of certain functions has the gaurantee of convergence (meaning error goes to zero). Least Squares only finds the smallest possible error, which may be nonzero.


| Section 4: Integer Stack Implementation |

This is an implementation of a stack data structure written by me. The reason for this is simply because having a stack to run computations with is useful. Currently, it is only used in the Numerical Methods section. MathMethods depends on Stack, so make sure to have them in the same directory.


| Section 4: How to use this library with your code |


| Section 6: Special Thanks |

In fall 2016, James Iwamasa, a personal friend from the computer science department at UC Santa Cruz, helped me implement the meanPolynomial() function. For the mean polynomial approximation algorithm, James implemented a recursive algorithm in C++ using vector objects to find all subsets of a list of integers. Then I converted this code to C, restructured it to work with the stack library, then optimized memory usage so that my laptop wouldn't crash due to RAM filling up for large enough sets of integers.