{ "info": { "author": "P. James Joyce", "author_email": "pjamesjoyce@gmail.com", "bugtrack_url": null, "classifiers": [ "Intended Audience :: Developers", "Intended Audience :: End Users/Desktop", "Intended Audience :: Science/Research", "License :: OSI Approved :: BSD License", "Operating System :: MacOS :: MacOS X", "Operating System :: Microsoft :: Windows", "Operating System :: POSIX", "Programming Language :: Python", "Programming Language :: Python :: 3", "Programming Language :: Python :: 3.4", "Programming Language :: Python :: 3.5", "Topic :: Scientific/Engineering :: Information Analysis", "Topic :: Scientific/Engineering :: Mathematics", "Topic :: Scientific/Engineering :: Visualization" ], "description": "# lcopt-dev\nDevelopment branch for the interactive tool for creating fully parameterised Life Cycle Assessment (LCA) foreground models (lcopt)\n\n| \tPlatform\t\t| Status \t\t|\n|---------------|---------------|\n| Unix \t\t| [![Build Status](https://travis-ci.org/pjamesjoyce/lcopt.svg?branch=development)](https://travis-ci.org/pjamesjoyce/lcopt) |\n| Windows \t\t| [![Windows Build status](https://ci.appveyor.com/api/projects/status/vwtfm3ml7hy070ku/branch/development?svg=true)](https://ci.appveyor.com/project/pjamesjoyce/lcopt/branch/development) |\n| Test coverage | [![Coverage Status](https://coveralls.io/repos/github/pjamesjoyce/lcopt/badge.svg?branch=development)](https://coveralls.io/github/pjamesjoyce/lcopt?branch=development) |\n|Citation | [![Publication](http://joss.theoj.org/papers/c0b544bee185c9ac75e96d24b8573547/status.svg)](http://joss.theoj.org/papers/c0b544bee185c9ac75e96d24b8573547)|\n\nLcopt is a python module for creating fully parameterised LCA foreground models using a Flask based interactive GUI developed by [James Joyce](https://pjamesjoyce.github.io/)\n\nIt integrates directly with BrightWay2, and can export models to SimaPro\n\nYou can export and share your model and results as an .lcoptview file, and share them with a wider audience using [lcoptview](http://lcoptview.rtfd.io)\n\nOnline documentation, including full installation instructions, is available [here](http://lcopt.readthedocs.io)\n\n## Installation\n\n### Development installation\n\nLcopt is continuing to develop, with new features and extensions being added. The `lcopt-dev` conda package is updated each time an update is pushed to the [`development` branch on github](https://github.com/pjamesjoyce/lcopt/tree/development).\n\nIt's recommended that you create a new environment separate from the one with `lcopt` in to install `lcopt-dev`, as they will overwrite one another.\n\nCreate and activate a dev environment at the command line/terminal like this\n\n```\nconda create -y -n lcopt-dev -c conda-forge -c cmutel -c haasad -c pjamesjoyce lcopt-dev\nactivate lcopt-dev # Note, use \"source activate lcopt-dev\" on Unix\n```\n\nOr to get the most up to date version of `lcopt-dev` in your existing environment:\n\n```\nactivate lcopt-dev # Note, use \"source activate lcopt-dev\" on Unix\nconda update -c conda-forge -c cmutel -c haasad -c pjamesjoyce lcopt-dev\n```\n\n### Linking lcopt to brightway\n\n`lcopt-dev` makes this easy, by using the excellent [`eidl`](https://github.com/haasad/EcoInventDownLoader) developed by [Adrian Haas](https://github.com/haasad).\n\nLcopt-dev can create models using external LCI data from any version of the [ecoinvent database](http://www.ecoinvent.org/database/ecoinvent-33/ecoinvent-33.html) (ecoinvent license required) or the [FORWAST database](http://forwast.brgm.fr/)\n\nIf you have an ecoinvent login, open up the command line/console and type:\n\n```\nlcopt-settings\n```\n\nThis will launch the settings page in your web browser. Enter your username and password, and choose your preferred version of ecoinvent. Click save.\n\n![Lcopt settings](./docs/assets/lcopt_dev_settings.jpg)\n\nThe first time you create a model, lcopt will automatically download and set up the ecoinvent database in brightway - just be patient as it takes a while. This only needs to happen once though.\n\nIf you don't have an ecoinvent login, leave this blank and lcopt will automatically download and use FORWAST instead.\n\n## Using lcopt (Easy)\n\nBelow are the basic commands to get lcopt's interactive GUI up and running to create your first model. A [Getting Started](https://lcopt.readthedocs.io/en/latest/2_Getting_Started.html) guide, including a [video runthrough](https://lcopt.readthedocs.io/en/latest/2_Getting_Started.html#video), as well as [more detailed instructions](https://lcopt.readthedocs.io/en/latest/3_use.html) are available in the [online documentation](https://lcopt.readthedocs.io/).\n\nTo launch lcopt and view an example model, at the command line use:\n\n```\nlcopt-launcher\n```\n\nLcopt is written in Python, so you can also use it from within a Python shell. Open up a jupyter notebook or python shell and use the following commands:\n\n## Using Lcopt from the python shell/Jupyter notebooks (Recommended)\n\nTo import lcopt use: \n\n```python\nfrom lcopt import *\n```\n\n### Creating a new model\n\nTo create a model, you need to create an instance of the LcoptModel class using the model name as the first argument:\n\n```python\nmodel = LcoptModel('My First Model')\n```\n\nBy default the model will be populated in the background with the details to link to the version of ecoinvent you specify in settings. If you want your model to use a dirfferent version or system model you can specify this using:\n\n\n```python\nmodel = LcoptModel('My First Ecoinvent 3.4 APOS Model', ecoinvent_version=\"3.4\", ecoinvent_system_model=\"apos\")\n```\n\nOr if you want to use FORWAST instead use:\n\n```python\nmodel = LcoptModel('My First FORWAST Model', useForwast=True)\n```\n\n### Loading an existing model\n\nLcopt saves models in your local APPDATA directory by default. In windows this is C:\\Users\\[your_name]\\AppData\\Local\\Lcopt\\Lcopt.\n\nYou can optionally tell lcopt to save models in your current directory using `lcopt-settings`\n\nTo load a model, use the model name (with or without the .lcopt extension) or the full file path (if it's not in the current directory or defualt directory), in this command:\n\n```python\nmodel = LcoptModel(load='My First Model')\n```\n\nNote : If you accidentally forget to use `load=` and you see a blank model don't panic. Lcopt won't overwrite your saved model unless you tell it to. Simply don't save the model and re-run the command with `load=`\n\n### Launching the GUI\n\nTo launch the GUI for your model simply call the `launch_interact` method of your newly created model instance:\n\n```python\nmodel.launch_interact()\n```\n\nThis will start a Flask server and launch your web browser to access the GUI. If it doesn't or you accidentally close the GUI tab, simply go to [http://127.0.0.1:5000/](http://127.0.0.1:5000/).\n\nInformation on how to use the GUI is located in 'More info...' panels dotted around at sensible locations within it.\n\nFor more details on using it, see the [documentation](https://lcopt.readthedocs.io/en/latest/3_use.html) or the [video](https://lcopt.readthedocs.io/en/latest/2_Getting_Started.html#video)\n\n## Contribute\n\nIf you have any problems, questions, comments, feature requests etc. please [raise an issue here on github](https://github.com/pjamesjoyce/lcopt/issues)\n\nIf you want to contribute to Lcopt, you're more than welcome! Please fork the [github repository](https://github.com/pjamesjoyce/lcopt/) and open a pull request. \n\nLcopt uses [py.test](https://docs.pytest.org/en/latest/index.html>) and Travis for automated testing, so please accompany any new features with corresponding tests. See the `tests` folder in the [source code](https://github.com/pjamesjoyce/lcopt/tree/master/tests) for examples. \n\n## Cite\n\nLcopt has been published in the [Journal of Open Source Software](http://joss.theoj.org/papers/10.21105/joss.00339).\n\n[![Publication](http://joss.theoj.org/papers/c0b544bee185c9ac75e96d24b8573547/status.svg)](http://joss.theoj.org/papers/c0b544bee185c9ac75e96d24b8573547)\n\nYou can download the citation in BibTeX for use in LaTeX or importing into [Mendeley](https://www.mendeley.com/)/other reference management software from [here](http://www.doi2bib.org/#/doi/10.21105/joss.00339).\n\nOr use the following citation:\n\nJoyce, P.J., 2017. Lcopt - An interactive tool for creating fully parameterised Life Cycle Assessment (LCA) foreground models. Journal of Open Source Software, 2:16. doi:10.21105/joss.00339\n\n## Thanks\n\nThanks to [Adrian Haas](https://github.com/haasad) for contributing to the ongoing development of lcopt!\n", "description_content_type": "", "docs_url": null, "download_url": "https://github.com/pjamesjoyce/lcopt/archive/0.4.2.tar.gz", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/pjamesjoyce/lcopt/", "keywords": "LCA", "license": "Copyright 2017 P. James Joyce\n\nRedistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:\n\n1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.\n\n2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.\n\n3. Neither the name of the copyright holder nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.\n\nTHIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS \"AS IS\" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.", "maintainer": "", "maintainer_email": "", "name": "lcopt-dev", "package_url": "https://pypi.org/project/lcopt-dev/", "platform": "", "project_url": "https://pypi.org/project/lcopt-dev/", "project_urls": { "Download": "https://github.com/pjamesjoyce/lcopt/archive/0.4.2.tar.gz", "Homepage": "https://github.com/pjamesjoyce/lcopt/" }, "release_url": "https://pypi.org/project/lcopt-dev/0.4.2/", "requires_dist": null, "requires_python": "", "summary": "An interactive tool for creating fully parameterised Life Cycle Assessment (LCA) foreground models", "version": "0.4.2" }, "last_serial": 4363950, "releases": { "0.4.2": [ { "comment_text": "", "digests": { "md5": "a1b1334a4d933278976564734cc6ae7f", "sha256": "23994a15fcec2f261dde4cfd2d4fc0ae45f1e006d09b70e14fc4ceba41e0c530" }, "downloads": -1, "filename": "lcopt-dev-0.4.2.tar.gz", "has_sig": false, "md5_digest": "a1b1334a4d933278976564734cc6ae7f", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 17851392, "upload_time": "2018-10-11T11:18:17", "url": "https://files.pythonhosted.org/packages/27/e0/f685c307539ea36f6c03ecd8c4670532a0f737abbd60cce8365c24400164/lcopt-dev-0.4.2.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "a1b1334a4d933278976564734cc6ae7f", "sha256": "23994a15fcec2f261dde4cfd2d4fc0ae45f1e006d09b70e14fc4ceba41e0c530" }, "downloads": -1, "filename": "lcopt-dev-0.4.2.tar.gz", "has_sig": false, "md5_digest": "a1b1334a4d933278976564734cc6ae7f", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 17851392, "upload_time": "2018-10-11T11:18:17", "url": "https://files.pythonhosted.org/packages/27/e0/f685c307539ea36f6c03ecd8c4670532a0f737abbd60cce8365c24400164/lcopt-dev-0.4.2.tar.gz" } ] }