algebraixlib is a library that provides constructs and facilities to harness the fundamentals of Data Algebra(tm).
Switch branches/tags
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
algebraixlib
docs
examples
test
.gitignore
COPYING.GPLv3.txt
COPYING.LGPLv3.txt
README.rst
RELEASES.rst
requirements.txt
runtests.py
setup.py
setup_data.py

README.rst

orphan:

logo

algebraixlib

What Is It?

algebraixlib is a library that provides constructs and facilities to harness the fundamentals of data algebra. Data algebra consists of mathematical constructs that can represent all data, no matter how it is structured, and the operations on that data. With this, all the advantages of a mathematically rigorous modeling can be unleashed. See also A Beginner's Introduction to Data Algebra.

Getting Started

  1. Make sure you have the required versions of Python and Jupyter Notebook installed (see Requirements below).
  2. Install the algebraixlib library (see How to Install below).
  3. Download the examples from our GitHub repository.
  4. Try the Hello_World.ipynb example first.

(Alternatively, you can also look at a static version of the notebooks in nbviewer; see the README file in our examples directory for direct links. For this you don't need to install or download anything. You can also start with the simpler hello_world.py. However, you'll lose out on some math and need to read up on it in our documentation at Read the Docs. )

Documentation and Support

See also our GitHub project page. In addition, there is a book about data algebra.

Detailed Instructions

Requirements

How to Install

If you already have Python installed and are familiar with installing packages, you can install algebraixlib with pip:

> pip install algebraixlib

Additional user permissions may be necessary to complete the installation. In such a situation, other options include installing the package for a single user (in the user's home directory):

> pip install algebraixlib --user <username>

or in a virtual environment (see Creation of virtual environments).

You can also manually download algebraixlib from GitHub or PyPI. To install from a download, unpack it and run the following command from the top-level source directory (the directory that contains the file setup.py):

> python setup.py install

(The same considerations about permissions apply.)

Unit Tests

The unit tests require the following libraries to be installed:

To execute the unit tests, download the file runtests.py and the directory test into any location on your system, then run runtests.py:

> mkdir algebraixlib-test
> cd algebraixlib-test
> svn export https://github.com/AlgebraixData/algebraixlib/trunk/runtests.py
> svn export https://github.com/AlgebraixData/algebraixlib/trunk/test
> python runtests.py

Documentation Build

The documentation build requires the following libraries be installed:

To run a documentation build, you need a local working copy of our complete GitHub repository. Then run build.py in the directory docs:

> mkdir algebraixlib
> cd algebraixlib
> svn export https://github.com/AlgebraixData/algebraixlib/trunk
> cd trunk/docs
> python build.py

Legalese

Copyright

Copyright(c) 2017 Algebraix Data Corporation.

License

algebraixlib is free software: you can redistribute it and/or modify it under the terms of version 3 of the GNU Lesser General Public License as published by the Free Software Foundation. A copy of the GNU Lesser General Public License is published along with algebraixlib on GitHub. Otherwise, see GNU licenses.

Warranty

algebraixlib is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details.