{ "info": { "author": "Jason Rudy", "author_email": "jcrudy@gmail.com", "bugtrack_url": null, "classifiers": [ "Development Status :: 3 - Alpha", "Intended Audience :: Developers", "Intended Audience :: Science/Research", "License :: OSI Approved :: BSD License", "Operating System :: MacOS", "Operating System :: Microsoft :: Windows", "Operating System :: POSIX", "Operating System :: Unix", "Programming Language :: Cython", "Programming Language :: Python", "Programming Language :: Python :: 2", "Programming Language :: Python :: 2.6", "Programming Language :: Python :: 2.7", "Programming Language :: Python :: 3", "Programming Language :: Python :: 3.4", "Programming Language :: Python :: 3.5", "Programming Language :: Python :: 3.6", "Topic :: Scientific/Engineering", "Topic :: Software Development" ], "description": "py-earth [![Build Status](https://travis-ci.org/scikit-learn-contrib/py-earth.png?branch=master)](https://travis-ci.org/scikit-learn-contrib/py-earth?branch=master)\n========\n\nA Python implementation of Jerome Friedman's Multivariate Adaptive Regression Splines algorithm, \nin the style of scikit-learn. The py-earth package implements Multivariate Adaptive Regression Splines using Cython and provides an interface that is compatible with scikit-learn's Estimator, Predictor, Transformer, and Model interfaces. For more information about \nMultivariate Adaptive Regression Splines, see the references below.\n\n## Now With Missing Data Support!\n\nThe py-earth package now supports missingness in its predictors. Just set `allow_missing=True` when constructing an `Earth` object.\n\n## Requesting Feedback\n\nIf there are other features or improvements you'd like to see in py-earth, please send me an email or open or comment on an issue. In particular, please let me know if any of the following are important to you:\n\n1. Improved speed\n2. Exporting models to additional formats\n3. Support for shared memory multiprocessing during fitting\n4. Support for cyclic predictors (such as time of day)\n5. Better support for categorical predictors\n6. Better support for large data sets\n7. Iterative reweighting during fitting\n\n## Installation\n\nMake sure you have numpy and scikit-learn installed. Then do the following:\n\n```\ngit clone git://github.com/scikit-learn-contrib/py-earth.git\ncd py-earth\nsudo python setup.py install\n```\n\n## Usage\n```python\nimport numpy\nfrom pyearth import Earth\nfrom matplotlib import pyplot\n\n#Create some fake data\nnumpy.random.seed(0)\nm = 1000\nn = 10\nX = 80*numpy.random.uniform(size=(m,n)) - 40\ny = numpy.abs(X[:,6] - 4.0) + 1*numpy.random.normal(size=m)\n\n#Fit an Earth model\nmodel = Earth()\nmodel.fit(X,y)\n\n#Print the model\nprint(model.trace())\nprint(model.summary())\n\n#Plot the model\ny_hat = model.predict(X)\npyplot.figure()\npyplot.plot(X[:,6],y,'r.')\npyplot.plot(X[:,6],y_hat,'b.')\npyplot.xlabel('x_6')\npyplot.ylabel('y')\npyplot.title('Simple Earth Example')\npyplot.show()\n ```\n\n## Other Implementations\n\nI am aware of the following implementations of Multivariate Adaptive Regression Splines:\n\n1. The R package earth (coded in C by Stephen Millborrow): http://cran.r-project.org/web/packages/earth/index.html\n2. The R package mda (coded in Fortran by Trevor Hastie and Robert Tibshirani): http://cran.r-project.org/web/packages/mda/index.html\n3. The Orange data mining library for Python (uses the C code from 1): http://orange.biolab.si/\n4. The xtal package (uses Fortran code written in 1991 by Jerome Friedman): http://www.ece.umn.edu/users/cherkass/ee4389/xtalpackage.html\n5. MARSplines by StatSoft: http://www.statsoft.com/textbook/multivariate-adaptive-regression-splines/\n6. MARS by Salford Systems (also uses Friedman's code): http://www.salford-systems.com/products/mars\n7. ARESLab (written in Matlab by Gints Jekabsons): http://www.cs.rtu.lv/jekabsons/regression.html\n\nThe R package earth was most useful to me in understanding the algorithm, particularly because of Stephen Milborrow's \nthorough and easy to read vignette (http://www.milbo.org/doc/earth-notes.pdf).\n\n## References\n\n1. Friedman, J. (1991). Multivariate adaptive regression splines. The annals of statistics, \n 19(1), 1\u201367. http://www.jstor.org/stable/10.2307/2241837\n2. Stephen Milborrow. Derived from mda:mars by Trevor Hastie and Rob Tibshirani.\n (2012). earth: Multivariate Adaptive Regression Spline Models. R package\n version 3.2-3. http://CRAN.R-project.org/package=earth\n3. Friedman, J. (1993). Fast MARS. Stanford University Department of Statistics, Technical Report No 110. \n https://statistics.stanford.edu/sites/default/files/LCS%20110.pdf\n4. Friedman, J. (1991). Estimating functions of mixed ordinal and categorical variables using adaptive splines.\n Stanford University Department of Statistics, Technical Report No 108. \n http://media.salford-systems.com/library/MARS_V2_JHF_LCS-108.pdf\n5. Stewart, G.W. Matrix Algorithms, Volume 1: Basic Decompositions. (1998). Society for Industrial and Applied \n Mathematics.\n6. Bjorck, A. Numerical Methods for Least Squares Problems. (1996). Society for Industrial and Applied \n Mathematics.\n7. Hastie, T., Tibshirani, R., & Friedman, J. The Elements of Statistical Learning (2nd Edition). (2009). \n Springer Series in Statistics\n8. Golub, G., & Van Loan, C. Matrix Computations (3rd Edition). (1996). Johns Hopkins University Press.\n\nReferences 7, 2, 1, 3, and 4 contain discussions likely to be useful to users of py-earth. References 1, 2, 6, 5, \n8, 3, and 4 were useful during the implementation process.\n\n\n\n\n\n\n", "description_content_type": null, "docs_url": null, "download_url": "https://github.com/scikit-learn-contrib/py-earth/archive/0.1.tar.gz", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "", "keywords": "", "license": "LICENSE.txt", "maintainer": "", "maintainer_email": "", "name": "sklearn-contrib-py-earth", "package_url": "https://pypi.org/project/sklearn-contrib-py-earth/", "platform": "", "project_url": "https://pypi.org/project/sklearn-contrib-py-earth/", "project_urls": { "Download": "https://github.com/scikit-learn-contrib/py-earth/archive/0.1.tar.gz" }, "release_url": "https://pypi.org/project/sklearn-contrib-py-earth/0.1.0/", "requires_dist": [ "scikit-learn (>=0.16)", "scipy (>=0.16)", "six", "pandas; extra == 'all_tests'", "patsy; extra == 'all_tests'", "statsmodels; extra == 'all_tests'", "sympy; extra == 'all_tests'", "cython; extra == 'dev'", "sphinx-gallery; extra == 'docs'", "sympy; extra == 'export'" ], "requires_python": "", "summary": "A Python implementation of Jerome Friedman's Multivariate Adaptive Regression Splines.", "version": "0.1.0" }, "last_serial": 3448246, "releases": { "0.1.0": [ { "comment_text": "", "digests": { "md5": "05f013a1b9a375711caddeae488e9aff", "sha256": "986caff5ccae7cbf5c04b46ec443756674797df598314dd4417a1dc64001c05d" }, "downloads": -1, "filename": "sklearn_contrib_py_earth-0.1.0-cp27-cp27m-macosx_10_7_x86_64.whl", "has_sig": false, "md5_digest": "05f013a1b9a375711caddeae488e9aff", "packagetype": "bdist_wheel", "python_version": "cp27", "requires_python": null, "size": 1863643, "upload_time": "2017-12-28T18:59:23", "url": "https://files.pythonhosted.org/packages/85/d3/b9b539855059cf2f14f423b8d197769994c3023543b994f82f3f1590cd48/sklearn_contrib_py_earth-0.1.0-cp27-cp27m-macosx_10_7_x86_64.whl" }, { "comment_text": "", "digests": { "md5": "8c4c559b96d9479d096a61d0af419a9b", "sha256": "1666018d8ba706fb31fe70338eca017f9afacce113abc28739256b0073d39705" }, "downloads": -1, "filename": "sklearn_contrib_py_earth-0.1.0-cp27-cp27m-win32.whl", "has_sig": false, "md5_digest": "8c4c559b96d9479d096a61d0af419a9b", "packagetype": "bdist_wheel", "python_version": "cp27", "requires_python": null, "size": 1593046, "upload_time": "2017-12-28T18:59:31", "url": "https://files.pythonhosted.org/packages/99/21/ae93ed73100913fb1e8f9c837c83ec70f5e9250d72813ded191ae3fb6148/sklearn_contrib_py_earth-0.1.0-cp27-cp27m-win32.whl" }, { "comment_text": "", "digests": { "md5": "8bb6eba0e27df913cd6a0ce24dcfb732", "sha256": "f2c8fc6b6edf0b97056db6c77237b7c65ed7a8e7bbbd7c4656065c3a1f46a88e" }, "downloads": -1, "filename": "sklearn_contrib_py_earth-0.1.0-cp27-cp27m-win_amd64.whl", "has_sig": false, "md5_digest": "8bb6eba0e27df913cd6a0ce24dcfb732", "packagetype": "bdist_wheel", "python_version": "cp27", "requires_python": null, "size": 1708614, "upload_time": "2017-12-28T18:59:41", "url": "https://files.pythonhosted.org/packages/c3/1a/879614e14f7e73af839aed0182f82aeba826c1e3411b51d8708feeae2069/sklearn_contrib_py_earth-0.1.0-cp27-cp27m-win_amd64.whl" }, { "comment_text": "", "digests": { "md5": "a7e59b6ce1bde0c1230cd69548e561bc", "sha256": "477b3ada2aaed25cfd59c6a4a244c9f37708d503ee80acc65150941cb7b00f6f" }, "downloads": -1, "filename": "sklearn_contrib_py_earth-0.1.0-cp35-cp35m-macosx_10_7_x86_64.whl", "has_sig": false, "md5_digest": "a7e59b6ce1bde0c1230cd69548e561bc", "packagetype": "bdist_wheel", "python_version": "cp35", "requires_python": null, "size": 1807438, "upload_time": "2017-12-28T18:59:49", "url": "https://files.pythonhosted.org/packages/32/28/d54c12f42c97521650d168b0d444e8991509ccdd20144a82ee196bcddc3d/sklearn_contrib_py_earth-0.1.0-cp35-cp35m-macosx_10_7_x86_64.whl" }, { "comment_text": "", "digests": { "md5": "c86b8d90cf3ac78ff963497100d8ea92", "sha256": "67d329f3104a1fbe968ed463f6ccc77c72eab15ff36e8ef49098d644c6c25a3c" }, "downloads": -1, "filename": "sklearn_contrib_py_earth-0.1.0-cp35-cp35m-win32.whl", "has_sig": false, "md5_digest": "c86b8d90cf3ac78ff963497100d8ea92", "packagetype": "bdist_wheel", "python_version": "cp35", "requires_python": null, "size": 1556220, "upload_time": "2017-12-28T18:59:55", "url": "https://files.pythonhosted.org/packages/74/de/6764a77acb7ab36b0e4f4f36cb4691d187d1ef3c668489fe6be18e58bd24/sklearn_contrib_py_earth-0.1.0-cp35-cp35m-win32.whl" }, { "comment_text": "", "digests": { "md5": "dac69df00e591bf160b7aa6824368aa0", "sha256": "a1477fde2223cd000154c73bae82f5aaedef0d7191a1e16fbfa8bc7a7ce6147b" }, "downloads": -1, "filename": "sklearn_contrib_py_earth-0.1.0-cp35-cp35m-win_amd64.whl", "has_sig": false, "md5_digest": "dac69df00e591bf160b7aa6824368aa0", "packagetype": "bdist_wheel", "python_version": "cp35", "requires_python": null, "size": 1677324, "upload_time": "2017-12-28T19:00:04", "url": "https://files.pythonhosted.org/packages/d8/9f/2decb9d969d9069e9c5bc1b41e9f6d4615e5bba927e70bd73d6cc49dd404/sklearn_contrib_py_earth-0.1.0-cp35-cp35m-win_amd64.whl" }, { "comment_text": "", "digests": { "md5": "0ffb7d6b35e2fa801b6f5e7d11e8c334", "sha256": "dab98cde502092562c3ae0d1cb19e1af4658ce77d2ebffe908c9a44c1a56eddb" }, "downloads": -1, "filename": "sklearn_contrib_py_earth-0.1.0-cp36-cp36m-macosx_10_7_x86_64.whl", "has_sig": false, "md5_digest": "0ffb7d6b35e2fa801b6f5e7d11e8c334", "packagetype": "bdist_wheel", "python_version": "cp36", "requires_python": null, "size": 1806496, "upload_time": "2017-12-28T19:00:11", "url": "https://files.pythonhosted.org/packages/46/e7/fa6d528e952028b650f3f032b038e2f7b186ff4af6e3a5d7b9d75cd358da/sklearn_contrib_py_earth-0.1.0-cp36-cp36m-macosx_10_7_x86_64.whl" }, { "comment_text": "", "digests": { "md5": "dbebd261763bf3e05cc3472e2fa473f5", "sha256": "4c8676ba36574a079645a6d02f096cafcd98b569ef63c84b954048082281271a" }, "downloads": -1, "filename": "sklearn_contrib_py_earth-0.1.0-cp36-cp36m-win32.whl", "has_sig": false, "md5_digest": "dbebd261763bf3e05cc3472e2fa473f5", "packagetype": "bdist_wheel", "python_version": "cp36", "requires_python": null, "size": 1566770, "upload_time": "2017-12-28T19:00:21", "url": "https://files.pythonhosted.org/packages/24/0b/f408a3c0763388f6cea4de087136458bcf83615a5012e1ceb8884810581f/sklearn_contrib_py_earth-0.1.0-cp36-cp36m-win32.whl" }, { "comment_text": "", "digests": { "md5": "016f48377e6e576f9467529d6ea57413", "sha256": "2d56eaf8fab09390dbcc98e4c88b9e277de89c041b68b5211b1f40af76a569d8" }, "downloads": -1, "filename": "sklearn_contrib_py_earth-0.1.0-cp36-cp36m-win_amd64.whl", "has_sig": false, "md5_digest": "016f48377e6e576f9467529d6ea57413", "packagetype": "bdist_wheel", "python_version": "cp36", "requires_python": null, "size": 1689521, "upload_time": "2017-12-28T19:00:30", "url": "https://files.pythonhosted.org/packages/40/89/ac892d8b1cbee7a03b5e01a6dd88251108435fe820227084fee9bb2b0f18/sklearn_contrib_py_earth-0.1.0-cp36-cp36m-win_amd64.whl" }, { "comment_text": "", "digests": { "md5": "d2096ed078db87b13d31684965e052f1", "sha256": "3d0f1efa5f5508610500deec0fe1084716acce1d0fc4fc81d48c52791ce7ba0c" }, "downloads": -1, "filename": "sklearn-contrib-py-earth-0.1.0.tar.gz", "has_sig": false, "md5_digest": "d2096ed078db87b13d31684965e052f1", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 1007785, "upload_time": "2017-12-28T19:00:38", "url": "https://files.pythonhosted.org/packages/f8/c4/53a24835bafac880036446cc13839471a025b41de1436543f30d15d846c1/sklearn-contrib-py-earth-0.1.0.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "05f013a1b9a375711caddeae488e9aff", "sha256": "986caff5ccae7cbf5c04b46ec443756674797df598314dd4417a1dc64001c05d" }, "downloads": -1, "filename": "sklearn_contrib_py_earth-0.1.0-cp27-cp27m-macosx_10_7_x86_64.whl", "has_sig": false, "md5_digest": "05f013a1b9a375711caddeae488e9aff", "packagetype": "bdist_wheel", "python_version": "cp27", "requires_python": null, "size": 1863643, "upload_time": "2017-12-28T18:59:23", "url": "https://files.pythonhosted.org/packages/85/d3/b9b539855059cf2f14f423b8d197769994c3023543b994f82f3f1590cd48/sklearn_contrib_py_earth-0.1.0-cp27-cp27m-macosx_10_7_x86_64.whl" }, { "comment_text": "", "digests": { "md5": "8c4c559b96d9479d096a61d0af419a9b", "sha256": "1666018d8ba706fb31fe70338eca017f9afacce113abc28739256b0073d39705" }, "downloads": -1, "filename": "sklearn_contrib_py_earth-0.1.0-cp27-cp27m-win32.whl", "has_sig": false, "md5_digest": "8c4c559b96d9479d096a61d0af419a9b", "packagetype": "bdist_wheel", "python_version": "cp27", "requires_python": null, "size": 1593046, "upload_time": "2017-12-28T18:59:31", "url": "https://files.pythonhosted.org/packages/99/21/ae93ed73100913fb1e8f9c837c83ec70f5e9250d72813ded191ae3fb6148/sklearn_contrib_py_earth-0.1.0-cp27-cp27m-win32.whl" }, { "comment_text": "", "digests": { "md5": "8bb6eba0e27df913cd6a0ce24dcfb732", "sha256": "f2c8fc6b6edf0b97056db6c77237b7c65ed7a8e7bbbd7c4656065c3a1f46a88e" }, "downloads": -1, "filename": "sklearn_contrib_py_earth-0.1.0-cp27-cp27m-win_amd64.whl", "has_sig": false, "md5_digest": "8bb6eba0e27df913cd6a0ce24dcfb732", "packagetype": "bdist_wheel", "python_version": "cp27", "requires_python": null, "size": 1708614, "upload_time": "2017-12-28T18:59:41", "url": "https://files.pythonhosted.org/packages/c3/1a/879614e14f7e73af839aed0182f82aeba826c1e3411b51d8708feeae2069/sklearn_contrib_py_earth-0.1.0-cp27-cp27m-win_amd64.whl" }, { "comment_text": "", "digests": { "md5": "a7e59b6ce1bde0c1230cd69548e561bc", "sha256": "477b3ada2aaed25cfd59c6a4a244c9f37708d503ee80acc65150941cb7b00f6f" }, "downloads": -1, "filename": "sklearn_contrib_py_earth-0.1.0-cp35-cp35m-macosx_10_7_x86_64.whl", "has_sig": false, "md5_digest": "a7e59b6ce1bde0c1230cd69548e561bc", "packagetype": "bdist_wheel", "python_version": "cp35", "requires_python": null, "size": 1807438, "upload_time": "2017-12-28T18:59:49", "url": "https://files.pythonhosted.org/packages/32/28/d54c12f42c97521650d168b0d444e8991509ccdd20144a82ee196bcddc3d/sklearn_contrib_py_earth-0.1.0-cp35-cp35m-macosx_10_7_x86_64.whl" }, { "comment_text": "", "digests": { "md5": "c86b8d90cf3ac78ff963497100d8ea92", "sha256": "67d329f3104a1fbe968ed463f6ccc77c72eab15ff36e8ef49098d644c6c25a3c" }, "downloads": -1, "filename": "sklearn_contrib_py_earth-0.1.0-cp35-cp35m-win32.whl", "has_sig": false, "md5_digest": "c86b8d90cf3ac78ff963497100d8ea92", "packagetype": "bdist_wheel", "python_version": "cp35", "requires_python": null, "size": 1556220, "upload_time": "2017-12-28T18:59:55", "url": "https://files.pythonhosted.org/packages/74/de/6764a77acb7ab36b0e4f4f36cb4691d187d1ef3c668489fe6be18e58bd24/sklearn_contrib_py_earth-0.1.0-cp35-cp35m-win32.whl" }, { "comment_text": "", "digests": { "md5": "dac69df00e591bf160b7aa6824368aa0", "sha256": "a1477fde2223cd000154c73bae82f5aaedef0d7191a1e16fbfa8bc7a7ce6147b" }, "downloads": -1, "filename": "sklearn_contrib_py_earth-0.1.0-cp35-cp35m-win_amd64.whl", "has_sig": false, "md5_digest": "dac69df00e591bf160b7aa6824368aa0", "packagetype": "bdist_wheel", "python_version": "cp35", "requires_python": null, "size": 1677324, "upload_time": "2017-12-28T19:00:04", "url": "https://files.pythonhosted.org/packages/d8/9f/2decb9d969d9069e9c5bc1b41e9f6d4615e5bba927e70bd73d6cc49dd404/sklearn_contrib_py_earth-0.1.0-cp35-cp35m-win_amd64.whl" }, { "comment_text": "", "digests": { "md5": "0ffb7d6b35e2fa801b6f5e7d11e8c334", "sha256": "dab98cde502092562c3ae0d1cb19e1af4658ce77d2ebffe908c9a44c1a56eddb" }, "downloads": -1, "filename": "sklearn_contrib_py_earth-0.1.0-cp36-cp36m-macosx_10_7_x86_64.whl", "has_sig": false, "md5_digest": "0ffb7d6b35e2fa801b6f5e7d11e8c334", "packagetype": "bdist_wheel", "python_version": "cp36", "requires_python": null, "size": 1806496, "upload_time": "2017-12-28T19:00:11", "url": "https://files.pythonhosted.org/packages/46/e7/fa6d528e952028b650f3f032b038e2f7b186ff4af6e3a5d7b9d75cd358da/sklearn_contrib_py_earth-0.1.0-cp36-cp36m-macosx_10_7_x86_64.whl" }, { "comment_text": "", "digests": { "md5": "dbebd261763bf3e05cc3472e2fa473f5", "sha256": "4c8676ba36574a079645a6d02f096cafcd98b569ef63c84b954048082281271a" }, "downloads": -1, "filename": "sklearn_contrib_py_earth-0.1.0-cp36-cp36m-win32.whl", "has_sig": false, "md5_digest": "dbebd261763bf3e05cc3472e2fa473f5", "packagetype": "bdist_wheel", "python_version": "cp36", "requires_python": null, "size": 1566770, "upload_time": "2017-12-28T19:00:21", "url": "https://files.pythonhosted.org/packages/24/0b/f408a3c0763388f6cea4de087136458bcf83615a5012e1ceb8884810581f/sklearn_contrib_py_earth-0.1.0-cp36-cp36m-win32.whl" }, { "comment_text": "", "digests": { "md5": "016f48377e6e576f9467529d6ea57413", "sha256": "2d56eaf8fab09390dbcc98e4c88b9e277de89c041b68b5211b1f40af76a569d8" }, "downloads": -1, "filename": "sklearn_contrib_py_earth-0.1.0-cp36-cp36m-win_amd64.whl", "has_sig": false, "md5_digest": "016f48377e6e576f9467529d6ea57413", "packagetype": "bdist_wheel", "python_version": "cp36", "requires_python": null, "size": 1689521, "upload_time": "2017-12-28T19:00:30", "url": "https://files.pythonhosted.org/packages/40/89/ac892d8b1cbee7a03b5e01a6dd88251108435fe820227084fee9bb2b0f18/sklearn_contrib_py_earth-0.1.0-cp36-cp36m-win_amd64.whl" }, { "comment_text": "", "digests": { "md5": "d2096ed078db87b13d31684965e052f1", "sha256": "3d0f1efa5f5508610500deec0fe1084716acce1d0fc4fc81d48c52791ce7ba0c" }, "downloads": -1, "filename": "sklearn-contrib-py-earth-0.1.0.tar.gz", "has_sig": false, "md5_digest": "d2096ed078db87b13d31684965e052f1", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 1007785, "upload_time": "2017-12-28T19:00:38", "url": "https://files.pythonhosted.org/packages/f8/c4/53a24835bafac880036446cc13839471a025b41de1436543f30d15d846c1/sklearn-contrib-py-earth-0.1.0.tar.gz" } ] }