{ "cells": [ { "cell_type": "markdown", "metadata": {}, "source": [ "# Linux Installation\n", "\n", "Linux installation is broken up into two categories. The first is for end user installation and the second is for development. The installation guide uses Ubuntu Server 18.04 LTS. You may need to adapt some commands for your variant of Linux." ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "## End User Installation\n", "\n", "The majority of users will want to simply install the binary distribution of the library. This can be accomplished using pip. If we do not have a binary wheel for your operating system, you must follow the development installation guide.\n", "\n", "```bash\n", "pip install matrixprofile\n", "```" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "## Development Installation\n", "\n", "Due to our usage of Cython and OpenMP for some modules, you are required to install some build essential dependencies. This portion of the installation guide will walk you through that." ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "### Install Anaconda\n", "\n", "Anaconda has become the defacto Python distribution for scientific computing and is highly recommended. You may use a base installation of Python without it, but this document does not cover that use case.\n", "\n", "Download the command line installer of Anaconda from the [Anaconda website](https://www.anaconda.com/distribution/).\n", "\n", "Once the installation completes, you can run the following to keep your terminal session open.\n", "Note that all commands assume you installed Anaconda in your home directory.\n", "\n", "```\n", "source ~/.bashrc\n", "```\n", "\n", "Conda will now load the (base) environment when you launch a terminal." ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "### Install Build Essential\n", "\n", "Build essential is required to compile some modules using Cython.\n", "\n", "```\n", "sudo apt install build-essential\n", "```" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "### Install matrixprofile for Development\n", "\n", "Finally, we can clone the matrixprofile source code and install it in development mode. If you wish, you may create a new Anaconda environment for this. Please refer to the [Anaconda documentation](https://docs.conda.io/projects/conda/en/latest/user-guide/tasks/manage-environments.html#creating-an-environment-with-commands) to create a conda environment.\n", "\n", "When I clone source code, I tend to favor putting all source files in a \"src\" directory within my home directory. Please substitute to suite your development preferences.\n", "\n", "```\n", "mkdir ~/src\n", "cd ~/src\n", "git clone https://github.com/matrix-profile-foundation/matrixprofile.git\n", "cd matrixprofile\n", "\n", "# for python 3.x\n", "pip install -r requirements.txt\n", "\n", "# for python 2.x\n", "pip install -r python2-requirements.txt\n", "\n", "pip install -e .\n", "```\n", "\n", "Once the installation completes, you can try running the tests to verify everything is OK.\n", "\n", "```\n", "pytest tests/\n", "```\n", "\n", "Please refer to our contribution guidelines for details on what we expect. Happy coding!" ] } ], "metadata": { "kernelspec": { "display_name": "Python 3", "language": "python", "name": "python3" }, "language_info": { "codemirror_mode": { "name": "ipython", "version": 3 }, "file_extension": ".py", "mimetype": "text/x-python", "name": "python", "nbconvert_exporter": "python", "pygments_lexer": "ipython3", "version": "3.7.4" } }, "nbformat": 4, "nbformat_minor": 4 }