{ "info": { "author": "Thomas R. Etherington, E. Penelope Holland, and David O'Sullivan", "author_email": "t.etherington@kew.org", "bugtrack_url": null, "classifiers": [], "description": "NLMpy\n=====\n\nNLMpy is a Python package for the creation of neutral landscape models that\nare widely used in the modelling of ecological patterns and processes across\nlandscapes.\n\nNLMpy aims to provide several advantages over existing NLM software:\n\n* it is open-source so it can be easily adapted or developed for specific modelling requirements.\n* being cross-platform it can be used on any computer system.\n* it brings together a much wider range of NLM algorithms, including some that are not available elsewhere.\n* it can be combined with geographic information system (GIS) data.\n* it enables novel combinations and integrations of different NLM algorithms.\n* it can be embedded into larger modelling frameworks based on software that is capable of executing a Python script. \n\nExample use\n===========\n\nUsing NLMpy to create and export a midpoint displacement NLM can be achieved with \nonly three lines of code:\n\n.. code:: python\n\n >>> import nlmpy\n >>> nlm = nlmpy.mpd(nRow=50, nCol=50, h=0.75)\n >>> nlmpy.exportASCIIGrid(\"raster.asc\", nlm)\n\nPython 3.x example use\n======================\n\nDue to differences in absolute and relative importing between Python versions 2.x and 3.x NLMpy needs to be imported slightly differently in version 3.x:\n\n.. code:: python\n\n >>> from nlmpy import nlmpy\n >>> nlm = nlmpy.mpd(nRow=50, nCol=50, h=0.75)\n >>> nlmpy.exportASCIIGrid(\"raster.asc\", nlm)\n\t\nPlease note that when executing the example scripts from the supplementary material provided with the published paper, if you are running Python 3.x you will need to modify the way NLMpy is imported by the script.\n\nOtherwise NLMPy should work fine in a 3.x environment and has been successfully tested with Python 3.5.2, Numpy 1.11.3, SciPy 0.18.1, Matplotlib 2.0.0, and NLMpy 0.1.4.\n\nDocumentation\n=============\n\n\nA full description of NLMpy is published in: Etherington TR, Holland EP, and \nO'Sullivan D (2015) NLMpy: a Python software package for the creation of \nneutral landscape models within a general numerical framework. Methods in \nEcology and Evolution 6(2):164-168 , which is freely available online \n(http://bit.ly/14i4x7n). \n\nThe journal website also holds example scripts and GIS data\n(http://bit.ly/1XUXjOF) that generate the figures in the paper. There are \nalso some tutorial videos that provide some advice about installing \n(http://bit.ly/1qLfMjt) and using (http://bit.ly/2491u9n) NLMpy.\n\n\nDependencies\n============\n\nNLMpy was developed using:\n\n* Python 2.7.3\n* NumPy 1.8.0\n* SciPy 0.13.2\n* Matplotlib 1.3.1\n\nVersion History\n===============\n\n* 0.1.5 - added some advice to the read me about imprting NLMpy with Python 3.x\n* 0.1.4 - updated code to add compatability with Python 3.x\n* 0.1.3 - updated documentation\n* 0.1.2 - updated documentation\n* 0.1.1 - added the exportASCIIGrid function\n\nInstallation notes\n==================\n\nGetting a properly working installation of Python and associated packages can be a rather \nunintuitive task \u2013 especially if you are not overly familiar with software distribution \nmethods. It is possible to build a Python installation by downloading Python itself \n(https://www.python.org/downloads/) and then adding required Python packages from the \nPython Package Index (https://pypi.python.org/pypi). However, a much simpler approach \nthat I would recommend is using a scientific distribution of Python that comes with all \nthe packages you are most likely to require for scientific applications.\n\nPerhaps the two most popular scientific distributions of Python are the Anaconda \ndistribution (https://store.continuum.io/cshop/anaconda/) and the Canopy distribution \n(https://www.enthought.com/products/canopy/). I would recommend either, as they are \nboth: cross-platform, free to download, and come with all the Python packages most \ncommonly required for scientific computing. My personal preference is for the Anaconda \ndistribution, as it comes with Spyder (https://pythonhosted.org/spyder/) that is in my \nopinion the best environment for writing Python code (it is similar to Rstudio for people \nmore used to using R), and because in Canopy access to some of the Python packages I use \na lot requires additional licencing. But in order to get NLMpy working either Anaconda or \nCanopy will work, as they both come with the NumPy (http://www.numpy.org/) and SciPy \n(http://www.scipy.org/) packages on which NLMpy depends, the Matplotlib \n(http://matplotlib.org/) package that the example scripts use to plot results, and the pip \n(https://pypi.python.org/pypi/pip) package that makes installation of NLMpy easy.\n\nOnce you have installed the Python version 2.7.x of either Anaconda or Canopy, the \ninstallation of NLMpy can be done from the command line using either a Terminal on \nOSX/UNIX or a Command Prompt on Windows. At the command line you just need to run::\n\n pip install nlmpy\n\nwhich will get the pip program to install NLMpy directly from the online Python Package \nIndex.\n\nYou may have a problem using this approach if you connect to the Internet via a proxy \nserver. So while this approach works fine for me at home, I can\u2019t use it at work. There \nis however an alternative approach. You can go to the NLMpy Python Package Index page \n(https://pypi.python.org/pypi/nlmpy) and download the nlmpy-0.1.1.tar.gz package file. \nWith the file downloaded to your computer you can then use pip to install NLMpy from this \nlocal file by running::\n\n pip install /Users/username/Downloads/nlmpy-0.1.5.tar.gz\n\nthough you will obviously have to specify the directory location for the package file that \nis correct on your computer!\n\nIf you are unable to get either of those approaches to work, there is an easy workaround. \nIf you decompress the nlmpy-0.1.5.tar.gz package file, you will find inside a nlmpy.py file \nthat contains all the NLMpy functions. If you simply move this file to the same location \non your computer as a Python script that wants to import nlmpy, then when those scripts are \nexecuted they will import all the NLMpy functions. So while this approach doesn\u2019t \nactually install NLMpy onto your computer, it does at least allow you to make use of the \nfunctionality of NLMpy within a neighbouring Python script.", "description_content_type": null, "docs_url": null, "download_url": "UNKNOWN", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://pypi.python.org/pypi/nlmpy", "keywords": null, "license": "MIT", "maintainer": null, "maintainer_email": null, "name": "nlmpy", "package_url": "https://pypi.org/project/nlmpy/", "platform": "UNKNOWN", "project_url": "https://pypi.org/project/nlmpy/", "project_urls": { "Download": "UNKNOWN", "Homepage": "https://pypi.python.org/pypi/nlmpy" }, "release_url": "https://pypi.org/project/nlmpy/0.1.5/", "requires_dist": null, "requires_python": null, "summary": "A Python package to create neutral landscape models", "version": "0.1.5" }, "last_serial": 2657423, "releases": { "0.1": [ { "comment_text": "", "digests": { "md5": "1bdc9e7ffd07514a048369716de91c3b", "sha256": "7c269472ab7f87580f8c33b3a73a3fc331ab8589fb69a131f9a82b51f4e86a1b" }, "downloads": -1, "filename": "nlmpy-0.1.tar.gz", "has_sig": false, "md5_digest": "1bdc9e7ffd07514a048369716de91c3b", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 5748, "upload_time": "2014-07-30T01:46:50", "url": "https://files.pythonhosted.org/packages/c8/27/6016f334baad9d207c0e8714cf777ed3fd8f063ef33c5cbdf7b64245c93e/nlmpy-0.1.tar.gz" } ], "0.1.1": [ { "comment_text": "", "digests": { "md5": "f20fb138477f1e08cbc24bfbedd71957", "sha256": "5fcef7d35bbf96e1ec00840631b3a0fff3645083fc259e3a6dc6d0549e976ff1" }, "downloads": -1, "filename": "nlmpy-0.1.1.tar.gz", "has_sig": false, "md5_digest": "f20fb138477f1e08cbc24bfbedd71957", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 9131, "upload_time": "2014-10-31T00:41:36", "url": "https://files.pythonhosted.org/packages/b2/1b/fd2cbf94e5ddd748a9655fff47c6d247367f28fa77b9e41888bdc6da3260/nlmpy-0.1.1.tar.gz" } ], "0.1.2": [], "0.1.3": [ { "comment_text": "Updated documentation", "digests": { "md5": "0e992942cc20eaf0578abb54ccfd9c0e", "sha256": "2af0027f1b3305ed7417d2ae342807881192752b2f7644e688fd25de1cad235e" }, "downloads": -1, "filename": "nlmpy-0.1.3.tar.gz", "has_sig": false, "md5_digest": "0e992942cc20eaf0578abb54ccfd9c0e", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 9632, "upload_time": "2016-05-26T11:51:07", "url": "https://files.pythonhosted.org/packages/9e/c6/d083ec3e864de82116acdb0ceb1f50f8a5236d6fa0cc7c5c2b028ee17ddc/nlmpy-0.1.3.tar.gz" } ], "0.1.4": [ { "comment_text": "", "digests": { "md5": "951dc9c9d62da41cccbf1e9ea44b6ce8", "sha256": "fee8337398dd75fd15c80adc671f3838f6211b2b893362a7f01859a3d548aa20" }, "downloads": -1, "filename": "nlmpy-0.1.4.tar.gz", "has_sig": false, "md5_digest": "951dc9c9d62da41cccbf1e9ea44b6ce8", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 9740, "upload_time": "2017-02-16T14:06:34", "url": "https://files.pythonhosted.org/packages/04/a6/e197ab71b98da869b9e0ee4674f8ec0ad324b1f6ee4cc757a11027df3139/nlmpy-0.1.4.tar.gz" } ], "0.1.5": [ { "comment_text": "", "digests": { "md5": "032dcfe22c49c505e200f010b239fdae", "sha256": "618eebc22a9fd8268893eaab14d40a2dd16939f31d59d00c46b6c1fc03e5b6d0" }, "downloads": -1, "filename": "nlmpy-0.1.5.tar.gz", "has_sig": false, "md5_digest": "032dcfe22c49c505e200f010b239fdae", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 10057, "upload_time": "2017-02-21T11:34:42", "url": "https://files.pythonhosted.org/packages/8a/85/94ebdcd2ec660471adbee031d6e51c151166fa5e6a50323d0725a9b9a2e9/nlmpy-0.1.5.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "032dcfe22c49c505e200f010b239fdae", "sha256": "618eebc22a9fd8268893eaab14d40a2dd16939f31d59d00c46b6c1fc03e5b6d0" }, "downloads": -1, "filename": "nlmpy-0.1.5.tar.gz", "has_sig": false, "md5_digest": "032dcfe22c49c505e200f010b239fdae", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 10057, "upload_time": "2017-02-21T11:34:42", "url": "https://files.pythonhosted.org/packages/8a/85/94ebdcd2ec660471adbee031d6e51c151166fa5e6a50323d0725a9b9a2e9/nlmpy-0.1.5.tar.gz" } ] }