{
    "info": {
        "author": "Nils Mueller",
        "author_email": "nils.mueller@ini.rub.de",
        "bugtrack_url": null,
        "classifiers": [],
        "description": "<img align=\"left\" src=\"https://api.travis-ci.org/NiMlr/PyFunctionBases.svg?branch=master\">\n\n<img align=\"right\" width=\"300\" height=\"300\" src=\"https://user-images.githubusercontent.com/39880630/56446422-dc61eb80-6302-11e9-8b46-78c0a9d08420.gif\">\n\n# PyFunctionBases\nA Python module to compute multi-dimensional arrays of evaluated functions based on Numpy. This module can be used for evaluation of functions, approximation or for feature engineering in machine learning.\n\nSpecifically, the module evaluates basis functions on intervals by employing a recursive formula of type\n<p align=\"center\">\n<img src=\"https://latex.codecogs.com/gif.latex?f_{n&plus;1}(x)&space;=&space;g(f_n(x),&space;\\dots,&space;f_0(x),x).\" title=\"f_{n+1}(x) = g(f_n(x), \\dots, f_0(x),x).\" />\n</p>\n\nThis is generalized to the multi-dimensional case by using a tensor product\n<p align=\"center\">\n<img src=\"https://latex.codecogs.com/gif.latex?(f_i({x_m}_k),f_j({x_m}_l))&space;\\mapsto&space;f_i({x_m}_k)f_j({x_m}_l)\" />\n</p>\n\nrepeatedly on coordinate wise one-dimensional function bases. The code is vectorized over the evalution points\n<p align=\"center\">\n<img src=\"https://latex.codecogs.com/gif.latex?x_m&space;\\in&space;\\mathbb{R}^{num\\_dim},&space;m&space;\\in&space;\\{1,&space;\\dots,&space;num\\_samples\\}\" />\n</p>\n\nand returns a multi-dimensional array of shape `(num_samples, degree+1, ..., degree+1)`, where `degree`\nis the cardinality of the one-dimensional bases omitting a constant function. The following picture shows the two-dimensional case.\n\n<p align=\"center\">\n<img width=\"399\" height=\"323\" src=\"https://user-images.githubusercontent.com/39880630/56447919-80e82b80-630b-11e9-92bd-6d81b0d78946.png\">\n</p>\n\nCurrently, the following functions are available:\n\n\n| Name | Domain |  \n|-------|-----------|\n| [`standard_poly`](https://en.wikipedia.org/wiki/Polynomial) | `(-Inf, Inf)`|\n| [`legendre_poly`](https://en.wikipedia.org/wiki/Legendre_polynomials) | `[-1, 1]`|\n| [`legendre_rational`](https://en.wikipedia.org/wiki/Legendre_rational_functions) | `[0, Inf)`|\n| [`chebyshev_poly`](https://en.wikipedia.org/wiki/Chebyshev_polynomials#First_kind) | `[-1, 1]`|\n\nPlease make sure that your data lies in these domains, checks will be run if desired.\n\n### Contents\n[1. Installation](#installation)  \n[2. Simple usage](#simple-usage)  \n[3. Where evaluation of polynomials can fail](#where-evaluation-of-polynomials-can-fail)  \n\n## Installation \nRequirements: `pip3 install numpy`\n\n```bash\npip3 install pyfunctionbases\n```\n\n\n## Simple Usage\nNow a simple example using standard polynomials is given. By exchanging the name parameter, you can try different functions.\n\n```python\nfrom pyfunctionbases import RecursiveExpansion\nimport numpy as np\n\n# create some data to evaluate basis functions on<\nnum_samples = 1000\nnum_dim = 2\nx = np.random.uniform(low=0.0, high=1.0, size=(num_samples, num_dim))\n\n# create an expansion object where name can be any\n# function name, that is in the table below\ndegree = 10\nname = 'standard_poly'\nexpn = RecursiveExpansion(degree, recf=name)\n\n# evaluate the function, result is of shape (num_samples, degree+1, degree+1)\nf_ij = expn.execute(x)\n\n# flatten the result if needed\nf_k = f_ij.reshape(num_samples,(degree+1)**num_dim)\n```\n\n## Where evaluation of polynomials can fail\nWhen evaluating functions it is easy to encounter numerical pitfalls. For polynomials specifically one can take measures to avoid problems with floating point numbers, e.g. by employing the representation indicated on the right hand side of the equation `c_1*(x**2)+ c_0*x = x*(c_1*x +c_0)`. Generalizing the former, one can avoid unnecessarily large or small numbers during the evaluation that are caused by large powers and which are badly represented by floating point numbers.\n\nIn approximation on the other hand, a basis representation like ``[x**n, ..., x**0]`` is useful in search for the right coefficients. This is a case where e.g. Legendre polynomials provide a useful alternative basis, that covers the exact same function space when the same degrees are considered. In the following code snipped, we can observe an example of this.\n\n![approx](https://user-images.githubusercontent.com/39880630/56443826-8d15be00-62f6-11e9-9cc2-43ae51ed8376.gif)\n\n```python\nfrom pyfunctionbases import RecursiveExpansion\nimport numpy as np\nimport matplotlib.pyplot as plt\n\n# create some data\nsamples = 1000\nx = np.random.uniform(low=-1.0, high=1.0, size=(samples,))\nx.sort()\n# evaluate a function to approximate on the data\nfvals = np.tanh(x)*np.cos(50*x)\n\n# set some a maximum degree for the polynomials\ndegree = 50\n\n# initialize the RecursiveExpansion\nexpnleg = RecursiveExpansion(degree, recf='legendre_poly')\nexpnstan = RecursiveExpansion(degree, recf='standard_poly')\n\n# compute the basis functions\nbasisleg = expnleg.execute(x[:, None], prec=1e-6)\nbasisstan = expnstan.execute(x[:, None], prec=1e-6)\n\n# find the coefficients of the least squares fit\n# to the function given the data\nsolleg = np.linalg.lstsq(basisleg, fvals, rcond=None)\nsolstan = np.linalg.lstsq(basisstan, fvals, rcond=None)\n\n# plot the result\nplt.plot(x, fvals)\nplt.plot(x, np.matmul(basisleg, solleg[0]))\nplt.plot(x, np.matmul(basisstan, solstan[0]))\nplt.show()\n```\n\n\n",
        "description_content_type": "",
        "docs_url": null,
        "download_url": "",
        "downloads": {
            "last_day": -1,
            "last_month": -1,
            "last_week": -1
        },
        "home_page": "https://github.com/NiMlr/PyFunctionBases",
        "keywords": "",
        "license": "MIT",
        "maintainer": "",
        "maintainer_email": "",
        "name": "pyfunctionbases",
        "package_url": "https://pypi.org/project/pyfunctionbases/",
        "platform": "",
        "project_url": "https://pypi.org/project/pyfunctionbases/",
        "project_urls": {
            "Homepage": "https://github.com/NiMlr/PyFunctionBases"
        },
        "release_url": "https://pypi.org/project/pyfunctionbases/1.6/",
        "requires_dist": null,
        "requires_python": "",
        "summary": "A Python module to compute multidimensional arrays of evaluated functions.",
        "version": "1.6"
    },
    "last_serial": 5167690,
    "releases": {
        "0.0.post68": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "df3ed6ec6dab3e536a170b03b25255b0",
                    "sha256": "113c7a0878da370e00b482978b6728090a36f55bed31eb52c3dc23883e35154f"
                },
                "downloads": -1,
                "filename": "pyfunctionbases-0.0.post68-py2-none-any.whl",
                "has_sig": false,
                "md5_digest": "df3ed6ec6dab3e536a170b03b25255b0",
                "packagetype": "bdist_wheel",
                "python_version": "py2",
                "requires_python": null,
                "size": 7543,
                "upload_time": "2019-04-04T23:19:41",
                "url": "https://files.pythonhosted.org/packages/02/fa/ab10e338b1ce2653c9135a9316b6e42ab95dbaf47c8333d1ff807859e42d/pyfunctionbases-0.0.post68-py2-none-any.whl"
            },
            {
                "comment_text": "",
                "digests": {
                    "md5": "4f9ad730bf50673f376e2d2cdd35c5e6",
                    "sha256": "7de88219744cc4892b395500075009f60936299d1cde377b0189475391c15d7a"
                },
                "downloads": -1,
                "filename": "pyfunctionbases-0.0.post68.tar.gz",
                "has_sig": false,
                "md5_digest": "4f9ad730bf50673f376e2d2cdd35c5e6",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 6946,
                "upload_time": "2019-04-04T23:19:43",
                "url": "https://files.pythonhosted.org/packages/38/1b/227f7d7aa26d0d9a0f84cb1e6dff884fc756ee3c670c27a31f2b96bb8ee8/pyfunctionbases-0.0.post68.tar.gz"
            }
        ],
        "0.1": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "21ffc243f2a1d8137179e1ad14c788b8",
                    "sha256": "23299751988b12ea7029b22fd56619f377e01a4f7901f23e62838e5c039debf8"
                },
                "downloads": -1,
                "filename": "pyfunctionbases-0.1-py3-none-any.whl",
                "has_sig": false,
                "md5_digest": "21ffc243f2a1d8137179e1ad14c788b8",
                "packagetype": "bdist_wheel",
                "python_version": "py3",
                "requires_python": null,
                "size": 5546,
                "upload_time": "2019-04-04T23:28:20",
                "url": "https://files.pythonhosted.org/packages/93/65/ab391307c02d63a65ec6c128e834c631a57ce144f7c8afdb906340c0974e/pyfunctionbases-0.1-py3-none-any.whl"
            }
        ],
        "1.0": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "4e0e3739ae5c133408a3ab2dd15db501",
                    "sha256": "c8fdb2cda74764cb94ee5fbe9436d2d58dcca26525db08cf2f56ddf811a22b3d"
                },
                "downloads": -1,
                "filename": "pyfunctionbases-1.0-py3-none-any.whl",
                "has_sig": false,
                "md5_digest": "4e0e3739ae5c133408a3ab2dd15db501",
                "packagetype": "bdist_wheel",
                "python_version": "py3",
                "requires_python": null,
                "size": 5548,
                "upload_time": "2019-04-04T23:31:09",
                "url": "https://files.pythonhosted.org/packages/15/be/2504243804c867f328d1f4abd02d82df203ac26e53a868a61cf1f298f140/pyfunctionbases-1.0-py3-none-any.whl"
            },
            {
                "comment_text": "",
                "digests": {
                    "md5": "5902acbdb07c7df3a3890569c7b63878",
                    "sha256": "cfd8e88b9c88ec4eca07c4c95040270ff1feeb0ad9f0c4af39c9146911d20bf1"
                },
                "downloads": -1,
                "filename": "pyfunctionbases-1.0.tar.gz",
                "has_sig": false,
                "md5_digest": "5902acbdb07c7df3a3890569c7b63878",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 6893,
                "upload_time": "2019-04-04T23:31:10",
                "url": "https://files.pythonhosted.org/packages/a1/d5/bc7bb3b2005299a2043ced360b0035d6a809fcd015136b2949cde84c292a/pyfunctionbases-1.0.tar.gz"
            }
        ],
        "1.1": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "066c90eb82fdae2876627de45929c3b7",
                    "sha256": "b9ab154450fc34d3eaa63db66dd60bdcb6fd9eaa081c9dee4d6b54a4611b112c"
                },
                "downloads": -1,
                "filename": "pyfunctionbases-1.1-py3-none-any.whl",
                "has_sig": false,
                "md5_digest": "066c90eb82fdae2876627de45929c3b7",
                "packagetype": "bdist_wheel",
                "python_version": "py3",
                "requires_python": null,
                "size": 8650,
                "upload_time": "2019-04-18T19:59:35",
                "url": "https://files.pythonhosted.org/packages/5a/80/5eaa02c06c9e8a113796699c1440b4cc9e6d83e8b8fe34f8859eddb890b2/pyfunctionbases-1.1-py3-none-any.whl"
            },
            {
                "comment_text": "",
                "digests": {
                    "md5": "703a50f7e88f600e07e010b719caf96a",
                    "sha256": "7136b8395c91b09674e1f7717e230f01cbaf0b5d616ef95793380dfea6d2b3cf"
                },
                "downloads": -1,
                "filename": "pyfunctionbases-1.1.tar.gz",
                "has_sig": false,
                "md5_digest": "703a50f7e88f600e07e010b719caf96a",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 10300,
                "upload_time": "2019-04-18T19:59:36",
                "url": "https://files.pythonhosted.org/packages/93/10/0542aef3dbb82f0688a4254c086f7b48ed18d7d4e9323641a85048aab6b6/pyfunctionbases-1.1.tar.gz"
            }
        ],
        "1.2": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "a46060677f6da2dd926fa3b30e772ac9",
                    "sha256": "0910ba0c8b17cd442735479811158c60118b7cc5434a6100802d62cdde6098a4"
                },
                "downloads": -1,
                "filename": "pyfunctionbases-1.2-py3-none-any.whl",
                "has_sig": false,
                "md5_digest": "a46060677f6da2dd926fa3b30e772ac9",
                "packagetype": "bdist_wheel",
                "python_version": "py3",
                "requires_python": null,
                "size": 9649,
                "upload_time": "2019-04-19T23:43:48",
                "url": "https://files.pythonhosted.org/packages/31/d2/da462d3c0d8a48ddeb0b8c39e733f5976ec49d5deab4031859290735b846/pyfunctionbases-1.2-py3-none-any.whl"
            },
            {
                "comment_text": "",
                "digests": {
                    "md5": "56c794ed81fe5d3192100becd1920a27",
                    "sha256": "f0bff45ed1fcecbad03e49da31f10cfa8ba228444af40141716beaa45598c81d"
                },
                "downloads": -1,
                "filename": "pyfunctionbases-1.2.tar.gz",
                "has_sig": false,
                "md5_digest": "56c794ed81fe5d3192100becd1920a27",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 12287,
                "upload_time": "2019-04-19T23:43:49",
                "url": "https://files.pythonhosted.org/packages/be/fd/7c684a612e4c1627f61873071b1acdb537b784b28b3551389846789385cc/pyfunctionbases-1.2.tar.gz"
            }
        ],
        "1.3": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "6a044018f4117b46464e0d1066c04956",
                    "sha256": "b8cd8fb8a01f81f4b9c5a4c290a5016819e035f548eb524a3fb7bf21791bbeec"
                },
                "downloads": -1,
                "filename": "pyfunctionbases-1.3-py3-none-any.whl",
                "has_sig": false,
                "md5_digest": "6a044018f4117b46464e0d1066c04956",
                "packagetype": "bdist_wheel",
                "python_version": "py3",
                "requires_python": null,
                "size": 9647,
                "upload_time": "2019-04-19T23:57:35",
                "url": "https://files.pythonhosted.org/packages/b1/6b/1e62c392e438537edde823d8512f941731192cbf67128459cc7be81823e7/pyfunctionbases-1.3-py3-none-any.whl"
            },
            {
                "comment_text": "",
                "digests": {
                    "md5": "e5791346987c8aa128da4c72a3e8559e",
                    "sha256": "be6fb613c73ff3b86e1d16dfda2c7cfb10e644fdd3414d4ba5a668225d8a9b47"
                },
                "downloads": -1,
                "filename": "pyfunctionbases-1.3.tar.gz",
                "has_sig": false,
                "md5_digest": "e5791346987c8aa128da4c72a3e8559e",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 12290,
                "upload_time": "2019-04-19T23:57:36",
                "url": "https://files.pythonhosted.org/packages/ab/28/164d1ca6a8a6bac923a1a22bf1a88f08047e9d8cd11bba0ef3e03f21ce60/pyfunctionbases-1.3.tar.gz"
            }
        ],
        "1.4": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "b2fe3507381693d2566f5f682d2c3eba",
                    "sha256": "28539312214a43435658b2338a40eeeaec1af9c6754cc50539f0479ba3e1ce37"
                },
                "downloads": -1,
                "filename": "pyfunctionbases-1.4-py3-none-any.whl",
                "has_sig": false,
                "md5_digest": "b2fe3507381693d2566f5f682d2c3eba",
                "packagetype": "bdist_wheel",
                "python_version": "py3",
                "requires_python": null,
                "size": 9663,
                "upload_time": "2019-04-20T11:29:36",
                "url": "https://files.pythonhosted.org/packages/e4/e7/92b3886d1e137de151fdbb551b90ce65c0d520a5489bfbe652d148e64b17/pyfunctionbases-1.4-py3-none-any.whl"
            },
            {
                "comment_text": "",
                "digests": {
                    "md5": "6b4dc9cc8c26b0cbe68b85caba3f4582",
                    "sha256": "2f81688250a9b82d9df520dd2115c79102e484a4aa10f7e34cf8131ba30fc431"
                },
                "downloads": -1,
                "filename": "pyfunctionbases-1.4.tar.gz",
                "has_sig": false,
                "md5_digest": "6b4dc9cc8c26b0cbe68b85caba3f4582",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 12324,
                "upload_time": "2019-04-20T11:29:37",
                "url": "https://files.pythonhosted.org/packages/45/c1/abbdc941e00dced8ab7d4e0bcad11959d1833e15f736c7cf04c7bcd0573e/pyfunctionbases-1.4.tar.gz"
            }
        ],
        "1.5": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "aac78e165cb562bdafec6f4893e250e5",
                    "sha256": "6d0d95d8f2860119bde43c030819948676cf82868da1be3ac1998dcedbf3c5ad"
                },
                "downloads": -1,
                "filename": "pyfunctionbases-1.5-py3-none-any.whl",
                "has_sig": false,
                "md5_digest": "aac78e165cb562bdafec6f4893e250e5",
                "packagetype": "bdist_wheel",
                "python_version": "py3",
                "requires_python": null,
                "size": 9668,
                "upload_time": "2019-04-20T11:34:10",
                "url": "https://files.pythonhosted.org/packages/c6/c2/e3de4777d8f5c83f90705b69ff9a2c70b21c928e4f96aeb0e91f3fef9a29/pyfunctionbases-1.5-py3-none-any.whl"
            },
            {
                "comment_text": "",
                "digests": {
                    "md5": "0434104f3ca4341a1b15b4061abc3ac5",
                    "sha256": "e1d09620684a3664bf22375d610d212afb7600bb3dd2928ac91a098e27f57aff"
                },
                "downloads": -1,
                "filename": "pyfunctionbases-1.5.tar.gz",
                "has_sig": false,
                "md5_digest": "0434104f3ca4341a1b15b4061abc3ac5",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 12333,
                "upload_time": "2019-04-20T11:34:11",
                "url": "https://files.pythonhosted.org/packages/a1/da/d2d6088ac5df26c4e7e4ab6fb1cdf38697657a8f99f169bc03033f8cb316/pyfunctionbases-1.5.tar.gz"
            }
        ],
        "1.6": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "c8dfb6d10af641e5b3d96aaa67803c3e",
                    "sha256": "341915298884b182a80dc9e855ff80e15642a51809e3f79c621c5d830e469b45"
                },
                "downloads": -1,
                "filename": "pyfunctionbases-1.6-py3-none-any.whl",
                "has_sig": false,
                "md5_digest": "c8dfb6d10af641e5b3d96aaa67803c3e",
                "packagetype": "bdist_wheel",
                "python_version": "py3",
                "requires_python": null,
                "size": 9673,
                "upload_time": "2019-04-20T11:36:09",
                "url": "https://files.pythonhosted.org/packages/06/4e/00bfec03ced3f74a6aa367c7985a485796dd06c9bb71ed5b5acd82f7dd82/pyfunctionbases-1.6-py3-none-any.whl"
            },
            {
                "comment_text": "",
                "digests": {
                    "md5": "bed512a7da8e657b28fa963edf180f55",
                    "sha256": "b0d843c148cfa84ea06f2acc27f4329a8c817bcd8fec09ff9e3f3e60e77f4487"
                },
                "downloads": -1,
                "filename": "pyfunctionbases-1.6.tar.gz",
                "has_sig": false,
                "md5_digest": "bed512a7da8e657b28fa963edf180f55",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 12339,
                "upload_time": "2019-04-20T11:36:10",
                "url": "https://files.pythonhosted.org/packages/5c/89/dca12a44096569ebae753f1454aa5630860107a25d343961be0e6998a8b0/pyfunctionbases-1.6.tar.gz"
            }
        ]
    },
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "md5": "c8dfb6d10af641e5b3d96aaa67803c3e",
                "sha256": "341915298884b182a80dc9e855ff80e15642a51809e3f79c621c5d830e469b45"
            },
            "downloads": -1,
            "filename": "pyfunctionbases-1.6-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "c8dfb6d10af641e5b3d96aaa67803c3e",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": null,
            "size": 9673,
            "upload_time": "2019-04-20T11:36:09",
            "url": "https://files.pythonhosted.org/packages/06/4e/00bfec03ced3f74a6aa367c7985a485796dd06c9bb71ed5b5acd82f7dd82/pyfunctionbases-1.6-py3-none-any.whl"
        },
        {
            "comment_text": "",
            "digests": {
                "md5": "bed512a7da8e657b28fa963edf180f55",
                "sha256": "b0d843c148cfa84ea06f2acc27f4329a8c817bcd8fec09ff9e3f3e60e77f4487"
            },
            "downloads": -1,
            "filename": "pyfunctionbases-1.6.tar.gz",
            "has_sig": false,
            "md5_digest": "bed512a7da8e657b28fa963edf180f55",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": null,
            "size": 12339,
            "upload_time": "2019-04-20T11:36:10",
            "url": "https://files.pythonhosted.org/packages/5c/89/dca12a44096569ebae753f1454aa5630860107a25d343961be0e6998a8b0/pyfunctionbases-1.6.tar.gz"
        }
    ]
}